eldenmoon commented on code in PR #3253:
URL: https://github.com/apache/doris-website/pull/3253#discussion_r2660171418
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/basic-element/sql-data-types/semi-structured/VARIANT.md:
##########
@@ -428,16 +452,40 @@ CREATE TABLE example_table (
'path_2' : STRING,
properties(
'variant_max_subcolumns_count' = '2048',
- 'variant_enable_typed_paths_to_sparse' = 'true'
+ 'variant_enable_typed_paths_to_sparse' = 'true',
+ 'variant_sparse_hash_shard_count' = '64'
)
>
);
```
<table>
-<tr><td>属性<br/></td><td>描述<br/></td></tr>
+<tr><td>稀疏列属性<br/></td><td>描述<br/></td></tr>
<tr><td>`variant_max_subcolumns_count`<br/></td><td>控制 Path
物化列数的上限；超过后新增路径可能存放于共享数据结构。默认 0 表示不限，建议设置为 2048；不推荐超过 10000。<br/></td></tr>
<tr><td>`variant_enable_typed_paths_to_sparse`<br/></td><td>默认指定了 Path 类型后，该
Path 一定会被提取（不计入 `variant_max_subcolumns_count`）。设置为 `true`
后也会计入阈值，可能被收敛到共享结构。<br/></td></tr>
+<tr><td>`variant_sparse_hash_shard_count`<br/></td><td>控制稀疏列的分片数量。将稀疏子列分散存储到多个稀疏列中，以以提升查询性能。默认值为
1，建议根据稀疏子列数量适当调整。<br/></td></tr>
+</table>
+
+```sql
+CREATE TABLE example_table (
+ id INT,
+ data_variant VARIANT<
+ 'path_1' : INT,
+ 'path_2' : STRING,
+ properties(
+ 'variant_enable_doc_mode' = 'true',
+ 'variant_doc_materialization_min_rows' = '10000',
+ 'variant_doc_hash_shard_count' = '64'
+ )
+ >
+);
+```
+
+<table>
+<tr><td>DOC 编码属性<br/></td><td>描述<br/></td></tr>
+<tr><td>`variant_enable_doc_mode`<br/></td><td>是否启用 DOC 编码模式。设置为 `true` 时，原始
JSON 会作为存储字段保存，用于快速返回整个 JSON 文档。启用后将无法使用稀疏列机制。默认值为 `false`。<br/></td></tr>
+<tr><td>`variant_doc_materialization_min_rows`<br/></td><td>DOC
编码模式下触发子列物化的最小行数阈值。当写入行数低于该值时，仅存储原始
JSON；当文件合并后行数达到该阈值时，才将子列物化为独立子列。用于减少小批量写入时的开销。<br/></td></tr>
+<tr><td>`variant_doc_hash_shard_count`<br/></td><td>控制 DOC 编码的分片数量。原始 JSON
会被拆散存储到指定数量的列中，查询整个 JSON 时再组装这些分片。默认值为 64，可根据 JSON 大小和并发需求调整。<br/></td></tr>
Review Comment:
可以参考下ck怎么描述的
--
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]
