Sdílet prostřednictvím

CREATE TABLE CLONE

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime

Naklonuje zdrojovou Deltu table do cílového umístění na konkrétní verzi. Klon může být buď hluboký, nebo mělký: hluboké klony kopírují data ze zdroje a ne. Můžete také klonovat zdroj Parquet a Iceberg tables. Viz Přírůstkové klonování Parquet a Iceberg tables do Delta Lake.

V Databricks SQL a Databricks Runtime 13.3 LTS a novějších můžete použít mělké klonování s Unity Catalog spravovanými tables. V Databricks Runtime 12.2 LTS a níže neexistuje podpora pro mělké klony v Unity Catalog. Viz mělký klon pro Unity Catalogtables.

Důležité

Mezi mělkými a hlubokými klony existují důležité rozdíly, které určují, jak je nejlépe používat. Viz Klonujte table na Azure Databricks.

Syntaxe

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

  • POKUD NEEXISTUJE

    Pokud je zadáno, příkaz je ignorován, pokud table_name již existuje.

  • [VYTVOŘIT NEBO] NAHRADIT

    Pokud je CREATE OR zadáno, table se nahradí, pokud existuje, a vytvoří se nově, pokud neexistuje. Bez CREATE OR nutnosti table_name existovat.

  • table_name

    Název Delta Lake, který se má vytvořit, table. Název nesmí obsahovat dočasnou specifikaci ani specifikaci možností. Pokud není název kvalifikovaný, vytvoří se table v aktuálním schema. table_name nesmí již existovat, pokud REPLACE nebyl IF NOT EXISTS zadán nebo nebyl zadán.

  • MĚLKÝ KLON nebo HLUBOKÝ KLON

    Pokud zadáte SHALLOW CLONE, Azure Databricks vytvoří kopii definice zdrojového table, ale bude odkazovat na zdrojové soubory table. Když zadáte DEEP CLONE (výchozí), Azure Databricks provede úplnou, nezávislou kopii zdrojového table.

  • source_table_name

    Název Delta Lake table, který se má naklonovat. Název může obsahovat časovou specifikaci nebo specifikaci možností.

  • TBLPROPERTIES

    Volitelně nastaví jednu nebo více uživatelem definovaných vlastností.

  • Cesta k umístění

    Volitelně můžete vytvořit externí table, se zadaným umístěním, protože cesta where jsou uložena data. Pokud je table_name cesta místo tableidentifier, operace selže. path musí být literál STRING.

Příklady

Můžete použít CREATE TABLE CLONE pro složité operace, jako je migrace dat, archivace dat, reprodukce toku strojového učení, krátkodobé experimenty a sdílení dat. Podívejte se na Klonovat table na Azure Databricks.