複製表資料至另一張表（CLONE TABLE） - MaxCompute

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;
--開啟全表掃描，執行select語句查看複製後目標表sale_detail_clone的資訊，驗證資料準確性。
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      |
+------------+-------------+-------------+------------+------------+

樣本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_clone中的資料。
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;
--開啟全表掃描，執行select語句查看複製後目標表sale_detail_clone1的資訊，驗證資料準確性。
SET odps.sql.allow.fullscan=true; 
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跨專案資料移轉。