Magazijnprojecten ontwikkelen in Visual Studio Code

Van toepassing op:✅ Warehouse in Microsoft Fabric

Informatie over het instellen van een databaseproject voor Fabric Data Warehouse in Visual Studio Code. U maakt een nieuw project, definieert schemaobjecten, bouwt en valideert het project en publiceert het naar uw magazijn.

Vereiste voorwaarden

Voordat u begint, moet u het volgende doen:

• Toegang tot een bestaand magazijnitem binnen een Fabric-werkruimte met bijdrager- of hogere machtigingen.
  • Zie Een voorbeeldwarehouse maken in Microsoft Fabric om een nieuw voorbeeldwarehouse te maken.
• Installeer Visual Studio Code op uw werkstation.
• Installeer de .NET SDK om databaseprojecten te bouwen en te publiceren.
• Installeer twee Visual Studio Code-extensies: SQL Database Projects en SQL Server (mssql).
  • U kunt de vereiste extensies rechtstreeks vanuit Visual Studio Code Marketplace installeren door te zoeken naar 'SQL Database Projects' of 'SQL Server (mssql)'.

Een nieuw databaseproject maken

U kunt een volledig nieuw databaseproject of een bestaand magazijn maken.

Optie 1: Een nieuw databaseproject maken op basis van het opdrachtenpalet in Visual Studio Code

1. Open Visual Studio Code.

2. Open het opdrachtpalet (Ctrl+Shift+P of Cmd+Shift+P op de Mac).

3. Zoek naar Databaseprojecten: Nieuw.

4. Selecteer Databaseprojecttype als SQL Server database.

5. Kies een projectnaam en selecteer de locatie van de lokale map.

6. Kies Synapse Data Warehouse in Microsoft Fabric als doelplatform.

7. Wanneer u hierom wordt gevraagd, selecteert u Ja (aanbevolen) voor een SDK-project.

   Belangrijk

   Alleen SDK-projecten worden ondersteund voor Fabric Data Warehouse.

8. Selecteer Ja op de vraag Wilt u de build van het SQL-project configureren als de standaard buildconfiguratie voor deze map?

9. Selecteer Ja als u de auteurs van de bestanden in deze map wilt vertrouwen.

Optie 2: Een nieuw databaseproject maken op basis van de extensie Databaseprojecten

1. Kies in Visual Studio Code het pictogram databaseprojecten-extensie op de activiteitenbalk.

2. Selecteer nieuwe maken in het deelvenster Databaseprojecten.

   

3. Selecteer Databaseprojecttype als SQL Server database.

4. Kies een projectnaam en selecteer de locatie van de lokale map.

5. Kies Synapse Data Warehouse in Microsoft Fabric als doelplatform.

6. Wanneer u hierom wordt gevraagd, selecteert u Ja (aanbevolen) voor een SDK-project. Alleen SDK-projecten worden ondersteund voor Fabric Data Warehouse.

7. Selecteer Ja op de vraag Wilt u de build van het SQL-project configureren als de standaard buildconfiguratie voor deze map?

8. Selecteer Ja als u de auteurs van de bestanden in deze map wilt vertrouwen.

Optie 3: Een databaseproject maken op basis van een bestaand magazijn

1. Maak eerst een nieuw verbindingsprofiel voor uw magazijn in Visual Studio Code.

   1. Selecteer de SQL Server-extensie in Visual Studio Code op de activiteitenbalk.
   2. Geef een profielnaam op. Kies Parameters.
   3. Geef de servernaam op. Haal in de Fabric-portal in de instellingen van uw magazijn de tekenreeks van het SQL-eindpunt op. (Dit verschilt van het SQL Analytics-eindpunt.) Het lijkt erop <server unique ID>.datawarehouse.fabric.microsoft.com. Dit is de servernaam.
   4. Voor verificatietype gebruikt u Microsoft Entra ID - Universeel met MFA-ondersteuning. Verifieer met uw Microsoft Entra-id.
   5. Geef andere informatie op als standaard of gewenst en selecteer Verbinding maken.

2. Kies in Visual Studio Code het pictogram databaseprojecten-extensie op de activiteitenbalk.

3. Selecteer de knop ... Opties in het deelvenster Databaseprojecten en kies De optie Project maken uit database .

   

4. Kies uw magazijn uit de bestaande verbindingsprofielen.

5. Geef een projectnaam op en kies een projectmap op uw werkstation.

6. Voor mapstructuur selecteert u Schema/Objecttype (aanbevolen).

7. Selecteer Nee (standaard) voor Machtigingen opnemen in project.

8. Selecteer Ja (aanbevolen) voor een SDK-project.

9. Selecteer Ja op de vraag Wilt u de build van het SQL-project configureren als de standaard buildconfiguratie voor deze map?

