Modifier un schéma de table

Dans cet article, vous allez apprendre à renommer des tables et à modifier le schéma d’une table en ajoutant, en renommant et en supprimant des colonnes. Il décrit les implications et les dépendances des modifications de schéma de table sur les objets et mappages référencés.

Avertissement

  • Les ingestions existantes, les mappages d’ingestion, les stratégies de mise à jour, les fonctions, les exportations, les vues matérialisées et d’autres opérations associées peuvent échouer après avoir modifié le schéma de table. Consultez dépendances et veillez à modifier l’implémentation des mappages d’ingestion, mettre à jour les stratégies, les fonctions, l’exportation et les vues matérialisées en conséquence.

Dépendances

La modification du schéma de table peut entraîner des échecs d’ingestion et de requête en raison de dépendances qui référencent le nom de la table ou les colonnes de table. La matrice suivante indique les implications des modifications de schéma.

Modification du schéma Dépendance
Renommage des tables Vues matérialisées :
* Par défaut, toutes les vues matérialisées qui référencent directement l’ancien nom de table sont mises à jour pour pointer vers le nouveau nom, de manière transactionnelle.
* Si le nom de la table est référencé à partir d’une fonction stockée appelée par la requête d’affichage, vous devez mettre à jour manuellement la référence de vue matérialisée à l’aide de .alter materialized-view.
Renommage des colonnes * Le changement de nom d’une colonne met automatiquement à jour toutes les références dans les mappages d’ingestion.
* Le changement de nom d’une colonne préserve les transformations existantes dans vos mappages.
Ajout de colonnes * L’ajout d’une nouvelle colonne ne met pas automatiquement à jour les mappages d’ingestion. Si vous souhaitez que la nouvelle colonne soit incluse, vous devez mettre à jour manuellement les mappages.
* La modification du schéma ne met pas à jour le mappage des données entrantes aux colonnes de table pendant l’ingestion.
* Après avoir ajouté des colonnes, veillez à mettre à jour le mappage afin que les données soient ingérées correctement.
Pour plus d'informations sur la mise à jour du mappage d'ingestion, consultez la commande .alter ingestion mapping
Type de colonne La modification d’un type de colonne n’est pas prise en charge à l’aide de l’option Modifier le schéma de table, car la modification d’un type de colonne entraîne une perte de données.
Suppression de colonnes * La suppression d’une colonne supprime la colonne de tous les mappages d’ingestion.
* La suppression d’une colonne est irréversible et provoque une perte de données. Vous ne pouvez pas interroger les données dans la colonne supprimée.
* Prudence Si vous supprimez une colonne, enregistrez-la, puis ajoutez-la à nouveau, les données ne sont pas restaurées. Il se comporte comme une colonne neuve et les mappages d'ingestion ne sont pas actualisés. Vous devez mettre à jour manuellement les mappages d’ingestion.

Conditions préalables

Renommer une table

Lorsque vous renommez une table, toutes les références à cette table dans vos mappages d’ingestion sont automatiquement mises à jour. Dans certains cas, vous devez mettre à jour manuellement les mappages de tables et les références. Avant de renommer une table, passez en revue les dépendances.

  1. Accédez à votre base de données KQL souhaitée, puis, dans le volet Explorateur, développez Tables.

  2. Sélectionnez un tableau dans la liste, puis ouvrez le menu Plus [...].

    Capture d’écran du menu Plus du tableau avec Modifier le schéma mis en surbrillance.

  3. Dans la fenêtre Modifier le schéma de table , modifiez le nom de la table. Si vous le souhaitez, modifiez la description de la table.

    Capture d’écran du schéma de modification de la table avec le champ nom de la table mis en surbrillance.

  4. Dans la section Dépendances , passez en revue les objets référencés.

    • Par défaut, la mise à jour automatique des vues matérialisées est activée. Vous pouvez afficher les mises à jour de la commande dans la visionneuse de commandes.

    • Si nécessaire, désactivez la mise à jour automatique des vues matérialisées. Veillez à passer en revue les implications dans Les dépendances et à mettre à jour manuellement le mappage d’ingestion de table si nécessaire.

    Capture d’écran de la visionneuse de commandes et de la section dépendances avec le commutateur Mise à jour automatique des vues matérialisées mis en surbrillance.

  5. Sélectionnez Mettre à jour et, dans la fenêtre de confirmation, entrez à nouveau le nom de la table, puis sélectionnez Modifier le schéma de table.

    Capture d’écran de la fenêtre de confirmation avec le champ nom de la table mis en surbrillance.

Modifier les colonnes de table

Lorsque vous renommez ou ajoutez des colonnes à une table, toutes les références à cette table dans vos mappages d’ingestion sont automatiquement mises à jour. Dans certains cas, vous devez mettre à jour manuellement les mappages de tables et les références. Avant de modifier les colonnes de la table, passez en revue les dépendances.

  1. Accédez à votre base de données KQL souhaitée. Dans le volet Explorateur, développez Tables.

  2. Sélectionnez un tableau dans la liste, puis ouvrez le menu Plus [...].

    Capture d’écran du menu Plus du tableau avec Modifier le schéma mis en surbrillance.

  3. Pour ajouter une nouvelle colonne, entrez un nom de colonne en bas de la liste des colonnes. Le nom de colonne doit commencer par une lettre et peut contenir des nombres, des points, des traits d’union ou des traits de soulignement.

  4. Sélectionnez un type de données pour votre colonne. Le type de colonne par défaut est string mais vous pouvez le modifier dans le menu déroulant du champ Type de colonne .

  5. Sélectionnez Ajouter une colonne pour ajouter d’autres colonnes.

  6. Dans la section Dépendances , passez en revue les objets référencés.

    • Par défaut, les mappages de mise à jour automatique sont activés . Vous pouvez afficher les mises à jour de la commande de mappage d’ingestion dans la visionneuse de commandes.

    • Si nécessaire, désactivez les mappages de mise à jour automatique. Veillez à passer en revue les implications dans Les dépendances et à mettre à jour manuellement le mappage d’ingestion de table si nécessaire.

    Capture d’écran de la visionneuse de commandes avec mappages de mise à jour automatique activés dans la section dépendances.

  7. Si nécessaire, mettez à jour le mappage d’ingestion des données.

Contenu connexe

  • Last updated on