Forrásvezérlő (előzetes verzió)

A következőre vonatkozik:✅ Raktár a Microsoft Fabric szolgáltatásban

Ez a cikk bemutatja, hogyan működnek a Git-integrációs és üzembehelyezési folyamatok a Microsoft Fabric-ben lévő raktárakban. Megtudhatja, hogyan állíthat be kapcsolatot az adattárral, kezelheti a raktárakat, és hogyan helyezheti üzembe őket különböző környezetekben. A Fabric Warehouse forrásvezérlése jelenleg előzetes verziójú funkció.

A Git-integrációs és üzembehelyezési folyamatokat is használhatja különböző forgatókönyvekhez:

  • Git- és SQL-adatbázisprojektek használatával kezelheti a növekményes változásokat, a csapatmunkát és a véglegesítési előzményeket az egyes adatbázis-objektumokban.
  • Telepítési folyamatokat használva előmozdítható a kódmódosítások különböző élesítés előtti és éles környezetekbe történő átvezetése.

Git-integráció

A Git Microsoft Fabric-integrációja lehetővé teszi a fejlesztők számára, hogy fejlesztési folyamataikat, eszközeiket és ajánlott eljárásaikat közvetlenül integrálják a Fabric platformba. Lehetővé teszi, hogy a Fabric fejlesztő fejlesztők a következőkre legyenek képesek:

  • A munkájuk biztonsági mentése és verziókezelése
  • Szükség szerint térjen vissza az előző szakaszokra
  • Együttműködés másokkal vagy egyedül a Git-ágak használatával
  • A jól ismert forrásvezérlő eszközök képességeinek alkalmazása Fabric elemek kezeléséhez

A Git integrációs folyamatával kapcsolatos további információkért lásd:

Kapcsolat beállítása a forrásvezérlővel

A Munkaterület beállításai lapon egyszerűen beállíthat egy kapcsolatot az adattárral a módosítások véglegesítéséhez és szinkronizálásához.

  1. A kapcsolat beállításához tekintse meg a Git-integráció első lépéseit. Kövesse az Utasításokat a Git-adattárhoz való csatlakozáshoz, hogy az Azure DevOps vagy a GitHub Git-szolgáltatóként működjön.
  2. A csatlakozás után az elemek, beleértve a raktárakat is, megjelennek a Forrás vezérlőpulton . Kép a raktár Fabric portáljáról a forráskód-kezelési beállításoknál.
  3. Miután sikeresen csatlakoztatta a raktárpéldányokat a Git-adattárhoz, megjelenik a raktármappák struktúrája az adattárban. Most már végrehajthatja a jövőbeli műveleteket, például lekéréses kérelmeket hozhat létre.

Adatbázisprojektek egy Git-beli raktárhoz

Az alábbi képen egy példa látható az adattárban található egyes raktárelemek fájlstruktúrájára:

Képernyőkép a mintaraktár-sémáról a Fabric portálon.

Amikor véglegesíti a raktárelemet a Git-adattárban, a rendszer sql-adatbázisprojektként konvertálja a raktárt forráskódformátummá. Az SQL-projektek olyan SQL-objektumok helyi ábrázolása, amelyek egyetlen adatbázis sémáját alkotják, például táblákat, tárolt eljárásokat vagy függvényeket. Az adatbázis-objektumok mappaszerkezete séma/objektumtípus szerint van rendszerezve. A raktár minden objektumát egy .sql fájl jelöli, amely tartalmazza az adatdefiníciós nyelv (DDL) definícióját. A raktártábla adatai és az SQL biztonsági funkciói nem szerepelnek az SQL Database-projektben.

A megosztott lekérdezések az adattárhoz is tartoznak, és öröklik a mentett nevet.

Telepítési csővezetékek

Telepítési csatornákat is használhat, hogy tárház kódját különböző környezetekbe telepítse, mint például a fejlesztési, tesztelési és produkciós környezetbe. Az üzembehelyezési folyamatok nem teszik elérhetővé az adatbázisprojekteket.

A következő lépésekkel fejezheti be a raktár üzembe helyezését a telepítési csővezeték használatával.

  1. Hozzon létre egy új üzembehelyezési folyamatot, vagy nyisson meg egy meglévő üzembehelyezési folyamatot. További információ: Bevezetés az üzembe helyezési folyamatok használatbavételéhez.
  2. Munkaterületek hozzárendelése különböző szakaszokhoz az üzembe helyezési céloknak megfelelően.
  3. Az alábbi példában látható módon válasszon ki, tekintse meg és hasonlítsa össze az elemeket, beleértve a raktárakat is. Screenshot a Fabric portálról, amely a fejlesztési, tesztelési és éles fázisokat mutatja.
  4. Válassza az Üzembe helyezés lehetőséget a raktárak üzembe helyezéséhez a fejlesztési, tesztelési és éles fázisokban.

