commande .create table

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

.createtableName 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 ou docstring 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 .create tables performances et réduire la charge sur le cluster.