本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

JSON数据类型概述

ElastiCache 支持许多用于处理JSON数据类型的 Valkey 和 Redis OSS 命令。以下是JSON数据类型的概述和支持的命令的详细列表。

术语

支持的JSON标准

JSON格式符合 RFC7159 和 ECMA-404 JSON 数据交换标准。UTF-8 支持JSON文本中的 Unicode。

根元素

根元素可以是任何JSON数据类型。请注意，在早期的 RFC 4627 中，只允许对象或数组作为根值。自更新到 RFC 7159 以来，JSON文档的根可以是任何JSON数据类型。

文档大小限制

JSON文档以一种经过优化的格式存储在内部，该格式经过优化，便于快速访问和修改。此格式通常会导致比同一文档的等效序列化表示使用稍多的内存。

单个JSON文档的内存消耗限制为 64 MB，这是内存中数据结构的大小，而不是JSON字符串的大小。您可以使用JSON.DEBUG MEMORY命令检查JSON文档消耗的内存量。

JSON ACLs

嵌套深度限制

当一个JSON对象或数组的元素本身就是另一个JSON对象或数组时，该内部对象或数组被称为 “嵌套” 在外部对象或数组中。最大嵌套深度上限为 128。任何创建包含嵌套深度大于 128 的文档的尝试都将被拒绝，并出现错误。

命令语法

大多数命令都要求将键名作为第一个参数。某些命令还带有一个路径参数。如果该路径参数是可选的且未提供，则默认为根目录。

表示法：

路径语法

Redis JSON 支持两种路径语法：

如果查询路径以“$”开头，则使用的是增强的语法。否则使用的是受限的语法。

增强的语法

示例

以下示例基于 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

如何 ElastiCache 与 Valkey 和 Redis 互动 OSS JSON

以下部分介绍如何 ElastiCache 使用 Valkey 和 Redis 与数据类型进行OSS交互。JSON

运算符优先顺序

当评估条件表达式以进行筛选时，&& 优先评估，然后评估 ||，这一点在大多数语言中很常见。首先运行括号内的运算符。

最大路径嵌套限制行为

ElastiCache (RedisOSS) 中的最大路径嵌套限制为 128。因此，像 $.a.b.c.d... 这样的值只能达到 128 个级别。

处理数字值

JSON没有单独的整数和浮点数数据类型。它们都被称为数字。

数字的表示形式：

当在输入时收到JSON数字时，它会被转换为两种内部二进制表示形式之一：64 位有符号整数或 64 位IEEE双精度浮点数。不保留原始字符串及其所有格式。因此，当一个数字作为JSON响应的一部分输出时，它会从内部的二进制表示形式转换为使用通用格式规则的可打印字符串。这些规则可能会导致生成的字符串与收到的字符串不同。

算术命令 NUMINCRBY 和 NUMMULTBY：

有关可用命令的详细列表，请参阅 支持的 Valkey 和 Redis 命令 OSS。

直接数组筛选

ElastiCache 使用 Valkey 或 Redis 可以直接OSS过滤数组对象。

对于像 [0,1,2,3,4,5,6] Valkey 或 Redis 这样的路径查询$[?(@<4)]，或者类似的数据{"my_key":[0,1,2,3,4,5,6]}和路径查询$.my_key[?(@<4)]， ElastiCache 在这两种情况下都OSS将返回 [1,2,3]。

数组索引行为

ElastiCache 使用 Valkey 或 Redis 时，数OSS组可以同时使用正索引和负索引。对于长度为 5 的数组，0 将查询第一个元素，1 将查询第二个元素，依此类推。负数从数组的末尾开始，因此 -1 将查询第五个元素，-2 将查询第四个元素，依此类推。

为了确保客户行为可预测， ElastiCache 使用 Valkey 或 Redis OSS 不会向下或向上舍入数组索引，因此，如果您有一个长度为 5 的数组，则调用索引 5 或更高、-6 或更低的索引，将不会产生结果。

严格语法评估

MemoryDB 不允许使用语法无效的JSON路径，即使路径的子集包含有效路径也是如此。这是为了维护我们客户的正确行为。