Uppgradera systemfilversionen av ett lager i en Git-integrerad Fabric-arbetsyta

Gäller för: ✅ Warehouse i Microsoft Fabric

Den här artikeln beskriver hur man uppgraderar lagervaror till den senaste systemfilversionen i en Git-integrerad Fabric-arbetsyta.

Important

Den här funktionen är i förhandsversion.

Microsoft Fabric uppdaterar periodiskt den underliggande artikeldefinitionen för artikeltyper, inklusive lagret. När denna elementdefinition ändras config.version höjs värdet i objektets .platform fil, till exempel från 1.0 till .2.0 För att undvika att bryta dina befintliga lagerändringar applicerar inte Fabric denna uppdatering automatiskt. Istället visar Fabric en Notis om Systemuppdatering iVersionskontroll och låter dig välja när uppdateringen ska tillämpas för en specifik artikeltyp, såsom lager.

Skärmdump från Fabric-portalen av Systemuppdateringens tillgängliga banner i Versionskontrollpanelen.

Förutsättningar

Identifiera att en systemfiluppdatering är tillgänglig

Värdet config.version och URL:en $schema innehåller den aktuella systemfilversionen för ett lager.

  1. Gå till din Git-anslutna arbetsyta och välj Versionskontroll.

  2. Om en systemuppdatering finns tillgänglig för lagerartikeltypen visar Fabric en systemuppdaterings-tillgänglig banner högst upp i källkontrollpanelen.

    Du kan också bekräfta den aktuella systemfilversionen för ett lager genom att inspektera egenskapen config.version i objektets .platform fil i ditt Git-arkiv. Till exempel visar följande .platform fil för ett lager med namnet dw en systemfilversion av 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"
        }
    }
    

För mer information om filen .platform , se Automatiskt genererade systemfiler.

Commit befintliga ändringar innan du applicerar systemfiluppdateringar

Innan du väljer Tillämpa systemuppdateringar, committa eventuella väntande ändringar i din arbetsyta.

Om du applicerar systemuppdateringar och committar dina egna lagerändringar tillsammans blir det svårare att separera de två uppsättningarna av ändringar senare. Om du committar dina befintliga ändringar först visas systemfiluppdateringen som en egen, isolerad commit. Denna separation gör det enklare att granska och vid behov återställa systemuppdateringen utan att påverka dina egna ändringar.

  1. Gå till Versionskontroll i Fabric-arbetsytan.
  2. Gå igenom de väntande ändringarna i listan Ändringar .
  3. Välj de objekt du vill commita, lägg till ett commit-meddelande och commit ändringarna till Git-arkivet.

För mer information om hur du committar ändringar, se Gör ändringar och commit warehouse-uppdateringar till Git.

Tillämpa systemuppdateringar

Efter att du har genomfört dina befintliga ändringar, applicera systemuppdateringen.

  1. I Versionskontroll, välj Tillämpa systemuppdateringar.

    Skärmdump från Fabric-portalen som visar statusnotisen Applying system-uppdateringar.

  2. Fabric applicerar systemuppdateringen på varje lager av den artikeltypen i arbetsytan. Om du har flera lager uppdateras alla samtidigt. Du kan inte välja enskilda lager att uppdatera.

  3. Vänta på att notifikationen om att tillämpa systemuppdateringar är klar.

Granska och committa systemuppdateringen

När systemuppdateringen är klar med tillämpningen, granska skillnaderna innan du gör dem.

  1. I Versionshantering, gå till listan Ändringar . Varje uppdaterat lager visas som en väntande ändring.

  2. Välj ett lager och välj sedan Granska och commit changes för att jämföra den senaste artikeldefinitionen med din nuvarande version. Du kan jämföra .sqlproj filen och andra systemfiler för att se exakt vad som har ändrats, till exempel en uppdaterad Sdk version.

    Ta en skärmdump från Fabric-portalen i dialogen Review och commit changes som jämför den nuvarande workspace-versionen med den senast synkade versionen.

  3. När du bekräftat att ändringarna förväntas, välj lagerobjekten, lägg till ett commit-meddelande och välj Commit för att committa systemuppdateringen till Git-arkivet.

Om du har flera lager i arbetsytan visar alla samma systemuppdatering. Granska och committa varje lager på samma sätt, antingen individuellt eller tillsammans, för att säkerställa att varje lager är uppgraderat till den senaste versionen.

Uppdateringshistorik för lagersystem

För en historik och versionsanteckningar för systemfilens versionshistorik, se Versionsanteckningar för Fabric Data Warehouse systemfil.