CLONE TABLE

CLONE TABLE支持高效地将源表数据复制到目标表中,适用于表数据迁移场景。本文以具体示例为您介绍clone table功能的使用。

使用限制

  • 目标表与源表的Schema需要兼容。

  • 支持分区表和非分区表,支持对聚簇表使用clone table命令复制表数据。

  • 目标表已存在时,一次性复制分区的数量上限为10000个。

  • 目标表不存在时,无分区数量限制,满足原子性。

  • 不支持在跨地域的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项目时,需要携带此参数。

  • dest_table_name:必填。目标表名称。

    • 当目标表不存在时,clone table命令会创建目标表,创建目标表使用的是create table like语义。更多create table like信息,请参见创建表

    • 当目标表已存在并指定if exists overwrite时,clone table命令会覆盖目标表或对应分区的数据。

    • 当目标表已存在并指定if exists ignore时,clone table命令会跳过已存在分区,不覆盖目标表已有分区的数据。

示例数据

为便于理解,本文为您提供源数据,基于源数据提供相关示例。创建分区表sale_detail和非分区表sale_detail_np,并添加数据,命令示例如下:

  • 分区表sale_detail

    --创建一张分区表sale_detail。
    create table if not exists sale_detail
    (
    shop_name     string,
    customer_id   string,
    total_price   double
    )
    partitioned by (sale_date string, region string);
    
    --向源表增加分区。
    alter table sale_detail add partition (sale_date='2013', region='china') partition (sale_date='2014', region='shanghai');
    
    --向源表追加数据。
    insert into sale_detail partition (sale_date='2013', region='china') values ('s1','c1',100.1),('s2','c2',100.2),('s3','c3',100.3);
    insert into sale_detail partition (sale_date='2014', region='shanghai') values ('null','c5',null),('s6','c6',100.4),('s7','c7',100.5);

    查询分区表sale_detail中的数据,命令示例如下:

    --开启全表扫描,仅此Session有效。执行select语句查看表sale_detail中的数据。
    set odps.sql.allow.fullscan=true; 
    select * from sale_detail;
    
    --返回结果。
    +------------+-------------+-------------+------------+------------+
    | 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   |
    +------------+-------------+-------------+------------+------------+
  • 非分区表sale_detail_np

    --创建一张非分区表sale_detail_np。
    create table if not exists sale_detail_np
    (
    shop_name     string,
    customer_id   string,
    total_price   double
    );
    
    --向源表追加数据。
    insert into sale_detail_np values ('s4','c4',100.4);

    查询非分区表sale_detail_np中的数据,命令示例如下:

    select * from sale_detail_np;
    --返回结果。
    +------------+-------------+-------------+
    | shop_name  | customer_id | total_price |
    +------------+-------------+-------------+
    | s4         | c4          | 100.4       |
    +------------+-------------+-------------+

使用示例

基于示例数据,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的信息,验证数据准确性。
    --开启全表扫描,仅此Session有效。执行select语句查看表sale_detail中的数据。
    set odps.sql.allow.fullscan=true; 
    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   |
    +------------+-------------+-------------+------------+------------+
  • 示例5:克隆Delta Table表

    --克隆Delta Table非分区表
    clone table mf_dt to new_table;
    
    --克隆Delta Table分区表
    clone table mf_dt2 partition (dd='01', hh='01') to new_table;

最佳实践

实现同Region的MaxCompute项目数据迁移请参见使用CLONE TABLE实现同地域MaxCompute跨项目数据迁移