Megosztás a következőn keresztül:

SQL-adatbázis forrásvezérlési integrációja a Microsoft Fabricben

  • Cikk

A következőre vonatkozik:✅ SQL-adatbázis a Microsoft Fabricben

Ebben az oktatóanyagban megtudhatja, hogyan használhatja az SQL-adatbázist a Fabric git integrációs forrásvezérlőjében.

A Microsoft Fabricben található SQL-adatbázisok forrásvezérlési integrációval vagy "git-integrációval" rendelkeznek, így az SQL-felhasználók idővel nyomon követhetik az adatbázis-objektumaik definícióit. Ez az integráció lehetővé teszi a csapat számára a következőket:

  • Véglegesítse az adatbázist a forrásvezérlőre, amely automatikusan kóddá alakítja az élő adatbázist a konfigurált forrásvezérlő adattárban (például az Azure DevOpsban).
  • Frissítse az adatbázis-objektumokat a forrásvezérlő tartalmából, amely ellenőrzi a forrásvezérlő-adattár kódját, mielőtt különbségi módosítást alkalmaz az adatbázisra.

Az élő adatbázis és a forrásvezérlő közötti egyszerű véglegesítési és frissítési ciklus diagramja.

Ha nem ismeri a gitet, íme néhány ajánlott erőforrás:

Ez a cikk hasznos forgatókönyveket mutat be, amelyek egyenként vagy kombinálva kezelhetők a fejlesztési folyamattal az SQL Database-ben a Fabricben:

A cikkben szereplő forgatókönyveket a Közzétett adatok egy epizódja ismerteti. Tekintse meg a videót a Fabric forrásvezérlési integrációjának áttekintéséhez:

Előfeltételek

Beállítás

Ez az adattár-kapcsolat a munkaterület szintjén érvényes, így az adattár egyetlen ága is hozzá van rendelve ehhez a munkaterülethez. Az adattár több ágból is rendelkezhet, de csak a munkaterület beállításai között kijelölt ág kódja lesz közvetlenül hatással a munkaterületre.

A munkaterület forrásvezérlő adattárhoz való csatlakoztatásának lépéseit a Git-integráció első lépései című témakörben találja. A munkaterület csatlakoztatható egy Azure DevOps- vagy GitHub-távoli adattárhoz.

A Fabric SQL-adatbázis hozzáadása a forrásvezérlőhöz

Ebben a forgatókönyvben adatbázis-objektumokat fog véglegesíteni a forrásvezérlőben. Előfordulhat, hogy olyan alkalmazást fejleszt, amelyben objektumokat hoz létre közvetlenül egy tesztadatbázisban, és az adatbázist a forrásvezérlőben követi nyomon, ugyanúgy, mint az alkalmazás kódját. Ennek eredményeképpen hozzáférhet az adatbázis-objektumok definícióinak előzményeihez, és a Git-fogalmakat, például az elágaztatást és az egyesítést használhatja a fejlesztési folyamat további testreszabásához.

  1. Csatlakozzon az SQL-adatbázishoz a Fabric SQL-szerkesztőben, az SQL Server Management Studióban, az mssql-bővítményben a Visual Studio Code-tal vagy más külső eszközökkel.
  2. Hozzon létre egy új táblát, tárolt eljárást vagy más objektumot az adatbázisban.
  3. Válassza ki az ... adatbázis menüjét, és válassza a Git szinkronizálási állapotának frissítése lehetőséget.
  4. A Forrás vezérlőelem gombra kattintva nyissa meg a forrás vezérlőpultját.
  5. Jelölje be a kívánt adatbázis melletti jelölőnégyzetet. Válassza a Véglegesítés lehetőséget. A Fabric szolgáltatás beolvassa az objektumdefiníciókat az adatbázisból, és beírja őket a távoli adattárba.
  6. Most már megtekintheti az adatbázis-objektumok előzményeit a kódtár forrásnézetében.

Mivel továbbra is szerkeszti az adatbázist, beleértve a meglévő objektumok szerkesztését is, ezeket a módosításokat véglegesítheti a forrásvezérlőben az előző lépések végrehajtásával.

A Fabric SQL-adatbázis frissítése a forrásvezérlőből

