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

JSON 資料類型概觀

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

術語

支援的 JSON 標準

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

根元素

根元素可為任何 JSON 資料類型。請注意，在舊版 RFC 4627 中，只允許將物件或陣列當作根值。由於更新至 RFC 7159，JSON 文件的根可為任何 JSON 資料類型。

文件大小限制

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

JSON ACL

巢狀深度限制

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 和 JSON.NUMMULTBY) 的算術操作會嘗試盡可能保持精確度。如果兩個運算元和產生的值符合 64 位元帶正負號的整數，則會執行整數算術。否則，輸入運算元會轉換為 64 位元 IEEE 雙精度浮點數、執行算術操作，並將結果轉換回字串。

算術命令 NUMINCRBY 和 NUMMULTBY：

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

嚴格語法評估

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