Partager via


commande .create tables

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

Crée de nouvelles tables vides en tant qu’opération en bloc.

La commande doit s’exécuter dans le contexte d’une base de données spécifique.

autorisations

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

Syntaxe

.createtables tableName1 (columnName:columnType [, ...]) [, tableName2 (columnName:columnType [, ...]) ... ] [with( propertyName = PropertyValue [, ...]])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
tableName string ✔️ Nom de la table à créer.
columnName, columnType string ✔️ Nom d’une colonne mappée au type de données de cette colonne. La liste des mappages définit le schéma de colonne de sortie.
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é.
folder string Nom du dossier à ajouter à la table.

Remarque

Si une ou plusieurs tables ayant les mêmes noms (respectant la casse) que les tables spécifiées existent déjà dans le contexte de la base de données, la commande retourne la réussite sans modifier les tables existantes, même dans les scénarios suivants :

  • Le schéma spécifié ne correspond pas au schéma d’une table existante
  • Le folder ou docstring les paramètres sont spécifiés avec des valeurs différentes de celles définies dans les tables existantes

Toutes les tables spécifiées qui n’existent pas sont créées.

Exemple

.create tables 
  MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
  MyUsers (UserId:string, Name:string)