Sdílet prostřednictvím

Integrace správy zdrojového kódu databáze SQL v Microsoft Fabric

Platí pro:✅SQL databázi v Microsoft Fabric

V tomto kurzu se dozvíte, jak pracovat s databází SQL ve Fabric pomocí gitové integrace Fabric pro správu zdrojového kódu.

Databáze SQL v Microsoft Fabric má integraci správy zdrojového kódu nebo integraci Gitu, aby uživatelé mohli v průběhu času sledovat definice svých databázových objektů. Tato integrace umožňuje týmu:

  • Potvrďte databázi do správy zdrojového kódu, která automaticky převede živou databázi na kód v nakonfigurovaném úložišti správy zdrojového kódu (například Azure DevOps).
  • Aktualizujte databázové objekty z obsahu správy zdrojového kódu, který před použitím rozdílové změny v databázi ověří kód v úložišti správy zdrojového kódu.

Diagram jednoduchého cyklu potvrzení a aktualizace mezi živou databází a správou zdrojového kódu

Pokud git neznáte, tady je několik doporučených zdrojů informací:

Tento článek představuje řadu užitečných scénářů, které můžete použít jednotlivě nebo v kombinaci ke správě procesu vývoje s využitím databáze SQL ve Fabricu:

Scénáře v tomto článku jsou popsány v epizodě Zveřejnění dat. Podívejte se na video s přehledem integrace správy zdrojového kódu ve Fabricu:

Poznámka:

Nastavení na úrovni databáze, jako je kolace a úroveň kompatibility, nejsou v tuto chvíli součástí integrace správy zdrojového kódu a kanálů nasazení. U nastavení databáze, která můžete nastavit pomocí T-SQL po vytvoření databáze, můžete databázi upravit pomocí skriptů po nasazení.

Požadavky

Nastavení

Toto připojení úložiště platí na úrovni pracovního prostoru, takže jedna větev v úložišti je přidružena k tomuto pracovnímu prostoru. Úložiště může mít více větví, ale jenom kód ve větvi vybrané v nastavení pracovního prostoru má přímý vliv na pracovní prostor.

Postup připojení pracovního prostoru k úložišti správy zdrojového kódu najdete v tématu Začínáme s integrací Gitu. Váš pracovní prostor je možné připojit ke vzdálenému úložišti Azure DevOps nebo GitHub.

Přidání databáze SQL Fabric do správy zdrojového kódu

V tomto scénáři potvrdíte databázové objekty do správy zdrojového kódu. Možná vyvíjíte aplikaci, ve které vytváříte objekty přímo v testovací databázi a sledujete ji ve správě zdrojového kódu stejně jako váš kód aplikace. V důsledku toho máte přístup k historii definic databázových objektů a můžete použít koncepty Gitu, jako je větvení a slučování, k přizpůsobení procesu vývoje.

  1. Připojte se k databázi SQL v editoru Fabric SQL, SQL Server Management Studio, rozšíření MSSQL pro Visual Studio Code nebo jiné externí nástroje.
  2. Vytvořte novou tabulku, uloženou proceduru nebo jiný objekt v databázi.
  3. Výběrem tlačítka Správa zdrojového kódu otevřete panel správy zdrojového kódu.
  4. Zaškrtněte políčko vedle požadované databáze. Vyberte Potvrdit. Služba Fabric čte definice objektů z databáze a zapisuje je do vzdáleného úložiště.
  5. Nyní můžete zobrazit historii databázových objektů ve zdrojovém zobrazení úložiště kódu.

Až budete pokračovat v úpravách databáze, včetně úprav existujících objektů, potvrďte tyto změny do správy zdrojového kódu pomocí předchozích kroků.

Soubor projektu SQL

Soubor projektu SQL v úložišti správy zdrojového kódu obsahuje metadata o databázi. Integrace správy zdrojového kódu v rámci systému Fabric používá tento soubor k přidání dalších funkcí do kanálů pro správu zdrojů a nasazování. Integrace správy zdrojového kódu Fabric automaticky generuje a aktualizuje soubor projektu. Vyhněte se ručním úpravám souboru projektu, protože úpravy souboru projektu budou přepsány integrací správy zdrojového kódu Fabric při dalším potvrzení z Fabric. Pokud ale chcete projekt SQL sestavit místně pomocí nástrojů SQL, jako je SQL Server Management Studio nebo rozšíření projektů SQL pro Visual Studio Code, můžete do master.dacpac souboru projektu přidat odkaz.

Integrace Fabric s projekty SQL přidává do souboru projektu následující vlastnosti metadat:

Funkce odkazů na systémové objekty je nastavena automaticky bez nutnosti žádné akce. Editor dotazů Fabric poskytuje skripty před nasazením a po nasazení ve složce Sdílené dotazy.

Aktualizace databáze SQL Fabric ze správy zdrojového kódu

