Vyvíjajte skladové projekty vo Visual Studio Code

Vzťahuje sa na: ✅ sklad v Microsoft Fabric

Naučte sa, ako nastaviť databázový projekt pre Fabric Data Warehouse vo Visual Studio Code. Vytvoríte nový projekt, definujete objekty schémy, zostavíte a overíte projekt a publikujete ho do svojho skladu.

Dôležité

Táto funkcia je vo verzii Preview.

Požiadavky

Skôr než začnete, uistite sa, že:

• Mať prístup k existujúcej položke skladu v pracovnom priestore služby Fabric s povoleniami prispievateľa alebo vyššími.
  • Pre vytvorenie nového skladu vzoriek pozri Vytvoriť sklad vzoriek v Microsoft Fabric.
• Nainštalujte Visual Studio Code na svoju pracovnú stanicu.
• Nainštalujte SDK .NET na tvorbu a publikovanie databázových projektov.
• Nainštalujte dve Visual Studio Code rozšírenia: SQL Database Projects a SQL Server (mssql).
  • Potrebné rozšírenia si môžete nainštalovať priamo z Visual Studio Code marketplace vyhľadaním "SQL Database Projects" alebo "SQL Server (mssql)".

Vytvorenie nového databázového projektu

Databázový projekt môžete vytvoriť od začiatku alebo existujúci sklad.

Možnosť 1: Vytvoriť nový databázový projekt z Command Palette vo Visual Studio Code

1. Otvorte Visual Studio Code.

2. Otvorte paletu príkazov (Ctrl+Shift+P alebo Cmd+Shift+P na Macu).

3. Vyhľadávanie databázových projektov: Nové.

4. Vyberte Typ projektu databázy ako SQL Server Databáza.

5. Vyberte názov projektu a vyberte umiestnenie lokálneho priečinka.

6. Vyberte Data Warehouse Synapse v Microsoft Fabric ako cieľovú platformu.

7. Po zobrazení výzvy vyberte Áno (odporúča sa) pre projekt v štýle súpravy SDK.

   Dôležité

   Pre Fabric Data Warehouse sú podporované len projekty SDK-štýlu.

8. Vyberte položku Áno na otázku Chcete nakonfigurovať zostavu projektu SQL ako predvolenú konfiguráciu zostavy pre tento priečinok?

9. Výberom položky Áno môžete dôverovať autorom súborov v tomto priečinku.

Možnosť 2: Vytvorenie nového databázového projektu z rozšírenia Databázové projekty

1. V Visual Studio Code vyberte ikonu rozšírenia Database Projects z Activity Bar.

2. Na table Databázové projekty vyberte položku Vytvoriť nové.

   

3. Vyberte Typ projektu databázy ako SQL Server Databáza.

4. Vyberte názov projektu a vyberte umiestnenie lokálneho priečinka.

5. Vyberte Data Warehouse Synapse v Microsoft Fabric ako cieľovú platformu.

6. Po zobrazení výzvy vyberte Áno (odporúča sa) pre projekt v štýle súpravy SDK. Pre Fabric Data Warehouse sú podporované len projekty SDK-štýlu.

7. Vyberte položku Áno na otázku Chcete nakonfigurovať zostavu projektu SQL ako predvolenú konfiguráciu zostavy pre tento priečinok?

8. Výberom položky Áno môžete dôverovať autorom súborov v tomto priečinku.

Možnosť 3: Vytvorenie databázového projektu z existujúceho skladu

1. Najprv vytvorte nový profil pripojenia pre váš sklad vo Visual Studio Code.

   1. Vyberte rozšírenie SQL Server v Visual Studio Code z Activity Bar.
   2. Zadajte názov profilu. Vyberte položku Parametre.
   3. Zadajte názov servera. V Fabric portáli, v nastaveniach vášho skladu, vyberte SQL endpoint a skopírujte poskytnutý reťazec. Toto je názov servera vášho skladu a líši sa od SQL analytics endpointu. Vyzerá to ako <server unique ID>.datawarehouse.fabric.microsoft.com.
   4. Pre Authentication type použite Microsoft Entra ID - Universal s podporou MFA. Overte sa pomocou svojho Microsoft Entra ID.
   5. Zadajte ďalšie informácie ako predvolené alebo požadované a vyberte položku Pripojiť.

