Delen via


Broncodebeheer met Warehouse (preview)

In dit artikel wordt uitgelegd hoe Git-integratie- en implementatiepijplijnen werken voor magazijnen in Microsoft Fabric. Meer informatie over het instellen van een verbinding met uw opslagplaats, het beheren van uw magazijnen en het implementeren ervan in verschillende omgevingen. Broncodebeheer voor Fabric Warehouse is momenteel een preview-functie.

U kunt zowel Git-integratie - als implementatiepijplijnen gebruiken voor verschillende scenario's:

  • Gebruik Git- en SQL-databaseprojecten voor het beheren van incrementele wijzigingen, teamsamenwerking, doorvoergeschiedenis in afzonderlijke databaseobjecten.
  • Gebruik implementatiepijplijnen om codewijzigingen te promoten in verschillende preproductie- en productieomgevingen.

Git-integratie

Met Git-integratie in Microsoft Fabric kunnen ontwikkelaars hun ontwikkelprocessen, hulpprogramma's en best practices rechtstreeks integreren in het Fabric-platform. Hiermee kunnen ontwikkelaars die in Fabric ontwikkelen het volgende doen:

  • Back-up en versie van hun werk
  • Naar behoefte terugkeren naar vorige fasen
  • Samenwerken met anderen of alleen werken met Git-vertakkingen
  • De mogelijkheden van vertrouwde hulpprogramma's voor broncodebeheer toepassen om Fabric-items te beheren

Zie voor meer informatie over het Git-integratieproces:

Een verbinding met broncodebeheer instellen

Op de pagina Werkruimte-instellingen kunt u eenvoudig een verbinding met uw opslagplaats instellen om wijzigingen door te voeren en te synchroniseren.

  1. Zie Aan de slag met Git-integratie om de verbinding in te stellen. Volg de instructies om verbinding te maken met een Git-opslagplaats met Azure DevOps of GitHub als een Git-provider.
  2. Zodra u verbinding hebt gemaakt, worden uw items, inclusief magazijnen, weergegeven in het configuratiescherm Bron. Schermopname van de Fabric-portal van het magazijn in de instellingen voor broncodebeheer.
  3. Nadat u de magazijnexemplaren hebt verbonden met de Git-opslagplaats, ziet u de mapstructuur van het magazijn in de opslagplaats. U kunt nu toekomstige bewerkingen uitvoeren, zoals het maken van een pull-aanvraag.

Databaseprojecten voor een magazijn in Git

De volgende afbeelding is een voorbeeld van de bestandsstructuur van elk magazijnitem in de opslagplaats:

Schermopname van de Fabric-portal van een voorbeeldwarehouseschema.

Wanneer u het magazijnitem doorvoert in de Git-opslagplaats, wordt het magazijn geconverteerd naar een broncode-indeling, als een SQL-databaseproject. Een SQL-project is een lokale weergave van SQL-objecten die deel uitmaken van het schema voor één database, zoals tabellen, opgeslagen procedures of functies. De mapstructuur van de databaseobjecten is ingedeeld op schema/objecttype. Elk object in het magazijn wordt weergegeven met een .sql-bestand dat de DDL-definitie (Data Definition Language) bevat. Warehouse-tabelgegevens en SQL-beveiligingsfuncties zijn niet opgenomen in het SQL-databaseproject.

Gedeelde query's worden ook doorgevoerd in de opslagplaats en nemen de naam over die ze worden opgeslagen als.

Download het SQL-databaseproject van een magazijn in Fabric

Met de SQL Database Projects-extensie die beschikbaar is in Azure Data Studio en Visual Studio Code, kunt u een magazijnschema beheren en wijzigingen in warehouseobjecten verwerken, zoals andere SQL-databaseprojecten.

Als u een lokale kopie van het schema van uw magazijn wilt downloaden, selecteert u SQL Database-project downloaden op het lint.

Schermopname van de Fabric-portal van het querylint. Het projectvak SQL-database downloaden is gemarkeerd.

