docs: json related functions

docs/reference/sql/functions/overview.md

@@ -247,4 +247,64 @@ select database();
 
 ### Admin Functions
 
-GreptimeDB provides `ADMIN` statement to run the administration functions, please refer to [ADMIN](.(/reference/sql/admin.md) reference.
+GreptimeDB provides `ADMIN` statement to run the administration functions, please refer to [ADMIN](.(/reference/sql/admin.md) reference.
+
+### JSON Functions
+
+GreptimeDB provides the following JSON functions to deal with values of JSON type:
+
+* `parse_json(string)` to parse a JSON string into a JSON value. Illegal JSON strings will return an error.
+* `json_to_string(json)` to convert a JSON value to a string.
+
+```sql
+SELECT json_to_string(parse_json('{"a": 1, "b": 2}'));
+
++----------------------------------------------------------+
+| json_to_string(parse_json(Utf8("{\"a\": 1, \"b\": 2}"))) |
++----------------------------------------------------------+
+| {"a":1,"b":2}                                            |
++----------------------------------------------------------+
+```
+
+* `json_get_bool(json, path)` to extract a boolean value from a JSON value by the path.
+* `json_get_int(json, path)` to extract an integer value from a JSON value by the path, while boolean values will be converted to integers.
+* `json_get_float(json, path)` to extract a float value from a JSON value by the path, while integer and boolean values will be converted to floats.
+* `json_get_string(json, path)` to extract a string value from a JSON value by the path. All valid JSON values will be converted to strings, including null values, objects and arrays.
+
+`path` is a string that select and extract elements from a json value. Checkout [SQL/JSONPath](https://github.com/datafuselabs/jsonb?tab=readme-ov-file#sqljsonpath) for supported `path` syntax.
+
+```sql
+SELECT json_get_int(parse_json('{"a": {"c": 3}, "b": 2}'), 'a.c');
+
++-----------------------------------------------------------------------+
+| json_get_int(parse_json(Utf8("{"a": {"c": 3}, "b": 2}")),Utf8("a.c")) |
++-----------------------------------------------------------------------+
+|                                                                     3 |
++-----------------------------------------------------------------------+
+```
+
+* `json_is_null(json)` to check whether a JSON value is a null value.
+* `json_is_bool(json)` to check whether a JSON value is a boolean value.
+* `json_is_int(json)` to check whether a JSON value is an integer value.
+* `json_is_float(json)` to check whether a JSON value is a float value.
+* `json_is_string(json)` to check whether a JSON value is a string value.
+* `json_is_object(json)` to check whether a JSON value is an object value.
+* `json_is_array(json)` to check whether a JSON value is an array value.
+
+```sql
+SELECT json_is_array(parse_json('[1, 2, 3]'));
+
++----------------------------------------------+
+| json_is_array(parse_json(Utf8("[1, 2, 3]"))) |
++----------------------------------------------+
+|                                            1 |
++----------------------------------------------+
+
+SELECT json_is_object(parse_json('1'));
+
++---------------------------------------+
+| json_is_object(parse_json(Utf8("1"))) |
++---------------------------------------+
+|                                     0 |
++---------------------------------------+
+```

i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/functions/overview.md

@@ -240,4 +240,64 @@ select database();
 
 ### 管理函数
 
-GreptimeDB 提供了 `ADMIN` 语句来执行管理函数，请阅读 [ADMIN](/reference/sql/admin.md) 文档。
+GreptimeDB 提供了 `ADMIN` 语句来执行管理函数，请阅读 [ADMIN](/reference/sql/admin.md) 文档。
+
+### JSON 函数
+
+GreptimeDB 提供了以下 JSON 相关函数来处理 JSON 类型的数据：
+
+* `parse_json(string)` 尝试将字符串解析为 JSON 类型。非法的 JSON 字符串将返回错误。
+* `json_to_string(json)` 将 JSON 类型的值转换为字符串。
+
+```sql
+SELECT json_to_string(parse_json('{"a": 1, "b": 2}'));
+
++----------------------------------------------------------+
+| json_to_string(parse_json(Utf8("{\"a\": 1, \"b\": 2}"))) |
++----------------------------------------------------------+
+| {"a":1,"b":2}                                            |
++----------------------------------------------------------+
+```
+
+* `json_get_bool(json, path)` 按照路径 `path` 从 JSON 中获取布尔值。
+* `json_get_int(json, path)` 按照路径 `path` 从 JSON 中获取整数值。布尔值将被转换为整数。
+* `json_get_float(json, path)` 按照路径 `path` 从 JSON 中获取浮点数值。布尔值、整数值将被转换为浮点数。
+* `json_get_string(json, path)` 按照路径 `path` 从 JSON 中获取字符串。所有类型的 JSON 值都将被转换为字符串，包括数组、对象和 null。
+
+`path` 是一个用于从 JSON 值中选择和提取元素的字符串。查看 [SQL/JSONPath](https://github.com/datafuselabs/jsonb?tab=readme-ov-file#sqljsonpath) 以了解支持的 `path` 语法。
+
+```sql
+SELECT json_get_int(parse_json('{"a": {"c": 3}, "b": 2}'), 'a.c');
+
++-----------------------------------------------------------------------+
+| json_get_int(parse_json(Utf8("{"a": {"c": 3}, "b": 2}")),Utf8("a.c")) |
++-----------------------------------------------------------------------+
+|                                                                     3 |
++-----------------------------------------------------------------------+
+```
+
+* `json_is_null(json)` 检查 JSON 中的值是否为 `NULL`。
+* `json_is_bool(json)` 检查 JSON 中的值是否为布尔值。
+* `json_is_int(json)` 检查 JSON 中的值是否为整数。
+* `json_is_float(json)` 检查 JSON 中的值是否为浮点数。
+* `json_is_string(json)` 检查 JSON 中的值是否为字符串。
+* `json_is_array(json)` 检查 JSON 中的值是否为数组。
+* `json_is_object(json)` 检查 JSON 中的值是否为对象。
+
+```sql
+SELECT json_is_array(parse_json('[1, 2, 3]'));
+
++----------------------------------------------+
+| json_is_array(parse_json(Utf8("[1, 2, 3]"))) |
++----------------------------------------------+
+|                                            1 |
++----------------------------------------------+
+
+SELECT json_is_object(parse_json('1'));
+
++---------------------------------------+
+| json_is_object(parse_json(Utf8("1"))) |
++---------------------------------------+
+|                                     0 |
++---------------------------------------+
+```