Udvikl lagerstedsprojekter i Visual Studio Code

Gælder for:✅ Warehouse i Microsoft Fabric

Få mere at vide om, hvordan du konfigurerer et databaseprojekt til Fabric Data Warehouse i Visual Studio Code. Du skal oprette et nyt projekt, definere skemaobjekter, opbygge og validere projektet og udgive det på dit lagersted.

Forudsætninger

Før du begynder, skal du sørge for at:

• Have adgang til en eksisterende lagerstedsvare i et stofarbejdsområde med bidragyder eller højere tilladelser.
  • Hvis du vil oprette et nyt eksempellagersted, skal du se Oprette et eksempellagersted i Microsoft Fabric.
• Installer Visual Studio Code på din arbejdsstation.
• Installer .NET SDK for at oprette og publicere databaseprojekter.
• Installer to Visual Studio Code-udvidelser: SQL Database Projects og SQL Server (mssql).
  • Du kan installere de nødvendige udvidelser direkte fra Visual Studio Code Marketplace ved at søge efter "SQL Database Projects" eller "SQL Server (mssql)".

Oprette et nyt databaseprojekt

Du kan oprette et databaseprojekt fra bunden eller et eksisterende lagersted.

Mulighed 1: Opret et nyt databaseprojekt fra kommandopaletten i Visual Studio Code

1. Åbn Visual Studio Code.

2. Åbn kommandopaletten (Ctrl+Shift+P eller Cmd+Shift+P på Mac).

3. Søg efter databaseprojekter: Ny.

4. Vælg Databaseprojekttype som SQL Server-database.

5. Vælg et projektnavn, og vælg placeringen af den lokale mappe.

6. Vælg Synapse Data Warehouse i Microsoft Fabric som destinationsplatform.

7. Når du bliver bedt om det, skal du vælge Ja (anbefales) for et SDK-projekt.

   Important

   Det er kun projekter i SDK-stil, der understøttes for Fabric Data Warehouse.

8. Vælg Ja til spørgsmålet Vil du konfigurere SQL-projektbuild som standardbuildkonfiguration for denne mappe?

9. Vælg Ja for at have tillid til forfatterne af filerne i denne mappe.

Mulighed 2: Opret et nyt databaseprojekt fra udvidelsen Databaseprojekter

1. I Visual Studio Code skal du vælge udvidelsesikonet Databaseprojekter på aktivitetslinjen.

2. I ruden Databaseprojekter skal du vælge Opret ny.

   

3. Vælg Databaseprojekttype som SQL Server-database.

4. Vælg et projektnavn, og vælg placeringen af den lokale mappe.

5. Vælg Synapse Data Warehouse i Microsoft Fabric som destinationsplatform.

6. Når du bliver bedt om det, skal du vælge Ja (anbefales) for et SDK-projekt. Det er kun projekter i SDK-stil, der understøttes for Fabric Data Warehouse.

7. Vælg Ja til spørgsmålet Vil du konfigurere SQL-projektbuild som standardbuildkonfiguration for denne mappe?

8. Vælg Ja for at have tillid til forfatterne af filerne i denne mappe.

Mulighed 3: Oprette et databaseprojekt fra et eksisterende lagersted

1. Først skal du oprette en ny forbindelsesprofil for dit lager i Visual Studio Code.

   1. Vælg SQL Server-udvidelsen i Visual Studio Code på aktivitetslinjen.
   2. Angiv et profilnavn. Vælg Parametre.
   3. Angiv servernavnet. Hent SQL-slutpunktsstrengen i Indstillinger for dit lagersted på Fabric-portalen. (Dette er forskelligt fra SQL-analyseslutpunktet). Det ligner <server unique ID>.datawarehouse.fabric.microsoft.com. Dette er servernavnet.
   4. Brug Microsoft Entra ID – Universal med MFA-understøttelse som Godkendelsestype. Godkend med dit Microsoft Entra-id.
   5. Angiv andre oplysninger som standard eller ønsket, og vælg Opret forbindelse.

2. I Visual Studio Code skal du vælge udvidelsesikonet Databaseprojekter på aktivitetslinjen.

