commande .create-merge table
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Crée une table ou étend une table existante.
La commande doit s’exécuter 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-mergetableName 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 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
Si la table n’existe pas, fonctionne exactement comme .create table commande.
Si la table T existe et que vous envoyez une .create-merge table T (<columns specification>) commande, puis :
- Toute colonne de <la spécification> des colonnes qui n’existait pas précédemment dans T sera ajoutée à la fin du schéma de T.
- Toute colonne dans T qui n’est pas dans <la spécification> des colonnes ne sera pas supprimée de T.
- Toute colonne de la spécification> de <colonnes qui existe dans T, mais avec un type de données différent entraîne l’échec de la commande.