Ebben a forgatókönyvben az SQL-projektek bővítményében kódként fog adatbázis-objektumokat létrehozni a VS Code-ban, majd véglegesítenie kell a fájlokat a forrásvezérlőhöz, mielőtt frissítené a Fabric SQL-adatbázist a forrásvezérlő-integrációból. Ez a forgatókönyv olyan fejlesztőknek szól, akik inkább a VS Code-ban dolgoznak, sql-projekteket használó meglévő alkalmazásokkal rendelkeznek, vagy fejlettebb CI-/CD-folyamatkövetelményekkel rendelkeznek.

  1. Győződjön meg arról, hogy telepítette a VS Code legújabb kiadását, valamint a VS Code mssql- és SQL-projektbővítményeit.
  2. Hozzon létre egy új SQL-adatbázist a munkaterületen, és véglegesítse azt a forrásvezérlőben objektumok hozzáadása nélkül. Ez a lépés hozzáadja az üres SQL-projekt és az SQL-adatbáziselem metaadatait az adattárhoz.
  3. Klónozza a forrásvezérlő adattárat a helyi gépre.
    • Az Azure DevOps használata esetén válassza a ... forrásvezérlő projekt helyi menüjét. Válassza a Klónozás lehetőséget az Azure DevOps-adattár helyi gépre másolásához. Ha még nem ismerkedik az Azure DevOpsszal, tekintse meg az Azure DevOps git-útmutatóját tartalmazó kódot.
    • Ha GitHubot használ, kattintson az adattár Kód gombjára, és másolja az URL-címet az adattár klónozásához a helyi gépre. Ha még csak most ismerkedik a GitHubbal, tekintse meg az adattár-útmutató klónozását .
  4. Nyissa meg a klónozott mappát a Visual Studio Code-ban. Előfordulhat, hogy a munkaterülethez társított ág nem az alapértelmezett. Az ág váltása után meg kell jelennie a VS Code-ban elnevezett <yourdatabase>.SQLDatabase mappának.
  5. Hozzon létre egy .sql fájlt legalább egy olyan táblához, amely az adatbázis mappastruktúrájában található. A fájlnak tartalmaznia kell a CREATE TABLE tábla utasítását. Hozzon létre például egy fájlt MyTable.sql a mappában dbo/Tables a következő tartalommal: 
    CREATE TABLE dbo.MyTable
(
    Id INT PRIMARY KEY,
    ExampleColumn NVARCHAR(50)
);
  6. Annak érdekében, hogy a szintaxis érvényes legyen, érvényesíthetjük az adatbázismodellt az SQL-projekttel. A fájlok hozzáadása után használja az Adatbázisprojektek nézetet a VS Code-ban a projekt létrehozásához .
  7. Sikeres buildelés után véglegesítse a fájlokat a forrásvezérlő nézettel a VS Code-ban vagy az előnyben részesített helyi Git-felületen.
  8. A véglegesítés leküldése/szinkronizálása a távoli adattárba. Ellenőrizze, hogy megjelentek-e az új fájlok az Azure DevOpsban vagy a GitHubon.
  9. Térjen vissza a Fabric webes felületére, és nyissa meg a Forrás vezérlőpultot a munkaterületen. Lehet, hogy már van egy riasztása, amely szerint "függőben van a git módosítása". A Frissítés (Az összes frissítése) gombra kattintva alkalmazza az SQL-projekt kódját az adatbázisra.
    • Előfordulhat, hogy az adatbázis azonnal jelzi, hogy a frissítés után "Véglegesítetlen". Ennek az az oka, hogy a Git Integration szolgáltatás közvetlenül összehasonlítja az elemdefinícióhoz létrehozott összes fájltartalmat, és lehetséges néhány véletlen eltérés. Ilyenek például az oszlopok beágyazott attribútumai. Ezekben az esetekben vissza kell véglegesítenie a forrásvezérlőt a Fabric webes felületén, hogy szinkronizálja a definíciót a véglegesítési művelet részeként létrehozott definícióval.
  10. Miután a frissítés befejeződött, egy tetszőleges eszközzel csatlakozzon az adatbázishoz. Az sql-projekthez hozzáadott objektumok láthatók az adatbázisban.

Feljegyzés

A helyi SQL-projekt módosításakor, ha szintaxishiba vagy nem támogatott funkciók használata történik a Fabricben, az adatbázis frissítése sikertelen lesz. A folytatáshoz manuálisan kell visszaállítania a módosítást a forrásvezérlőben.

