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

A Git-integráció alapfogalmai

Ez a cikk a Git alapfogalmait és a Git Microsoft Fabric-munkaterülettel való integrálásának folyamatát ismerteti.

Engedélyek

  • A szervezet rendszergazdájának engedélyeznie kell a Git-integrációt.
  • A bérlői rendszergazdának engedélyeznie kell a kereszt-geó exportálást, ha a munkaterület és az Azure tárház két különböző régióban található. Ez a korlátozás nem vonatkozik a GitHubra.
  • A munkaterületen és a Gitben a következő szakaszokban felsorolt engedélyek határozzák meg a végrehajtandó műveleteket.

Az alábbi lista azt mutatja be, hogy a különböző munkaterületi szerepkörök milyen műveleteket végezhetnek a Git-adattárban lévő engedélyüktől függően:

  • Rendszergazda: Bármilyen műveletet végrehajthat a munkaterületen, csak a Git-szerepköre korlátozza.
  • Tag/közreműködő: Miután csatlakoztak egy munkaterülethez, a tagok/közreműködők a Git-szerepkörüktől függően véglegesíthetik és frissíthetik a módosításokat. A munkaterület-kapcsolattal kapcsolatos műveletekhez (például csatlakozáshoz, leválasztáshoz vagy ágak váltásához) kérjen segítséget egy rendszergazdától.
  • Megtekintő: Nem hajthat végre semmilyen műveletet. A megtekintő nem látja a Gittel kapcsolatos információkat a munkaterületen.

Munkaterületi szerepkörök

Az alábbi táblázat a Fabric munkaterületen a különböző gyakori műveletek végrehajtásához szükséges engedélyeket ismerteti:

Művelet Munkaterületi szerepkör
Munkaterület csatlakoztatása a Git-adattárhoz Adminisztrátor
Munkaterület szinkronizálása a Git-adattárral Adminisztrátor
A munkaterület lecsatlakoztatása a Git-adattárról Adminisztrátor
Ág váltása a munkaterületen (vagy a kapcsolati beállítás bármilyen módosítása) Adminisztrátor
Git-kapcsolat részleteinek megtekintése Rendszergazda, tag, közreműködő
A 'Git állapot' munkaterület megtekintése Rendszergazda, tag, közreműködő
Frissítés a Gitből Az alábbi szerepkörök mindegyike:

Közreműködő a munkaterületen (írási engedély az összes elemre)

Az elem tulajdonosa (ha a bérlői kapcsoló letiltja a nem tulajdonos frissítéseket)

Építsünk a külső függőségekre (ahol alkalmazható)
Munkaterület-módosítások véglegesítése a Gitben Az alábbi szerepkörök mindegyike:

Közreműködő a munkaterületen (írási engedély az összes elemre)

Az elem tulajdonosa (ha a bérlői kapcsoló letiltja a nem tulajdonos frissítéseket)

Építsünk a külső függőségekre (ahol alkalmazható)
Új Git-ág létrehozása a Hálón belülről Adminisztrátor
Áttérés egy másik munkaterületre Rendszergazda, tag, közreműködő

Git szerepkörök

Az alábbi táblázat a különböző gyakori műveletek végrehajtásához szükséges Git-engedélyeket ismerteti:

Művelet Git-engedélyek
Munkaterület csatlakoztatása a Git-adattárhoz Olvas=Engedélyez
Munkaterület szinkronizálása a Git-adattárral Olvas=Engedélyez
A munkaterület lecsatlakoztatása a Git-adattárról Nincs szükség engedélyekre
Ág váltása a munkaterületen (vagy a kapcsolati beállítás bármilyen módosítása) Olvasás=Engedélyezés (a céladattárban/könyvtárban/ágban)
Git-kapcsolat részleteinek megtekintése Olvasás vagy egyik sem
A 'Git állapot' munkaterület megtekintése Olvas=Engedélyez
Frissítés a Gitből Olvas=Engedélyez
Munkaterület-módosítások véglegesítése a Gitben Olvas=Engedélyez
Hozzájárulás=Engedélyezés
Az ágpolitika engedélyezze a közvetlen elköteleződést.
Új Git-ág létrehozása a Hálón belülről Szerep=Írás
Ág létrehozása=Engedélyezés
Áttérés egy másik munkaterületre Olvas=Engedélyez
Ág létrehozása=Engedélyezés

Csatlakozás és szinkronizálás

