CLONE TABLE

功能介绍

支持高效地将源表中的数据复制到目标表中。将数据复制到目标表之后，建议您执行数据验证以确保复制后数据的准确性。例如，执行select命令查看表的数据、执行desc命令查看表大小。

使用限制

• 目标表与源表的Schema需要兼容。
• 支持分区表和非分区表，暂不支持对聚簇表使用clone table命令复制表数据。
• 目标表已存在时，一次性复制分区的数量上限为10000个。
• 目标表不存在时，无分区数量限制，满足原子性。
• 对同一个非分区表或分区表的同一个分区，执行clone table命令的次数不能超过7次。
• 不支持在跨区域的MaxCompute项目之间使用clone table命令复制表数据。
• 不支持对外部表使用clone table命令复制表数据。

命令格式

clone table <[<src_project_name>.]<src_table_name>> [partition(<pt_spec>), ...]
 to <[<dest_project_name>.]<dest_table_name>> [if exists [overwrite | ignore]] ;

• src_project_name：可选。源表所属MaxCompute项目名称。不指定时，默认为当前项目。当源表与目标表不属于同一个MaxCompute项目时，需要携带此参数。
• src_table_name：必填。源表名称。
• pt_spec：可选。源表的分区信息。格式为(partition_col1 = partition_col_value1, partition_col2 = partition_col_value2, ...)。partition_col是分区字段，partition_col_value是分区值。
• dest_project_name：可选。目标表所属MaxCompute项目名称。不指定时，默认为当前项目。当目标表与源表不属于同一个MaxCompute项目时，需要携带此参数。
• desc_table_name：必填。目标表名称。
  • 当目标表不存在时，clone table命令会创建目标表，创建目标表使用的是create table like语义。更多create table like信息，请参见创建表。
  • 当目标表已存在并指定if exists overwrite时，clone table命令会覆盖目标表或对应分区的数据。
  • 当目标表已存在并指定if exists ignore时，clone table命令会跳过已存在分区，不覆盖目标表已有分区的数据。

示例数据

使用示例

基于示例数据，clone table命令的使用示例如下：

• 示例1：全量复制非分区表sale_detail_np的数据至目标表sale_detail_np_clone。命令示例如下：

  --复制表数据。
  clone table sale_detail_np to sale_detail_np_clone;
  --查看复制后目标表sale_detail_np_clone的信息，验证数据准确性。
  select * from sale_detail_np_clone;
  --返回结果。
  +------------+-------------+-------------+
  | shop_name  | customer_id | total_price |
  +------------+-------------+-------------+
  | s4         | c4          | 100.4       |
  +------------+-------------+-------------+

• 示例2：复制分区表sale_detail指定分区的数据至目标表sale_detail_clone。命令示例如下：

  --复制表数据。
  clone table sale_detail partition (sale_date='2013', region='china') to sale_detail_clone if exists overwrite;
  --查看复制后目标表sale_detail_clone的信息，验证数据准确性。
  select * from sale_detail_clone;
  --返回结果。
  +------------+-------------+-------------+------------+------------+
  | shop_name  | customer_id | total_price | sale_date  | region     |
  +------------+-------------+-------------+------------+------------+
  | s1         | c1          | 100.1       | 2013       | china      |
  | s2         | c2          | 100.2       | 2013       | china      |
  | s3         | c3          | 100.3       | 2013       | china      |
  +------------+-------------+-------------+------------+------------+

• 示例3：全量复制分区表sale_detail的数据至目标表sale_detail_clone（示例2已生成的表）并跳过目标表中已存在的分区。命令示例如下：

  --复制表数据。
  clone table sale_detail to sale_detail_clone if exists ignore;
  --查看复制后目标表sale_detail_clone的信息，验证数据准确性。
  select * from sale_detail_clone;
  --返回结果。
  +------------+-------------+-------------+------------+------------+
  | shop_name  | customer_id | total_price | sale_date  | region     |
  +------------+-------------+-------------+------------+------------+
  | s1         | c1          | 100.1       | 2013       | china      |
  | s2         | c2          | 100.2       | 2013       | china      |
  | s3         | c3          | 100.3       | 2013       | china      |
  | null       | c5          | NULL        | 2014       | shanghai   |
  | s6         | c6          | 100.4       | 2014       | shanghai   |
  | s7         | c7          | 100.5       | 2014       | shanghai   |
  +------------+-------------+-------------+------------+------------+

• 示例4：全量复制分区表sale_detail的数据至目标表sale_detail_clone1。命令示例如下：

  --复制表数据。
  clone table sale_detail to sale_detail_clone1;
  --查看复制后目标表sale_detail_clone1的信息，验证数据准确性。
  select * from sale_detail_clone1;
  --返回结果。
  +------------+-------------+-------------+------------+------------+
  | shop_name  | customer_id | total_price | sale_date  | region     |
  +------------+-------------+-------------+------------+------------+
  | s1         | c1          | 100.1       | 2013       | china      |
  | s2         | c2          | 100.2       | 2013       | china      |
  | s3         | c3          | 100.3       | 2013       | china      |
  | null       | c5          | NULL        | 2014       | shanghai   |
  | s6         | c6          | 100.4       | 2014       | shanghai   |
  | s7         | c7          | 100.5       | 2014       | shanghai   |
  +------------+-------------+-------------+------------+------------+