10. Visual Studio Code extraheert projectbestanden uit het magazijnproject.

    

11. Wanneer het extraheren is voltooid, ziet u de volgende melding: 'Projectbestanden extraheren: Geslaagd. Voltooid".

12. Selecteer Ja als u de auteurs van de bestanden in deze map wilt vertrouwen.

Nieuw databaseproject voor uw magazijn

Het nieuwe databaseproject voor uw magazijn wordt weergegeven in het menu SQL Database Projects.

Uw projectstructuur ziet er als volgt uit:

 | Project Name
 ├── Database References
 ├── SQLCMD Variables
 ├── .vscode/
 └── schema/
     ├── Functions
     ├── Tables
     └── Views

Het databaseproject configureren

1. Klik met de rechtermuisknop op het project en selecteer .sqlproj-bestand bewerken.

   

2. Controleer of de nieuwste versie van Microsoft.Build.Sql SDK zich in het bestand bevindt. Wijzig bijvoorbeeld in het .sqlproj-bestand de versie van Microsoft.Build.Sql naar 2.0.0.

      <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />
   

3. Controleer de nieuwste versie van Microsoft.SqlServer.Dacpacs.FabricDw en voeg een verwijzing toe in het Project/ItemGroup XML-knooppunt. Voorbeeld:

      <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />
   

   Dit is hoe uw databaseproject voor een magazijn eruit moet zien na de updates.

    <?xml version="1.0" encoding="utf-8"?>
    <Project DefaultTargets="Build">
      <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />
      <PropertyGroup>
        <Name>DatabaseProject715wh</Name>
        <ProjectGuid>{2E278BCC-F118-4DDB-9255-94697F2930B4}</ProjectGuid>
        <DSP>Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider</DSP>
        <ModelCollation>1033, CI</ModelCollation>
      </PropertyGroup>
      <ItemGroup>
        <None Include=".vscode\tasks.json" />
        <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />
      </ItemGroup>
      <Target Name="BeforeBuild">
        <Delete Files="$(BaseIntermediateOutputPath)\project.assets.json" />
      </Target>
    </Project>
   

4. Sla het .sqlproj bestand op. Selecteer Ja bij de prompt om uw databaseproject opnieuw te laden.

Belangrijk

Het Fabric Data Warehouse-team brengt regelmatig nieuwe versies van NuGet-pakketten uit. Aangezien de standaardversiewaarden in het .sqlproj bestand na verloop van tijd kunnen worden gewijzigd, moet u deze in uw lokale project bijwerken om te blijven afgestemd op de nieuwste versies die beschikbaar zijn via de NuGet voor Microsoft.SqlServer.Dacpacs.FabricDw.

Databaseobjecten toevoegen of bijwerken

U kunt databaseobjecten definiëren of wijzigen, zoals tabellen, weergaven, opgeslagen procedures en functies binnen uw magazijnproject.

Voeg onder de map voor een schema, bijvoorbeeld dbo, de T-SQL-definities van objecten in uw magazijn toe, verwijder deze of breng wijzigingen aan. Als u een bestaand object wilt wijzigen, opent u het bijbehorende .sql bestand en werkt u de definitie zo nodig bij.

Wanneer u het project bouwt, worden alle nieuwe en bijgewerkte objecten gevalideerd en opgenomen in het gegenereerde dacpac-bestand in {project folder location}/bin/debug/{project name}.dacpac het bestand.

Wijzigingen die hier worden aangebracht, zijn alleen zichtbaar in het databaseproject en worden pas doorgevoerd in Microsoft Fabric als u uw project bouwt en publiceert .

Het project bouwen en valideren

1. Open het databaseproject als dit nog niet is geopend.

2. Klik met de rechtermuisknop op het project en selecteer Build om het databaseproject te bouwen.

   

3. De build zou succesvol moeten zijn. Los eventuele fouten op op basis van berichten in de uitvoer van de build-gebeurtenis.

Opmerking

Op dit moment moet de standaardterminal van Visual Studio Code PowerShell zijn voor het buildproces in de extensie Databaseprojecten. Kies Terminal in het opdrachtpalet: Selecteer Standaardprofiel en selecteer vervolgens PowerShell.

Publiceren naar Fabric Data Warehouse

Nadat u uw project hebt gebouwd, publiceert u het naar uw doelwarehouse. Publiceren genereert een script om het verschil tussen het gegevensbankproject en het actuele data warehouse op te lossen en voert een script uit om het data warehouse in overeenstemming te brengen met het project. Het gecompileerde model van het magazijnschema in een DACPAC-bestand kan worden geïmplementeerd in een doelwarehouse.

1. Klik met de rechtermuisknop op het project en selecteer Publiceren.

2. Kies Publiceren naar een bestaande SQL-server.

