CREATE TABLE CLONE

Aplica-se a: Databricks SQL Databricks Runtime

Clona uma Delta table de origem para um destino numa versão específica. Um clone pode ser profundo ou superficial: clones profundos copiam os dados da fonte e clones superficiais não. Também pode clonar as fontes Parquet e Iceberg tables. Consulte clonar incrementalmente Parquet e Iceberg tables para Delta Lake.

No Databricks SQL e Databricks Runtime 13.3 LTS e superior, você pode usar clone superficial com o Unity Catalog gerenciado tables. No Databricks Runtime 12.2 LTS e inferior, não há suporte para clones superficiais no Unity Catalog. Consulte clone superficial para Unity Catalogtables.

Sintaxe

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

• SE NÃO EXISTIR

  Se especificado, a instrução será ignorada se table_name já existir.

• [CRIAR OU] SUBSTITUIR

  Se CREATE OR for especificado, o table será substituído se existir e recém-criado se não existir. Sem CREATE OR o table_name deve existir.

• table_name

  O nome do novo Delta Lake table. O nome não deve incluir uma especificação temporal ou uma especificação de opções. Se o nome não estiver qualificado, o table será criado na schemaatual. table_name não deve existir já, a menos que REPLACE ou IF NOT EXISTS tenha sido especificado.

• CLONE RASO ou CLONE PROFUNDO

  Se você especificar SHALLOW CLONE o Azure Databricks fará uma cópia da definição do tablede origem, mas fará referência aos arquivos do tablede origem. Quando se especifica DEEP CLONE (padrão), o Azure Databricks fará uma cópia completa e independente da origem table.

• source_table_name

  O nome do Lago Delta table ser clonado. O nome pode incluir uma especificação temporal ou uma especificação de opções.

• TBLPROPERTIES

  Opcionalmente, define uma ou mais propriedades definidas pelo usuário.

• Caminho LOCALIZAÇÃO

  Opcionalmente, cria um tableexterno, com o local fornecido como o caminho where os dados são armazenados. Se table_name for um caminho em vez de um tableidentifier, a operação falhará. path deve ser um literal STRING.

Exemplos

Você pode usar CREATE TABLE CLONE para operações complexas, como migração de dados, arquivamento de dados, reprodução de fluxo de aprendizado de máquina, experimentos de curto prazo e compartilhamento de dados. Veja clonar um table no Azure Databricks.