Vývoj projektů skladu v editoru Visual Studio Code

platí pro:✅ Warehouse v Microsoft Fabric

Naučte se nastavit databázový projekt pro Datový sklad Fabric v editoru Visual Studio Code. Vytvoříte nový projekt, definujete objekty schématu, sestavíte a ověříte projekt a publikujete ho do skladu.

Požadavky

Než začnete, ujistěte se, že:

• Mít přístup k existující položce skladu v pracovním prostoru Fabric s oprávněními Přispěvatel nebo vyšší.
  • Pokud chcete vytvořit nový ukázkový sklad, přečtěte si téma Vytvoření ukázkového skladu v Microsoft Fabric.
• Nainstalujte visual Studio Code na pracovní stanici.
• Nainstalujte sadu .NET SDK pro sestavení a publikování databázových projektů.
• Nainstalujte dvě rozšíření editoru Visual Studio Code: SQL Database Projects a SQL Server (mssql).
  • Požadovaná rozšíření můžete nainstalovat přímo z marketplace editoru Visual Studio Code tak, že vyhledáte "projekty SQL Database" nebo "SQL Server (mssql)".

Vytvoření nového databázového projektu

Databázový projekt můžete vytvořit úplně od začátku nebo existujícího skladu.

Možnost 1: Vytvoření nového databázového projektu z palety příkazů v editoru Visual Studio Code

1. Otevřete Visual Studio Code.

2. Otevřete paletu příkazů (Ctrl+Shift+P nebo Cmd+Shift+P na Macu).

3. Vyhledejte databázové projekty: Nové.

4. Vyberte typ databázového projektu jako databáze SQL Serveru.

5. Zvolte název projektu a vyberte umístění místní složky.

6. Jako cílovou platformu zvolte Datový sklad Synapse v Microsoft Fabric .

7. Po zobrazení výzvy vyberte možnost Ano (doporučeno) pro projekt ve stylu sady SDK.

   Důležité

   Pro datový sklad Fabric se podporují jenom projekty ve stylu sady SDK .

8. Chcete nakonfigurovat sestavení projektu SQL jako výchozí konfiguraci sestavení pro tuto složku, vyberte ano?

9. Chcete-li autorům souborů v této složce důvěřovat, vyberte ano .

Možnost 2: Vytvoření nového databázového projektu z rozšíření Databázové projekty

1. V editoru Visual Studio Code zvolte na panelu aktivit ikonu rozšíření Databázové projekty.

2. V podokně Databázové projekty vyberte Vytvořit nový.

   

3. Vyberte typ databázového projektu jako databáze SQL Serveru.

4. Zvolte název projektu a vyberte umístění místní složky.

5. Jako cílovou platformu zvolte Datový sklad Synapse v Microsoft Fabric .

6. Po zobrazení výzvy vyberte možnost Ano (doporučeno) pro projekt ve stylu sady SDK. Pro datový sklad Fabric se podporují jenom projekty ve stylu sady SDK .

7. Chcete nakonfigurovat sestavení projektu SQL jako výchozí konfiguraci sestavení pro tuto složku, vyberte ano?

8. Chcete-li autorům souborů v této složce důvěřovat, vyberte ano .

Možnost 3: Vytvoření databázového projektu z existujícího skladu

1. Nejprve vytvořte nový profil připojení pro váš sklad v editoru Visual Studio Code.

   1. Na panelu aktivit vyberte rozšíření SQL Serveru v editoru Visual Studio Code.
   2. Zadejte název profilu. Zvolte Parametry.
   3. Zadejte název serveru. V portálu Fabric, v nastavení vašeho skladu, načtěte řetězec SQL endpointu. (Liší se od koncového bodu SQL Analytics.) Vypadá to jako <server unique ID>.datawarehouse.fabric.microsoft.com. Toto je název serveru.
   4. Pro typ ověřování použijte Microsoft Entra ID – Univerzální s podporou vícefaktorového ověřování. Ověřte se pomocí vašeho ID Microsoft Entra.
   5. Zadejte další informace jako výchozí nebo požadované a vyberte Připojit.

2. V editoru Visual Studio Code zvolte na panelu aktivit ikonu rozšíření Databázové projekty .