Egy SQL-adatbázis frissítése a Fabricben a forrásvezérlőből egyesíti az SQL-projekt buildelési és az SqlPackage-közzétételi műveletet. Az SQL-projekt összeállítása ellenőrzi az SQL-fájlok szintaxisát, és létrehoz egy .dacpac fájlt. Az SqlPackage közzétételi művelete meghatározta az adatbázis frissítéséhez szükséges módosításokat a .dacpac fájlnak megfelelően. A Fabric felület egyszerűsített jellege miatt a rendszer a következő beállításokat alkalmazza az SqlPackage közzétételi műveletére:

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

A forrásvezérelt SQL-projekt a helyi gépre is klónozva szerkeszthető a VS Code, a Visual Studio vagy más SQL-projekteszközök használatával. Az SQL-projektet helyileg kell létrehozni, hogy érvényesítse a módosításokat, mielőtt véglegesíti őket a forrásvezérlésre.

Ág-munkaterület létrehozása

Ebben a forgatókönyvben egy új fejlesztési környezetet fog beállítani a Fabricben úgy, hogy a Fabric a forrásvezérlő definíciója alapján duplikált erőforráskészletet hoz létre. A duplikált adatbázis tartalmazza azokat az adatbázis-objektumokat, amelyeket a forrásvezérlőbe ellenőriztünk. Ez a forgatókönyv olyan fejlesztőknek szól, amelyek folytatják az alkalmazásfejlesztési életciklusukat a Fabricben, és a Fabric forrásvezérlési integrációját használják.

  1. Végezze el azt a forgatókönyvet , amely a Fabric SQL-adatbázist kódmá alakítja a forrásvezérlőben.
    • Egy SQL-projekttel és a Fabric objektum metaadataival rendelkező forrásvezérlő adattárban kell lennie egy ágnak.
  2. A Háló munkaterületen nyissa meg a forrás vezérlőpultját . A Forrás vezérlőelem menü Ágak lapján válassza az Elágazás lehetőséget az új munkaterületre.
  3. Adja meg a létrehozandó ág és munkaterület nevét. Az ág a forrásvezérlő adattárban lesz létrehozva, és az elágaztatáshoz tartozó ág véglegesített tartalmával lesz feltöltve. A munkaterület a Fabricben jön létre.
  4. Lépjen az újonnan létrehozott munkaterületre a Fabricben. Az adatbázis létrehozása után az újonnan létrehozott adatbázis mostantól tartalmazza a kódtárban megadott objektumokat. Ha megnyitja a Háló lekérdezésszerkesztőt, és az Objektumkezelőben navigál, az adatbázis új (üres) táblákkal és egyéb objektumokkal rendelkezik.

Módosítások egyesítése egyik ágból a másikba

Ebben a forgatókönyvben a forrásvezérlő adattár használatával fogja áttekinteni az adatbázis módosításait, mielőtt azok üzembe helyezésre elérhetők lennének. Ez a forgatókönyv olyan fejlesztőknek szól, amelyek csapatkörnyezetben dolgoznak, és forrásvezérlőt használnak az adatbázis-módosítások kezeléséhez.

Hozzon létre két munkaterületet a társított ágakkal ugyanabban az adattárban, az előző forgatókönyvben leírtak szerint.

  1. Ha az adatbázis a másodlagos ágon van, módosítsa az adatbázis-objektumokat.
    • Módosíthatja például egy meglévő tárolt eljárást, vagy létrehozhat egy új táblát.
  2. A Forrásvezérlő módosításainak beadása a Fabric forrásvezérlő paneljén található Véglegesítés gombbal.
  3. Az Azure DevOpsban vagy a GitHubon hozzon létre egy lekéréses kérelmet a másodlagos ágról az elsődleges ágra.
    • A lekéréses kérelemben láthatja az adatbázis kódjának változásait az elsődleges munkaterület és a másodlagos munkaterület között.
  4. A lekéréses kérelem befejezése után a forrásvezérlő frissül, de az elsődleges munkaterület hálójában lévő adatbázis nem módosul. Az elsődleges adatbázis módosításához frissítse az elsődleges munkaterületet a forrásvezérlőről a Fabric forrásvezérlő paneljének Frissítés gombjával.

Kapcsolódó tartalom