Partager via


CREATE TABLE AS CLONE OF

S’applique à : Entrepôt dans Microsoft Fabric

Crée une table qui est un clone de copie zéro d’une autre table dans Warehouse à l’intérieur de Microsoft Fabric. Seules les métadonnées de la table sont copiées. Les données sous-jacentes de la table, stockées sous forme de fichiers parquet, ne sont pas copiées.

Pour plus d’informations sur le clonage d’une table dans Microsoft Fabric, consultez Cloner une table avec TSQL dans Microsoft Fabric. Vous pouvez également cloner des tables dans Microsoft Fabric à travers le portail Fabric, pour obtenir des exemples consultez Cloner des tables dans le portail Fabric.

Conventions de la syntaxe Transact-SQL

Syntaxe

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}]

Arguments

database_name

Nom de la base de données qui contiendra la nouvelle table clonée. La valeur par défaut est la base de données active.

schema_name

Schéma de la table où se trouve le clone de table. La spécification du schéma est facultative lorsque la table est clonée dans le même schéma. Si aucun schéma n’est spécifié, le schéma par défaut est utilisé.

Le nom du schéma doit obligatoirement être spécifié quand une table est clonée entre plusieurs schémas.

table_name

Nom de la table clonée. Les noms de tables doivent respecter les règles applicables aux identificateurs. table_name peut avoir un maximum de 128 caractères.

point_in_time

À la date et à l’heure fournies, la table clone reflète avec précision les données telles qu’elles étaient à cette date et heure particulières au format UTC. Le format de la valeur de type de données datetime doit être « AAAA-MM-JJThh:mm:ss », où « T » indique le début de l’heure.

Il n’est pas nécessaire de spécifier point_in_time pour créer des clones de table à partir du moment actuel.

L’entrepôt conserve et maintient automatiquement l’historique des données pendant sept jours civils. Pour plus d’informations, consultez Cloner la table.

autorisations

Nécessite :

  • Autorisation SELECT sur l’ensemble de la table source
  • Autorisations CREATE TABLE sur le schéma dans lequel le clone de la table sera créé

Contraintes

Les contraintes de clé primaire et de clé unique définies dans la table source sont répliquées lors de la création d’un clone.

Limites

Pour plus de limitations, consultez Limitations de la table clone.

Exemples

R. Créer un clone de table dans le même schéma

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

B. Créer un clone de table dans plusieurs schémas au sein du même entrepôt de données

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

C. Créer un clone de table dans le même schéma et à un moment donné

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

D. Créer un clone de table sur un schéma à un moment donné

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