commande .alter-merge table

Changer de service à l’aide de la liste déroulante Version . En savoir plus sur la navigation.
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 columnNametable

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.