További információkért a Fabric üzembe helyezési folyamatokról lásd: Bevezetés az üzembe helyezési folyamatokba.

A forrásvezérlés korlátozásai

A Git-integráció korlátai

  • Jelenleg, ha egy kényszert vagy oszlopot ad hozzá az adatbázisprojekthez a ALTER TABLE használatával, az üzembe helyezési folyamat törli és újraalkotja a táblát, ami az adatok elvesztéséhez vezet. A tábladefiníció és az adatok megőrzéséhez fontolja meg a következő alternatív megoldást:
    • Hozzon létre egy új másolatot a tábláról a raktárban a , , vagy a Táblaklón használatával.
    • Igény szerint módosítsa az új tábladefiníciót új megkötésekkel vagy oszlopokkal a használatával ALTER TABLE.
    • Törölje a régi táblát.
    • Nevezze át az új táblát a régi tábla nevére a sp_rename használatával.
    • Módosítsa a régi tábla definícióját az SQL Database-projektben pontosan ugyanúgy. A forrásvezérlőben lévő raktár SQL Database-projektjének és az élő raktárnak most egyeznie kell.
  • Jelenleg ne hozzon létre adatfolyam Gen2-t a raktár kimeneti célhelyével. Megjelenik egy új DataflowsStagingWarehouse elem a repozitóriumban, és akadályozza meg a Git-beli véglegesítést és frissítést.
  • Fabric Git-integráció nem támogatja az SQL Analytics végpontelemét.
  • Az SQL Analytics-végpont és a raktár közötti elemek közötti függőségek, elemek szekvenálása és szinkronizálási hiányosságai hatással vannak az "új vagy meglévő munkaterületre való elágaztatásra" és a "váltás másik ágra" munkafolyamatokra a fejlesztés és a folyamatos integráció során.

A telepítési csővezetékek korlátozásai

  • Jelenleg, ha egy kényszert vagy oszlopot ad hozzá az adatbázisprojekthez a ALTER TABLE használatával, az üzembe helyezési folyamat törli és újraalkotja a táblát, ami az adatok elvesztéséhez vezet.
  • Jelenleg ne hozzon létre adatfolyam Gen2-t a raktár kimeneti célhelyével. Megjelenik egy új elnevezett DataflowsStagingWarehouse elem az üzembehelyezési folyamatban, és letiltja az üzembe helyezést.
  • A Fabric üzembehelyezési folyamatok nem támogatják az SQL Analytics végpont elemét.
  • Az SQL-elemzési végpont és a raktár közötti függőségek, az elemek sorrendje és a szinkronizációs eltérések befolyásolják a Fabric Deployment Pipelines munkafolyamatait.

Nem támogatott forgatókönyvek

A következő CI/CD-munkafolyamatok hivatalosan nem támogatottak, ha a különböző munkaterületeken lévő raktárak eltérő összeállításokkal rendelkeznek. Annak ellenére, hogy ezek a műveletek hibák nélkül is sikeresek lehetnek, metaadat-hibákat eredményezhetnek.

Az összes ilyen esetben, ha rendezési eltérés történik, használja a Python szkriptet scripts/dw-collation-error-update-tmsl/pbi_interactive.py a Fabric eszközkészletben a GitHub adattárban az adathalmaz (TMSL) rendezésének frissítéséhez, hogy megfeleljen a raktári rendezésnek.

Scenario Leírás Kockázat
Telepítési csővezetékek Nem támogatott a raktártartalom előmozdítása folyamatszakaszokon keresztül (például Dev → Test → Prod), ahol a célraktár más rendezéssel lett létrehozva, mint a forrás. Az üzembe helyezés sikeres lehet, de az adathalmaz-rendezés nem frissül a célraktár-rendezésnek megfelelően.
Ágazás egy új vagy meglévő munkaterületre A Git-integráció használata egy meglévő munkaterületről egy új vagy meglévő munkaterületre való elágaztatáshoz, ahol a raktár más rendezéssel rendelkezik, nem támogatott. A rendszer szinkronizálja a raktár tartalmát, de a rendezési metaadatok nincsenek egyeztetve.
Ágak váltása munkaterületen A Githez csatlakoztatott munkaterületen nem támogatott egy másik rendezésű raktárhoz társított ágra váltás. A szinkronizált tartalom olyan rendezési feltételezéseket tartalmazhat, amelyek nem felelnek meg az aktuális raktárnak.
Módosítások egyesítése a munkaterületek között ágakon keresztül A Git-ágak egyesítése olyan munkaterületeken, ahol a raktárak különböző rendezésekkel rendelkeznek, nem támogatott. Az egyesítés a Git szintjén sikeres lehet, de az eredményül kapott adathalmaz-rendezés nem tükrözi a célraktár rendezését.

Kapcsolódó tartalom

  • Last updated on