commande .create-merge tables
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Vous permet de créer et d’étendre les schémas de tables existantes dans une seule opération en bloc, dans le contexte d’une base de données spécifique.
autorisations
Cette commande nécessite des autorisations utilisateur de base de données et des autorisations d’administrateur de table pour étendre des tables existantes.
Syntaxe
.create-mergetables 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 ou étendre. |
| columnName, columnType | string |
✔️ | Nom d’une colonne existante ou nouvelle 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. |
Retours
- Les tables spécifiées qui n’existent pas sont créées.
- Les tables spécifiées qui existent déjà ont leurs schémas étendus.
- Les colonnes inexistantes sont ajoutées à la fin du schéma de la table existante.
- Les colonnes existantes qui ne sont pas spécifiées dans la commande ne seront pas supprimées du schéma de la table existante.
- Les colonnes existantes spécifiées avec un type de données dans la commande différente de celle des schémas de la table existante entraînent un échec. Aucune table n’est créée.
Exemple
.create-merge tables
MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
MyUsers (UserId:string, Name:string)
Sortie
| tableName | nom_base_de_données | Dossier | DocString |
|---|---|---|---|
| MyLogs | TopComparison | ||
| MyUsers | TopComparison |