Zdieľať cez


Integrácia ovládacieho prvku zdrojovej databázy SQL v službe Microsoft Fabric

Vzťahuje sa na:databáza SQL v službe Microsoft Fabric

V tomto kurze sa naučíte pracovať s databázou SQL v službe Fabric s ovládacím prvkom zdroja integrácie služby Fabric git.

Databáza SQL v službe Microsoft Fabric má integráciu riadenia zdrojov alebo integráciu git, čo používateľom SQL umožňuje sledovať definície objektov databázy v priebehu času. Táto integrácia umožňuje tímu:

  • Potvrdiť databáze ako zdrojový ovládací prvok, ktorý automaticky konvertuje živú databázu na kód v nakonfigurovanom odkladacom priestore správy zdrojov (napríklad Azure DevOps).
  • Aktualizujte objekty databázy z obsahu správy zdrojového kódu, ktorý pred použitím diferenciálnej zmeny v databáze overuje kód v odkladacom priestore zdrojovej správy.

Diagram jednoduchého cyklu potvrdenia a aktualizácie medzi ovládacím prvkom dynamickej databázy a zdroja.

Ak nepoznáte systém git, tu je niekoľko odporúčaných zdrojov:

Tento článok popisuje sériu užitočných scenárov, ktoré je možné použiť jednotlivo alebo v kombinácii na spravovanie procesu vývoja s databázou SQL v službe Fabric:

Scenáre v tomto článku sú popísané v epizóde o vystavení údajov. Pozrite si video s prehľadom integrácie zdrojového ovládacieho prvku v službe Fabric:

Požiadavky

Inštalácia

Toto pripojenie k odkladaciemu priestoru sa vzťahuje na úrovni pracovného priestoru, aby bola k tomuto pracovnému priestoru priradená jedna vetva v odkladacom priestore. Odkladací priestor môže mať viacero vetiev, ale len kód vo vetve vybratej v nastaveniach pracovného priestoru bude priamo mať vplyv na pracovný priestor.

Kroky na pripojenie pracovného priestoru k odkladaciemu priestoru zdrojového ovládacieho prvku nájdete v téme Začíname s integráciou Git. Váš pracovný priestor môže byť pripojený k vzdialenému odkladaciemu priestoru Azure DevOps alebo GitHub.

Pridanie databázy Fabric SQL do ovládacieho prvku source

V tomto scenári odovzdáte objekty databázy do ovládacieho prvku zdroja. Možno vyvíjate aplikáciu, v ktorej vytvárate objekty priamo v testovacej databáze a sledujete ju v zdrojovej kontrole, rovnako ako kód aplikácie. Výsledkom je, že máte prístup k histórii definícií objektov databázy a môžete používať koncepty služby Git, ako napríklad vetvenie a zlúčenie, na ďalšie prispôsobovanie procesu vývoja.

  1. Pripojte sa k databáze SQL v editore Fabric SQL, SQL Server Management Studio, rozšírení mssql s Visual Studio Code alebo inými externými nástrojmi.
  2. Vytvorte novú tabuľku, uloženú procedúru alebo iný objekt v databáze.
  3. Vyberte ponuku ... pre databázu, vyberte položku Obnoviť stav synchronizácie systému Git.
  4. Výberom tlačidla Ovládací prvok Zdroj otvorte ovládací panel zdroja.
  5. Začiarknite políčko vedľa požadovanej databázy. Vyberte položku Potvrdiť. Služba Fabric prečíta definície objektov z databázy a zapíše ich do vzdialeného odkladacieho priestoru.
  6. Teraz môžete zobraziť históriu objektov databázy v zobrazení zdroja kódu.

Počas upravovania databázy vrátane úprav existujúcich objektov môžete potvrdiť tieto zmeny do ovládacieho prvku zdroja pomocou predchádzajúcich krokov.

Aktualizácia databázy Fabric SQL zo zdrojového ovládacieho prvku

