Ismerkedés a Git-integrációval

Ez a cikk a Microsoft Fabric Git-integrációs eszközének alábbi alapvető feladatait ismerteti:

• Csatlakozás Git-adattárhoz
• Módosítások véglegesítése
• Frissítés a Gitből
• Leválasztás a Gitről

Javasoljuk, hogy a kezdés előtt olvassa el a Git-integrációs áttekintését.

Előfeltételek

Ahhoz, hogy a Git integrálható legyen a Microsoft Fabric-munkaterülettel, be kell állítania az alábbi előfeltételeket mind a Fabric, mind a Git számára.

Anyag előfeltételei

A Git-integrációs funkció eléréséhez Fabric-kapacitásravan szüksége. Az összes támogatott Fabric elem használatához Fabric kapacitás szükséges. Ha még nem rendelkezik ilyennel, regisztráljon egy ingyenes próbaverzióra. Azok az ügyfelek, akik már rendelkeznek Power BI Premium-kapacitással, használhatják ezt a kapacitást, de ne feledje, hogy bizonyos Power BI-termékváltozatok csak a Power BI-elemeket támogatják.

Emellett a felügyeleti portálon engedélyezni kell a következő bérlői kapcsolókat :

• A felhasználók Fabric elemeket készíthetnek
• A felhasználók szinkronizálhatják a munkaterület elemeit a Git-adattárakkal
• Munkaterületek létrehozása (csak akkor, ha új munkaterületre szeretne ágazni.)
• A felhasználók szinkronizálhatják a munkaterület elemeit a GitHub-adattárakkal: Csak GitHub-felhasználók számára

Ezeket a kapcsolókat a bérlői rendszergazda, a kapacitásadminisztrátor vagy a munkaterület rendszergazdája engedélyezheti a szervezet beállításaitól függően.

Git-előfeltételek

A Git-integráció jelenleg az Azure DevOps és a GitHub esetében támogatott. Ha a Git-integrációt szeretné használni a Fabric-munkaterülettel, az alábbiakra van szüksége az Azure DevOpsban vagy a GitHubon:

Az Azure DevOps korlátozásai

• Egy aktív Azure DevOps-fiók , amely ugyanahhoz a Fabric-felhasználóhoz van regisztrálva (akkor is támogatott, ha az Azure DevOps-szervezet más bérlőben található, mint a Fabric-bérlő). Hozzon létre egy ingyenes fiókot.
• Hozzáférés egy meglévő adattárhoz.

A GitHub korlátozásai

• Aktív GitHub-fiók. Hozzon létre egy GitHub-fiókot.

• Az alábbi személyes hozzáférési jogkivonatok egyike:

  • A finomhangolt token (ajánlott) tartalom olvasási és írási engedéllyel a tároló engedélyei alatt:

    

    Ha ezt a jogkivonatot a GitHub Enterprise-nal szeretné használni, kövesse az alábbi utasításokat.

  • Hozz létre egy klasszikus GitHub hozzáférési tokent engedélyezett repo-hatókörökkel:

    

Munkaterület csatlakoztatása Git-adattárhoz

Csatlakozás Git-adattárhoz

Csak a munkaterület rendszergazdája tud munkaterületet csatlakoztatni egy adattárhoz, 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. Ha egy munkaterületet azure-beli vagy GitHub-adattárhoz szeretne csatlakoztatni, kövesse az alábbi lépéseket:

1. Jelentkezzen be a Hálóba, és keresse meg azt a munkaterületet, amelyhez csatlakozni szeretne.

2. Ugrás a munkaterület beállításaira

   

3. Válassza a Git-integrációt.

4. Válassza ki a Git-szolgáltatót. Jelenleg az Azure DevOps és a GitHub támogatott.

Azure DevOps Connect

Ha az Azure DevOpsot választja, a Csatlakozás lehetőséget választva automatikusan bejelentkezhet a Microsoft Entra-felhasználó által a Fabricbe bejelentkezett Azure Repos-fiókba.

