commande .create table
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Crée une table vide.
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
.create
tableName columnName:
(
columnType [,
...])
[with
(
propertyName =
propertyValue [,
...]])
table
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 de ces 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 table portant le même nom (sensible à la casse) existe déjà dans le contexte de la base de données, la commande retourne la réussite sans modifier la table existante, même dans les scénarios suivants :
- Le schéma spécifié ne correspond pas au schéma de la table existante
- Les
folder
paramètres oudocstring
les paramètres sont spécifiés avec des valeurs différentes de celles définies dans la table
Exemple
.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 )
Sortie
Retourne le schéma de la table au format JSON, identique à :
.show table MyLogs schema as json
Remarque
Pour créer plusieurs tables, utilisez la commande pour améliorer les performances et réduire la .create tables
charge des données.