A munkaterületet csak a munkaterület rendszergazdája csatlakoztathatja a Git-adattárakhoz, de a csatlakozás után bárki, aki rendelkezik engedéllyel, dolgozhat a munkaterületen. Ha Ön nem rendszergazda, kérjen segítséget a rendszergazdától a csatlakozáshoz.

Amikor egy munkaterületet a Githez csatlakoztat, a Fabric szinkronizál a két hely között, így ugyanazzal a tartalommal rendelkeznek. A kezdeti szinkronizálás során, ha a munkaterület vagy a Git-ág üres, míg a másik tartalommal rendelkezik, a rendszer a tartalmat a nem létező helyről az üresre másolja. Ha a munkaterület és a Git-ág is rendelkezik tartalommal, el kell döntenie, hogy a szinkronizálás melyik irányba haladjon.

  • Ha a munkaterületet a Git-ágra véglegesíti, a program minden támogatott munkaterületi tartalmat exportál a Gitbe, és felülírja az aktuális Git-tartalmat.
  • Ha Git-tartalommal frissíti a munkaterületet, a munkaterület tartalma felülíródik, és elveszíti a munkaterület tartalmát. Mivel a Git-ág mindig visszaállítható egy korábbi fázisba, míg a munkaterület nem, ezért, ha ezt a lehetőséget választja, a rendszer kérni fogja a megerősítést.

Képernyőkép a párbeszédpanelről, amely megkérdezi, hogy melyik irányban kell szinkronizálni, ha a Git és a munkaterület is rendelkezik tartalommal.

Ha nem választja ki a szinkronizálandó tartalmat, nem folytathatja a munkát.

Képernyőkép arról, hogy a munkaterület szinkronizálásáig nem folytathatja a munkát.

Mappák

Csatlakozáskor és szinkronizáláskor a munkaterület struktúrája tükrözve lesz a Git-adattárban, beleértve a mappák struktúráját is. A mappák munkaterület-elemei a Git-adattár azonos nevű mappáiba lesznek exportálva. Ezzel szemben a Git-mappák elemei a munkaterület azonos nevű mappáiba lesznek importálva.

Megjegyzés

Mivel a mappastruktúra megmarad, ha a munkaterületen vannak mappák, és a csatlakoztatott Git-mappa még nem rendelkezik almappákkal, azokat eltérőnek tekintjük. A forráskezelő panelen kap egy nem véglegesített módosításokat állapotot, és a munkaterület frissítése előtt véglegesítenie kell a módosításokat a Gitben. Ha először frissít, a Git-mappastruktúra felülírja a munkaterület mappastruktúráját. További információ: Mappamódosítások biztonságos kezelése.

Munkaterület és a hozzá tartozó Git-ág almappákkal ellátott képernyőképe.

  • Az üres mappákat a rendszer nem másolja a Gitbe. Amikor elemeket hoz létre vagy helyez át egy mappába, a mappa a Gitben jön létre.
  • A Git üres mappái automatikusan törlődnek.
  • A munkaterület üres mappái akkor sem törlődnek automatikusan, ha az összes elem más mappába kerül.
  • A mappastruktúra legfeljebb 10 szint mélyre van megőrzve.

Mappamódosítások biztonságos kezelése

Ha a munkaterületen vannak mappák, és a csatlakoztatott Git-mappa még nem rendelkezik almappákkal, azokat eltérőnek tekintjük, mert a mappastruktúra eltérő. Ha mappákat tartalmazó munkaterületet csatlakoztat a Githez, nem véglegesített módosításokat állapotot kap a forrás vezérlőpulton, és a módosításokat véglegesítenie kell a Gitben a munkaterület frissítése előtt.

Ha a fiókszabályzat vagy az engedélyek miatt nem tud közvetlenül módosításokat végezni a csatlakoztatott ágon, javasoljuk a Kijelölési ág lehetőség használatát:

  1. Egy új ág kiválasztása: A branch checkout funkcióval hozzon létre egy ágat a Fabric munkaterület frissített állapotával.
  2. Mappamódosítások véglegesítése: Bármely munkaterület mappamódosítása ezen az új ágon véglegesítve lehet.
  3. Módosítások egyesítése: A megszokott pull request (PR) és egyesítési folyamatok használatával integrálhatja ezeket a frissítéseket az eredeti ágba.

Csatlakozás megosztott munkaterülethez

Ha olyan munkaterülethez próbál csatlakozni, amely már kapcsolódik a Githez, a következő üzenethez juthat:

A Git-fiókba való bejelentkezést jelző hibaüzenet képernyőképe.

Lépjen a Forrás vezérlőpult jobb oldalán található Fiókok lapra, válasszon ki egy fiókot, és csatlakozzon hozzá.