2. V Visual Studio Code vyberte ikonu rozšírenia Database Projects z panela aktivít.

3. Vyberte tlačidlo ... možností na table Databázové projekty a vyberte možnosť Vytvoriť projekt z databázy .

   

4. Vyberte si svoj sklad z existujúcich profilov pripojenia.

5. Zadajte názov projektu a vyberte priečinok projektu na pracovnej stanici.

6. Pre štruktúru priečinkov vyberte Schéma/Typ objektu (odporúča sa).

7. V časti Zahrnúť povolenia do projektu vyberte položku Nie (predvolené).

8. Pre projekt v štýle SDK vyberte Áno (odporúča sa).

9. Vyberte položku Áno na otázku Chcete nakonfigurovať zostavu projektu SQL ako predvolenú konfiguráciu zostavy pre tento priečinok?

10. Visual Studio Code extrahuje projektové súbory z warehouse projektu.

    

11. Po úspešnom extrahovaní sa zobrazí nasledujúce upozornenie: "Extrahovať súbory projektu: Úspešné. Dokončené".

12. Výberom položky Áno môžete dôverovať autorom súborov v tomto priečinku.

Nový databázový projekt pre váš sklad

Nový databázový projekt pre váš sklad sa zobrazí v ponuke SQL Database Projects.

Štruktúra vášho projektu vyzerá takto:

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

Konfigurácia databázového projektu

1. Kliknite pravým tlačidlom myši na projekt a vyberte položku Upraviť súbor .sqlproj.

   

2. Overte, či súbor obsahuje najnovšiu verziu Microsoftu. Build.SQL SDK. Napríklad zmeniť verziu pre na Microsoft.Build.Sql v 2.2.0 súbore .sqlproj .

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

3. Overte najnovšiu verziu Microsoft.SqlServer.Dacpacs.FabricDw a pridajte odkaz do uzla Project/ItemGroup XML. Príklad:

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

   Takto by mal vyzerať váš databázový projekt pre sklad po aktualizáciách.

    <?xml version="1.0" encoding="utf-8"?>
    <Project DefaultTargets="Build">
      <Sdk Name="Microsoft.Build.Sql" Version="2.2.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. Uložte .sqlproj súbor. Vo výzve na opätovné načítanie databázového projektu vyberte položku Áno.

Dôležité

Tím Fabric Data Warehouse často vydáva nové verzie balíkov NuGet. Keďže predvolené hodnoty verzie v súbore .sqlproj sa môžu časom meniť, nezabudnite ich aktualizovať v lokálnom projekte, aby zostali v súlade s najnovšími verziami dostupnými z NuGet pre Microsoft.SqlServer.Dacpacs.FabricDw.

Pridanie alebo aktualizácia databázových objektov

V rámci projektu skladu môžete definovať alebo upraviť databázové objekty, ako sú tabuľky, zobrazenia, uložené procedúry a funkcie.

V priečinku pre schému, napríklad dbo, pridajte alebo odstráňte alebo vykonajte zmeny v definíciách T-SQL objektov vo vašom sklade. Ak chcete upraviť existujúci objekt, otvorte jeho .sql príslušný súbor a podľa potreby aktualizujte definíciu.

Pri vytváraní projektu sa všetky nové a aktualizované objekty overia a zahrnú do vygenerovaného súboru dacpac v {project folder location}/bin/debug/{project name}.dacpac súbore.

Zmeny tu sú len v databázovom projekte a neprejavujú sa v Microsoft Fabric, kým neBuild a Publish svoj projekt.

Zostavenie a overenie projektu

1. Otvorte databázový projekt, ak ešte nie je otvorený.

2. Kliknite pravým tlačidlom myši na projekt a vyberte položku Zostaviť , aby ste vytvorili databázový projekt.

   

3. Zostavenie by malo byť úspešné. Opravte všetky chyby na základe správ poskytnutých vo výstupe udalosti zostavy.

