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

Mi a Microsoft Fabric Git integrációja?

Ez a cikk bemutatja a fejlesztőknek, hogyan integrálhatók a Git-verziókövetés a Microsoft Fabric-alkalmazás életciklus-felügyeleti (ALM) eszközével.

Feljegyzés

A Git-integráció néhány eleme előzetes verzióban érhető el. További információkért tekintse meg a támogatott elemek listáját.

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

  • 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
  • Az ismerős forrásvezérlő eszközök képességeit alkalmazzuk a Fabric elemek kezelésére.

A forrásvezérlővel való integráció munkaterületi szinten van. A fejlesztők egyetlen folyamat során, az összes elem teljes körű láthatóságával verziószámba helyezhetik a munkaterületen belül fejlesztett elemeket. A munkaterület struktúrája, beleértve almappákat, megmarad a Git-adattárban.

Tekintse meg a támogatott elemek listáját.

Adatvédelmi információk

A Git-integráció engedélyezése előtt tekintse át az alábbi adatvédelmi nyilatkozatokat:

Támogatott Git-szolgáltatók

A következő Git-szolgáltatók támogatottak:

Támogatott elemek

Az alábbi elemek jelenleg támogatják a Git-integrációt:

Ha a munkaterület vagy a Git-címtár nem támogatott elemeket tartalmaz, akkor is csatlakoztatható, de a nem támogatott elemeket a rendszer figyelmen kívül hagyja. A rendszer nem menti vagy szinkronizálja őket, de azokat sem törli. Ezek megjelennek a forrás vezérlőpulton, de nem véglegesítheti vagy frissítheti őket.

Szempontok és korlátozások

Általános Git-integrációs korlátozások

  • A Fabric hitelesítési módszerének legalább olyan erősnek kell lennie, mint a Git hitelesítési módszere. Ha például a Git többtényezős hitelesítést igényel, a Fabricnek többtényezős hitelesítésre is szüksége van.
  • Az Analysis Serviceshez csatlakoztatott Power BI-adathalmazok jelenleg nem támogatottak.
  • Ha egy munkaterületi identitást használ egy összetevőben, és véglegesíti azt a Gitben, az csak az azonos identitáshoz csatlakoztatott munkaterületen frissíthető (vissza egy háló-munkaterületre). Legyen óvatos, mert ez olyan funkciókat is érinthet, mint az ágazás.
  • Az almodulok nem támogatottak.
  • A szuverén felhőszolgáltatások nem támogatottak.
  • Az Azure DevOps-fiókot ugyanarra a felhasználóra kell regisztrálni, aki a Fabric-munkaterületet használja.
  • Az Azure DevOps nem támogatott, ha az IP-alapú feltételes hozzáférési szabályzat érvényesítése engedélyezve van .
  • A bérlői rendszergazdának engedélyeznie kell a térinformatikai exportálást , ha a munkaterület és a Git-adattár két különböző földrajzi régióban található.
  • Ha a szervezet feltételes hozzáférést konfigurált, győződjön meg arról, hogy a Power BI szolgáltatásban ugyanazok a feltételek vannak beállítva , hogy a hitelesítés a várt módon működjön.
  • A véglegesítés mérete legfeljebb 125 MB lehet.

A GitHub Enterprise korlátozásai

Egyes GitHub Enterprise-verziók és -beállítások nem támogatottak. Példa:

  • GitHub Enterprise Cloud adatrezidenciával (ghe.com)
  • Az egyéni tartománnyal rendelkező GitHub Enterprise Server akkor sem támogatott, ha a példány nyilvánosan elérhető
  • Magánhálózaton üzemeltetett Github Enterprise Server
  • IP-engedélyezési lista

Munkaterület korlátozásai

  • Csak a munkaterület rendszergazdája kezelheti a Git-adattárhoz való kapcsolatokat, például a csatlakozást, a leválasztást vagy az ág hozzáadását.
    A csatlakozás után bárki dolgozhat a munkaterületen, aki rendelkezik engedéllyel .
  • A sablonalkalmazásokat tartalmazó munkaterületek nem csatlakoztathatók a Githez.
  • A MyWorkspace nem tud git-szolgáltatóhoz csatlakozni.

Ág- és mappakorlátozások

  • Az ágnév maximális hossza 244 karakter.
  • A fájlnevek teljes elérési útja legfeljebb 250 karakter hosszúságú lehet. A hosszabb nevek kudarcot vallanak.
  • A fájl maximális mérete 25 MB.
  • A mappastruktúra legfeljebb 10 szint mélységig megőrizhető.
  • A jelentés/adathalmaz .pbix formátumban való letöltése a szolgáltatásból a Git-integrációval való üzembe helyezés után nem ajánlott, mivel az eredmények megbízhatatlanok. Javasoljuk, hogy a PowerBI Desktop használatával töltse le a jelentéseket/adathalmazokat .pbix formátumban.
  • Ha az elem megjelenítendő neve ezen jellemzők bármelyikével rendelkezik, a Git-mappa átnevezve lesz a logikai azonosítóra (Guid) és írja be a következőt:
  • Ha mappákat tartalmazó munkaterületet csatlakoztat a Githez, módosításokat kell véglegesítenie a Git-adattárban, ha ez a mappastruktúra eltérő.