V tomto scénáři vytvoříte databázové objekty jako kód v rozšíření projektů SQL v editoru Visual Studio Code a potom před aktualizací databáze SQL Fabric z integrace správy zdrojového kódu potvrdíte soubory do správy zdrojového kódu. Tento scénář se zaměřuje na vývojáře, kteří dávají přednost práci v editoru Visual Studio Code, mají stávající aplikace využívající projekty SQL nebo mají pokročilejší požadavky na kanál CI/CD.

  1. Ujistěte se, že jste nainstalovali nejnovější verzi editoru Visual Studio Code a rozšíření projektů MSSQL a SQL pro Visual Studio Code.
  2. Vytvořte ve svém pracovním prostoru novou databázi SQL a potvrďte ji do správy zdrojového kódu, aniž byste museli přidávat objekty. Tento krok přidá do úložiště prázdná metadata projektu SQL a položky databáze SQL.
  3. Naklonujte úložiště správy zdrojového kódu do místního počítače.
    • Pokud používáte Azure DevOps, vyberte kontextovou nabídku ... projektu správy zdrojového kódu. Vyberte Clone a zkopírujte úložiště Azure DevOps do místního počítače. Pokud s Azure DevOps začínáte, přečtěte si průvodce Code s gitem pro Azure DevOps.
    • Pokud používáte GitHub, vyberte tlačítko Code v úložišti a zkopírujte adresu URL pro klonování úložiště do místního počítače. Pokud s GitHubem začínáte, přečtěte si příručku klonování úložiště.
  4. Otevřete naklonovanou složku v Visual Studio Code. Větev přidružená k vašemu pracovnímu prostoru nemusí být výchozí. Po přepnutí větve by se měla zobrazit složka pojmenovaná <yourdatabase>.SQLDatabase v editoru Visual Studio Code.
  5. Vytvořte .sql soubor pro alespoň jednu tabulku, kterou chcete vytvořit v databázi ve struktuře složek pro vaši databázi. Soubor by měl obsahovat CREATE TABLE příkaz pro tabulku. Vytvořte například soubor pojmenovaný MyTable.sql ve složce dbo/Tables s následujícím obsahem: 
    CREATE TABLE dbo.MyTable
(
    Id INT PRIMARY KEY,
    ExampleColumn NVARCHAR(50)
);
  6. Pokud chcete zajistit platnost syntaxe, ověřte model databáze pomocí projektu SQL. Po přidání souborů použijte zobrazení Databázové projekty v editoru Visual Studio Code k sestavení projektu.
  7. Po úspěšném sestavení potvrďte soubory do správy zdrojového kódu pomocí zobrazení správy zdrojového kódu v editoru Visual Studio Code nebo preferovaného místního rozhraní Git.
  8. Nasdílejte/synchronizujte potvrzení do vzdáleného úložiště. Zkontrolujte, jestli se nové soubory zobrazují v Azure DevOps nebo GitHubu.
  9. Vraťte se do webového rozhraní Fabric a otevřete panel Správy zdrojového kódu v pracovním prostoru. Možná už máte upozornění, že "máte čekající změny z Git". Vyberte tlačítko Aktualizovat (Aktualizovat vše) a použijte kód z projektu SQL do databáze.
    • Po aktualizaci se může databáze okamžitě zobrazit jako nepotvrzená. K tomuto stavu dochází, protože funkce integrace Gitu přímo porovnává veškerý obsah souboru vygenerovaný pro definici položky a některé neúmyslné rozdíly jsou možné. Jedním z příkladů jsou atributy v řádku sloupců. V těchto případech je nutné provést zpětné potvrzení do systému správy zdrojového kódu ve webovém rozhraní Fabric, aby se definice synchronizovala s tím, co je vygenerováno během operace potvrzení.
  10. Po dokončení aktualizace se pomocí nástroje podle vašeho výběru připojte k databázi. Objekty, které jste přidali do projektu SQL, jsou viditelné v databázi.

Poznámka:

Pokud provedete změny místního projektu SQL a dojde k chybě syntaxe nebo použití nepodporovaných funkcí ve Fabric, aktualizace databáze selže. Než budete moct pokračovat, musíte změnu ve správě zdrojového kódu vrátit ručně.

Aktualizace SQL databáze v prostředí Fabric ze správy zdrojového kódu kombinuje sestavení SQL projektu a operaci publikování pomocí SqlPackage. Sestavení projektu SQL ověří syntaxi souborů SQL a vygeneruje .dacpac soubor. Operace publikování SqlPackage určuje změny potřebné k aktualizaci databáze tak, aby odpovídaly .dacpac souboru. Z důvodu zjednodušené povahy rozhraní Fabric se na operaci publikování SqlPackage použijí následující možnosti:

  • /p:ScriptDatabaseOptions = false
  • /p:DoNotAlterReplicatedObjects = false
  • /p:IncludeTransactionalScripts = true
  • /p:GenerateSmartDefaults = true

Můžete také naklonovat zdrojový řízený projekt SQL do místního počítače pro úpravy v nástroji Visual Studio Code, SQL Server Management Studio nebo jiných projektových nástrojů SQL. Před potvrzením změn do správy zdrojového kódu vytvořte projekt SQL místně a ověřte změny.

Vytvořte pracovní prostor větve