V tomto scenári budete vytvárať objekty databázy ako kód v rozšírení projektov SQL v nástroji VS Code a potom odovzdáte súbory do zdrojového ovládacieho prvku pred aktualizáciou databázy Sql služby Fabric z integrácie zdrojového ovládacieho prvku. Tento scenár je zameraný na vývojárov, ktorí dávajú prednosť práci v nástroji VS Code, majú existujúce aplikácie používajúcie projekty SQL alebo majú pokročilejšie požiadavky na kanál CI/CD.

  1. Uistite sa, že ste nainštalovali najnovšie vydanie nástroja VS Code a rozšírenia projektov mssql a SQL pre VS Code.
  2. Vytvorte vo svojom pracovnom priestore novú databázu SQL a zaviazajte ju k ovládaciemu prvku zdroja bez toho, aby ste museli pridávať objekty. Tento krok pridá do odkladacieho priestoru prázdne metaúdaje projektu SQL a položky databázy SQL.
  3. Naklonujte odkladací priestor zdrojového ovládacieho prvku na lokálny počítač.
    • Ak používate Azure DevOps, vyberte kontextová ... ponuka pre projekt ovládacieho prvku zdroja. Vyberte položku Clone (Klonovať), aby ste mohli skopírovať odkladací priestor Azure DevOps do lokálneho počítača. Ak ste novým používateľom služby Azure DevOps, pozrite si tému Príručka Code with git pre Azure DevOps.
    • Ak používate GitHub, vyberte tlačidlo Kód v odkladacom priestore a skopírujte URL adresu na klonovanie odkladacieho priestoru do lokálneho počítača. Ak ste novým používateľom služby GitHub, pozrite si sprievodcu klonovaním odkladacieho priestoru.
  4. Otvorte klonovaný priečinok v programe Visual Studio Code. Vetva priradená k vášmu pracovnému priestoru možno nie je predvolená. Po prepnutí vetvy by sa mal zobraziť priečinok s názvom <yourdatabase>.SQLDatabase v nástroji VS Code.
  5. Vytvorte .sql súbor pre aspoň jednu tabuľku, ktorú by ste chceli vytvoriť v databáze v rámci štruktúry priečinkov databázy. Súbor by mal obsahovať CREATE TABLE príkaz pre tabuľku. Vytvorte napríklad súbor s názvom MyTable.sql v priečinku dbo/Tables s nasledujúcim obsahom:
    CREATE TABLE dbo.MyTable
    (
        Id INT PRIMARY KEY,
        ExampleColumn NVARCHAR(50)
    );
    
  6. S cieľom overiť platnosť syntaxe môžeme overiť model databázy pomocou projektu SQL. Po pridaní súborov vytvorte projekt pomocou zobrazenia Databázové projekty v nástroji VS Code.
  7. Po úspešnej zostave potvrdiť súbory ako zdrojovú kontrolu so zobrazením ovládacieho prvku zdroja v nástroji VS Code alebo preferovanom lokálnom rozhraní git.
  8. Presunutie/synchronizácia potvrdenia vo vzdialenom odkladacom priestore. Skontrolujte, či sa vaše nové súbory zobrazili v službách Azure DevOps alebo GitHub.
  9. Vráťte sa do webového rozhrania služby Fabric a otvorte v pracovnom priestore ovládací panel Zdroj. Je možné, že už máte upozornenie "čakáte na zmeny zo služby git". Vyberte tlačidlo Aktualizovať (Aktualizovať všetko) a použite kód z projektu SQL v databáze.
    • Databázu môže po aktualizácii ihneď vidieť pod názvom "Uncommitted". Je to preto, lebo funkcia integrácie so službou Git umožňuje priame porovnanie všetkého obsahu súboru vygenerovaného pre definíciu položky a niektoré neúmyselné rozdiely sú možné. Jedným z príkladov sú vložené atribúty v stĺpcoch. V týchto prípadoch sa budete musieť vrátiť k ovládaciemu prvku zdroja vo webovom rozhraní služby Fabric, aby ste synchronizovali definíciu s tým, čo sa vygeneruje ako súčasť operácie potvrdenia.
  10. Po dokončení aktualizácie sa pripojte k databáze pomocou nástroja, ktorý ste si vybrali. Objekty, ktoré ste pridali do projektu SQL viditeľné v databáze.

Poznámka

Ak sa pri vykonávaní zmien v lokálnom projekte SQL vyskytne syntaktická chyba alebo použitie nepodporovaných funkcií v službe Fabric, aktualizácia databázy zlyhá. Kým budete môcť pokračovať, musíte zmenu v ovládaní zdroja vrátiť manuálne.