Ha már bejelentkezett az Azure-ba a Fabricből egy másik fiókkal, válassza ki a fiókját a listából, és válassza a Csatlakozás lehetőséget.

Ha először jelentkezik be a Fabric szolgáltatásból, vagy új fiókot szeretne hozzáadni, válassza a Fiók hozzáadása lehetőséget.

Ha első alkalommal csatlakozik, engedélyeznie kell a felhasználót. Adja meg az alábbi információkat:

• Megjelenítendő név – minden felhasználóhoz egyedinek kell lennie
• Az Azure DevOps URL-címe – Az Azure DevOps-adattár URL-címe. Az URL-cím formátumának https://dev.azure.com/{organization}/{project}/_git/{repository} vagy https://{organization}.visualstudio.com/{project}/_git/{repo} formátumúnak kell lennie.
• Hitelesítés – Hitelesítheti magát OAuth2-vel vagy egy szolgáltatásazonosítóval. További információ: Azure DevOps – Git Integration with service principal

Bejelentkezés után válassza a Csatlakozás lehetőséget , hogy a Fabric hozzáférhessen a fiókjához

GitHub Connect

Ha a GitHubot választja, be kell jelentkeznie a GitHub-fiókjába. Ha már bejelentkezett a GitHubra, válassza ki a fiókját a listából, és válassza a Csatlakozás lehetőséget.

Ha először jelentkezik be a Fabric szolgáltatásból, vagy új fiókot szeretne hozzáadni, válassza a Fiók hozzáadása lehetőséget.

Ha először csatlakozik, a GitHub-felhasználót engedélyeznie kell. Adja meg az alábbi információkat:

• Megjelenítendő név – minden GitHub-felhasználó esetében egyedinek kell lennie
• Személyes hozzáférési token - klasszikus vagy részletes személyes hozzáférési token
• Adattár URL-címe (nem kötelező) – Ha nem ad meg URL-címet, bármely olyan adattárhoz csatlakozhat, amelyhez hozzáférése van. Ha URL-címet ad meg, csak ehhez az adattárhoz csatlakozhat.

A bejelentkezés után válassza a Csatlakozás lehetőséget , hogy a Fabric hozzáférhessen a GitHub-fiókjához.

Csatlakozás munkaterülethez

Ha a munkaterület már csatlakozik az Azure DevOps/GitHubhoz, kövesse a megosztott munkaterülethez való csatlakozásra vonatkozó utasításokat.

Azure DevOps-ág csatlakoztatása

1. A legördülő menüben adja meg a következő adatokat arról az ágról, amelyhez csatlakozni szeretne:

   • Szervezet
   • Projekt
   • Git-adattár.
   • Ág (Válasszon ki egy meglévő ágat a legördülő menüben, vagy válassza az + Új ág lehetőséget egy új ág létrehozásához. Egyszerre csak egy ághoz csatlakozhat.)
   • Mappa (Írja be egy meglévő mappa nevét, vagy adjon meg egy nevet egy új mappa létrehozásához. Ha üresen hagyja a mappa nevét, a tartalom a gyökérmappában jön létre. Egyszerre csak egy mappához csatlakozhat.)

GitHub-branch csatlakoztatása

1. A legördülő menüben adja meg a következő adatokat arról az ágról, amelyhez csatlakozni szeretne:

   • Adattár URL. Ha hatókörrel rendelkező jogkivonattal csatlakozott a GitHubhoz, a rendszer automatikusan kitölti az URL-címet, és csak ehhez az adattárhoz tud csatlakozni.
   • Ág (Válasszon ki egy meglévő ágat a legördülő menüben, vagy válassza az + Új ág lehetőséget egy új ág létrehozásához. Egyszerre csak egy ághoz csatlakozhat.)
   • Mappa (Írja be egy meglévő mappa nevét, vagy adjon meg egy nevet egy új mappa létrehozásához. Ha üresen hagyja a mappa nevét, a tartalom a gyökérmappában jön létre. Egyszerre csak egy mappához csatlakozhat.)

