Tabelas Delta Clone

Podes usar o comando Delta Lake CLONE em Microsoft Fabric para criar uma cópia de uma tabela Delta num momento específico. Um clone captura a tabela de origem tal como existe quando executas o comando, ou numa versão anterior que especificas com sintaxe de viagem no tempo.

Clonar é útil quando se quer uma cópia segura de uma tabela para desenvolvimento, validação ou experimentação. A tabela de origem não é modificada, e as alterações que fazes ao clone não afetam a tabela de origem.

O que o clone faz

Um clone cria uma tabela Delta alvo a partir de um snapshot da tabela Delta de origem. É possível:

  • Clonar a versão mais recente da tabela de origem
  • Clone uma versão específica da tabela usando VERSION AS OF
  • Clone um ponto específico no tempo usando TIMESTAMP AS OF

Como o clone é baseado num snapshot, não acompanha automaticamente as alterações posteriores na tabela de origem.

Clone raso

Um clone superficial cria uma nova tabela Delta que faz referência aos ficheiros de dados existentes da tabela de origem. A Delta Lake copia os metadados da tabela no momento do clone, mas não copia os ficheiros de dados subjacentes para um novo armazenamento.

Utilize um clone superficial quando precisar de uma cópia rápida e que poupe armazenamento para tarefas de curta duração:

  • Criar um sandbox para desenvolvimento
  • Teste alterações ao esquema ou à transformação sem risco
  • Executar testes com dados semelhantes aos de produção
  • Criar cópias temporárias para resolução de problemas
  • Criar capturas instantâneas num determinado momento para validação

Um clone superficial é eficiente em armazenamento porque a origem e o clone partilham os mesmos ficheiros de dados OneLake. Depois de o clone existir, as atualizações que fazes ao clone criam novos ficheiros para o clone e não alteram a tabela de origem.

Note

Apenas SHALLOW CLONE é suportado no código aberto Delta Lake e Fabric. DEEP CLONE não está disponível.

Sintaxe

Utilize os seguintes padrões de sintaxe para criar clones de tabelas Delta.

Clonar a versão atual

CREATE TABLE target_table SHALLOW CLONE source_table;

Clone uma versão específica

CREATE TABLE target_table SHALLOW CLONE source_table VERSION AS OF 125;

Clonar a partir de um ponto no tempo

CREATE TABLE target_table SHALLOW CLONE source_table TIMESTAMP AS OF '2026-05-18T08:30:00Z';

Substituir um clone existente

Use CREATE OR REPLACE TABLE para atualizar um alvo clone com um snapshot mais recente:

CREATE OR REPLACE TABLE sandbox.sales_orders_test
SHALLOW CLONE operations.sales_orders;

Entenda o que é clonado

Componente Comportamento
Ficheiros de dados Referenciado a partir dos ficheiros OneLake da tabela de origem (não copiado).
Informações de partição Copiado.
Schema Copiado.
Propriedades da tabela Copiado.
Dependência da origem após a clonagem Sim — o clone depende de os ficheiros de dados da origem continuarem disponíveis.
Fonte Histórico dos registos Delta Não foi copiado para o histórico da tabela alvo. O clone inicia o seu próprio log Delta.

Utilize a clonagem para cenários comuns

Usa o clone da tabela Delta quando precisares:

  • Criar ambientes sandbox para desenvolvimento
  • Alterações no esquema de teste sem risco para a tabela de origem
  • Validar transformações em relação a um instantâneo de produção
  • Crie uma cópia de um determinado momento para depuração ou auditoria
  • Fornecer um snapshot só de leitura para uma equipa a jusante

Considerações sobre o OneLake

Os clones rasos partilham os ficheiros subjacentes do OneLake com a tabela de origem. Esta conceção torna a clonagem superficial rápida e eficiente em termos de armazenamento, mas também significa que depende de os ficheiros da tabela de origem continuarem disponíveis.

Tem cuidado ao executares VACUUM na tabela de origem. Se VACUUM remover ficheiros de origem que um clone raso ainda referencia, o clone pode deixar de funcionar porque esses ficheiros já não estão disponíveis no OneLake.

Para criar uma cópia independente e duradoura que resista a VACUUM na origem, considere copiar os dados com uma gravação completa (CREATE TABLE ... AS SELECT) em vez de clonagem.