Képernyőkép a Fiókok lapról, amelyen a felhasználó egy GitHub-fiókhoz csatlakozik.

Git állapota

A csatlakozás után a munkaterület egy Git állapotoszlopot jelenít meg, amely a munkaterület egyes elemeinek szinkronizálási állapotát jelzi a távoli ág elemeihez képest.

Képernyőkép, ha egy munkaterület elemei a Git-állapotukat tagolva jelennek meg.

Minden elem az alábbi állapotok egyikével rendelkezik:

  • Szinkronizálva (az elem ugyanaz a munkaterületen és a Git-ágban)
  • Ütközés (az elem a munkaterületen és a Git branch-ban is módosult)
  • Nem támogatott elem
  • Nem véglegesített módosítások a munkaterületen
  • Frissítés szükséges a Gittől
  • Az elem mindkét helyen azonos, de frissíteni kell az utolsó véglegesítésre

Szinkronizálási információk

Amíg csatlakozik, a következő információk jelennek meg a képernyő alján:

  • Csatlakoztatott ág
  • Az utolsó szinkronizálás időpontja
  • A hivatkozás az utolsó commithez, amelyhez a munkaterület szinkronizálva van

Képernyőkép a githez való csatlakozáskor a képernyő alján megjelenő szinkronizálási információkról.

Forrásvezérlő panel

A képernyő tetején a Forrás vezérlőelem ikon látható. A munkaterületen és a Git-ágban eltérő elemek számát jeleníti meg. Amikor módosításokat végeznek a munkaterületen vagy a Git-ágon, a szám frissül. Amikor a munkaterület szinkronizálva van a Git-ággal, a Forrás vezérlőelem ikon 0-t jelenít meg.

Képernyőkép a forrásvezérlő ikonról, amelyen a nulla elem megváltozott.

A Forrás vezérlőpult megnyitásához válassza a Forrás vezérlő ikont.

A forrásvezérlő panel oldalán három fül található:

Véglegesítések és frissítések

Ha módosításokat végez a munkaterületen vagy a Git-ágon, a forrásvezérlő ikon a különböző elemek számát jeleníti meg. A Forrás vezérlőpult megnyitásához válassza a forrásvezérlő ikont.

A Véglegesítés és frissítés panel két szakaszból áll.

A módosítások a munkaterületen módosított elemek számát jelenítik meg, amelyeket le kell kötelezni a Gitre.
A frissítések a Git-ágban módosított és a munkaterületre frissíteni kívánt elemek számát jelenítik meg.

Az egyes szakaszokban a módosított elemek az állapotot jelző ikonnal jelennek meg:

  • új
  • módosított
  • törölt
  • konfliktus
  • ugyanazokkal a módosításokkal

A panel tetején található Frissítés gomb frissíti a módosítások és frissítések listáját.

Képernyőkép a forrás vezérlőpultról, amelyen a módosított elemek állapota látható.

Elkötelezés

  • A munkaterület módosított elemei a Módosítások szakaszban jelennek meg. Ha több módosított elem is van, kiválaszthatja, hogy mely elemeket szeretné véglegesíteni a Git-ágban.
  • Ha frissítések történtek a Git-ágon, a munkaterület frissítéséig a véglegesítések nem hajthatók végre.

Frissítés

  • A véglegesítéssel és visszavonással ellentétben a Frissítés parancs mindig frissíti a teljes ágat, és a legutóbbi véglegesítéssel szinkronizál. Nem jelölhet ki bizonyos frissítendő elemeket.
  • Ha módosításokat hajtottak végre a munkaterületen és a Git ágban ugyanazon az elemen, a frissítések az ütközés feloldásáig le lesznek tiltva.

További információ a véglegesítésről és a frissítésről. További információ a frissítési folyamatról és az ütközések megoldásáról.

Ágak / Fiókok

