ATTACH TABLE

Introduced or updated: v1.2.698

企业版功能

ATTACH TABLE是企业版功能。 如需获取许可证，请联系 Databend 支持团队。

将现有表附加到另一个表。该命令将表的数据和模式从一个数据库移动到另一个数据库，但实际上并不复制数据。而是创建一个指向原始表数据的链接以访问数据。

• 通过附加表，您可以无缝地将云服务平台中的表连接到私有化部署环境中已部署的现有表，而无需实际移动数据。当您希望将数据从 Databend 的私有化部署迁移到 Databend Cloud 同时最大限度地减少数据传输开销时，此功能特别有用。

• 附加表以 READ_ONLY 模式运行。在此模式下，源表中的更改会立即反映在附加表中。但是，附加表仅用于查询目的，不支持更新。这意味着 INSERT、UPDATE 和 DELETE 操作在附加表上是不允许的；只能执行 SELECT 查询。

语法

ATTACH TABLE <target_table_name> [ ( <column_list> ) ] '<source_table_data_URI>'
CONNECTION = ( <connection_parameters> )

• <column_list>：一个可选的、逗号分隔的列列表，用于包含源表中的列，允许用户仅指定必要的列，而不是包含所有列。如果未指定，将包含源表中的所有列。

  • 重命名源表中包含的列会更新其在附加表中的名称，并且必须使用新名称访问它。
  • 删除源表中包含的列会使其在附加表中无法访问。
  • 对未包含的列的更改（例如在源表中重命名或删除它们）不会影响附加表。

• <source_table_data_URI> 表示源表数据的路径。对于类似 S3 的对象存储，格式为 s3://<bucket-name>/<database_ID>/<table_ID>，例如 s3://databend-toronto/1/23351/，它表示存储桶中表文件夹的确切路径。

  

  要获取表的数据库 ID 和表 ID，请使用 FUSE_SNAPSHOT 函数。在下面的示例中，snapshot_location 值中的 1/23351/ 部分表示数据库 ID 为 1，表 ID 为 23351。

  SELECT * FROM FUSE_SNAPSHOT('default', 'employees');
  
  Name                |Value                                              |
  --------------------+---------------------------------------------------+
  snapshot_id         |d6cd1f3afc3f4ad4af298ad94711ead1                   |
  snapshot_location   |1/23351/_ss/d6cd1f3afc3f4ad4af298ad94711ead1_v4.mpk|
  format_version      |4                                                  |
  previous_snapshot_id|                                                   |
  segment_count       |1                                                  |
  block_count         |1                                                  |
  row_count           |3                                                  |
  bytes_uncompressed  |122                                                |
  bytes_compressed    |523                                                |
  index_size          |470                                                |
  timestamp           |2023-07-11 05:38:27.0                              |

• CONNECTION 指定建立与对象存储的链接所需的连接参数，该对象存储存储源表的数据。连接参数因不同的存储服务而异，具体取决于其特定要求和身份验证机制。有关更多信息，请参见 连接参数。

教程

• 使用 ATTACH TABLE 链接表

示例

此示例创建一个附加表，其中包括存储在 AWS S3 中的源表中的所有列：

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>'
);

此示例创建一个附加表，其中包括仅从存储在 AWS S3 中的源表中选择的列（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>'
);