3. Vælg indstillingsknappen ... i ruden Databaseprojekter , og vælg Opret projekt fra database .

   

4. Vælg dit lagersted blandt de eksisterende forbindelsesprofiler.

5. Angiv et projektnavn, og vælg en projektmappe på din arbejdsstation.

6. For mappestruktur skal du vælge Skema/objekttype (anbefales).

7. For Medtag tilladelser i projektet skal du vælge Nej (standard).

8. For SDK-projekt skal du vælge Ja (anbefales).

9. Vælg Ja til spørgsmålet Vil du konfigurere SQL-projektbuild som standardbuildkonfiguration for denne mappe?

10. Visual Studio Code udtrækker projektfiler fra lagerstedsprojekt.

    

11. Når udpakningen er gennemført, får du vist følgende meddelelse: "Udpak projektfiler: Fuldført. Afsluttet".

12. Vælg Ja for at have tillid til forfatterne af filerne i denne mappe.

Nyt databaseprojekt til dit lager

Det nye databaseprojekt for dit lagersted vises i menuen SQL Database-projekter.

Din projektstruktur ser sådan ud:

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

Konfigurere databaseprojektet

1. Højreklik på projektet, og vælg Rediger .sqlproj-fil.

   

2. Kontrollér, at den nyeste version af Microsoft.Build.Sql SDK er i filen. I filen skal du f.eks .sqlproj . ændre versionen for Microsoft.Build.Sql til 2.0.0.

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

3. Kontrollér den nyeste version af Microsoft.SqlServer.Dacpacs.FabricDw, og tilføj en reference i XML-noden Project/ItemGroup . For eksempel:

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

   Sådan skal dit databaseprojekt for et lager se ud efter opdateringerne.

    <?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. Gem din .sqlproj fil. Når du bliver bedt om at genindlæse databaseprojektet, skal du vælge Ja.

Important

Fabric Data Warehouse-teamet udgiver ofte nye versioner af NuGet-pakker. Da standardversionsværdierne .sqlproj i filen kan ændre sig over tid, skal du sørge for at opdatere dem i dit lokale projekt for at holde dem ajour med de nyeste versioner, der er tilgængelige fra NuGet til Microsoft.SqlServer.Dacpacs.FabricDw.

Tilføje eller opdatere databaseobjekter

Du kan definere eller ændre databaseobjekter, f.eks. tabeller, visninger, lagrede procedurer og funktioner i dit lagerstedsprojekt.

Under mappen for et skema skal du f.eks dbo. tilføje eller slette eller foretage ændringer i T-SQL-definitionerne af objekter på dit lager. Hvis du vil ændre et eksisterende objekt, skal du åbne det tilsvarende .sql arkiv og opdatere definitionen efter behov.

Når du bygger projektet, valideres alle nye og opdaterede objekter og inkluderes i den genererede dacpac-fil i {project folder location}/bin/debug/{project name}.dacpac filen.

Ændringer, der foretages her, er kun for databaseprojektet og afspejles ikke i Microsoft Fabric, før du opretter og publicerer dit projekt.

Byg og valider projektet

1. Åbn databaseprojektet, hvis det ikke allerede er åbnet.

2. Højreklik på projektet, og vælg Byg for at bygge databaseprojektet.

   

3. Byggeriet skal lykkes. Ret eventuelle fejl baseret på meddelelser i outputtet af build-hændelsen.

Notat

I øjeblikket skal din Visual Studio Code-standardterminal være PowerShell , for at build-processen i databaseprojektudvidelsen kan lykkes. I kommandopaletten skal du vælge Terminal: Vælg Standardprofil, og vælg derefter PowerShell.

Publicer til Fabric Data Warehouse

Når du har oprettet dit projekt, skal du publicere det på dit destinationslager. Udgivelse opretter et script for at løse forskellen mellem databaseprojektet og det faktiske lagersted og udfører et script for at få lagerstedet til at matche projektet. Den kompilerede model af lagerstedsskemaet i en .dacpac-fil kan installeres på et destinationslagersted.

1. Højreklik på projektet, og vælg Udgiv.

2. Vælg Publicer på en eksisterende SQL-server.

