共用方式為

CREATE TABLE CLONE

  • 發行項

適用於：核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime

將來源 Delta table 複製到指定版本的目標位置。 複製可以是深層或淺層：從來源複製數據進行深層複製，而淺層複製則不會。 您也可以複製來源 Parquet 和 Iceberg tables。 請參閱 以累加方式複製 Parquet 和 Iceberg tables 至 Delta Lake。

在 Databricks SQL 和 Databricks Runtime 13.3 LTS 及更高版本中，您可以使用淺層複製搭配 Unity Catalog 托管 tables。 在 Databricks Runtime 12.2 LTS 和以下版本中，Unity Catalog不支持淺層複製。 請參閱 Unity的淺層複製 Catalogtables。

重要

淺層和深層複製之間有重要的差異，可判斷其最佳使用方式。 請參閱在 Azure Databricks上 複製 。

語法

CREATE TABLE [IF NOT EXISTS] table_name
   [SHALLOW | DEEP] CLONE source_table_name [TBLPROPERTIES clause] [LOCATION path]

[CREATE OR] REPLACE TABLE table_name
   [SHALLOW | DEEP] CLONE source_table_name [TBLPROPERTIES clause] [LOCATION path]

Parameters

  • IF NOT EXISTS

    如果指定，則如果 table_name 已經存在，則會忽略 語句。

  • [CREATE OR]取代

    如果指定 CREATE OR，則在 table 存在時進行取代，不存在時則進行創建。 CREATE OR沒有 table_name 必須存在。

  • table_name

    要建立之 Delta Lake table 的名稱。 名稱不得包含 時態規格或選項規格。 如果名稱不符合資格，則會在目前 schema中建立 table。 table_name除非已指定 或 REPLACE ，否則IF NOT EXISTS不得已經存在。

  • 淺層複製或深層複製

    如果您指定 SHALLOW CLONE，Azure Databricks 會複製來源 table的定義，但引用來源 table的檔案。 當您指定 DEEP CLONE（預設）時，Azure Databricks 會將來源 table完整且獨立地複製一份。

  • source_table_name

    要複製之 Delta Lake table 的名稱。 名稱可能包含 時態規格或選項規格。

  • TBLPROPERTIES

    選擇性地設定一或多個使用者定義的屬性。

  • 位置路徑

    可選擇性地建立一個外部 table，並使用提供的位置作為儲存資料的路徑 where 。 如果 table_name 本身是路徑而非 tableidentifier，則操作將會失敗。 path 必須是 STRING 常值。

範例

您可以 CREATE TABLE CLONE 用於複雜的作業，例如數據遷移、數據封存、機器學習流程重現、短期實驗和數據共用。 請參閱 在 Azure Databricks上複製 table。