De lokale kopie van een databaseproject dat de definitie van het magazijnschema bevat. Het databaseproject kan worden gebruikt voor het volgende:

  • Maak het magazijnschema opnieuw in een ander magazijn.
  • Ontwikkel het magazijnschema verder in clienthulpprogramma's, zoals Azure Data Studio of Visual Studio Code.

SQL-databaseproject publiceren naar een nieuw magazijn

Het magazijnschema publiceren naar een nieuw magazijn:

  1. Maak een nieuw magazijn in uw Fabric-werkruimte.
  2. Selecteer op de nieuwe startpagina van het magazijn onder Een magazijn bouwen de optie SQL-databaseproject. Schermopname van de Fabric-portal van de knop SQL Database-project.
  3. Selecteer het .zip-bestand dat is gedownload uit het bestaande magazijn.
  4. Het magazijnschema wordt gepubliceerd naar het nieuwe magazijn.

Implementatiepijplijnen

U kunt ook implementatiepijplijnen gebruiken om uw magazijncode in verschillende omgevingen te implementeren, zoals ontwikkeling, test en productie. Implementatiepijplijnen maken geen databaseproject beschikbaar.

Gebruik de volgende stappen om uw magazijnimplementatie te voltooien met behulp van de implementatiepijplijn.

  1. Maak een nieuwe implementatiepijplijn of open een bestaande implementatiepijplijn. Zie Aan de slag met implementatiepijplijnen voor meer informatie.
  2. Wijs werkruimten toe aan verschillende fasen op basis van uw implementatiedoelen.
  3. Items selecteren, weergeven en vergelijken, inclusief magazijnen tussen verschillende fasen, zoals wordt weergegeven in het volgende voorbeeld. Schermopname van de Fabric-portal van de ontwikkelings-, test- en productiefasen.
  4. Selecteer Implementeren om uw magazijnen te implementeren in de fasen Ontwikkeling, Testen en Productie .

Zie Overzicht van infrastructuurimplementatiepijplijnen voor meer informatie over het proces voor infrastructuurimplementatiepijplijnen.

Beperkingen in broncodebeheer

Beperkingen in Git-integratie

  • Als u ALTER TABLE momenteel een beperking of kolom toevoegt in het databaseproject, wordt de tabel verwijderd en opnieuw gemaakt bij het implementeren, wat resulteert in gegevensverlies. Overweeg de volgende tijdelijke oplossing om de tabeldefinitie en -gegevens te behouden:
    • Maak een nieuwe kopie van de tabel in het magazijn, met behulp CREATE TABLE van en INSERT, CREATE TABLE AS SELECTof Kloontabel.
    • Wijzig de nieuwe tabeldefinitie met nieuwe beperkingen of kolommen, naar wens, met behulp van ALTER TABLE.
    • Verwijder de oude tabel.
    • Wijzig de naam van de nieuwe tabel in de naam van de oude tabel met behulp van sp_rename.
    • Wijzig de definitie van de oude tabel in het SQL-databaseproject op exact dezelfde manier. Het SQL-databaseproject van het magazijn in broncodebeheer en het livewarehouse moet nu overeenkomen.
  • Maak momenteel geen Dataflow Gen2 met een uitvoerbestemming naar het magazijn. Doorvoeren en bijwerken vanuit Git wordt geblokkeerd door een nieuw item met de naam DataflowsStagingWarehouse die wordt weergegeven in de opslagplaats.
  • Sql Analytics-eindpunt wordt niet ondersteund met Git-integratie.

Beperkingen voor implementatiepijplijnen

  • Als u ALTER TABLE momenteel een beperking of kolom toevoegt in het databaseproject, wordt de tabel verwijderd en opnieuw gemaakt bij het implementeren, wat resulteert in gegevensverlies.
  • Maak momenteel geen Dataflow Gen2 met een uitvoerbestemming naar het magazijn. De implementatie wordt geblokkeerd door een nieuw item met de naam DataflowsStagingWarehouse die wordt weergegeven in de implementatiepijplijn.
  • Het SQL Analytics-eindpunt wordt niet ondersteund in implementatiepijplijnen.