3. Als u het publicatieprofiel wilt selecteren om te laden, kiest u de eerste keer dat u publiceert het profiel niet gebruiken.

   • U kunt opties voor het publiceren van uw magazijn opslaan in een publicatieprofiel. Wanneer u klaar bent, krijgt u de optie in een Visual Studio Code-melding om de publicatieopties op te slaan die u zojuist hebt gebruikt voor een publicatieprofielbestand.
   • U kunt het publicatieprofiel in de toekomst opnieuw gebruiken wanneer u uw project naar uw opslagplatform publiceert. Mogelijk hebt u verschillende profielopties voor verschillende magazijnen of voor verschillende omgevingen in uw ontwikkel-/test-/acceptatie-/productieontwikkelingsomgevingen.

4. Kies het verbindingsprofiel voor Fabric Data Warehouse in de lijst.

5. Kies de naam van het doelwarehouse.

6. In de optie Actie Kiezen kunt u Een script genereren om het script te controleren voordat u het publiceert of een project publiceren naar een magazijn.

   • De eerste keer dat u wijzigingen wilt implementeren, moet u het script zorgvuldig genereren en de resulterende T-SQL controleren die moet worden toegepast op het doelwarehouse. Er worden geen wijzigingen aangebracht in het doelwarehouse.
   • Als u Publiceren kiest, worden wijzigingen naar uw doelwarehouse geschreven.

   

7. Kies In de melding Wilt u de instellingen opslaan in een profiel (.publish.xml)?, kies Ja en sla uw publicatieprofielkeuzes op voor de volgende keer dat u wilt publiceren.

Belangrijke implementatie-instellingen voor magazijnprojecten

Bij het implementeren van databaseprojecten in Fabric Data Warehouse bepalen verschillende instellingen schemawijzigingen en kan dit van invloed zijn op de veiligheid van gegevens. Wees voorzichtig.

• BlockOnPossibleDataLoss

  • Wat het doet: Voorkomt implementatie als er een risico bestaat op gegevensverlies (bijvoorbeeld het verwijderen van een kolom of tabel die gegevens bevat).
  • Aanbeveling: Altijd ingesteld op True in productie om kritieke gegevens te beveiligen.
  • Voorzichtigheid: Door het hierop in te stellen, wordt implementatie mogelijk, zelfs als gegevens verloren kunnen gaan. Gebruik alleen in gecontroleerde omgevingen (bijvoorbeeld dev/test).

• DropObjectsNotInSource

  • Wat het doet: Hiermee worden objecten in de doeldatabase verwijderd die niet aanwezig zijn in de projectbron.
  • Aanbeveling: Gebruik in ontwikkel-/testomgevingen om restobjecten op te schonen.
  • Voorzichtigheid: Als u DropObjectsNotInSource in productie gebruikt, kunnen belangrijke objecten en gegevens worden verwijderd. Controleer dit voordat u deze inschakelt.

• Pre-Deployment Scripts

  • Wat het doet: Voert aangepaste SQL-scripts uit vóór de schema-implementatie.
  • Veelgebruikte toepassingen:
    • Gegevens archiveren of back-ups maken voordat tabellen worden verwijderd
    • Beperkingen of triggers tijdelijk uitschakelen
    • Verouderde objecten opschonen
  • Voorzichtigheid: Zorg ervoor dat scripts idempotent zijn en geen schemawijzigingen introduceren die conflicteren met de implementatie.

Aanbeveling

Wanneer een implementatieproces idempotent is, kan het meerdere keren worden uitgevoerd zonder problemen te veroorzaken en kunt u implementeren naar meerdere databases zonder de status vooraf te hoeven bepalen.

• Post-Deployment Scripts

  • Wat het doet: Voert aangepaste SQL-scripts uit na de schema-implementatie.
  • Veelgebruikte toepassingen:
    • Zoekopdracht of referentiegegevens
    • Beperkingen of triggers opnieuw inschakelen
    • Logboekimplementatiegeschiedenis
  • Voorzichtigheid: Vermijd zware bewerkingen op grote tabellen in productie; zorg ervoor dat scripts indien nodig veilig kunnen worden uitgevoerd.

Belangrijk

Controleer altijd implementatiescripts en -instellingen voordat u publiceert. Test eerst in ontwikkel-/testomgevingen om onbedoeld gegevensverlies te voorkomen.

Publiceren controleren

Maak verbinding met uw magazijn- en scriptobjecten die zijn gewijzigd of geverifieerd door systeemcatalogusobjecten uit te voeren.

Verwante artikelen

• Werkstromen voor ontwikkeling en implementatie
• Afhankelijkheden tussen magazijnen ontwikkelen en implementeren
• Aan de slag met Fabric-implementatiepijplijnen