Válassza a Csatlakozás és szinkronizálás lehetőséget.

A kezdeti szinkronizálás során, ha a munkaterület vagy a Git-ág üres, 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, a rendszer megkérdezi, hogy a szinkronizálás melyik irányba haladjon. A kezdeti szinkronizálásról további információt a Csatlakozás és a szinkronizálás című témakörben talál.

A csatlakozás után a munkaterület megjeleníti a forrásvezérlő adatait, amelyek lehetővé teszik a felhasználó számára a csatlakoztatott ág megtekintését, az ág egyes elemeinek állapotát és az utolsó szinkronizálás időpontját.

Ha szinkronizálni szeretné a munkaterületet a Git-ággal, véglegesítse a munkaterületen végrehajtott módosításokat a Git-ágon, és frissítse a munkaterületet , amikor valaki új véglegesítéseket hoz létre a Git-ágon.

Módosítások véglegesítése a gitben

Miután sikeresen csatlakozott egy Git-mappához, szerkessze a munkaterületet a szokásos módon. A mentett módosítások csak a munkaterületen lesznek mentve. Ha elkészült, véglegesítheti a módosításokat a Git-ágban, vagy visszavonhatja a módosításokat, és visszaállíthatja az előző állapotot.

További információ a commit-ekről.

Véglegesítés a Gitben

Ha véglegesíteni szeretné a módosításokat a Git-ágban, kövesse az alábbi lépéseket:

1. Lépjen a munkaterületre.

2. Válassza a Forrás vezérlőelem ikont. Ez az ikon a nem véglegesített módosítások számát jeleníti meg.

3. Válassza a Módosítások lehetőséget a Forrás vezérlőpulton . Megjelenik egy lista, amelyen az összes módosított elem látható, és egy ikon jelzi, hogy az elem új, módosított, ütközés, módosítás vagy törlés.

4. Jelölje ki a véglegesíteni kívánt elemeket. Az összes elem kijelöléséhez jelölje be a felső jelölőnégyzetet.

5. Adjon hozzá megjegyzést a mezőbe. Ha nem ad hozzá megjegyzést, a rendszer automatikusan hozzáad egy alapértelmezett üzenetet.

6. Válassza a Véglegesítés lehetőséget.

   

A módosítások véglegesítése után a véglegesített elemek törlődnek a listából, és a munkaterület a szinkronizált új véglegesítésre mutat.

A véglegesítés sikeres befejezése után a kijelölt elemek állapota a Véglegesítés nélküliről a Szinkronizáltra változik.

Mentett módosítás visszavonása

A munkaterület módosításainak mentése után, ha úgy dönt, hogy nem szeretné véglegesíteni ezeket a módosításokat a Gitben, visszavonhatja a módosításokat, és visszaállíthatja az elemeket az előző állapotukra. A módosítások visszavonásához kövesse az alábbi lépéseket:

1. Lépjen a munkaterületre.

2. Válassza a Forrás vezérlőelem gombot. Ez a gomb a nem véglegesített módosítások számát is megjeleníti.

3. Válassza a Módosítások lehetőséget a Forrás vezérlőpulton . Megjelenik egy lista, amelyen az összes módosított elem látható, és egy ikon jelzi, hogy a módosított elem új, módosított, ütközés vagy törölt-e.

4. Jelölje ki a visszavonni kívánt módosításokat.

5. Jelölje be az „Tudomásul veszem, hogy a munkaterület elemei törölhetők, és nem állíthatók vissza” jelölőnégyzetet, majd válassza a Visszavonás lehetőséget.

   

6. A megerősítéshez kattintson ismét a Visszavonás gombra. A megjelenő párbeszédpanel attól függően változhat, hogy a rendszer észleli-e a törölt elemeket. Az első képernyőképen nincsenek törlések. A második, ha a rendszer törléseket észlel.

   

   

