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 mielőtt hozzákezd, olvassa el a Git-integráció á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.

Háló előfeltételei

A Git-integrációs funkció eléréséhez az alábbiak egyikére van szüksége:

• Power BI Premium-licenc. A Prémium Szintű Power BI-licencek csak az összes Power BI-elemet támogatják.
• Hálókapacitás. Az összes támogatott Hálóelem használatához hálókapacitás szükséges. Ha még nem rendelkezik ilyennel, regisztráljon egy ingyenes próbaverzióra.

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

• A felhasználók hálóelemeket hozhatnak létre
• A felhasználók szinkronizálhatják a munkaterület elemeit a Git-adattárakkal
• Csak GitHub-felhasználók esetén: A felhasználók szinkronizálhatják a munkaterület elemeit a GitHub-adattárakkal

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

• Aktív Azure-fiók, amely a Fabric-munkaterületet használó felhasználóhoz van regisztrálva. 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:

  • Részletes jogkivonat (ajánlott) tartalom olvasási és írási engedélyekkel az adattár engedélyei alatt:

    

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

  • Klasszikus GitHub-jogkivonat létrehozása engedélyezett adattár-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.

GitHub Connect

Ha a GitHubot választja, be kell jelentkeznie a GitHub-fiókjába.
Válassza a Fiók hozzáadása lehetőséget, ha először jelentkezik be a Hálóból, vagy válasszon egyet a felsorolt fiókok közül. A bejelentkezés után válassza a Csatlakozás lehetőséget , hogy a Fabric hozzáférhessen a GitHub-fiókjához.

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

• Megjelenítendő név – minden GitHub-felhasználó esetében egyedinek kell lennie
• A személyes hozzáférési jogkivonat - klasszikus vagy részletes személyes hozzáférési jogkivonata
• 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.

Csatlakozás munkaterülethez

Ha a munkaterület már csatlakozik a 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:

   Feljegyzés

   Egy munkaterületet egyszerre csak egy ághoz és egy mappához csatlakoztathat.

   • 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-ág csatlakoztatása

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

   Feljegyzés

   Egy munkaterületet egyszerre csak egy ághoz és egy mappához csatlakoztathat.

   • Adattár URL-címe. 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 véglegesítésekrő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 az összes módosított elemgel, és egy ikon, amely jelzi, hogy az elem új , módosított , ütközés vagy törölt-e.

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 el lesznek távolítva 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 ezeket az elemeket az előző állapotba. 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. Válassza a Visszavonás lehetőséget.

   

6. A megerősítéshez kattintson ismét a Visszavonás gombra.

   

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, a rendszer újra létrehozza az elemet, és egyes metaadatok elveszhetnek. 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.

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. A Forrás vezérlőpult használatával lekérheti a legújabb módosításokat, egyesíthet vagy visszaállíthat a munkaterületre, és frissítheti az élő elemeket. 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.

A sikeres frissítés után az elemek listája el lesz távolítva, és a munkaterület arra az új véglegesítésre mutat, amellyel szinkronizálva van.

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

Munkaterület leválasztása a Gitről

Csak a munkaterület rendszergazdája tudja leválasztani a munkaterületet a Git-adattárról. Ha Ön nem rendszergazda, kérjen segítséget a rendszergazdától a leválasztással 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.
• A sablonalkalmazásokat tartalmazó munkaterületek nem csatlakoztathatók a Githez.
• A szuverén felhők nem támogatottak.

Az Azure DevOps korlátozásai

• Az Azure DevOps-fiókot ugyanarra a felhasználóra kell regisztrálni, aki a Fabric-munkaterületet használja.
• 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ó.
• A véglegesítés mérete legfeljebb 125 MB lehet.

A GitHub korlátozásai

• A GitHub nem tudja kikényszeríteni a térinformatikai érvényesítést.
• 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-beállítások nem támogatottak. Példa:

• IP-engedélyezési lista
• Privát hálózatkezelés
• Egyéni tartományok

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 munkaterület mappaszerkezete nem jelenik meg a Git-adattárban. A mappák munkaterület-elemei a gyökérkönyvtárba lesznek exportálva.

Á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 sikertelenek.
• A fájl maximális mérete 25 MB.
• A git-integrációval történő üzembe helyezés után nem tölthet le jelentést/adatkészletet .pbix formátumban a szolgáltatásból.
• Ha egy mappát elnevez a Gitben, a logikai azonosító (Guid) előtagként jelenik meg a típus előtt, ha az elem megjelenítendő neve:
  • Több mint 256 karakterből áll
  • . vagy szóközzel végződik
  • A következő karakterek bármelyikét tartalmazza: " / : ? < > \ * |

Elágaztatá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.
• Elágaztatáskor létrejön egy új munkaterület, és az eredeti munkaterület beállításai nem lesznek másolva. Módosítsa az összes beállítást vagy definíciót, hogy az új munkaterület megfeleljen a szervezet szabályzatainak.
• 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.

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 Véglegesítés 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. Az elemmappában nem 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 (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 .pbip projektet, é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

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