Compartilhar via

CREATE TABLE AS CLONE OF

  • Artigo

Aplica-se a: Depósito no Microsoft Fabric

Cria outra tabela como um clone cópia zero de outra tabela no Depósito no Microsoft Fabric. Somente os metadados da tabela são copiados. Os dados subjacentes da tabela, armazenados como arquivos parquet, não são copiados.

Para obter mais informações sobre como clonar uma tabela no Microsoft Fabric, confira Clonar tabela com TSQL no Microsoft Fabric. Você também pode clonar tabelas no Microsoft Fabric por meio do portal do Fabric, por exemplo, confira Clonar tabelas no portal do Fabric.

Convenções de sintaxe de Transact-SQL

Sintaxe

CREATE TABLE 
    { database_name.schema_name.table_name | schema_name.table_name | table_name } 
AS CLONE OF 
    { database_name.schema_name.table_name | schema_name.table_name | table_name } [AT {point_in_time}]

Argumentos

database_name

O nome do banco de dados que conterá a nova tabela clonada. O padrão é o banco de dados atual.

schema_name

O esquema da tabela em que o clone da tabela está localizado. Especificar o esquema é opcional quando a tabela é clonada dentro do mesmo esquema. Se ele estiver vazio, o esquema padrão será usado.

Fornecer o nome do esquema é necessário quando uma tabela é clonada entre esquemas.

table_name

O nome da tabela clonada. Os nomes de tabela precisam seguir as regras para identificadores. table_name pode ter, no máximo, 128 caracteres.

point_in_time

Na data e hora fornecidas, o clone da tabela espelha com precisão os dados como estavam naquela data e hora específicas em UTC. O formato do valor do tipo de dados datetime deve ser 'YYYY-MM-DDThh:mm:ss', em que 'T' indica o início da hora.

Não é preciso especificar point_in_time para criar clones de tabela no ponto no tempo atual.

O Warehouse preserva e mantém automaticamente o histórico de dados por sete dias corridos. Para obter mais informações, visite Clonar tabela.

Permissões

Exige:

  • Permissão SELECT em toda a tabela de origem
  • Permissões CREATE TABLE no esquema no qual o clone da tabela será criado

Restrições

As restrições de chave primária e exclusiva definidas na tabela de origem são replicadas ao criar um clone.

Limitações

Para limitações, confira Limitações ao clonar tabela.

Exemplos

a. Criar um clone de tabela dentro do mesmo esquema

--Clone creation within the same schema
CREATE TABLE dbo.Employee AS CLONE OF dbo.EmployeeUSA;

B. Criar um clone de tabela entre esquemas no mesmo data warehouse

--Clone creation across schemas
CREATE TABLE dbo.Employee AS CLONE OF dbo1.EmployeeUSA;

C. Criar um clone de tabela dentro do mesmo esquema em um ponto no tempo

--Clone creation within the same schema
CREATE TABLE dbo.Employee AS CLONE OF dbo.EmployeeUSA AT '2023-05-23T14:24:10.325';

D. Criar um clone da tabela no esquema em um ponto no tempo

--Clone creation within the same schema
CREATE TABLE dbo.Employee AS CLONE OF dbo1.EmployeeUSA AT '2023-05-23T14:24:10';

Conteúdo relacionado