Upgrade de systeembestandsversie van een warehouse in een Git-geïntegreerde Fabric-werkruimte

Van toepassing op: ✅ Warehouse in Microsoft Fabric

Dit artikel beschrijft hoe je magazijnitems kunt upgraden naar de nieuwste systeembestandsversie in een Git-geïntegreerde Fabric-werkruimte.

Important

Deze functie is beschikbaar als preview-versie.

Microsoft Fabric werkt periodiek de onderliggende itemdefinitie bij voor itemtypes, inclusief het magazijn. Wanneer deze itemdefinitie verandert, wordt de config.version waarde in het .platform bestand van het item verschoven, bijvoorbeeld van 1.0 naar 2.0. Om te voorkomen dat je bestaande warehousewijzigingen wordt gebroken, past Fabric deze update niet automatisch toe. In plaats daarvan toont Fabric een melding van de beschikbare systeemupdate in Source control en laat je kiezen wanneer je de update toepast voor een specifiek itemtype, zoals magazijn.

Screenshot uit het Fabric-portaal van de beschikbare banner voor System-updates in het Broncode-beheerpaneel.

Prerequisites

Identificeer dat er een systeembestandsupdate beschikbaar is

De config.version waarde en de $schema URL bevatten de huidige systeembestandsversie voor een warehouse.

  1. Ga naar je Git-verbonden werkruimte en selecteer Source control.

  2. Als er een systeemupdate beschikbaar is voor het type magazijnitem, toont Fabric bovenaan het Source control-paneel een systeemupdate-banner.

    Je kunt ook de huidige systeembestandsversie van een warehouse bevestigen door de config.version eigenschap in het .platform bestand van het item in je Git-repository te inspecteren. Bijvoorbeeld, het volgende .platform bestand voor een warehouse met naam dw toont een systeembestandsversie van 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"
    }
}

Voor meer informatie over het .platform bestand, zie Automatisch gegenereerde systeembestanden.

Comm bestaande wijzigingen voordat je systeembestandsupdates toepast

Voordat je kiest voor systeemupdates toepassen, committe je eventuele openstaande wijzigingen in je werkruimte.

Als je systeemupdates toepast en je eigen warehousewijzigingen samen committed, wordt het later moeilijker om de twee sets wijzigingen te scheiden. Als je eerst je bestaande wijzigingen commit, verschijnt de systeembestandsupdate als een op zichzelf staande, geïsoleerde commit. Deze scheiding maakt het makkelijker om de systeemupdate te herzien en indien nodig terug te draaien zonder je eigen wijzigingen te beïnvloeden.

  1. Ga naar Source control in de Fabric-werkruimte.
  2. Bekijk de openstaande wijzigingen in de lijst met wijzigingen .
  3. Selecteer de items die je wilt commiten, voeg een commit-bericht toe en commit de wijzigingen in de Git-repository.

Voor meer informatie over het committen van wijzigingen, zie Make changes and commmit warehouse-updates naar Git.

Pas systeemupdates toe

Nadat je je bestaande wijzigingen hebt vastgezet, pas je de systeemupdate toe.

  1. Selecteer in Broncodebeheersysteemupdates toepassen.

    Screenshot van het Fabric-portaal toont de voortgangsmelding Applying systemupdates.

  2. Fabric past de systeemupdate toe op elk magazijn van dat itemtype in de werkruimte. Als je meerdere magazijnen hebt, worden ze allemaal tegelijk bijgewerkt. Je kunt geen individuele magazijnen selecteren om te updaten.

  3. Wacht tot de melding voor systeemupdates aanvragen is afgerond.

Bekijk en commi de systeemupdate

Wanneer de systeemupdate klaar is met aanbrengen, bekijk dan de verschillen voordat je ze vastlegt.

  1. Ga in Source Control naar de lijst met Wijzigingen . Elk bijgewerkt magazijn verschijnt als een lopende wijziging.

  2. Selecteer een magazijn en selecteer vervolgens 'Controleren en commit wijzigingen ' om de nieuwste itemdefinitie te vergelijken met je huidige versie. Je kunt het .sqlproj bestand vergelijken met andere systeembestanden om precies te zien wat er is veranderd, bijvoorbeeld een bijgewerkte Sdk versie.

    Maak een screenshot van het Fabric-portaal van het dialoog Review en commit changes, waarbij de huidige workspace-versie wordt vergeleken met de laatst gesynchroniseerde versie.

  3. Nadat je hebt bevestigd dat de wijzigingen verwacht worden, selecteer je de warehouse-items, voeg je een commit-bericht toe en selecteer je Commit om de systeemupdate in de Git-repository te commiten.

Als je meerdere magazijnen in de werkruimte hebt, tonen ze allemaal dezelfde systeemupdate. Bekijk en committeer elk magazijn op dezelfde manier, afzonderlijk of samen, om zeker te zijn dat elk magazijn is geüpgraded naar de nieuwste versie.

Geschiedenis van het updatesysteem van het magazijnsysteem

Voor een geschiedenis en release-notities van de versiegeschiedenis van het systeembestand, zie Release notes voor Fabric Data Warehouse systeembestand.

Verwante onderwerpen

  • Last updated on