yiguolei commented on code in PR #4001:
URL: https://github.com/apache/doris-website/pull/4001#discussion_r3619332415
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/variant-functions/parse-to-variant.md:
##########
@@ -0,0 +1,87 @@
+---
+{
+ "title": "PARSE_TO_VARIANT",
+ "language": "zh-CN",
+ "description": "将 JSON 文本解析为 VARIANT 值。"
+}
+---
+
+## 功能
+
+`PARSE_TO_VARIANT` 将 `VARCHAR` 表达式中的一个完整 JSON 值解析为 `VARIANT`。支持 JSON
对象、数组、字符串、数字、布尔值和 JSON 字面量 `null`。
+
+## 语法
+
+```sql
+PARSE_TO_VARIANT(json_text)
+```
+
+## 参数
+
+- `json_text`:包含一个完整 JSON 值的 `VARCHAR` 表达式。
+
+## 返回值
+
+- 返回 `VARIANT` 值。
+- 输入为 SQL `NULL` 时返回 SQL `NULL`。
+- 输入为 JSON `null` 时返回 Variant/JSON `null`,它与 SQL `NULL` 不同。
+
+## 实验性行为
+
+`ColumnVariantV2` 是实验性的、仅用于计算的执行路径,默认关闭。可以在当前 FE session 中执行以下语句开启:
+
+```sql
+SET enable_variant_v2 = true;
+```
+
+该 session variable 只改变表达式结果的执行类型,不改变表存储、读写器或 Compaction 使用的物理 `VARIANT` 类型。
+
+## 错误处理
+
+非法 JSON 会使 `PARSE_TO_VARIANT` 返回错误。如果希望将非法输入转换为 SQL `NULL`,请使用
[PARSE_TO_VARIANT_ERROR_TO_NULL](./parse-to-variant-error-to-null)。
+
+## 示例
+
+### 解析 JSON 值
+
+```sql
+SELECT PARSE_TO_VARIANT('{\"id\": 42, \"tags\": [\"doris\", \"sql\"]}');
+SELECT PARSE_TO_VARIANT('[10, 20, 30]');
+SELECT PARSE_TO_VARIANT('42');
+SELECT PARSE_TO_VARIANT('true');
+SELECT PARSE_TO_VARIANT('\"doris\"');
+SELECT PARSE_TO_VARIANT('null');
+```
+
+### 提取值并 CAST 为确定类型
Review Comment:
这里少一个cast的文档。
cast 文档中包括两部分:
1. cast to variant, 把其他类型cast 到variant
2. cast variant 到其他类型
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]