3. Vælg Brug ikke profil for Vælg publiceringsprofil, der skal indlæses, første gang du publicerer.

   • Du kan gemme indstillinger for udgivelse af lagerstedet i en publiceringsprofil. Når du er færdig, får du mulighed for at gemme de publiceringsindstillinger, du lige har brugt, i en Visual Studio Code-meddelelse for at gemme de publiceringsindstillinger, du lige har brugt, i en publiceringsprofilfil.
   • Du kan genbruge publiceringsprofilen i fremtiden, når du publicerer dit projekt på dit lagersted. Du kan have forskellige profilindstillinger for forskellige lagersteder eller for forskellige miljøer i udviklings-/test-/accept-/produktionsudviklingsmiljøer.

4. Vælg forbindelsesprofilen Fabric Data Warehouse på listen.

5. Vælg navnet på destinationslagerstedet.

6. I indstillingen Vælg handling kan du enten generere script for at gennemse scriptet, før du publicerer, eller udgive projektet på et lagersted.

   • Første gang du vil installere ændringer, skal du omhyggeligt generere script og gennemse den resulterende T-SQL, der skal anvendes på destinationslageret. Der foretages ingen ændringer på mållageret.
   • Hvis du vælger Udgiv, skrives ændringerne til destinationslageret.

   

7. På meddelelsen Vil du gemme indstillingerne i en profil (.publish.xml)?, skal du vælge Ja og gemme dine valg for publiceringsprofil til næste gang, du skal offentliggøre.

Vigtige implementeringsindstillinger for lagerprojekter

Når databaseprojekter deployeres til Fabric Data Warehouse, styrer flere indstillinger skemaændringer og kan påvirke datasikkerheden. Brug med forsigtighed.

• BlockOnPossibleDataLoss

  • Hvad den gør: Forhindrer udrulning, hvis der er risiko for datatab (for eksempel at droppe en kolonne eller tabel med data).
  • Anbefaling: Altid sat til True i produktion for at beskytte kritiske data.
  • Forsigtighed: At sætte det til False tillader udrulning, selvom data kan gå tabt. Brug kun i kontrollerede miljøer (for eksempel udvikling/test).

• DropObjectsNotInSource

  • Hvad den gør: Fjerner objekter i måldatabasen, som ikke er til stede i projektkildekoden.
  • Anbefaling: Brug i udviklings-/testmiljøer til at rydde op i resterende objekter.
  • Forsigtighed: At bruge DropObjectsNotInSource i produktion kan slette vigtige objekter og data. Dobbelttjek før aktivering.

• Pre-Deployment Scripts

  • Hvad den gør: Udfører brugerdefinerede SQL-scripts før skemaudrulningen.
  • Almindelige anvendelser:
    • Arkivér eller sikkerhedskopier data før du dropper tabeller
    • Deaktiver begrænsninger eller triggere midlertidigt
    • Oprydning af arvobjekter
  • Forsigtighed: Sørg for, at scripts er idempotente og ikke introducerer skemaændringer, der er i konflikt med deployment.

Tips

Når en implementeringsproces er idempotent, kan den køres flere gange uden problemer, og du kan implementere til flere databaser uden at skulle forudbestemme deres status.

• Post-Deployment Scripts

  • Hvad den gør: Udfører brugerdefinerede SQL-scripts efter skema-implementeringen.
  • Almindelige anvendelser:
    • Seedopslag eller referencedata
    • Genaktiver begrænsninger eller triggere
    • Logudrulningshistorik
  • Forsigtighed: Undgå tunge operationer på store borde i produktion; Sørg for, at scripts sikkert kan køre flere gange, hvis det er nødvendigt.

Important

Gennemgå altid deployment-scripts og indstillinger, før du udgiver dem. Test først i udviklings-/testmiljøer for at forhindre utilsigtet datatab.

Bekræft udgivelse

Opret forbindelse til lagerstedet og scriptobjekter, der er blevet ændret, eller bekræft ved at køre systemkatalogobjekter.

Relaterede artikler

• Arbejdsgange for udvikling og implementering
• Udvikl og udrul afhængigheder på tværs af lager.
• Kom i gang med at bruge Fabric-udrulningspipelines