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

JSON 資料類型概觀

MemoryDB 支援許多使用JSON資料類型的 Valkey 和 Redis OSS命令。以下是JSON資料類型的概觀，以及支援命令的詳細清單。

術語

支援JSON的標準

JSON 格式符合 RFC 7159 和 ECMA-404 JSON資料交換標準。UTF支援JSON文字中的 -8 Unicode。

根元素

根元素可以是任何JSON資料類型。請注意，在舊版 RFC 4627 中，僅允許物件或陣列作為根值。自更新至 RFC 7159 以來，JSON文件的根可以是任何JSON資料類型。

文件大小限制

JSON 文件會以針對快速存取和修改最佳化的格式儲存在內部。此格式通常會比相同文件的等效序列化表示法消耗更多記憶體。單一JSON文件的記憶體使用量限制為 64MB ，這是記憶體內資料結構的大小，而不是JSON字串的大小。可以使用 JSON.DEBUG MEMORY命令檢查JSON文件耗用的記憶體量。

JSON ACLs

巢狀深度限制

當JSON物件或陣列的元素本身是另一個JSON物件或陣列時，該內部物件或陣列稱為「巢狀」外部物件或陣列內。巢狀深度上限為 128。任何建立巢狀深度大於 128 文件的嘗試，都會遭到拒絕，並顯示錯誤。

命令語法

大多數命令需要 Valkey 或 Redis OSS金鑰名稱作為第一個引數。部分命令也有路徑引數。如果路徑引數為選用且未提供，則路徑引數會預設為根。

標記法：

路徑語法

JSON for Valkey 和 Redis OSS支援兩種路徑語法：

如果查詢路徑以 '$' 開頭，它會使用增強型語法。否則，將使用受限語法。

增強語法

範例

下列範例建立在 Goessner 的範例XML資料上，我們已透過新增其他欄位修改這些資料。

{ "store": {
    "book": [ 
      { "category": "reference",
        "author": "Nigel Rees",
        "title": "Sayings of the Century",
        "price": 8.95,
        "in-stock": true,
        "sold": true
      },
      { "category": "fiction",
        "author": "Evelyn Waugh",
        "title": "Sword of Honour",
        "price": 12.99,
        "in-stock": false,
        "sold": true
      },
      { "category": "fiction",
        "author": "Herman Melville",
        "title": "Moby Dick",
        "isbn": "0-553-21311-3",
        "price": 8.99,
        "in-stock": true,
        "sold": false
      },
      { "category": "fiction",
        "author": "J. R. R. Tolkien",
        "title": "The Lord of the Rings",
        "isbn": "0-395-19395-8",
        "price": 22.99,
        "in-stock": false,
        "sold": false
      }
    ],
    "bicycle": {
      "color": "red",
      "price": 19.95,
      "in-stock": true,
      "sold": false
    }
  }
}

更多篩選條件表達式範例：

127.0.0.1:6379> JSON.SET k1 . '{"books": [{"price":5,"sold":true,"in-stock":true,"title":"foo"}, {"price":15,"sold":false,"title":"abc"}]}'
OK
127.0.0.1:6379> JSON.GET k1 $.books[?(@.price>1&&@.price<20&&@.in-stock)]
"[{\"price\":5,\"sold\":true,\"in-stock\":true,\"title\":\"foo\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?(@.price>1 && @.price<20 && @.in-stock)]'
"[{\"price\":5,\"sold\":true,\"in-stock\":true,\"title\":\"foo\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?((@.price>1 && @.price<20) && (@.sold==false))]'
"[{\"price\":15,\"sold\":false,\"title\":\"abc\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?(@.title == "abc")]'
[{"price":15,"sold":false,"title":"abc"}]

127.0.0.1:6379> JSON.SET k2 . '[1,2,3,4,5]'
127.0.0.1:6379> JSON.GET k2 $.*.[?(@>2)]
"[3,4,5]"
127.0.0.1:6379> JSON.GET k2 '$.*.[?(@ > 2)]'
"[3,4,5]"

127.0.0.1:6379> JSON.SET k3 . '[true,false,true,false,null,1,2,3,4]'
OK
127.0.0.1:6379> JSON.GET k3 $.*.[?(@==true)]
"[true,true]"
127.0.0.1:6379> JSON.GET k3 '$.*.[?(@ == true)]'
"[true,true]"
127.0.0.1:6379> JSON.GET k3 $.*.[?(@>1)]
"[2,3,4]"
127.0.0.1:6379> JSON.GET k3 '$.*.[?(@ > 1)]'
"[2,3,4]"

受限語法

範例

常見錯誤字首

每個錯誤訊息都有一個字首。以下是常見錯誤字首的清單：

JSON 相關指標

提供下列JSON資訊指標：

若要查詢核心指標，請執行 命令：

info json_core_metrics

MemoryDB 如何與 互動 JSON

以下說明 MemoryDB 如何與JSON資料類型互動。

運算子優先順序

評估用於篩選的條件表達式時，&& 優先，然後評估 ||，就像大多數語言一樣。括號內的操作會先執行。

路徑巢狀上限行為

MemoryDB 的路徑巢狀限制上限為 128。$.a.b.c.d... 等值只能達到 128 個等級。

處理數值

JSON 沒有整數和浮點數的個別資料類型。均稱為數字。

收到JSON數字時，會以兩種格式之一儲存。如果數字符合 64 位元的已簽署整數，則會將其轉換為該格式；否則，它會儲存為字串。兩個JSON數字 （例如 JSON和NUMINCRBY JSONNUMMULTBY） 的算術操作會嘗試盡可能保持精確度。如果兩個運算元和產生的值符合 64 位元已簽署整數，則會執行整數算術。否則，輸入運算元會轉換為 64 位元IEEE雙精度浮點數、執行算術操作，並將結果轉換回字串。

算術命令 NUMINCRBY 和 NUMMULTBY：

如需可用命令的詳細清單，請參閱支援的命令。

嚴格語法評估

即使JSON路徑子集包含有效的路徑，MemoryDB 不允許具有無效語法的路徑。這是為了我們的客戶保持正確行為。