eldenmoon commented on code in PR #4170:
URL: https://github.com/apache/doris-website/pull/4170#discussion_r4079850946
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/complex-types/variant.md:
##########
@@ -28,18 +28,29 @@
| 你的需求 | 建议阅读 |
| --- | --- |
| 快速完成 CSV / JSON 导入 | 继续阅读本文 |
-| 选择默认模式、Sparse、DOC mode 或 Schema Template | [VARIANT
使用与配置指南](../../../sql-manual/basic-element/sql-data-types/semi-structured/variant-workload-guide)
|
-| 查询 VARIANT 语法、索引、限制或配置参考 |
[VARIANT](../../../sql-manual/basic-element/sql-data-types/semi-structured/VARIANT)
|
+| 选择默认模式、Sparse、DOC mode 或 Schema Template | [VARIANT
使用与配置指南](../../../sql-manual/basic-element/sql-data-types/semi-structured/variant-workload-guide.md)
|
+| 查询 VARIANT 语法、索引、限制或配置参考 |
[VARIANT](../../../sql-manual/basic-element/sql-data-types/semi-structured/VARIANT.md)
|
## 使用限制
-- 当前仅支持 **CSV** 和 **JSON** 两种数据格式导入 `VARIANT` 列。
+- 下文示例导入的是 **CSV** 和 **JSON** 文件。导入作业会把写入 `VARIANT` 列的任何字符串字段按 JSON
解析，因此只要源列是字符串（例如 Parquet 的 `STRING` 列），其他格式也同样适用。Arrow 格式不能导入 `VARIANT` 列。
+
+## 导入时值如何转换
+
+- **CSV 格式：** `VARIANT` 字段的文本按 JSON 解析。`\N` 导入为 SQL `NULL`。非法 JSON 文本导入为
VARIANT 字符串。
+- **JSON 格式：** 字段对应的 JSON 值按原样导入。如果该值是 JSON 字符串，其内容会再按 JSON 文本解析一次，因此 `"123"`
导入为数值 `123`，`"true"` 导入为布尔值 `true`。顶层的 JSON 布尔值导入为数值 `1` 或 `0`。JSON `null`
或缺失的字段导入为 SQL `NULL`。
+- **超范围的数值：** 包含超出 [-2^63, 2^64 - 1] 的整数或超出 `DOUBLE` 范围的数值的文档无法解析，整个文档会作为一个
VARIANT 字符串导入。
+- **`NOT NULL` 列：** VARIANT 值为 SQL `NULL` 的行会被过滤，包括解析失败而得到 SQL `NULL`
的值。被过滤的行计入 `max_filter_ratio`（默认 `0`），因此默认情况下导入作业会失败。
+- **INSERT 的行为不同：** `INSERT` 不解析字符串。`INSERT INTO t VALUES (1, '{"a": 1}')`
写入的是 VARIANT 字符串 `{"a": 1}`，从 `s3()`、`hdfs()`、`local()` 执行 `INSERT INTO ...
SELECT` 也是如此。需要写入对象时请使用 `PARSE_TO_VARIANT`。
+- **存储会规范化值：** 值为 `null` 的对象成员，以及值为空对象或空数组的成员，在写入时可能被移除。
Review Comment:
存储会规范化值 加个简单的 demo
--
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]
