commande .alter-merge table
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
La commande .alter-merge table :
- Sécurise les données dans les colonnes existantes
- Ajoute de nouvelles colonnes,
docstringet un dossier à une table existante - Doit s’exécuter dans le contexte d’une base de données spécifique qui étend le nom de la table
autorisations
Vous devez disposer au moins des autorisations d’administrateur de table pour exécuter cette commande.
Syntaxe
.alter-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 à modifier. |
| columnName, columnType | string |
✔️ | Nom d’une colonne existante ou nouvelle 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. |
Remarque
Si vous essayez de modifier un type de colonne, la commande échoue. Utilisez .alter column à la place.
Conseil
Permet .show table [tableName] cslschema d’obtenir le schéma de colonne existant avant de le modifier.
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. |
Impact de la commande sur les données
- Les données existantes ne seront pas modifiées ou supprimées
- De nouvelles colonnes seront ajoutées à la fin du schéma
- Les données dans les nouvelles colonnes sont supposées être null
Exemples
.alter-merge table MyTable (ColumnX:string, ColumnY:int)
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")
Contenu connexe
Utilisez la .alter commande table lorsque vous souhaitez redéfinir davantage les paramètres de la table. Pour plus d’informations, consultez la table .alter.