CREATE TABLE CLONE

Si applica a: Databricks SQL Databricks Runtime

Clona una tabella Delta di origine in una destinazione di destinazione in una versione specifica. Un clone può essere profondo o superficiale: i cloni profondi copiano i dati dall'origine e i cloni superficiali non lo fanno. È anche possibile clonare le tabelle Parquet e Iceberg di origine. Vedere Clonare in modo incrementale le tabelle Parquet e Iceberg in Delta Lake.

In Databricks SQL e Databricks Runtime 13.3 LTS e versioni successive è possibile usare clone superficiale con tabelle gestite di Unity Catalog. In Databricks Runtime 12.2 LTS e versioni successive non è disponibile alcun supporto per cloni superficiali in Unity Catalog. Vedere Clone superficiale per le tabelle del catalogo Unity.

Sintassi

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]

Parametri

• SE NON ESISTE

  Se specificato, l'istruzione viene ignorata se table_name esiste già.

• [CREATE OR] SOSTITUIRE

  Se CREATE OR viene specificata la tabella viene sostituita se esiste e appena creata in caso contrario. Senza CREATE OR l'oggetto table_name deve esistere.

• table_name

  Nome della tabella Delta Lake da creare. Il nome non deve includere una specifica temporale. Se il nome non è qualificato, la tabella viene creata nello schema corrente. table_name non deve esistere già, a meno che REPLACE non sia stato specificato o IF NOT EXISTS .

• CLONE SUPERFICIALE o CLONE PROFONDO

  Se si specifica SHALLOW CLONE Azure Databricks eseguirà una copia della definizione della tabella di origine, ma fare riferimento ai file della tabella di origine. Quando si specifica DEEP CLONE (impostazione predefinita) Azure Databricks creerà una copia completa e indipendente della tabella di origine.

• source_table_name

  Nome della tabella Delta Lake da clonare. Il nome può includere una specifica temporale.

• TBLPROPERTIES

  Facoltativamente, imposta una o più proprietà definite dall'utente.

• PERCORSO

  Facoltativamente, crea una tabella esterna, con la posizione specificata come percorso in cui vengono archiviati i dati. Se table_name stesso un percorso anziché un identificatore di tabella, l'operazione avrà esito negativo. path deve essere un valore letterale STRING.

Esempi

È possibile usare CREATE TABLE CLONE per operazioni complesse come la migrazione dei dati, l'archiviazione dei dati, la riproduzione del flusso di Machine Learning, esperimenti a breve termine e la condivisione dei dati. Vedere Clonare una tabella in Azure Databricks.