Aktualizácia databázy SQL v službe Fabric zo zdrojového ovládacieho prvku kombinuje kompilovanie projektu SQL a operáciu publikovania v sqlpackage. Projekt SQL projekt overí syntax súborov SQL a vygeneruje súbor .dacpac. Operácia publikovania SqlPackage určila zmeny potrebné na aktualizáciu databázy tak, aby sa zhodovala so súborom .dacpac. Z dôvodu zjednodušeného charakteru rozhrania služby Fabric sa na operáciu publikovania sqlPackage použijú nasledujúce možnosti:

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

Projekt SQL, ktorý je kontrolovaný zdrojom, môže byť tiež klonovaný do lokálneho počítača na úpravu v nástrojoch VS Code, Visual Studio alebo iných projektových nástrojoch SQL. Projekt SQL by mal byť vytvorený lokálne na overenie zmien pred ich odoslaním do kontroly zdrojov.

Vytvorenie pracovného priestoru vetvy

V tomto scenári nastavíte nové vývojové prostredie v službe Fabric tým, že v službe Fabric vytvoríte duplicitnú množinu zdrojov na základe definície ovládacieho prvku zdroja. Duplicitná databáza bude obsahovať objekty databázy, ktoré sme skontrolovali do ovládacieho prvku zdroja. Tento scenár je zameraný na vývojárov, ktorí pokračujú v životnom cykle vývoja aplikácií v službe Fabric a využívajú integráciu ovládania zdroja zo služby Fabric.

  1. Dokončite scenár a skonvertujte databázu SQL fabric na kód v ovládaní zdroja.
    • Mali by ste mať vetvu v odkladacom priestore zdrojovej kontroly s projektom SQL aj metaúdajmi objektu fabric.
  2. V pracovnom priestore služby Fabric otvorte ovládací panel zdroja. Na karte Vetvy v ponuke Ovládací prvok Zdroj vyberte položku Vetviť do nového pracovného priestoru.
  3. Zadajte názvy vetvy a pracovného priestoru, ktoré sa vytvoria. Vetva sa vytvorí v odkladacom priestore zdrojovej kontroly a vyplní sa súvisiacim obsahom vetvy priradenej k pracovnému priestoru, z ktorého vetvíte. Pracovný priestor sa vytvorí v službe Fabric.
  4. Prejdite do novovytvoreného pracovného priestoru v službe Fabric. Po dokončení vytvárania databázy novovytvorená databáza teraz obsahuje objekty zadané v odkladacom priestore kódu. Ak otvoríte editor dotazov služby Fabric a prejdete v časti Prieskumník objektov, databáza obsahuje nové (prázdne) tabuľky a ďalšie objekty.

Zlúčenie zmien z jednej vetvy do druhej

V tomto scenári budete používať odkladací priestor zdrojového ovládacieho prvku na kontrolu zmien databázy predtým, ako budú k dispozícii na nasadenie. Tento scenár je zameraný na vývojárov, ktorí pracujú v tímovom prostredí a na spravovanie zmien v databáze používajú zdrojovú kontrolu.

Vytvorte dva pracovné priestory s priradenými vetvami v tom istom odkladacom priestore, ako je to popísané v predchádzajúcom scenári.

  1. Keď je databáza na druhej vetve, vykonávať zmeny v objektoch databázy.
    • Môžete napríklad upraviť existujúcu uloženú procedúru alebo vytvoriť novú tabuľku.
  2. Skontrolujte tieto zmeny v ovládacom prvku zdroja pomocou tlačidla Potvrdiť na ovládacom paneli zdroja v službe Fabric.
  3. V službách Azure DevOps alebo GitHub vytvorte žiadosť o prijatie zmien zo sekundárnej vetvy do primárnej vetvy.
    • V žiadosti o prijatie zmien môžete vidieť zmeny v kóde databázy medzi primárnym pracovným priestorom a sekundárnym pracovným priestorom.
  4. Po dokončení žiadosti o prijatie zmien sa aktualizuje ovládací prvok zdroja, ale databáza v službe Fabric v primárnom pracovnom priestore sa nezmení. Ak chcete zmeniť primárnu databázu, aktualizujte primárny pracovný priestor z ovládacieho prvku zdroja pomocou tlačidla Aktualizovať na paneli ovládacieho prvku zdroja v službe Fabric.