Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. Les implications et les dépendances des modifications de schéma de table sur les objets référencés et les mappages sont décrites.
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 assurez-vous de modifier l'implémentation des mappages d'ingestion, de mettre à jour les politiques, 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. Les implications des modifications de schéma sont indiquées dans la matrice suivante.
| Modification du schéma | Dépendance |
|---|---|
| Renommage des tables |
Vues matérialisées : * Par défaut, toutes les vues matérialisées référençant 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 à jour automatiquement 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
- Un espace de travail doté d'une capacité activée par Microsoft Fabric
- Une base de données KQL avec des autorisations de modification
- Les modifications de schéma de table ne sont pas prises en charge lorsqu’il existe une connexion OneLake active. Désactivez la disponibilité de OneLake avant de renommer une table ou de modifier des colonnes de table. Vous pouvez l’activer ultérieurement et une nouvelle copie est enregistrée dans OneLake.
Renommer une table
Le changement de nom d’une table met automatiquement à jour toutes les références à celle-ci dans vos mappages d’ingestion. Dans certains cas, les mappages de tables et les références nécessitent une mise à jour manuelle. Passez en revue les dépendances avant de renommer une table.
Accédez à votre base de données KQL souhaitée, puis, dans le volet Explorateur, développez Tables.
Sélectionnez un tableau dans la liste, puis ouvrez le menu Plus [...].
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.
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.
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.
Modifier les colonnes de table
Le changement de nom et l’ajout de colonnes à une table met automatiquement à jour toutes les références à celle-ci dans vos mappages d’ingestion. Dans certains cas, les mappages de tables et les références nécessitent une mise à jour manuelle. Passez en revue les dépendances avant de modifier les colonnes de la table.
Accédez à votre base de données KQL souhaitée, puis, dans le volet Explorateur, développez Tables.
Sélectionnez un tableau dans la liste, puis ouvrez le menu Plus [...].
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.
Sélectionnez un type de données pour votre colonne. Le type de colonne par défaut est
string, mais peut être modifié dans le menu déroulant du type de colonne champ.Sélectionnez Ajouter une colonne pour ajouter d’autres colonnes.
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.
Si nécessaire, mettez à jour le mappage d’ingestion des données.
Contenu connexe
- Créer une table vide
- Mappage d’ingestion des données