3. V podokně ... vyberte tlačítko Možnosti a zvolte Možnost Vytvořit projekt z databáze.

   

4. Vyberte svůj sklad z existujících profilů připojení.

5. Zadejte název projektu a zvolte složku projektu na pracovní stanici.

6. Pro strukturu složek vyberte Typ schématu nebo objektu (doporučeno).

7. V části Zahrnout oprávnění do projektu vyberte Ne (výchozí).

8. V případě projektu ve stylu sady SDK vyberte Ano (doporučeno).

9. Chcete nakonfigurovat sestavení projektu SQL jako výchozí konfiguraci sestavení pro tuto složku, vyberte ano?

10. Visual Studio Code extrahuje soubory projektu z datového skladu.

    

11. Po úspěšném extrakci se zobrazí následující oznámení: Extrahování souborů projektu: Úspěšné. Dokončeno".

12. Chcete-li autorům souborů v této složce důvěřovat, vyberte ano .

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

Nový databázový projekt pro váš sklad se zobrazí v nabídce Projekty služby SQL Database.

Struktura projektu vypadá takto:

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

Konfigurace databázového projektu

1. Klikněte pravým tlačítkem myši na projekt a vyberte Upravit soubor .sqlproj.

   

2. Ověřte, zda je v souboru nejnovější verze Microsoft.Build.Sql SDK. Například v souboru .sqlproj změňte verzi pro Microsoft.Build.Sql na 2.0.0.

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

3. Ověřte nejnovější verzi Microsoft.SqlServer.Dacpacs.FabricDw a přidejte odkaz do Project/ItemGroup uzlu XML. Například:

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

   Takto by měl váš databázový projekt pro sklad vypadat po aktualizací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 soubor. Na příkazovém řádku pro opětovné načtení databázového projektu vyberte Ano.

Důležité

Tým datového skladu Fabric často vydává nové verze balíčků NuGet. Vzhledem k tomu, že výchozí hodnoty verzí v .sqlproj souboru se můžou v průběhu času měnit, nezapomeňte je aktualizovat v místním projektu, aby zůstaly v souladu s nejnovějšími verzemi dostupnými z NuGetu pro Microsoft.SqlServer.Dacpacs.FabricDw.

Přidání nebo aktualizace databázových objektů

Můžete definovat nebo upravit databázové objekty, jako jsou tabulky, zobrazení, uložené procedury a funkce v rámci projektu skladu.

Ve složce schématu můžete například dbopřidat nebo odstranit nebo provést změny definic T-SQL objektů ve skladu. Pokud chcete upravit existující objekt, otevřete odpovídající .sql soubor a podle potřeby aktualizujte definici.

Při sestavování projektu se všechny nové a aktualizované objekty ověří a zahrnou do vygenerovaného souboru dacpac v {project folder location}/bin/debug/{project name}.dacpac souboru.

Změny provedené zde jsou pouze v databázovém projektu a neprojevují se v Microsoft Fabric, dokud projekt nevytvořili a nepublikujete .

Sestavení a ověření projektu

1. Otevřete databázový projekt, pokud ještě nebyl otevřen.

2. Klikněte pravým tlačítkem myši na projekt a vyberte Sestavit a sestavte projekt databáze.

   

3. Sestavení by mělo být úspěšné. Opravte všechny chyby na základě zpráv zadaných ve výstupu události sestavení.

Poznámka:

V současné době musí být výchozím terminálem editoru Visual Studio Code PowerShell, aby byl proces sestavení v rozšíření Databázové projekty úspěšný. Na paletě příkazů zvolte Terminál: Vyberte výchozí profil a pak vyberte PowerShell.

Publikování do Fabric Data Warehouse

Po sestavení projektu ho nahrajte do cílového úložiště. Publikování vytvoří skript k vyřešení rozdílu mezi databázovým projektem a skutečným datovým úložištěm a spustí skript, který přizpůsobí datové úložiště projektu. Zkompilovaný model schématu skladu v souboru .dacpac lze nasadit do cílového skladu.

1. Klikněte pravým tlačítkem myši na projekt a vyberte Publikovat.

