commande .create table based-on

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Crée une table vide basée sur une table existante. Cette commande doit s’exécuter dans le contexte d’une base de données spécifique.

Remarque

Toutes les propriétés de la table source sont copiées dans la nouvelle table, avec les exceptions suivantes :

• Stratégie de mise à jour
• Principaux autorisés : lors de l’utilisation de la .create table based-on commande, le principal actuel est ajouté aux administrateurs de table.

autorisations

Vous devez disposer au moins des autorisations d’administrateur de base de données pour exécuter cette commande.

Syntaxe

.createtableName based-on otherTable [ifnotexists] [with( propertyName = propertyValue [, ...])]table

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
ifnotexists	string		Si elle est spécifiée, la table est créée uniquement si elle n’existe pas déjà.
tableName	string	✔️	Nom de la table à créer. Le nom sénestif doit être unique dans la base de données.
otherTable	string	✔️	Nom d’une table existante à utiliser comme source pour les colonnes, la documentation et le dossier de la table en cours de création.
propertyName, propertyValue	string		Liste séparée par des virgules de paires de propriétés clé-valeur. Consultez les propriétés prises en charge.

Propriétés prises en charge

Nom	Type	Description
docstring	string	Texte libre décrivant l’entité à ajouter. Cette chaîne est présentée dans différents paramètres d’expérience utilisateur en regard des noms d’entité. La valeur par défaut est Créée en fonction de< tableName>.
folder	string	Nom du dossier où ajouter la table. La valeur par défaut est le même dossier que tableName.

Retours

Cette commande retourne le schéma du nouveau tableau au format JSON, similaire à l’exécution de la commande suivante :

.show table MyLogs schema as json

Remarque

• Si la table existe déjà :
  • Si ifnotexists l’indicateur est spécifié, la commande est ignorée (aucune modification n’est appliquée).
  • Si ifnotexists l’indicateur n’est PAS spécifié, une erreur est retournée.

Exemple

.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")