Re: [PR] Add FAQ for null value description in VARIANT and JSON type [doris-website]

[via GitHub]

morningman commented on code in PR #2396:
URL: https://github.com/apache/doris-website/pull/2396#discussion_r2096712924


##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-data-types/semi-structured/JSON.md:
##########
@@ -848,4 +848,28 @@ mysql> select id, j, json_type(j, '$.k1') from test_json 
order by id;
 
 ```
 
-
+### FAQ
+1. JSON类型中的null和SQL中的NULL(IS NULL)有区别吗
+
+是的，JSON中的null例如`{"key1" : nulll}`表示`key1`这个JSON键存在，并且值为null(作为一个特殊类型会被编码到JSON 
binary中)，而SQL中的NULL是指没有这个JSON键。例如

Review Comment:
   `{"key1" : null}`
   Same error for all other docs



##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/basic-element/sql-data-types/semi-structured/VARIANT.md:
##########
@@ -461,8 +461,12 @@ SELECT * FROM example_table WHERE data_string LIKE 
'%doris%';
 
 ### FAQ
 1. Stream Load 报错： [CANCELLED][INTERNAL_ERROR]tablet error: 
[DATA_QUALITY_ERROR]Reached max column size limit 2048。
+
 由于 Compaction 和元信息存储限制，VARIANT 类型会限制列数，默认 2048 列，可以适当调整 BE 配置 
`variant_max_merged_tablet_schema_size` ，但是不建议超过 4096
 
+2. VARIANT 类型中的 null（例如 `{"key": null}` ）和 SQL 中的 NULL（即 IS NULL）有区别吗？ 
+
+没有区别，在 VARIANT 类型中，它们被视为等价的。

Review Comment:
   
   
![image](https://github.com/user-attachments/assets/05d98c92-9fab-4f49-b837-ec63a369f2a0)
   



##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/basic-element/sql-data-types/semi-structured/VARIANT.md:
##########
@@ -461,8 +461,12 @@ SELECT * FROM example_table WHERE data_string LIKE 
'%doris%';
 
 ### FAQ
 1. Stream Load 报错： [CANCELLED][INTERNAL_ERROR]tablet error: 
[DATA_QUALITY_ERROR]Reached max column size limit 2048。
+
 由于 Compaction 和元信息存储限制，VARIANT 类型会限制列数，默认 2048 列，可以适当调整 BE 配置 
`variant_max_merged_tablet_schema_size` ，但是不建议超过 4096
 
+2. VARIANT 类型中的 null（例如 `{"key": null}` ）和 SQL 中的 NULL（即 IS NULL）有区别吗？ 
+
+没有区别，在 VARIANT 类型中，它们被视为等价的。

Review Comment:
   4 spaces intend



##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-data-types/semi-structured/JSON.md:
##########
@@ -848,4 +848,28 @@ mysql> select id, j, json_type(j, '$.k1') from test_json 
order by id;
 
 ```
 
-
+### FAQ
+1. JSON类型中的null和SQL中的NULL(IS NULL)有区别吗
+
+是的，JSON中的null例如`{"key1" : nulll}`表示`key1`这个JSON键存在，并且值为null(作为一个特殊类型会被编码到JSON 
binary中)，而SQL中的NULL是指没有这个JSON键。例如

Review Comment:
   leave space before and after english word. You can `AutoCorrect` in vscode 
to do it



-- 
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: commits-unsubscr...@doris.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org