Poznámka

Momentálne musí byť váš Visual Studio Code predvolený terminál PowerShell, aby bol proces Build v rozšírení Database Projects úspešný. Na palete príkazov vyberte položku Terminál: Vyberte položku Predvolený profil a potom vyberte položku PowerShell.

Publikovať do Fabric Data Warehouse

Po vytvorení projektu ho publikujte v cieľovom sklade. Publikovanie vytvorí skript na vyriešenie rozdielu medzi databázovým projektom a skutočným skladom a spustí skript, aby sa sklad zhodoval s projektom. Skompilovaný model schémy skladu v súbore .dacpac je možné nasadiť do cieľového skladu.

1. Kliknite pravým tlačidlom myši na projekt a vyberte položku Publikovať.

2. Vyberte položku Publikovať na existujúcom serveri SQL.

3. V časti Vybrať profil publikovania, ktorý sa má načítať, pri prvom publikovaní vyberte položku Nepoužívať profil.

   • Možnosti publikovania skladu môžete uložiť do profilu publikovania. Keď skončíte, dostanete možnosť v notifikácii Visual Studio Code uložiť práve použité publikačné možnosti na zverejnenie profilového súboru.
   • Publikovací profil môžete v budúcnosti opätovne použiť, keď budete svoj projekt publikovať vo svojom sklade. Môžete mať rôzne možnosti profilu pre rôzne sklady alebo pre rôzne prostredia vo vývojových prostrediach vývoja/testovania/prijímania/výroby.

4. Vyberte profil pripojenia Fabric Data Warehouse zo zoznamu.

5. Vyberte názov cieľového skladu.

6. V možnosti Vybrať akciu môžete buď vygenerovať skript na kontrolu skriptu pred publikovaním, alebo publikovať projekt do skladu.

   • Pri prvom nasadení zmien by ste mali starostlivo vygenerovať skript a skontrolovať výsledný T-SQL, ktorý sa má použiť v cieľovom sklade. V cieľovom sklade sa nevykonajú žiadne zmeny.
   • Ak vyberiete možnosť Publikovať, zmeny sa zapíšu do cieľového skladu.

   

7. V oznámení Chcete uložiť nastavenia do profilu (.publish.xml)??, vyberte Áno a uložte svoje možnosti profilu publikovania pre ďalšie zverejnenie.

Dôležité nastavenia nasadenia pre skladové projekty

Pri nasadzovaní databázových projektov do Fabric Data Warehouse ovplyvňuje niekoľko nastavení zmeny schémy a môže ovplyvniť bezpečnosť dát. Používajte opatrne.

• BlockOnPossibleDataLoss

  • Čo robí: Zabraňuje nasadeniu, ak hrozí strata dát (napríklad vynechanie stĺpca alebo tabuľky obsahujúcej dáta).
  • Odporúčanie: Vždy nastavené na True produkciu na ochranu kritických dát.
  • Opatrnosť: Nastavenie na False povolenie nasadenia aj v prípade, že sa dáta môžu stratiť. Používajte len v kontrolovaných prostrediach (napríklad vývoj/testovanie).

• DropObjectsNotInSource

  • Čo robí: Vyhadzuje objekty do cieľovej databázy, ktoré nie sú prítomné v zdrojovom kóde projektu.
  • Odporúčanie: Použitie vo vývojových/testovacích prostrediach na čistenie zvyšných objektov.
  • Opatrnosť: Použitie DropObjectsNotInSource v produkcii môže vymazať dôležité objekty a dáta. Pred povolením si to dôkladne overte.

Dôležité

Vždy si pred publikovaním skontrolujte nastavenia nasadenia. Najskôr testujte vo vývojárskom alebo testovacom prostredí, aby ste predišli neúmyselnej strate dát.

Overenie publikovania

Pripojte sa k svojmu skladu a skriptujte objekty, ktoré boli zmenené, alebo overte spustením objektov systémového katalógu.

Súvisiace články

• Pracovné postupy vývoja a nasadenia
• Vyvinúť a nasadiť závislosti medzi skladmi
• Začíname používať kanály nasadenia služby Fabric