V tomto scénáři nastavíte nové vývojové prostředí ve Fabric tím, že necháte Fabric vytvořit duplicitní sadu prostředků na základě definice řízení verzí. Kopie databáze obsahuje databázové objekty, které jste umístili pod správu zdrojů. Tento scénář je určený pro vývojáře, kteří pokračují v životním cyklu vývoje aplikací na platformě Fabric a využívají integraci správy zdrojového kódu z Fabric.

  1. Dokončete scénář převodu databáze Fabric SQL na kód ve správě zdrojového kódu.
    • V úložišti správy zdrojového kódu byste měli mít větev s projektem SQL i metadaty objektu Fabric.
  2. V pracovním prostoru Fabric otevřete panel správy verzí. Na kartě Větve v nabídce Správa zdrojového kódu vyberte Možnost Větvení do nového pracovního prostoru.
  3. Zadejte názvy větve a pracovního prostoru, které chcete vytvořit. Větev se vytvoří v úložišti správy zdrojového kódu a naplní se potvrzeným obsahem větve přidruženého k pracovnímu prostoru, ze které větvení provádíte. Pracovní prostor je vytvořen ve Fabricu.
  4. Přejděte do nově vytvořeného pracovního prostoru ve Fabric. Po dokončení vytváření databáze teď nově vytvořená databáze obsahuje objekty zadané v úložišti kódu. Pokud otevřete editor dotazů Fabric a přejdete v Průzkumníku objektů, vaše databáze obsahuje nové (prázdné) tabulky a další objekty.

Sloučení změn z jedné větve do druhé

V tomto scénáři použijete úložiště správy zdrojového kódu ke kontrole změn databáze předtím, než budou k dispozici pro nasazení. Tento scénář je určený pro vývojáře, kteří pracují v týmovém prostředí a ke správě změn databáze používají správu zdrojového kódu.

Vytvořte dva pracovní prostory s přidruženými větvemi ve stejném úložišti, jak je popsáno v předchozím scénáři.

  1. U databáze v sekundární větvi proveďte změny databázových objektů.
    • Můžete například upravit existující uloženou proceduru nebo vytvořit novou tabulku.
  2. Tyto změny můžete komitovat do správy zdrojového kódu pomocí tlačítka Commit na panelu správy zdrojového kódu v Fabric.
  3. V Azure DevOps nebo GitHub vytvořte pull request z sekundární větve na primární větev.
    • V žádosti o přijetí změn uvidíte změny v kódu databáze mezi primárním pracovním prostorem a sekundárním pracovním prostorem.
  4. Po dokončení žádosti o přijetí změn se aktualizuje systém správy verzí, ale databáze ve Fabric v primárním pracovním prostoru se nezmění. Pokud chcete změnit primární databázi, aktualizujte primární pracovní prostor ze systému správy verzí pomocí tlačítka Aktualizovat na panelu systému správy verzí ve Fabric.

Správa statických dat pomocí skriptu po nasazení

V tomto scénáři řídíte řádky ve vyhledávací tabulce v databázi pomocí správy zdrojového kódu. Funkce, která umožňuje tuto funkci, skripty před nasazením a po nasazení, platí také pro kanály nasazení, takže ke správě statických dat v obou scénářích můžete použít stejné skripty.

  1. Z databáze SQL v prostředí Fabric, která je připojená ke správě zdrojového kódu, identifikujte nebo vytvořte tabulku, kterou chcete spravovat pro statická data. Můžete dbo.Colors mít například tabulku, která je používána vaší aplikací a má známou sadu hodnot, které se často nemění.

  2. Vytvořte nový dotaz v editoru databáze SQL ve Fabric. V editoru dotazů přidejte MERGE příkaz pro správu obsahu Colors tabulky. Například:

    MERGE dbo.Colors AS target
USING (VALUES
    (1, 'Red'),
    (2, 'Green'),
    (3, 'Blue')
) AS source (Id, Name)
ON target.Id = source.Id
WHEN MATCHED THEN
    UPDATE SET Name = source.Name
WHEN NOT MATCHED BY TARGET THEN
    INSERT (Id, Name) VALUES (source.Id, source.Name)
WHEN NOT MATCHED BY SOURCE THEN
    DELETE;

  3. Přejmenujte dotaz a Post-Deployment-StaticData.sql přesuňte ho do sdílených dotazů.

  4. Ve sdílených dotazech vyberte z nabídky ... dotazu a zvolte Nastavit jako skript po nasazení.

Tento dotaz se automaticky spustí jako součást jakékoli aktualizace ze systému správy zdrojového kódu nebo z kanálu nasazení, takže statická data v Colors tabulce můžete spravovat pomocí správy zdrojového kódu. Dotaz můžete upravit v editoru dotazů Fabric a potvrdit změny ve správě zdrojového kódu, abyste mohli v průběhu času spravovat změny statických dat. Kromě toho, protože skripty před nasazením a po nasazení jsou součástí projektu SQL, můžete také upravit dotaz z místního počítače pomocí editoru Visual Studio Code nebo jiných nástrojů projektu SQL a pak tyto změny potvrdit do správy zdrojového kódu. Další informace o skriptech před nasazením a po nasazení najdete v dokumentaci k projektům SQL.

Související obsah

  • Last updated on