commande .create table

  • Article

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 d’au moins les autorisations d’utilisateur de base de données pour exécuter cette commande.

Syntax

.createtableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire Description
tableName string ✔️ Nom de la table à créer.
columnName, columnType string ✔️ Nom d’une colonne mappée au type de données dans 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 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.

Notes

Si une table portant le même nom (respectant la casse) existe déjà dans le contexte de la base de données, la commande retourne 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 ou docstring 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, comme suit :

.show table MyLogs schema as json

Notes

Pour créer plusieurs tables, utilisez la commande pour améliorer les .create tables performances et réduire la charge sur le cluster.