2. Zvolte Publikovat na existující server SQL.

3. Pokud chcete vybrat profil publikování, který chcete načíst, zvolte při prvním publikování možnost Nepoužívat profil.

   • Možnosti publikování skladu můžete uložit do profilu publikování. Až budete hotovi, dostanete v oznámení ve Visual Studio Code možnost uložit právě použité možnosti publikování do souboru profilu publikování.
   • V budoucnu můžete znovu použít publikační profil, když publikujete svůj projekt do skladiště dat. Můžete mít různé možnosti profilu pro různé sklady nebo pro různá prostředí ve vývojových/testovacích/akceptačních/produkčních vývojových prostředích.

4. V seznamu vyberte profil připojení datového skladu Fabric.

5. Zvolte název cílového skladu.

6. V možnosti Zvolit akci můžete buď vygenerovat skript a zkontrolovat skript před publikováním, nebo publikovat projekt do skladu.

   • Při prvním nasazení změn byste měli pečlivě vygenerovat skript a zkontrolovat výsledný T-SQL, který se použije v cílovém skladu. V cílovém skladu se neprovedou žádné změny.
   • Pokud zvolíte Publikovat, změny budou zapsány do vašeho cílového skladu.

   

7. V oznámení Chcete uložit nastavení v profilu (.publish.xml)?, zvolte Ano a uložte volby profilu publikování pro příště, až budete muset publikovat.

Důležitá nastavení nasazení pro projekty skladu

Při nasazování databázových projektů do Fabric Data Warehouse několik nastavení ovládá změny schématu a může ovlivnit bezpečnost dat. Používejte s opatrností.

• BlockOnPossibleDataLoss

  • Co to dělá: Zabrání nasazení, pokud hrozí riziko ztráty dat (například vyřazení sloupce nebo tabulky obsahující data).
  • Doporučení: Pokud chcete chránit důležitá data, vždy nastavte True v produkčním prostředí.
  • Opatrnost: Nastavení na False umožňuje nasazení i když může dojít ke ztrátě dat. Používejte pouze v kontrolovaných prostředích (například vývoj/testování).

• DropObjectsNotInSource

  • Co to dělá: Zahodí objekty v cílové databázi, které nejsou ve zdroji projektu.
  • Doporučení: Použití v vývojových/testovacích prostředích k vyčištění zbývajících objektů.
  • Opatrnost: Použití DropObjectsNotInSource v produkčním prostředí může odstranit důležité objekty a data. Před povolením pečlivě zkontrolujte.

• Pre-Deployment Scripts

  • Co to dělá: Spustí vlastní skripty SQL před nasazením schématu.
  • Běžná použití:
    • Archivace nebo zálohování dat před vyřazením tabulek
    • Dočasné zakázání omezení nebo triggerů
    • Vyčištění starších objektů
  • Opatrnost: Ujistěte se, že skripty jsou idempotentní a nezavádějí změny schématu, které jsou v konfliktu s nasazením.

Návod

Pokud je proces nasazení idempotentní, může být spuštěn několikrát, aniž by způsoboval problémy, a můžete ho nasadit do více databází, aniž byste museli předem určit jejich stav.

• Post-Deployment Scripts

  • Co to dělá: Spustí vlastní skripty SQL po nasazení schématu.
  • Běžná použití:
    • Počáteční vyhledávání nebo referenční data
    • Opětovné povolení omezení nebo triggerů
    • Historie nasazení protokolu
  • Opatrnost: Vyhněte se velkým operacím s velkými tabulkami v produkčním prostředí; zajistěte, aby skripty v případě potřeby mohly bezpečně spouštět vícekrát.

Důležité

Před publikováním vždy zkontrolujte skripty a nastavení nasazení. Nejprve testujte v vývojových/testovacích prostředích, abyste zabránili neúmyslné ztrátě dat.

Ověřte publikování

Připojte se ke svému skladu a objektům skriptu, které byly změněny nebo ověřovány spuštěním objektů katalogu systému.

Související články

• Pracovní postupy vývoje a nasazení
• Vývoj a nasazení závislostí mezi sklady
• Začínáme používat nasazovací kanály Fabric