Vývoj skladových projektov v editore Visual Studio Code

Vzťahuje sa na:✅ Warehouse v službe Microsoft Fabric

Zistite, ako nastaviť databázový projekt pre sklad údajov služby Fabric v editore Visual Studio Code. Vytvoríte nový projekt, definujete objekty schémy, zostavíte a overíte projekt a publikujete ho do svojho skladu.

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.
  • Ak chcete vytvoriť nový sklad vzoriek, pozrite si tému Vytvorenie vzorového skladu v službe Microsoft Fabric.
• Nainštalujte Visual Studio Code na svoju pracovnú stanicu.
• Nainštalujte súpravu .NET SDK na vytváranie a publikovanie databázových projektov.
• Nainštalujte dve rozšírenia Visual Studio Code: SQL Database Projects a SQL Server (mssql).
  • Požadované rozšírenia môžete nainštalovať priamo z trhu Visual Studio Code vyhľadaním výrazu "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: Vytvorenie nového databázového projektu z palety príkazov v editore 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 Databáza SQL Servera.

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

6. Ako cieľovú platformu vyberte Synapse Data Warehouse v Microsoft Fabric .

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é iba projekty v štýle SDK .

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 editore Visual Studio Code vyberte na paneli aktivít ikonu rozšírenia Databázové projekty.

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

   

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

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

5. Ako cieľovú platformu vyberte Synapse Data Warehouse v Microsoft Fabric .

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

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 v editore Visual Studio Code.

   1. Na paneli aktivít vyberte rozšírenie SQL Server v editore Visual Studio Code.
   2. Zadajte názov profilu. Vyberte položku Parametre.
   3. Zadajte názov servera. Na portáli Fabric v nastaveniach skladu načítajte reťazec koncového bodu SQL . (To sa líši od koncového bodu analýzy SQL.) Vyzerá to tak.<server unique ID>.datawarehouse.fabric.microsoft.com Toto je názov servera.
   4. Pre typ overovania použite Microsoft Entra ID – univerzálne 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 editore Visual Studio Code vyberte na paneli aktivít ikonu rozšírenia Databázové projekty .

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 projektu skladu.

    

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 sa v súbore nachádza najnovšia verzia súpravy Microsoft.Build.Sql SDK. Napríklad v súbore .sqlproj zmeňte verziu na Microsoft.Build.Sql2.0.0.

      <Sdk Name="Microsoft.Build.Sql" Version="2.0.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.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. 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 vykonané v tomto dokumente sa týkajú iba databázového projektu a neprejavia sa v službe Microsoft Fabric, kým projekt nevytvoríte a nepublikujete .

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

V súčasnosti musí byť predvolený terminál Visual Studio Code PowerShell , aby bol proces zostavovania v rozšírení databázových projektov úspešný. Na palete príkazov vyberte položku Terminál: Vyberte položku Predvolený profil a potom vyberte položku PowerShell.

Publikovanie do skladu údajov štruktúry

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. Po dokončení sa v oznámení Visual Studio Code zobrazí možnosť uložiť možnosti publikovania, ktoré ste práve použili, do súboru profilu publikovania.
   • Profil publikovania môžete znova použiť v budúcnosti pri publikovaní projektu do skladu. 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. Zo zoznamu vyberte profil pripojenia Fabric Data Warehouse.

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, ktoré môžu 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.

• Pre-Deployment Scripts

  • Čo robí: Spúšťa vlastné SQL skripty pred nasadením schémy.
  • Bežné využitie:
    • Archivujte alebo zálohujte dáta pred ukončením tabuliek
    • Dočasne vypnúť obmedzenia alebo spúšťače
    • Čistenie starých objektov
  • Opatrnosť: Uistite sa, že skripty sú idempotentné a nezavádzajú zmeny schémy, ktoré by boli v rozpore s nasadením.

Prepitné

Keď je proces nasadenia idempotentný, môže byť spustený viackrát bez problémov a môžete nasadiť do viacerých databáz bez potreby vopred určovať ich stav.

• Post-Deployment Scripts

  • Čo robí: Po nasadení schémy vykonáva vlastné SQL skripty.
  • Bežné využitie:
    • Seed vyhľadávanie alebo referenčné dáta
    • Opätovné povolenie obmedzení alebo spúšťačov
    • História nasadenia v denníku
  • Opatrnosť: Vyhnúť sa náročným operáciám na veľkých stoloch vo výrobe; zabezpečiť, aby skripty mohli bezpečne bežať viackrát, ak je to potrebné.

Dôležité

Vždy si pred publikovaním preštudujte skripty a nastavenia nasadenia. Najskôr testujte vo vývojových/testovacích prostrediach, 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