Compartir a través de


CREATE TABLE AS CLONE OF

Se aplica a: Warehouse en Microsoft Fabric

Crea una nueva tabla a modo de clon sin copia de otra tabla en el almacenamiento de Microsoft Fabric. Solo se copian los metadatos de la tabla. Los datos subyacentes de la tabla, almacenados como archivos Parquet, no se copian.

Para más información sobre cómo clonar una tabla en Microsoft Fabric, consulte Clonación de tablas con TSQL en Microsoft Fabric. También puede clonar tablas en Microsoft Fabric a través del portal de Fabric, para ver ejemplos, consulte Clonación de tablas en el portal de Fabric.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Nombre de la base de datos que contendrá la nueva tabla clonada. El valor predeterminado es la base de datos actual.

schema_name

Esquema de la tabla donde se encuentra el clon de la tabla. La especificación del esquema es opcional cuando se clona la tabla dentro del mismo esquema. Si se deja vacío, se usa el esquema predeterminado.

Cuando se clona una tabla entre esquemas, es necesario proporcionar el nombre del esquema.

table_name

Nombre de la tabla clonada. Los nombres de las tablas deben seguir las reglas de los identificadores. table_name puede tener hasta 128 caracteres.

point_in_time

En la fecha y hora proporcionadas, la tabla clona con precisión refleja los datos tal y como estaba en esa fecha y hora concretas en UTC. El formato del valor del tipo de datos datetime debe ser "AAAA-MM-DDThh:mm:ss", donde "T" indica el inicio de la hora.

No es necesario especificar el point_in_time para crear clones de tabla a partir del momento dado.

El almacén conserva y mantiene automáticamente el historial de datos durante siete días naturales. Para obtener más información, consulte Clonar tabla.

Permisos

Requiere:

  • Permiso SELECT de toda la tabla de origen
  • Permisos CREATE TABLE del esquema en el que se creará el clon de la tabla

Restricciones

Al crear un clon, las restricciones de clave principal y única definidas en la tabla de origen se replican.

Limitaciones

Para más limitaciones, consulte Limitaciones de clones de tabla.

Ejemplos

A. Creación de un clon de tabla dentro del mismo esquema

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

B. Creación de un clon de tabla entre esquemas dentro del mismo almacenamiento de datos

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

C. Creación de un clon de tabla dentro del mismo esquema a un momento dado

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

D. Creación de un clon de tabla en todos los esquemas a un momento dado

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