💬Generate LLM translations (#2093)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

docs/cn/guides/55-performance/01-virtual-column.md

@@ -7,34 +7,50 @@ import EEFeature from '@site/src/components/EEFeature';
 
 <EEFeature featureName='VIRTUAL COLUMN'/>
 
-Virtual Column 是一种结构，通过提取 [Variant](/sql/sql-reference/data-types/variant) 数据中的嵌套字段，并将这些数据存储在单独的存储文件中来形成。当您定期查询 Variant 数据中的特定嵌套字段时，请考虑使用 Virtual Column，以实现以下优势：
+# Databend 中的虚拟列：加速半结构化数据的查询
 
-- **加速查询处理**: Virtual Column 通过消除遍历整个嵌套结构以定位所需数据的需求，从而简化了查询过程。从 Virtual Column 直接检索数据与访问常规列的过程类似，从而显著加速了查询执行。
+Databend 中的虚拟列提供了一种强大而自动的方式，可以显著加速对半结构化数据的查询，尤其是存储在 [Variant](/sql/sql-reference/data-types/variant) 数据类型中的数据。此功能动态优化数据访问，从而加快查询执行速度并减少资源消耗。
 
-- **减少内存使用**: Variant 数据通常包含许多内部字段，读取所有这些字段可能会导致大量内存消耗。通过转换为读取 Virtual Column，可以显著减少内存使用，从而降低潜在的内存溢出风险。
+## 概述
+
+当处理 `VARIANT` 列中的嵌套数据结构时，访问特定数据点可能会成为性能瓶颈。Databend 的虚拟列通过自动识别和优化嵌套字段来解决此问题。虚拟列可以直接检索数据，类似于访问常规列，而无需重复遍历整个嵌套结构。
+
+Databend 在数据提取期间自动检测 `VARIANT` 列中的嵌套字段。如果某个字段满足一定的存在阈值，它将在后台物化为虚拟列，确保数据随时可用于优化查询。此过程是完全自动的，无需手动配置或干预。
 
 ![Alt text](/img/sql/virtual-column.png)
 
-## 管理 Virtual Column
+## 性能优势
+
+*   **显著的查询加速：** 虚拟列通过直接访问嵌套字段，显著减少了查询执行时间。这消除了为每个查询遍历复杂 JSON 结构的开销。
+*   **降低资源消耗：** 通过仅物化必要的嵌套字段，虚拟列最大限度地减少了查询处理期间的内存消耗。这提高了资源利用率，并改善了整体系统性能。
+*   **自动优化：** Databend 自动识别字段并将其物化为虚拟列。然后，查询优化器会自动重写查询，以便在访问 `VARIANT` 列中的数据时利用这些虚拟列。
+*   **透明操作：** 虚拟列的创建和管理对用户完全透明。查询会自动优化，而无需更改查询语法或数据加载过程。查询优化器负责重写查询以利用虚拟列。
+
+## 工作原理
 
-Databend 提供了各种命令来管理 Virtual Column。有关详细信息，请参见 [VIRTUAL COLUMN](/sql/sql-reference/data-types/variant/)。
+1.  **数据提取：** 提取包含 `VARIANT` 列的数据时，Databend 会分析 JSON 数据的结构。
+2.  **字段存在检查：** Databend 检查嵌套字段是否满足一定的存在阈值。
+3.  **虚拟列物化：** 如果满足字段存在阈值，系统会自动在后台将该字段物化为虚拟列。
+4.  **查询优化：** 当查询访问 `VARIANT` 列中的嵌套字段时，查询优化器会自动重写查询，以使用相应的虚拟列来更快地检索数据。
+
+## 重要注意事项
+
+*   **开销：** 虽然虚拟列通常可以提高查询性能，但它们确实会引入一些存储和维护开销。Databend 会自动平衡虚拟列的优势与此开销，以确保最佳性能。
+*   **实验性功能：** 虚拟列目前是一项实验性功能。默认情况下处于禁用状态。要启用虚拟列，必须将 `enable_experimental_virtual_column` 设置为 `1`：
+*   **自动刷新：** 插入数据后，虚拟列将自动刷新。如果您不想自动生成虚拟列数据，可以将 `enable_refresh_virtual_column_after_write` 设置为 `0` 以禁用虚拟列的生成。可以使用 refresh virtual column 命令完成异步刷新。有关详细信息，请参见 [REFRESH VIRTUAL COLUMN](/sql/sql-commands/ddl/virtual-column/refresh-virtual-column)。
+*   **显示虚拟列：** 您可以通过 [SHOW VIRTUAL COLUMNS](/sql/sql-commands/ddl/virtual-column/show-virtual-columns) 命令查看有关虚拟列的信息，并且可以通过 [FUSE_VIRTUAL_COLUMN](/sql/sql-functions/system-functions/fuse_virtual_column) 系统函数查看有关虚拟列元数据的信息。
 
 ## 使用示例
 
-此示例演示了 Virtual Column 的实际使用及其对查询执行的影响：
+此示例演示了虚拟列的实际使用及其对查询执行的影响：
 
 ```sql
--- 创建一个名为 'test' 的表，其中包含类型为 Variant 的列 'id' 和 'val'。
-CREATE TABLE test(id int, val variant);
+SET enable_experimental_virtual_column=1;
 
--- 为 'val' 列中的特定元素创建 Virtual Column。
-CREATE VIRTUAL COLUMN (
-  val ['name'],                 -- 提取 'name' 字段。
-  val ['tags'] [0],             -- 提取 'tags' 数组中的第一个元素。
-  val ['pricings'] [0] ['type'] -- 提取 'pricings' 数组中第一个 pricing 的 'type' 字段。
-) FOR test;
+-- Create a table named 'test' with columns 'id' and 'val' of type Variant.
+CREATE TABLE test(id int, val variant);
 
--- 将示例记录与 Variant 数据插入到 'test' 表中。
+-- Insert sample records into the 'test' table with Variant data.
 INSERT INTO
   test
 VALUES
@@ -65,10 +81,9 @@ INSERT INTO test SELECT * FROM test;
 INSERT INTO test SELECT * FROM test;
 INSERT INTO test SELECT * FROM test;
 
--- 刷新 Virtual Column
-REFRESH VIRTUAL COLUMN FOR test;
+-- Show the virtual columns
 
--- 解释用于从表中选择特定字段的查询执行计划。
+-- Explain the query execution plan for selecting specific fields from the table.
 EXPLAIN
 SELECT
   val ['name'],
@@ -79,21 +94,21 @@ FROM
 
 -[ EXPLAIN ]-----------------------------------
 Exchange
-├── output columns: [test.val['name'] (#2), test.val['tags'][0] (#3), test.val['pricings'][0]['type'] (#4)]
+├── output columns: [test.val['name'] (#3), test.val['pricings'][0]['type'] (#5), test.val['tags'][0] (#8)]
 ├── exchange type: Merge
 └── TableScan
-    ├── table: default.book_db.test
-    ├── output columns: [val['name'] (#2), val['tags'][0] (#3), val['pricings'][0]['type'] (#4)]
+    ├── table: default.default.test
+    ├── output columns: [val['name'] (#3), val['pricings'][0]['type'] (#5), val['tags'][0] (#8)]
     ├── read rows: 160
-    ├── read size: 4.96 KiB
-    ├── partitions total: 16
-    ├── partitions scanned: 16
-    ├── pruning stats: [segments: <range pruning: 6 to 6>, blocks: <range pruning: 16 to 16>]
+    ├── read size: 1.69 KiB
+    ├── partitions total: 6
+    ├── partitions scanned: 6
+    ├── pruning stats: [segments: <range pruning: 6 to 6>, blocks: <range pruning: 6 to 6>]
     ├── push downs: [filters: [], limit: NONE]
     ├── virtual columns: [val['name'], val['pricings'][0]['type'], val['tags'][0]]
     └── estimated rows: 160.00
 
--- 解释用于仅从表中选择 'name' 字段的查询执行计划。
+-- Explain the query execution plan for selecting only the 'name' field from the table.
 EXPLAIN
 SELECT
   val ['name']
@@ -108,23 +123,28 @@ Exchange
     ├── table: default.book_db.test
     ├── output columns: [val['name'] (#2)]
     ├── read rows: 160
-    ├── read size: 1.70 KiB
+    ├── read size: < 1 KiB
     ├── partitions total: 16
     ├── partitions scanned: 16
     ├── pruning stats: [segments: <range pruning: 6 to 6>, blocks: <range pruning: 16 to 16>]
     ├── push downs: [filters: [], limit: NONE]
     ├── virtual columns: [val['name']]
     └── estimated rows: 160.00
 
--- 显示系统中定义的所有 Virtual Column。
-SHOW VIRTUAL COLUMNS;
-
-┌─────────────────────────────────────────────────────────────────────────────┐
-│ database │  table │                     virtual_columns                     │
-├──────────┼────────┼─────────────────────────────────────────────────────────┤
-│ default  │ test   │ val['name'], val['pricings'][0]['type'], val['tags'][0] │
-└─────────────────────────────────────────────────────────────────────────────┘
-
--- 删除与 'test' 表关联的 Virtual Column。
-DROP VIRTUAL COLUMN FOR test;
+-- Display all the auto generated virtual columns.
+SHOW VIRTUAL COLUMNS WHERE table='test';
+
+╭────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ database │  table │ source_column │ virtual_column_id │    virtual_column_name   │ virtual_column_type │
+│  String  │ String │     String    │       UInt32      │          String          │        String       │
+├──────────┼────────┼───────────────┼───────────────────┼──────────────────────────┼─────────────────────┤
+│ default  │ test   │ val           │        3000000000 │ ['id']                   │ UInt64              │
+│ default  │ test   │ val           │        3000000001 │ ['name']                 │ String              │
+│ default  │ test   │ val           │        3000000002 │ ['pricings'][0]['price'] │ String              │
+│ default  │ test   │ val           │        3000000003 │ ['pricings'][0]['type']  │ String              │
+│ default  │ test   │ val           │        3000000004 │ ['pricings'][1]['price'] │ String              │
+│ default  │ test   │ val           │        3000000005 │ ['pricings'][1]['type']  │ String              │
+│ default  │ test   │ val           │        3000000006 │ ['tags'][0]              │ String              │
+│ default  │ test   │ val           │        3000000007 │ ['tags'][1]              │ String              │
+╰────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```

docs/cn/sql-reference/00-sql-reference/31-system-tables/system-virtual-columns.md

@@ -11,11 +11,15 @@ import FunctionDescription from '@site/src/components/FunctionDescription';
 另请参阅：[SHOW VIRTUAL COLUMNS](../../10-sql-commands/00-ddl/07-virtual-column/show-virtual-columns.md)
 
 ```sql
+SET enable_experimental_virtual_column=1;
+
 SELECT * FROM system.virtual_columns;
 
-┌───────────────────────────────────────────────────────────────────────────────────────────────┐
-│ database │  table │ virtual_columns │         created_on         │         updated_on         │
-├──────────┼────────┼─────────────────┼────────────────────────────┼────────────────────────────┤
-│ default  │ test   │ val['name']     │ 2023-12-25 21:24:26.127790 │ 2023-12-25 21:24:38.455268 │
-└───────────────────────────────────────────────────────────────────────────────────────────────┘
+╭───────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ database │  table │ source_column │ virtual_column_id │ virtual_column_name │ virtual_column_type │
+│  String  │ String │     String    │       UInt32      │        String       │        String       │
+├──────────┼────────┼───────────────┼───────────────────┼─────────────────────┼─────────────────────┤
+│ default  │ test   │ val           │        3000000000 │ ['id']              │ UInt64              │
+│ default  │ test   │ val           │        3000000001 │ ['name']            │ String              │
+╰───────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```

docs/cn/sql-reference/10-sql-commands/00-ddl/07-virtual-column/refresh-virtual-column.md

@@ -11,11 +11,12 @@ import EEFeature from '@site/src/components/EEFeature';
 
 <EEFeature featureName='VIRTUAL COLUMN'/>
 
-刷新表的 virtual columns。在以下情况下，virtual columns 需要刷新：
+Databend 中的 `REFRESH VIRTUAL COLUMN` 命令用于显式触发现有表的 virtual column 的创建。虽然 Databend 会自动管理新数据的 virtual column，但在某些特定情况下，需要手动刷新才能充分利用此功能。
 
-- 在为已包含 Variant 数据的表创建 virtual columns 后，需要刷新 virtual columns。
-- 修改表的 virtual columns 时，在修改后刷新它们。
-- 如果 `enable_refresh_virtual_column_after_write` 设置为 1（默认），则在数据更新后会自动刷新表的 virtual columns。但是，如果未启用此设置，则需要手动刷新 virtual columns。
+## 何时使用 `REFRESH VIRTUAL COLUMN`
+
+- **在启用功能之前已存在的表：** 如果你的表包含在启用 virtual column 功能*之前*（或在升级到具有自动 virtual column 创建的版本之前）创建的 `VARIANT` 数据，则需要刷新 virtual column 以启用查询加速。Databend 不会自动为这些表中已存在的数据创建 virtual column。
+- **禁用写入时自动刷新：** 如果在数据摄取期间将 `enable_refresh_virtual_column_after_write` 设置为 `0`（禁用），则 Databend 将*不会*在写入数据时自动创建 virtual column。在这种情况下，如果希望从性能改进中受益，则必须在加载数据后手动刷新 virtual column。
 
 ## 语法
 
@@ -25,8 +26,35 @@ REFRESH VIRTUAL COLUMN FOR <table>
 
 ## 示例
 
-此示例刷新名为“test”的表的 virtual columns：
+此示例刷新名为“test”的表的 virtual column：
 
 ```sql
+SET enable_experimental_virtual_column=1;
+
+SET enable_refresh_virtual_column_after_write=0;
+
+CREATE TABLE test(id int, val variant);
+
+INSERT INTO
+  test
+VALUES
+  (
+    1,
+    '{"id":1,"name":"databend"}'
+  ),
+  (
+    2,
+    '{"id":2,"name":"databricks"}'
+  );
+
 REFRESH VIRTUAL COLUMN FOR test;
+
+SHOW VIRTUAL COLUMNS WHERE table = 'test';
+╭───────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ database │  table │ source_column │ virtual_column_id │ virtual_column_name │ virtual_column_type │
+│  String  │ String │     String    │       UInt32      │        String       │        String       │
+├──────────┼────────┼───────────────┼───────────────────┼─────────────────────┼─────────────────────┤
+│ default  │ test   │ val           │        3000000000 │ ['id']              │ UInt64              │
+│ default  │ test   │ val           │        3000000001 │ ['name']            │ String              │
+╰───────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```