Címtárnév korlátozásai

  • A Git-adattárhoz csatlakozó könyvtár neve az alábbi elnevezési korlátozásokkal rendelkezik:

    • Címtár neve nem kezdődhet vagy végződhet szóközzel vagy tabulátorral.
    • A könyvtárnév nem tartalmazhat a következő karakterek egyikét sem: "/:<>\*|

  • Az elemmappa (az elemfájlokat tartalmazó mappa) nem tartalmazhat a következő karakterek egyikét sem: ":<>\*?|. Ha átnevezi a mappát egy ilyen karaktert tartalmazó mappára, a Git nem tud csatlakozni vagy szinkronizálni a munkaterülettel, és hiba történik.

Kiterjedési korlátozások

  • Az elágazáshoz engedélytáblában felsorolt engedélyek szükségesek.
  • Ehhez a művelethez rendelkezésre álló kapacitásnak kell lennie.
  • Az új munkaterületre való elágaztatáskor minden munkaterület- és ágelnevezési korlátozás érvényes.
  • Az új munkaterületen csak a Git által támogatott elemek érhetők el.
  • A kapcsolódó ágak listája csak azokat az ágakat és munkaterületeket jeleníti meg, amelyek megtekintéséhez engedéllyel rendelkezik.
  • A Git-integrációt engedélyezni kell.
  • Elágaztatáskor létrejön egy új ág, és az eredeti ág beállításai nem lesznek másolva. Módosítsa az összes beállítást vagy definíciót, hogy az új megfeleljen a szervezet szabályzatainak.
  • Meglévő munkaterületre való elágaztatáskor:
    • A cél-munkaterületnek támogatnia kell a Git-kapcsolatot.
    • A felhasználónak a cél-munkaterület rendszergazdájának kell lennie.
    • A cél-munkaterületnek kapacitással kell rendelkeznie.
    • A munkaterületen nem lehetnek sablonalkalmazások.
  • Vegye figyelembe, hogy amikor elágaztat egy munkaterületre, a Gitbe nem mentett elemek elveszhetnek. Javasoljuk, hogy az elágaztatás előtt véglegesítse a megőrizni kívánt elemeket.

Szinkronizálási és véglegesítési korlátozások

  • Egyszerre csak egy irányban szinkronizálhat. Nem véglegesítheti és nem frissítheti egyszerre.
  • A bizalmassági címkék nem támogatottak, és a bizalmassági címkékkel rendelkező elemek exportálása letiltható. Ha bizalmassági címkékkel rendelkező elemeket szeretne véglegesíteni a bizalmassági címke nélkül, kérjen segítséget a rendszergazdától .
  • Korlátozott elemekkel működik. A mappa nem támogatott elemeit a rendszer figyelmen kívül hagyja.
  • A nevek duplikálása nem engedélyezett. Még ha a Power BI engedélyezi is a név duplikálását, a frissítés, a véglegesítés vagy a visszavonási művelet meghiúsul.
  • A B2B támogatása nem biztosított.
  • Az ütközésfeloldás részben a Gitben történik.
  • A 'Commit to Git' folyamat során a Fabric szolgáltatás törli az elem mappában lévő fájlokat, amelyek nem részei az elemdefiníciónak. Az olyan fájlok, amelyek nem egy elemmappában vannak, nem törlődnek.
  • A módosítások véglegesítése után előfordulhat, hogy váratlan módosításokat tapasztal az elemen, amelyet nem végzett el. Ezek a változások szemantikailag jelentéktelenek, és több okból is előfordulhatnak. Például:
    • Az elemdefiníciós fájl manuális módosítása. Ezek a módosítások érvényesek, de eltérhetnek a szerkesztők által végzett módosításoktól. Ha például átnevez egy szemantikai modelloszlopot a Gitben, és importálja ezt a módosítást a munkaterületre, a szemantikai modell következő véglegesítésekor a bim-fájl módosultként regisztrál, a módosított oszlop pedig a columns tömb hátoldalára kerül. Ennek az az oka, hogy a bim-fájlokat létrehozó AS-motor az átnevezett oszlopokat a tömb végére küldi. Ez a módosítás nem befolyásolja az elem működését.
    • CRLF-sortöréseket használó fájl véglegesítése. A szolgáltatás LF (vonalcsatorna) sortöréseket használ. Ha a Git-adattárban CRLF-sortörésekkel rendelkező elemfájlok voltak, a szolgáltatásból való véglegesítéskor ezek a fájlok LF értékre változnak. Ha például megnyit egy jelentést az asztalon, mentse a projektfájlt (.pbip), és töltse fel a Gitbe a CRLF használatával.
  • A szemantikai modell továbbfejlesztett frissítési API-val való frissítése minden frissítés után Git-diffet eredményez.

Kapcsolódó tartalom