Partager via


commande .alter table

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

La commande .alter table :

  • Sécurise les données dans des colonnes « conservées »
  • Réorganiser les colonnes de table
  • Définit un nouveau schéma de colonne, docstringet un dossier sur une table existante, en remplaçant le schéma de colonne existant, docstringet le dossier
  • Doit s’exécuter dans le contexte d’une base de données spécifique qui étend le nom de la table

Avertissement

L’utilisation incorrecte de la .alter commande peut entraîner une perte de données.

autorisations

Vous devez disposer au moins des autorisations d’administrateur de table pour exécuter cette commande.

Syntaxe

.altertableName 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.

Avertissement

Les colonnes existantes qui ne sont pas spécifiées dans la commande sont supprimées. Cela peut entraîner une perte de données inattendue.

Conseil

Permet .show table [tableName] cslschema d’obtenir le schéma de table 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 dans les colonnes répertoriées dans la commande ne seront pas modifiées
  • Les données existantes dans les colonnes non répertoriées dans la commande seront 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
  • La table aura les mêmes colonnes, dans le même ordre, comme spécifié

Remarque

Si vous essayez de modifier un type de colonne, la commande échoue. Utilisez .alter column à la place.

Avertissement

  • L’ingestion des données qui ignore l’ordre des colonnes et se produit en parallèle avec .alter table les risques d’ingestion de données dans les colonnes incorrectes. Pour éviter cela, assurez-vous que l’ingestion utilise un objet de mappage ou arrête l’ingestion lors de l’exécution de la .alter table commande.
  • L’ingestion des données peut modifier le schéma de colonne d’une table. Veillez à ne pas supprimer accidentellement les colonnes souhaitées qui ont été ajoutées pendant l’ingestion.

Exemples

.alter table MyTable (ColumnX:string, ColumnY:int) 
.alter table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")
  • Utilisez .alter-merge quand vous souhaitez conserver les paramètres de la table et remplacer ou développer uniquement certaines colonnes. Pour plus d’informations, consultez la table .alter-merge.
  • Pour modifier la stratégie de rétention de table, consultez .alter table policy retention.
  • Pour modifier la stratégie de mise en cache de table, consultez la mise en cache de la stratégie de table .alter.
  • Pour modifier la stratégie de mise à jour de table, consultez la mise à jour de la stratégie .alter table.
  • Pour modifier la stratégie de fusion de table, consultez .alter table policy merge.