A munkaterület kijelölt elemei visszaállnak a munkaterület utolsó szinkronizálásának időpontjára.

Fontos

Ha töröl egy elemet, majd visszavonja a módosításokat, az elem létrehoz egy újat, és a metaadatok egy része elveszhet. A bizalmassági címkék például nem maradnak meg, ezért alaphelyzetbe kell állítani őket, és az elem tulajdonosa az aktuális felhasználóra van állítva.

A hozzáadott elemek visszavonása véglegesen törli az elemet.

Munkaterület frissítése a Gitből

Amikor valaki új módosítást véglegesít a csatlakoztatott Git-ágon, megjelenik egy értesítés a megfelelő munkaterületen. Használja a Forráskód-kezelő panelt, hogy lekérje a legújabb módosításokat, egyesítsen vagy visszavonjon a munkaterületre, és frissítse az élő elemeket. A mappák módosításai is frissülnek. További információ a frissítésről.

Munkaterület frissítéséhez kövesse az alábbi lépéseket:

1. Lépjen a munkaterületre.
2. Válassza a Forrás vezérlőelem ikont.
3. Válassza a Frissítések lehetőséget a Forrás vezérlőpulton. Megjelenik egy lista az ágban az utolsó frissítés óta módosított összes elemet tartalmazó listával.
4. Válassza az Összes frissítése lehetőséget.

5. A megerősítést kérő diaglogon válassza a Frissítés lehetőséget.

A sikeres frissítés után a rendszer eltávolítja az elemek listáját, és a munkaterület arra az új munkaterületre mutat, amellyel szinkronizálva van.

A frissítés sikeres befejezése után az elemek állapota szinkronizálva lesz.

Munkaterület lekapcsolása a Gitről

Csak a munkaterület rendszergazdája tudja leválasztani a munkaterületet a Git-adattárról. Amennyiben Ön nem rendszergazda, kérjen segítséget a rendszergazdától a leválasztási folyamattal kapcsolatban. Ha Ön rendszergazda, és le szeretné bontani az adattárat, kövesse az alábbi lépéseket:

1. Ugrás a munkaterület beállításaira
2. Git-integráció kiválasztása
3. Válassza a Munkaterület leválasztása lehetőséget
4. A megerősítéshez válassza ismét a Kapcsolat bontása lehetőséget.

Engedélyek

A munkaterületen végrehajtható műveletek a munkaterületen és a Git-adattárban található engedélytől függenek. Az engedélyek részletesebb ismertetését az Engedélyek című témakörben találja.

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 korlátozásai

• 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 feltételes hozzáférést konfigurált, győződjön meg arról, hogy a Power BI Szolgáltatás ugyanazokat a feltételeket állította be a hitelesítéshez, hogy az 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 korlátozásai

• Csak a GitHub felhőalapú verziói támogatottak. A helyszíni telepítés nem támogatott.
• A GitHub nem tudja kikényszeríteni a földrajzi régiók közötti érvényesítéseket.
• Az egyszerre véglegesíteni kívánt fájlok összesített mérete legfeljebb 50 MB lehet. Ezért ha több elemet kell véglegesítenie, előfordulhat, hogy néhány külön véglegesítésre van szükség. A fájlok véglegesítésével kapcsolatos további információkért tekintse meg a hibaelhárítási útmutatót.

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 akár 10 szintig is 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:
  • Több mint 256 karakterből áll
  • Egy . vagy szóközzel végződik.
  • Az címtárnév korlátozásainak leírásában említett tiltott karaktereket tartalmazza.
• 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.

Elágazá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 szolgáltatások nem támogatottak.
• 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 elemmappában lévő fájlokat, amelyek nem részei az elemdefiníciónak. A nem egy elemmappában található, nem kapcsolódó fájlok 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

• A Git integrációs folyamatának ismertetése
• Git ágak kezelése
• A Git-integráció ajánlott eljárásai