Kezdje el a Git integrációval

Ez a cikk végigvezeti a Fabric Git integrációs eszközének következő alapvető feladatait:

• 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 szüksége van egy Fabric kapacitásra. 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 :

• Felhasználók létrehozhatnak Fabric elemeket – szükség lehet, ha Fabric-artefaktumokat használnak
• 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.)
• Felhasználók szinkronizálhatják a munkaterület elemeit 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 Azure DevOps és GitHub esetében támogatott. Ha a Git-integrációt a Fabric-munkaterülettel szeretné használni, az alábbiakra van szüksége Azure DevOpsban vagy GitHub:

Azure DevOps

• Aktív Azure DevOps-fiók regisztrálva ugyanahhoz a Fabric-felhasználóhoz (akkor is támogatott, ha Azure DevOps-szervezet más bérlőben található, mint a Fabric-bérlő). Ingyenes fiók létrehozása.
• Access egy meglévő adattárba.

GitHub

• Aktív GitHub fiók. GitHub fiók létrehozása.

• Az a következő személyes hozzáférési tokenek:

  • fine-grained token (ajánlott) Kontents olvasási és írási engedély az adattár engedélyei alatt:

    

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

  • Hozzon létre egy GitHub klasszikus jogkivonatot 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 egy Azure 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 Azure DevOps és GitHub támogatottak.

Azure DevOps Csatlakozás

Ha Azure DevOps-t választja, válassza a Connect lehetőséget a Microsoft Entra-felhasználó által a Fabricbe bejelentkezett Azure Repos fiókba való automatikus bejelentkezéshez.

Ha már bejelentkezett Azure a Fabricből egy másik fiókkal, válassza ki a fiókját a listából, és válassza a Connect 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
• Azure DevOps URL – Az Azure DevOps tárház URL-je. Az URL-címnek https://dev.azure.com/{organization}/{project}/_git/{repository} vagy https://{organization}.visualstudio.com/{project}/_git/{repo} formátumban 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 Connect lehetőséget, hogy a Fabric hozzáférjen a fiókjához.

GitHub Csatlakozás

Ha GitHub választ, be kell jelentkeznie GitHub fiókjába. Ha már bejelentkezett GitHub, válassza ki a fiókját a listából, és válassza a Connect 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, Autorizálás szükséges a GitHub felhasználójához. Adja meg az alábbi információkat:

• Jelnév – minden GitHub felhasználó esetében egyedinek kell lennie
• Személyes hozzáférési token - a klasszikus vagy részletes személyes hozzáférési token
• Repository URL (nem kötelező a github.com esetén, ghe.com esetén kötelező) – Ha nem ad meg URL-címet, csatlakozhat bármely github.com adattárhoz, 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 Connect opciót, hogy a Fabric hozzáférjen a GitHub-fiókjához.

Csatlakozás munkaterülethez

Ha a munkaterület már csatlakozik az Azure DevOpshoz/GitHubhoz, kövesse az Csatlakozás megosztott munkaterülethez utasításait.

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:

   • Organizáció
   • Project
   • 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 ágcsatlakozás

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

   • Tárház URL. Ha hatókörrel rendelkező tokennal csatlakozott a GitHub-hoz, az URL-címet automatikusan kitölti, és csak az adott 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ésről szóló információkat, amelyekkel megtekintheted a csatlakoztatott ágat, az egyes elemek á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.

A közreműködők és a tagok számára az ágak közötti váltás engedélyezése

Alapértelmezés szerint az olyan ágműveletek, mint az Ág váltása és a Kivétel új ágra , a munkaterület rendszergazdai szerepkörét igénylik. A munkaterület rendszergazdája azonban engedélyezheti a munkaterületszintű beállítást , amely lehetővé teszi, hogy a legalább közreműködői szerepkörrel rendelkező felhasználók módosíthassák a Git-ágat. Ha ez a beállítás engedélyezve van, a munkaterület összes összetevőjéhez írási hozzáféréssel rendelkező közreműködők vagy tagok is válthatnak ágakat, és új ágakat hozhatnak létre a saját identitásuk alatt.

Ez a beállítás:

• Munkaterületenként van konfigurálva (nincs bérlőszintű kapcsoló a letiltásához).
• Aktív Git-kapcsolatot igényel a munkaterületen.
• Nem módosítja a munkaterületek csatlakoztatására vagy leválasztására vonatkozó engedélyeket – ezek a műveletek csak rendszergazdai jogosultsággal maradnak.

A Git-szerepkör követelményeinek részletes engedélytáblázatát az Engedélyek című témakörben találja.

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.

Véglegesítés önálló ágra

Az önálló ág véglegesítése egy Git-integrációs funkció, amellyel új ágat hozhat létre, és egyetlen műveletben véglegesítheti az aktuális módosításokat. Más szóval, ahelyett, hogy a kapcsolódó ágra véglegesítene, azonnal létrehozhat egy új ágat: a rendszer indíthat egy új Git-ágat, és ott tárolja a munkáját anélkül, hogy el kellene hagynia vagy át kellene váltania az eredeti ágról.

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 új fiókra lehetőséget.

Fontos

Vegye figyelembe a következőket:

• az újonnan létrehozott ág nem lesz csatlakoztatva a meglévő munkaterülethez.
• az újonnan létrehozott ág az aktuális munkaterület utolsó szinkronizálási állapotán alapul.
• ez a funkció akkor is lehetséges, ha vannak bejövő frissítések – még akkor is, ha az alapértelmezett véglegesítés le van tiltva.
• a jelenlegi munkaterület állapota nem változik a véglegesítés miatt, és a jelenlegi állapotban marad.

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 az Updates pontot a Forrás vezérlőpultban. 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ő párbeszédpanelen 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. Ha Ön nem rendszergazda, kérje a rendszergazda segítségét a leválasztáshoz. 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.

Permissions

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.

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