Mettre à jour la version système d’un entrepôt dans un espace de travail intégré Git Fabric

S’applique à : ✅ Entrepôt dans Microsoft Fabric

Cet article décrit comment mettre à jour les éléments d’entrepôt vers la dernière version du fichier système dans un espace de travail Fabric intégré Git.

Important

Cette fonctionnalité est en version préliminaire.

Microsoft Fabric met à jour périodiquement la définition sous-jacente des types d’articles, y compris l’entrepôt. Lorsque cette définition d’élément change, la config.version valeur dans le fichier de l’élément .platform est déplacée, par exemple de 1.0 vers 2.0. Pour éviter de casser les changements existants de votre entrepôt, Fabric n'applique pas automatiquement cette mise à jour. À la place, Fabric affiche un avis de disponibilité à la mise à jour système dans le contrôle de version et vous permet de choisir quand appliquer la mise à jour pour un type d’article spécifique, comme entrepôt.

Capture d’écran du portail Fabric de la bannière disponible de mise à jour système dans le panneau de contrôle de version.

Prerequisites

Identifiez qu’une mise à jour du fichier système est disponible

La config.version valeur et l’URL $schema contiennent la version actuelle du fichier système pour un entrepôt.

  1. Allez dans votre espace de travail connecté à Git, et sélectionnez Contrôle de version.

  2. Si une mise à jour système est disponible pour le type d’article d’entrepôt, Fabric affiche une bannière de mise à jour système disponible en haut du panneau de contrôle de source (Source control pan).

    Vous pouvez également confirmer la version actuelle du fichier système pour un entrepôt en inspectant la config.version propriété dans le fichier de l’article .platform dans votre dépôt Git. Par exemple, le fichier suivant .platform pour un entrepôt nommé dw montre une version système de 2.0:

    {
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
    "metadata": {
        "type": "Warehouse",
        "displayName": "dw"
    },
    "config": {
        "version": "2.0",
        "logicalId": "5e477a9e-0e1a-bf9b-4eb8-33420d62f352"
    }
}

Pour plus d’informations sur le .platform fichier, voir Fichiers système générés automatiquement.

Validez les modifications existantes avant d’appliquer des mises à jour des fichiers système

Avant de sélectionner Appliquer les mises à jour système, commencez les modifications en attente dans votre espace de travail.

Si vous appliquez des mises à jour système et commoutez vos propres modifications d’entrepôt, il devient plus difficile de séparer les deux ensembles de modifications plus tard. Si vous commencez par effectuer vos modifications existantes, la mise à jour du fichier système apparaît comme une validation isolée à part entière. Cette séparation facilite la révision et, si nécessaire, la remise à jour du système sans affecter vos propres modifications.

  1. Allez dans le contrôle de version dans l’espace de travail Fabric.
  2. Examinez les modifications en cours dans la liste des Changements .
  3. Sélectionnez les éléments que vous souhaitez valider, ajoutez un message de commit, puis validez les modifications dans le dépôt Git.

Pour plus d’informations sur l’envoi de modifications, consultez Faire des modifications et des mises à jour de l’entrepôt sur Git.

Appliquer les mises à jour système

Après avoir validé vos modifications existantes, appliquez la mise à jour système.

  1. Dans le contrôle de version, sélectionnez Appliquer les mises à jour système.

    Capture d’écran du portail Fabric montrant la notification de progression Appliquer les mises à jour système.

  2. Fabric applique la mise à jour système à chaque entrepôt de ce type d’article dans l’espace de travail. Si vous avez plusieurs entrepôts, ils sont tous mis à jour en même temps. Vous ne pouvez pas sélectionner des entrepôts individuels pour les mettre à jour.

  3. Attendez que la notification de mise à jour système d’application soit terminée.

Examiner et valider la mise à jour système

Lorsque la mise à jour système sera terminée, examinez les différences avant de les valider.

  1. Dans le contrôle de version, allez dans la liste des changements. Chaque entrepôt mis à jour apparaît comme un changement en attente.

  2. Sélectionnez un entrepôt, puis sélectionnez Examiner et valider les modifications pour comparer la dernière définition d’article avec votre version actuelle. Vous pouvez comparer le fichier et d’autres .sqlproj fichiers système pour voir exactement ce qui a changé, comme une version mise à jour Sdk .

    Faites une capture d’écran du portail Fabric de la critique et commit la boîte de dialogue de modifications en comparant la version actuelle de l’espace de travail avec la dernière version synchronisée.

  3. Après avoir confirmé que les changements sont attendus, sélectionnez les éléments de l’entrepôt, ajoutez un message de validation, puis sélectionnez Commit pour valider la mise à jour système dans le dépôt Git.

Si vous avez plusieurs entrepôts dans l’espace de travail, ils affichent tous la même mise à jour système. Examinez et commencez chaque entrepôt de la même manière, individuellement ou ensemble, pour vous assurer que chaque entrepôt est mis à jour vers la dernière version.

Historique des mises à jour du système d’entrepôt

Pour un historique et des notes de version du fichier système, voir Notes de version pour Fabric Data Warehouse fichier système.

Contenu connexe

  • Last updated on