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.

Fontos

Ez a funkció előzetes verzióban érhető el.

Permissions

Azure DevOps-engedélyek

Az alábbi lista bemutatja, hogy a különböző munkaterületi szerepkörök milyen műveleteket végezhetnek az Azure DevOps-engedélyüktől függően:

  • Rendszergazda: Bármilyen műveletet végrehajthat a munkaterületen, csak az Azure DevOps-szerepköre korlátozza.
  • Tag/közreműködő: Miután csatlakozott egy munkaterülethez, a tagok/közreműködők az Azure DevOps-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 Rendszergazda.
  • Megtekintő: Nem hajthat végre semmilyen műveletet. A megtekintő nem látja a Gittel kapcsolatos információkat a munkaterületen.

A gyakori műveletekhez szükséges engedélyek

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

Művelet Munkaterületi szerepkör Git-engedélyek
munkaterület Csatlakozás Git-adattárba Admin Read=Allow
Munkaterület szinkronizálása a Git-adattárral Admin Read=Allow
Munkaterület leválasztása a Git-adattárról Admin 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) Admin Read=Engedélyezés (a céladattárban/könyvtárban/ágban)
Git-kapcsolat részleteinek megtekintése Rendszergazda, tag, közreműködő Olvasás vagy nincs
Lásd: "Git állapot" munkaterület Rendszergazda, tag, közreműködő Read=Allow
Frissítés a Gitből Az alábbiak 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)

BUILD külső függőségekre (adott esetben)
Read=Allow
Munkaterület-módosítások véglegesítése a Gitben Az alábbiak 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)

BUILD külső függőségekre (adott esetben)
Read=Allow
Hozzájárulás=Engedélyezés
a fiókszabályzatnak engedélyeznie kell a közvetlen véglegesítést
Új Git-ág létrehozása a Hálón belülről Admin Role=Write
Ág létrehozása=Engedélyezés

Csatlakozás és szinkronizálás

Csak a munkaterület rendszergazdája tud munkaterületet csatlakoztatni az Azure-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, ha ezt a lehetőséget választja, a rendszer kérnie kell a megerősítést.

Screenshot of dialog asking which direction to sync if both Git and the workspace have content.

Ha nem választja ki, hogy melyik tartalmat szeretné szinkronizálni, addig nem folytathatja a munkát, amíg meg nem teszi:

Screenshot notification that you can't continue working until workspace is synced.

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.

Screenshot if items in a workspace with their Git status outlined.

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-ágban 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:

  • Csatlakozás ág
  • Az utolsó szinkronizálás időpontja
  • A munkaterület utolsó véglegesítésére mutató hivatkozás

Screenshot of sync information that appears on the bottom of the screen when connected to Git.

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

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 a munkaterület szinkronizálva van a Git-ággal, a Forrás vezérlőelem ikon 0-t jelenít meg.

Screenshot of the source control icon showing zero items changed.

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őelem panel megnyitásához válassza a forrásvezérlő ikont.

A Forrás vezérlőelem panelEn a Módosítások lap a munkaterületen módosított és a Git felé véglegesíteni kívánt elemek számát jeleníti meg, a Frissítések lapon pedig a Git ágban módosított és a munkaterületre frissíteni kívánt elemek száma látható.

Minden lapon a módosított elemek az állapotot jelző ikonnal jelennek meg:

  • Új
  • Módosított
  • Törölt
  • Konfliktus

Screenshot of the source control panel showing the status of the changed items.

Véglegesítés

  • Ha egynél több elemet szeretne véglegesíteni, kiválaszthatja, hogy mely elemeket szeretné véglegesíteni a Git-ágban.
  • Ha frissítések történtek a Git-ágon, a véglegesítések le lesznek tiltva, amíg nem frissíti a munkaterületet.

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ésre 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.

Szempontok és korlátozások

General limitations

  • Az Azure DevOps-fiókot ugyanarra a felhasználóra kell regisztrálni, aki a Fabric-munkaterületet használja.
  • A Power BI hitelesítési módszerének legalább olyan erősnek kell lennie, mint az Azure DevOps hitelesítési módszere. Ha például az Azure DevOps többtényezős hitelesítést igényel, a Power BI-nak többtényezős hitelesítésre is szükség van.
  • A Power BI-adathalmazok és az Analysis Services közvetlen lekérdezési és összetett modelljei jelenleg nem támogatottak.
  • A DirectLake szemantikai modelljei jelenleg nem támogatottak.
  • A szemantikai modell továbbfejlesztett frissítési API-val való frissítése minden frissítés után Git-diffet eredményez.

Munkaterület korlátozásai

Csak a munkaterület rendszergazdája kezelheti az Azure-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 .

Á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 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: ", /, :, <, >, \\, *, , ?|

    A logikai azonosító (Guid) előtagként lesz hozzáadva a típus előtt, amikor elnevezi a mappát a Gitben.

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

  • A véglegesítés méretkorlátja 125 MB.
  • 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. Ha a nem támogatott elemek a mappában találhatók, a rendszer figyelmen kívül hagyja őket.
  • A nevek duplikálása nem engedélyezett – még akkor sem, ha a Power BI engedélyezi, a frissítési, véglegesítési vagy visszavonási művelet meghiúsul.
  • A B2B nem támogatott.
  • Az ütközésfeloldás részben a Gitben történik.