XCOPY跨地域复制

数据跨境传输合规声明

如果在使用 XCOPY 时涉及跨境数据传输，需符合相关地域的法律法规要求。

功能介绍

跨地域数据复制（XCOPY）功能支持表快照（Snapshot）增量复制，适用于跨Region数据备份、迁移、共享等场景。

• 采用文件级增量复制，拷贝列压缩的二进制数据文件，兼顾传输效率、降低传输成本及数据一致性。

• 基于表快照（SnapShot）复制，复制后的数据与原表解耦，独立管理备份生命周期。

• 表快照（Snapshot）副本的数据可恢复时间点明确，即Point-in-Time Recovery（PITR）。可以从上游数据源补全最近丢失数据。

• 增量复制为分区（Partition）级，前后两次复制基于同一个表的两个Snapshot。如果有重复的分区，将不会触发重复复制，只复制差异的分区。

• 计费参考：跨地域数据复制费用。

适用范围

• 地域限制：中国香港、新加坡、日本（东京）。

• 跨Region带宽：初始值为10Gbps，按需调整。

• XCOPY对象：表快照（SnapShot）。

  表快照支持对普通表（包括分区/非分区/聚簇表）、PK/Append Delta Table 创建，不支持对 Transaction Table 创建。

• XCOPY任务数上限：

  每个项目最多并发执行128个XCOPY Snapshot，超过限制后任务提交会失败。

• 权限限制：

  • 待复制数据源的项目和复制目标的项目必须归属于同一个主账号。

  • 在待复制数据源的项目中，具备待复制表快照（SnapShot）的SELECT权限。

  • 在复制目标的项目中，具备CREATE TABLE权限。

XCOPY功能开通

XCOPY命令说明

XCOPY SNAPSHOT <src_remote_project_name>.<src_remote_snapshot_name>
TO SNAPSHOT [<dest_local_project_name>.]<dest_local_snapshot_name> 
OPTIONS(src_region=<region_name>); 

使用示例

该示例实现新加坡（SGP）主 Region 到中国香港（HK）备 Region 的数据容灾备份。如下图所示：

• 备份阶段

  主区域（Region-SGP）：Account A（User1）下的 Project_A 包含源表 Table_X 和 Table_Y，分别创建快照 SNAPSHOT_X1/X2 和 SNAPSHOT_Y1。

  -- 备份阶段
  -- User在 Region-SGP 创建快照
  CREATE SNAPSHOT TABLE
  Project_A.table_x_snapshot_20260101
  CLONE Project_A.table_x; 

• 跨域复制

  通过跨地、跨国专线将快照数据从主 Region复制到备 Region。

  -- User在 Region-HK Copy Region-SGP 创建的快照
  XCOPY
  SNAPSHOT Project_A.table_x_snapshot_20260101
  TO
  SNAPSHOT Project_B.table_x_snapshot_20260101
  OPTIONS( src_region =” ap-southeast-1”);

• 恢复阶段

  备区域（Region-HK）：Project_B 接收复制后的快照，可基于快照恢复为 Table_Z 等目标表。

  -- 恢复阶段
  -- User在 Region-HK 临时查询备份数据
  SELECT * FROM Project_B.table_x_snapshot_20260101;
  
  -- User在 Region-HK 恢复数据
  CREATE TABLE table_x CLONE table_x_snapshot_20260101;