JSON.SET - Amazon ElastiCache

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

JSON.SET

在路徑上設定JSON值。

如果路徑呼叫物件成員:

  • 如果父元素不存在,命令會傳回NONEXISTENT錯誤。

  • 如果父元素存在,但不是物件,則命令會傳回 ERROR。

  • 如果有父元素且為物件:

    • 如果沒有成員,只會在父物件是路徑中的最後一個子系時,將新成員附加至父物件。否則,命令會傳回NONEXISTENT錯誤。

    • 如果成員存在,其值將被JSON值取代。

如果路徑呼叫陣列索引:

  • 如果父元素不存在,命令會傳回NONEXISTENT錯誤。

  • 如果父元素存在,但不是陣列,則命令會傳回 ERROR。

  • 如果父元素存在,但索引超出範圍,則命令會傳回OUTOFBOUNDARIES錯誤。

  • 如果父元素存在且索引有效,則該元素將被新JSON值取代。

如果路徑呼叫物件或陣列,則該值 (物件或陣列) 將被新JSON值取代。

語法

JSON.SET <key> <path> <json> [NX | XX]

[NX | XX] 您可以在其中有 0 或 1 個 [NX | XX] 識別碼。

  • 金鑰 (必要) – JSON 文件類型的 Valkey 或 Redis OSS金鑰。

  • 路徑 (必要) – JSON 路徑。對於新金鑰,JSON路徑必須是根 "."。

  • NX (選用) – 如果路徑是根,則只有在金鑰不存在時才設定值。也就是插入新文件。如果路徑不是根,請只在沒有路徑時才設定值。也就是將值插入文件中。

  • XX (選用) – 如果路徑是根,則只有在金鑰存在時才設定 值。也就是取代現有文件。如果路徑不是根,請只在有路徑時才設定值。也就是更新現有值。

傳回

  • 成功時有簡單字串 'OK'。

  • 如果不符合 NX 或 XX 條件,即為 null。

範例

增強型路徑語法:

127.0.0.1:6379> JSON.SET k1 . '{"a":{"a":1, "b":2, "c":3}}' OK 127.0.0.1:6379> JSON.SET k1 $.a.* '0' OK 127.0.0.1:6379> JSON.GET k1 "{\"a\":{\"a\":0,\"b\":0,\"c\":0}}" 127.0.0.1:6379> JSON.SET k2 . '{"a": [1,2,3,4,5]}' OK 127.0.0.1:6379> JSON.SET k2 $.a[*] '0' OK 127.0.0.1:6379> JSON.GET k2 "{\"a\":[0,0,0,0,0]}"

受限路徑語法:

127.0.0.1:6379> JSON.SET k1 . '{"c":{"a":1, "b":2}, "e": [1,2,3,4,5]}' OK 127.0.0.1:6379> JSON.SET k1 .c.a '0' OK 127.0.0.1:6379> JSON.GET k1 "{\"c\":{\"a\":0,\"b\":2},\"e\":[1,2,3,4,5]}" 127.0.0.1:6379> JSON.SET k1 .e[-1] '0' OK 127.0.0.1:6379> JSON.GET k1 "{\"c\":{\"a\":0,\"b\":2},\"e\":[1,2,3,4,0]}" 127.0.0.1:6379> JSON.SET k1 .e[5] '0' (error) OUTOFBOUNDARIES Array index is out of bounds