💬Generate LLM translations (#1657)

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

Author: github-actions[bot]

docs/cn/sql-reference/10-sql-commands/00-ddl/01-table/92-attach-table.md

@@ -5,26 +5,31 @@ sidebar_position: 6
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="引入或更新于：v1.2.549"/>
+<FunctionDescription description="引入或更新版本：v1.2.698"/>
 
 import EEFeature from '@site/src/components/EEFeature';
 
 <EEFeature featureName='ATTACH TABLE'/>
 
 将现有表附加到另一个表。该命令将表的数据和模式从一个数据库移动到另一个数据库，但实际上并不复制数据。相反，它创建一个指向原始表数据的链接以访问数据。
 
-Attach Table 使您能够无缝地将云服务平台中的表连接到私有部署环境中已存在的表，而无需物理移动数据。这在您希望将数据从私有部署的 Databend 迁移到 [Databend Cloud](https://www.databend.com) 时特别有用，同时最大限度地减少数据传输开销。
+- Attach Table 使您能够无缝地将云服务平台中的表连接到私有化部署环境中现有的表，而无需物理移动数据。这在您希望将数据从 Databend 的私有化部署迁移到 [Databend Cloud](https://www.databend.com) 同时最小化数据传输开销时特别有用。
 
-附加的表以 READ_ONLY 模式运行。在此模式下，源表中的更改会立即反映在附加表中。然而，附加表仅用于查询目的，不支持更新。这意味着在附加表上不允许执行 INSERT、UPDATE 和 DELETE 操作；只能执行 SELECT 查询。
+- 附加的表以 READ_ONLY 模式运行。在此模式下，源表中的更改会立即反映在附加的表中。然而，附加的表仅用于查询目的，不支持更新。这意味着在附加的表上不允许执行 INSERT、UPDATE 和 DELETE 操作；只能执行 SELECT 查询。
 
 ## 语法
 
 ```sql
-ATTACH TABLE <target_table_name> '<source_table_data_URI>'
-CONNECTION = ( <connection_parameters> )
+ATTACH TABLE <目标表名> [ ( <列列表> ) ] '<源表数据_URI>'
+CONNECTION = ( <连接参数> )
 ```
+- `<列列表>`: 一个可选的、逗号分隔的列列表，用于包含源表中的列，允许用户指定仅需要的列，而不是包含所有列。如果未指定，将包含源表中的所有列。
 
-- `<source_table_data_URI>` 表示源表数据的路径。对于类似 S3 的对象存储，格式为 `s3://<bucket-name>/<database_ID>/<table_ID>`，例如 _s3://databend-toronto/1/23351/_，它表示存储桶中表文件夹的确切路径。
+  - 在源表中重命名包含的列会更新其在附加表中的名称，并且必须使用新名称访问它。
+  - 在源表中删除包含的列会使其在附加表中无法访问。
+  - 对未包含的列的更改，例如在源表中重命名或删除它们，不会影响附加表。
+
+- `<源表数据_URI>` 表示源表数据的路径。对于 S3 类似的对象存储，格式为 `s3://<bucket-name>/<database_ID>/<table_ID>`，例如 _s3://databend-toronto/1/23351/_，它表示桶内表文件夹的确切路径。
 
   ![Alt text](/img/sql/attach.png)
 
@@ -48,91 +53,30 @@ CONNECTION = ( <connection_parameters> )
   timestamp           |2023-07-11 05:38:27.0                              |
   ```
 
-- `CONNECTION` 指定建立与存储源表数据的对象存储链接所需的连接参数。不同存储服务的连接参数根据其特定要求和认证机制而有所不同。有关更多信息，请参见 [连接参数](../../../00-sql-reference/51-connect-parameters.md)。
+- `CONNECTION` 指定建立与存储源表数据的对象存储链接所需的连接参数。连接参数因不同存储服务的特定要求和认证机制而异。有关更多信息，请参见 [连接参数](../../../00-sql-reference/51-connect-parameters.md)。
 
-## 示例
+## 教程
 
-本示例展示了如何将 Databend Cloud 中的新表与 Databend 中的现有表链接，该表将数据存储在名为 "databend-toronto" 的 Amazon S3 存储桶中。
+- [使用 ATTACH TABLE 链接表](/tutorials/databend-cloud/link-tables)
 
-#### 步骤 1. 在 Databend 中创建表
+## 示例
 
-创建一个名为 "population" 的表并插入一些示例数据：
+此示例创建一个附加表，其中包含存储在 AWS S3 中的源表的所有列：
 
-```sql title='Databend:'
-CREATE TABLE population (
-  city VARCHAR(50),
-  population INT
+```sql
+ATTACH TABLE population_all_columns 's3://databend-doc/1/16/' CONNECTION = (
+  REGION='us-east-2',
+  AWS_KEY_ID = '<your_aws_key_id>',
+  AWS_SECRET_KEY = '<your_aws_secret_key>'
 );
-
-INSERT INTO population (city, population) VALUES
-  ('Toronto', 2731571),
-  ('Montreal', 1704694),
-  ('Vancouver', 631486);
 ```
 
-#### 步骤 2. 获取数据库 ID 和表 ID
-
-使用 [FUSE_SNAPSHOT](../../../20-sql-functions/16-system-functions/fuse_snapshot.md) 函数获取数据库 ID 和表 ID。以下结果表明数据库 ID 为 **1**，表 ID 为 **556**：
-
-```sql title='Databend:'
-SELECT * FROM FUSE_SNAPSHOT('default', 'population');
-
-┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│            snapshot_id           │                 snapshot_location                 │ format_version │ previous_snapshot_id │ segment_count │ block_count │ row_count │ bytes_uncompressed │ bytes_compressed │ index_size │          timestamp         │
-├──────────────────────────────────┼───────────────────────────────────────────────────┼────────────────┼──────────────────────┼───────────────┼─────────────┼───────────┼────────────────────┼──────────────────┼────────────┼────────────────────────────┤
-│ f252dd43d1aa44898a04827808342daf │ 1/556/_ss/f252dd43d1aa44898a04827808342daf_v4.mpk │              4 │ NULL                 │             1 │           1 │         3 │                 70 │              448 │        531 │ 2023-11-01 02:35:47.325319 │
-└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-```
-
-当您访问 Amazon S3 上的存储桶页面时，您会观察到数据被组织在路径 `databend-toronto` > `1` > `556` 中，如下所示：
-
-![Alt text](/img/sql/attach-table-2.png)
-
-#### 步骤 3. 在 Databend Cloud 中链接表
+此示例创建一个附加表，其中仅包含存储在 AWS S3 中的源表的选定列（`city` 和 `population`）：
 
-登录 Databend Cloud 并在工作表中运行以下命令以链接名为 "population_readonly" 的表：
-
-```sql title='Databend Cloud:'
-ATTACH TABLE population_readonly 's3://databend-toronto/1/556/' CONNECTION = (
+```sql
+ATTACH TABLE population_only (city, population) 's3://databend-doc/1/16/' CONNECTION = (
+  REGION='us-east-2',
   AWS_KEY_ID = '<your_aws_key_id>',
   AWS_SECRET_KEY = '<your_aws_secret_key>'
 );
-```
-
-要验证链接是否成功，请在 Databend Cloud 中运行以下查询：
-
-```sql title='Databend Cloud:'
-SELECT * FROM population_readonly;
-
--- 预期结果：
-┌────────────────────────────────────┐
-│       city       │    population   │
-├──────────────────┼─────────────────┤
-│ Toronto          │         2731571 │
-│ Montreal         │         1704694 │
-│ Vancouver        │          631486 │
-└────────────────────────────────────┘
-```
-
-一切就绪！如果您在 Databend 中更新源表，您可以在 Databend Cloud 中的目标表中观察到相同的更改。例如，如果您将源表中 Toronto 的人口更改为 2,371,571：
-
-```sql title='Databend:'
-UPDATE population
-SET population = 2371571
-WHERE city = 'Toronto';
-```
-
-您可以看到更新已同步到 Databend Cloud 中的附加表：
-
-```sql title='Databend Cloud:'
-SELECT * FROM population_readonly;
-
--- 预期结果：
-┌────────────────────────────────────┐
-│       city       │    population   │
-├──────────────────┼─────────────────┤
-│ Toronto          │         2371571 │
-│ Montreal         │         1704694 │
-│ Vancouver        │          631486 │
-└────────────────────────────────────┘
 ```

docs/cn/tutorials/databend-cloud/link-tables.md

@@ -0,0 +1,167 @@
+---
+title: 使用 ATTACH TABLE 链接表
+---
+
+在本教程中，我们将指导您如何使用 [ATTACH TABLE](/sql/sql-commands/ddl/table/attach-table) 命令将 Databend Cloud 中的表与存储在 S3 桶中的现有 Databend 表链接起来。
+
+## 开始之前
+
+在开始之前，请确保您已具备以下先决条件：
+
+- 本地机器上已安装 [Docker](https://www.docker.com/)，因为它将用于启动私有化部署的 Databend。
+- 一个 AWS S3 桶，用作私有化部署 Databend 的存储。[了解如何创建 S3 桶](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)。
+- 具有足够权限访问 S3 桶的 AWS Access Key ID 和 Secret Access Key。[管理您的 AWS 凭证](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)。
+- 本地机器上已安装 BendSQL。有关如何使用各种包管理器安装 BendSQL 的说明，请参阅 [安装 BendSQL](/guides/sql-clients/bendsql/#installing-bendsql)。
+
+## 步骤 1：在 Docker 中启动 Databend
+
+1. 在本地机器上启动一个 Databend 容器。以下命令使用 S3 作为存储后端，使用 `databend-doc` 桶以及指定的 S3 端点和认证凭证启动 Databend 容器。
+
+```bash
+docker run \
+    -p 8000:8000 \
+    -e QUERY_STORAGE_TYPE=s3 \
+    -e AWS_S3_ENDPOINT="https://s3.us-east-2.amazonaws.com" \
+    -e AWS_S3_BUCKET=databend-doc\
+    -e AWS_ACCESS_KEY_ID=<your-aws-access-key-id> \ 
+    -e AWS_SECRET_ACCESS_KEY=<your-aws-secrect-access-key> \ 
+    datafuselabs/databend:v1.2.699-nightly
+```
+
+2. 创建一个名为 `population` 的表来存储城市、省份和人口数据，并插入示例记录如下：
+
+```sql
+CREATE TABLE population (
+  city VARCHAR(50),
+  province VARCHAR(50),  
+  population INT
+);
+
+INSERT INTO population (city, province, population) VALUES
+  ('Toronto', 'Ontario', 2731571),
+  ('Montreal', 'Quebec', 1704694),
+  ('Vancouver', 'British Columbia', 631486);
+```
+
+3. 运行以下语句以检索表在 S3 中的位置。如下所示的结果中，本教程中表的 S3 URI 为 `s3://databend-doc/1/16/`。
+
+```sql
+SELECT snapshot_location FROM FUSE_SNAPSHOT('default', 'population');
+
+┌──────────────────────────────────────────────────┐
+│                 snapshot_location                │
+├──────────────────────────────────────────────────┤
+│ 1/16/_ss/513c5100aa0243fe863b4cc2df0e3046_v4.mpk │
+└──────────────────────────────────────────────────┘
+```
+
+## 步骤 2：在 Databend Cloud 中设置附加表
+
+1. 使用 BendSQL 连接到 Databend Cloud。如果您不熟悉 BendSQL，请参考本教程：[使用 BendSQL 连接到 Databend Cloud](../connect/connect-to-databendcloud-bendsql.md)。
+
+2. 执行以下语句以创建两个附加表：
+    - 第一个表 `population_all_columns` 包含源数据中的所有列。
+    - 第二个表 `population_only` 仅包含选定的列（`city` 和 `population`）。
+
+```sql
+-- 创建一个包含源数据中所有列的附加表
+ATTACH TABLE population_all_columns 's3://databend-doc/1/16/' CONNECTION = (
+  REGION='us-east-2',
+  AWS_KEY_ID = '<your_aws_key_id>',
+  AWS_SECRET_KEY = '<your_aws_secret_key>'
+);
+
+-- 创建一个仅包含选定列（city 和 population）的附加表
+ATTACH TABLE population_only (city, population) 's3://databend-doc/1/16/' CONNECTION = (
+  REGION='us-east-2',
+  AWS_KEY_ID = '<your_aws_key_id>',
+  AWS_SECRET_KEY = '<your_aws_secret_key>'
+);
+```
+
+## 步骤 3：验证附加表
+
+1. 查询两个附加表以验证其内容：
+
+```sql
+SELECT * FROM population_all_columns;
+
+┌───────────────────────────────────────────────────────┐
+│       city       │     province     │    population   │
+├──────────────────┼──────────────────┼─────────────────┤
+│ Toronto          │ Ontario          │         2731571 │
+│ Montreal         │ Quebec           │         1704694 │
+│ Vancouver        │ British Columbia │          631486 │
+└───────────────────────────────────────────────────────┘
+
+SELECT * FROM population_only;
+
+┌────────────────────────────────────┐
+│       city       │    population   │
+├──────────────────┼─────────────────┤
+│ Toronto          │         2731571 │
+│ Montreal         │         1704694 │
+│ Vancouver        │          631486 │
+└────────────────────────────────────┘
+```
+
+2. 如果您在 Databend 中更新源表，您可以在 Databend Cloud 的附加表中观察到相同的变化。例如，如果您将源表中 Toronto 的人口更改为 2,371,571：
+
+```sql
+UPDATE population
+SET population = 2371571
+WHERE city = 'Toronto';
+```
+
+执行更新后，您可以查询两个附加表以验证更改是否反映：
+
+```sql
+-- 检查包含所有列的附加表中的更新后人口  
+SELECT population FROM population_all_columns WHERE city = 'Toronto';
+
+-- 检查仅包含人口列的附加表中的更新后人口  
+SELECT population FROM population_only WHERE city = 'Toronto';
+```
+
+上述查询的预期输出：
+
+```sql
+┌─────────────────┐
+│    population   │
+├─────────────────┤
+│         2371571 │
+└─────────────────┘
+```
+
+3. 如果您从源表中删除 `province` 列，它将不再在附加表中可用。
+
+```sql
+ALTER TABLE population DROP province;
+```
+
+删除列后，任何引用它的查询都将导致错误。然而，剩余的列仍然可以成功查询。
+
+例如，尝试查询已删除的 `province` 列将失败：
+
+```sql
+SELECT province FROM population_all_columns;
+error: APIError: QueryFailed: [1065]error:
+  --> SQL:1:8
+  |
+1 | SELECT province FROM population_all_columns
+  |        ^^^^^^^^ column province doesn't exist
+```
+
+但是，您仍然可以检索 `city` 和 `population` 列：
+
+```sql
+SELECT city, population FROM population_all_columns;
+
+┌────────────────────────────────────┐
+│       city       │    population   │
+├──────────────────┼─────────────────┤
+│ Toronto          │         2371571 │
+│ Montreal         │         1704694 │
+│ Vancouver        │          631486 │
+└────────────────────────────────────┘
+```