A Forrás vezérlőpult Ágak lapja lehetővé teszi az ágak kezelését és az ághoz kapcsolódó műveletek végrehajtását. Két fő szakasza van:

  • Az aktuális ágon végrehajtható műveletek:

    • Átlépés egy másik munkaterületre (közreműködők és magasabb jogosultságúak): Új munkaterületet hoz létre, vagy egy meglévő munkaterületre vált az aktuális munkaterület utolsó elkötelezése alapján. Ezután csatlakozik a cél munkaterülethez és ághoz.
    • Új ág létrehozása (Csak rendszergazdák számára elérhető a munkaterületen): Létrehoz egy új ágat a munkaterület utolsó szinkronizált commitja alapján, és módosítja a Git-kapcsolatot az aktuális munkaterületen. Ez nem módosítja a munkaterület tartalmát.
    • Ágváltás (munkaterület-rendszergazdának kell lennie): Szinkronizálja a munkaterületet egy másik új vagy meglévő ággal, és felülbírálja a munkaterület összes elemét a kijelölt ág tartalmával.

    Képernyőkép a forrásvezérlő panel

  • Kapcsolódó ágak.
    Az Ágak lap a kapcsolódó munkaterületek listáját is tartalmazza, amelyekre kiválaszthatja és átállíthatja azokat. A kapcsolódó munkaterületek az aktuális ággal azonos kapcsolati tulajdonságokkal rendelkeznek, például ugyanazzal a szervezettel, projekttel, adattárral és Git-mappával.
    Ez a funkció lehetővé teszi, hogy az aktuális munkája kontextusához kapcsolódó egyéb ágakhoz tartozó munkaterületek között navigáljon anélkül, hogy keresgélnie kellene ezeket a Fabric munkaterületei listájában.
    A megfelelő munkaterület megnyitásához válassza ki a listában szereplő elemet.

    Képernyőkép azokról a kapcsolódó ágakról, amelyekre a felhasználó átválthat.

További információ: Elágaztatási korlátozások.

Fiókadatok

A Fiók részletei lap annak a GitHub-fióknak a részleteit jeleníti meg, amelyhez a felhasználó csatlakozik. Két szakaszból áll. A felső szakaszban a Git-szolgáltató és a fiók neve látható. Az alsó szakasz azt az adattárat és ágat mutatja be, amelyhez a munkaterület csatlakozik. Ez a lap jelenleg csak a GitHubhoz csatlakoztatott munkaterületeken érhető el.

A GitHub-fiók adatai a következők:

  • Git-fiók adatai

    • Szolgáltató
    • Számla neve

  • Git-adattár

  • Fiók

Képernyőkép a Fiókok lapról a Forrás vezérlőpulton, amelyen a Git részletei, az adattár és az ágnevek láthatók.

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ők nincsenek támogatva.
  • Ha a munkaterület több száz elemet tartalmaz, fontolja meg kisebb összetevőkre való felosztását. Minden készletet külön munkaterületen kell elhelyezni, és egy másik Git-ághoz kell csatolni, vagy egyetlen ághoz kell kapcsolódnia, különböző mappákba rendezve.
  • 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 .
  • Ha a munkaterület és a Git-adattár két különböző földrajzi régióban található, a bérlői rendszergazdának engedélyeznie kell a földrajzi területek közötti exportálást.
  • Ha a szervezet konfigurálta a feltételes hozzáférést, győződjön meg arról, hogy a Power BI Szolgáltatás ugyanazokat a feltételeket állította be, hogy a hitelesítés a várt módon működjön.
  • A rendszer a következő véglegesítési méretkorlátot alkalmazza:
    • 25 MB az Azure DevOps-összekötő és a Szolgáltatásnév használatával.
    • 125 MB az alapértelmezett egyszeri bejelentkezés (SSO) Microsoft Entra ID-fiókkal és Azure DevOps-összekötővel a felhasználói főazonosítót használva.

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
  • engedélyezett IP-címek listája

Azure DevOps–GitHub Enterprise migrálási szempont

Ha a csapat a Fabric Git Integration szolgáltatást használja, és az Azure DevOpsból a GitHub Enterprise-ba való migrálást értékeli, ajánlott ellenőrzési teszteket futtatni annak érdekében, hogy a Git Integration funkciói ne változhassanak. A Fabric Git Integration az alapul szolgáló Git-szolgáltatói API-kra támaszkodik, amelyek az Azure DevOps és a GitHub Enterprise képességeiben és korlátaiban különböznek a fent leírtak szerint.

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.
  • 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 nem működnek.
  • A fájl maximális mérete 25 MB.
  • A mappastruktúra legfeljebb 10 szint mélységig megtartható.
  • 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 az mappaszerkezet 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:

    • A 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.

Kiterjeszté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 mentse el 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 nem támogatott.
  • Az ütközésfeloldás részben a Gitben történik.
  • A Githez való véglegesítés folyamat során a Fabric szolgáltatás törli az elem mappájában lévő fájlokat, amelyek nem részei az elemdefiníciónak. Az olyan fájlok, amelyek nem kapcsolódnak tétel mappájához, 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 (soremelés) 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 CRLFhaszná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

  • Last updated on