Udvikl lagerprojekter i Visual Studio Code

Gælder for:✅ Warehouse i Microsoft Fabric

Lær, hvordan du opsætter 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.
  • For at oprette et nyt prøvelager, se Opret et eksempellager i Microsoft Fabric.
• Installer Visual Studio Code på din arbejdsstation.
• Installer SDK'en .NET for at bygge og udgive 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 Command Palette 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 Database Project Type 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 målplatform.

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

   Important

   Kun SDK-stil projekter 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 vælg Database Projects udvidelsesikonet fra Activity Bar.

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

   

3. Vælg Database Project Type 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 målplatform.

6. Når du bliver bedt om det, skal du vælge Ja (anbefales) for et SDK-projekt. Kun SDK-stil projekter 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 udvidelsen SQL Server i Visual Studio Code fra Aktivitetsbaren.
   2. Angiv et profilnavn. Vælg Parametre.
   3. Angiv servernavnet. I Fabric-portalen, i indstillingerne for dit lager, vælg SQL-endpoint og kopier den angivne streng. Dette er servernavnet på dit lager og er forskelligt fra SQL-analyse-endpointet. Det ligner <server unique ID>.datawarehouse.fabric.microsoft.com.
   4. For Autentificeringstype, brug Microsoft Entra ID - Universal med MFA-understøttelse. Autentificér 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 ikonet Database Projects udvidelse fra 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 lagerprojektet.

    

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.

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, gælder kun databaseprojektet og afspejles ikke i Microsoft Fabric, før du Build og Publish 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.

Publicér 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 i en Visual Studio Code-notifikation for at gemme de publiceringsmuligheder, du lige har brugt, til en publicer profilfil.
   • Du kan genbruge publiceringsprofilen i fremtiden, når du udgiver dit projekt på dit lager. Du kan have forskellige profilindstillinger for forskellige lagersteder eller for forskellige miljøer i udviklings-/test-/accept-/produktionsudviklingsmiljøer.

4. Vælg forbindelsesprofilen til Fabric Data Warehouse fra 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 implementeres 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.

• 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.

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