Json_keys

Description

Syntax

ARRAY<STRING> json_keys(JSON, [VARCHAR path])

JSON_KEYS() 函数用于从 JSON 对象的顶级值中返回键。这些键作为数组返回，或者如果给定了路径参数，则返回所选路径的顶级键。您需要将 JSON 文档作为函数的参数提供。您还可以（可选地）提供第二个参数，以指定 JSON 文档中“顶级”路径从何处开始。 其中，json_doc 是 JSON 文档，path 是一个可选参数，用于确定 JSON 文档中“顶级”路径从何处开始。

注意:

如果所选对象为空，则结果数组为空。如果顶级值包含嵌套的子对象，返回值不包括这些子对象的键。

Example

  2. mysql> SELECT JSON_KEYS('{"a": 1, "b": {"c": 30}}');
  3. +-----------------------------------------------------+
  4. | json_keys(cast('{"a": 1, "b": {"c": 30}}' as JSON)) |
  5. +-----------------------------------------------------+
  6. | ["a", "b"]                                          |
  7. +-----------------------------------------------------+
  8. 1 row in set (0.35 sec)
  10. mysql> SELECT JSON_KEYS('{"a": 1, "b": {"c": 30}}', '$.b');
  11. +------------------------------------------------------------+
  12. | json_keys(cast('{"a": 1, "b": {"c": 30}}' as JSON), '$.b') |
  13. +------------------------------------------------------------+
  14. | ["c"]                                                      |
  15. +------------------------------------------------------------+
  16. 1 row in set (0.07 sec)
  18. mysql> SELECT JSON_KEYS('{}');
  19. +-------------------------------+
  20. | json_keys(cast('{}' as JSON)) |
  21. +-------------------------------+
  22. | []                            |
  23. +-------------------------------+
  24. 1 row in set (0.07 sec)
  26. mysql> SELECT JSON_KEYS('[1,2]');
  27. +----------------------------------+
  28. | json_keys(cast('[1,2]' as JSON)) |
  29. +----------------------------------+
  30. | NULL                             |
  31. +----------------------------------+
  32. 1 row in set (0.07 sec)
  34. mysql> SELECT JSON_KEYS('[]');
  35. +-------------------------------+
  36. | json_keys(cast('[]' as JSON)) |
  37. +-------------------------------+
  38. | NULL                          |
  39. +-------------------------------+
  40. 1 row in set (0.07 sec)

Keywords

json,json_keys