Sdílet prostřednictvím


Základní koncepty integrace Gitu

Tento článek vysvětluje základní koncepty Gitu a proces integrace Gitu s pracovním prostorem Microsoft Fabric.

Důležité

Tato funkce je ve verzi Preview.

Oprávnění

  • Aby bylo možné používat integraci Gitu, musí ji správce vaší organizace povolit správcem vaší organizace.
  • Pokud jsou pracovní prostor a úložiště ve dvou různých oblastech, musí správce tenanta povolit křížový export.
  • Akce, které můžete provést v pracovním prostoru, závisí na oprávněních, která máte v pracovním prostoru i v Azure DevOps.

Oprávnění Azure DevOps

Následující seznam ukazuje, jaké různé role pracovního prostoru můžou dělat v závislosti na jejich oprávněních Azure DevOps:

  • Správa: Může provádět jakoukoli operaci v pracovním prostoru, omezená pouze jejich rolí Azure DevOps.
  • Člen/přispěvatel: Jakmile se připojí k pracovnímu prostoru, může člen nebo přispěvatel potvrdit a aktualizovat změny v závislosti na jejich roli Azure DevOps. V případě akcí souvisejících s připojením k pracovnímu prostoru (například připojení, odpojení nebo přepnutí větví) vyhledejte pomoc od Správa.
  • Prohlížeč: Nemůže provádět žádné akce. Prohlížeč nemůže v pracovním prostoru zobrazit žádné související informace o Gitu.

Oprávnění potřebná pro běžné operace

Následující tabulka popisuje oprávnění potřebná k provádění různých běžných operací:

Operace Role pracovního prostoru Oprávnění Gitu
Připojení pracovního prostoru do úložiště Git správce Read=Allow
Synchronizace pracovního prostoru s úložištěm Git správce Read=Allow
Odpojení pracovního prostoru od úložiště Git správce Nejsou potřeba žádná oprávnění.
Přepnutí větve v pracovním prostoru (nebo jakékoli změny nastavení připojení) správce Read=Allow (v cílovém úložišti, adresáři nebo větvi)
Zobrazení podrobností o připojení Gitu Správa, člen, přispěvatel Čtení nebo Žádné
Zobrazení stavu Gitu v pracovním prostoru Správa, člen, přispěvatel Read=Allow
Aktualizace z Gitu Všechny tyto možnosti:

Přispěvatel v pracovním prostoru (oprávnění PRO ZÁPIS u všech položek)

Vlastník položky (pokud přepínač tenanta blokuje aktualizace pro vlastníky)

BUILD na externích závislostech (pokud je to možné)
Read=Allow
Potvrzení změn pracovního prostoru do Gitu Všechny tyto možnosti:

Přispěvatel v pracovním prostoru (oprávnění PRO ZÁPIS u všech položek)

Vlastník položky (pokud přepínač tenanta blokuje aktualizace pro vlastníky)

BUILD na externích závislostech (pokud je to možné)
Read=Allow
Contribute=Allow
Zásady větve by měly umožňovat přímé potvrzení.
Vytvoření nové větve Git z prostředků infrastruktury správce Role=Zápis
Vytvořit větev=Povolit

Připojení a synchronizace

Pracovní prostor může připojit jenom správce pracovního prostoru k Azure Repos, ale po připojení může v pracovním prostoru pracovat kdokoli s oprávněními. Pokud nejste správce, požádejte správce o pomoc s připojením.

Když připojíte pracovní prostor k Gitu, Prostředky infrastruktury se synchronizují mezi těmito dvěma umístěními, aby měly stejný obsah. Pokud je během této počáteční synchronizace pracovní prostor nebo větev Gitu prázdná, zatímco druhý obsahuje obsah, zkopíruje se obsah z neprázdného umístění do prázdného. Pokud pracovní prostor i větev Gitu obsahují obsah, musíte se rozhodnout, jaký směr má synchronizace proběhnout.

  • Pokud potvrdíte pracovní prostor do větve Git, veškerý podporovaný obsah pracovního prostoru se exportuje do Gitu a přepíše aktuální obsah Gitu.
  • Pokud pracovní prostor aktualizujete obsahem Gitu, obsah pracovního prostoru se přepíše a ztratíte obsah pracovního prostoru. Vzhledem k tomu, že větev Gitu se dá kdykoli obnovit do předchozí fáze, když pracovní prostor nemůže, pokud zvolíte tuto možnost, zobrazí se výzva k potvrzení.

Snímek obrazovky s dialogovým oknem s dotazem, který směr se má synchronizovat, pokud má Git i pracovní prostor obsah

Pokud nevyberete, který obsah se má synchronizovat, nebudete moct dál pracovat, dokud to neuděláte:

Snímek obrazovky s oznámením, že nemůžete pokračovat v práci, dokud se pracovní prostor nesynchronizuje

Stav Gitu

Po připojení se v pracovním prostoru zobrazí sloupec stavu Gitu, který označuje stav synchronizace jednotlivých položek v pracovním prostoru ve vztahu k položkám ve vzdálené větvi.

Snímek obrazovky s informacemi o stavu Gitu v pracovním prostoru

Každá položka má jeden z následujících stavů:

  • Synchronizovaná (položka je stejná v pracovním prostoru a větvi Gitu)
  • Konflikt (položka se změnila v pracovním prostoru i ve větvi Gitu)
  • Nepodporovaná položka
  • Nepotvrzené změny v pracovním prostoru
  • Vyžaduje se aktualizace z Gitu
  • Položka je na obou místech shodná, ale musí být aktualizována na poslední potvrzení.

Informace o synchronizaci

Pokud jste připojení, zobrazí se v dolní části obrazovky následující informace:

  • větev Připojení
  • Čas poslední synchronizace
  • Propojení s posledním potvrzením, se kterým se pracovní prostor synchronizuje

Snímek obrazovky s informacemi o synchronizaci, které se zobrazí v dolní části obrazovky při připojení k Gitu

Potvrzení a aktualizace

Podokno správy zdrojového kódu

Nahoře na obrazovce je ikona správy zdrojového kódu. Zobrazuje počet položek, které se liší v pracovním prostoru a ve větvi Git. Když se pracovní prostor synchronizuje s větví Git, zobrazí se ikona Správy zdrojového kódu 0.

Snímek obrazovky s ikonou správy zdrojového kódu se změněnými nulovými položkami

Když dojde ke změnám pracovního prostoru nebo větve Git, ikona správy zdrojového kódu zobrazí počet položek, které se liší. Výběrem ikony správy zdrojového kódu otevřete podokno Správy zdrojového kódu.

V podokně Správy zdrojového kódu se na kartě Změny zobrazuje počet položek, které se změnily v pracovním prostoru, a je potřeba je potvrdit do Gitu a na kartě Aktualizace se zobrazuje počet položek, které byly změněny ve větvi Gitu, a je potřeba je aktualizovat do pracovního prostoru.

Na každé kartě jsou změněné položky uvedené s ikonou označující stav:

  • Nwe
  • Upravené
  • Odstraněny
  • Konflikt

Snímek obrazovky s panelem správy zdrojového kódu zobrazující stav změněných položek

Potvrzení

  • Pokud je k potvrzení více než jedna položka, můžete vybrat, které položky se mají potvrdit do větve Git.
  • Pokud došlo k aktualizacím větve Git, potvrzení se deaktivují, dokud neaktualizujete pracovní prostor.

Aktualizovat

  • Na rozdíl od potvrzení a vrácení zpět příkaz Update vždy aktualizuje celou větev a synchronizuje se s nejnovějším potvrzením. Nemůžete vybrat konkrétní položky, které chcete aktualizovat.
  • Pokud byly změny provedeny v pracovním prostoru a ve větvi Gitu ve stejné položce, budou aktualizace zakázané, dokud se konflikt nevyřeší.

Přečtěte si další informace o tom, jak potvrdit a aktualizovat. Přečtěte si další informace o procesu aktualizace a řešení konfliktů.

Úvahy a omezení

Obecná omezení

  • Účet Azure DevOps musí být zaregistrovaný pro stejného uživatele, který používá pracovní prostor Fabric.
  • Metoda ověřování v Power BI musí být alespoň tak silná jako metoda ověřování pro Azure DevOps. Pokud například Azure DevOps vyžaduje vícefaktorové ověřování, musí Power BI také vyžadovat vícefaktorové ověřování.
  • Přímé dotazy a složené modely v datových sadách Power BI a analysis Services se v tuto chvíli nepodporují.
  • Sémantické modely DirectLake se v tuto chvíli nepodporují.
  • Aktualizace sémantického modelu pomocí rozhraní API rozšířené aktualizace způsobí rozdíl Gitu po každé aktualizaci.
  • Struktura složek pracovního prostoru se neprojeví v úložišti Git. Položky pracovního prostoru ve složkách se exportují do kořenového adresáře.

Omezení pracovního prostoru

  • Připojení k úložišti Azure může spravovat jenom správce pracovního prostoru, jako je připojení, odpojení nebo přidání větve.
    Po připojení může v pracovním prostoru pracovat kdokoli s oprávněním.

Omezení větví a složek

  • Maximální délka názvu větve je 244 znaků.

  • Maximální délka celé cesty pro názvy souborů je 250 znaků. Delší názvy selžou.

  • Maximální velikost souboru je 25 MB.

  • Po nasazení sestavy nebo datové sady jako .pbix ze služby nemůžete stáhnout sestavu nebo datovou sadu.

  • Pokud zobrazovaný název položky:

    • Má více než 256 znaků.
    • Končí znakem .' nebo mezerou.
    • Obsahuje některý z následujících znaků: ", /, :, <, >, \\, *, ?|

    Logické ID (Guid) se přidá jako předpona před typ při pojmenování složky v Gitu.

Omezení synchronizace a potvrzení

  • Limit velikosti potvrzení je 125 MB.
  • Synchronizaci můžete synchronizovat pouze v jednom směru. Nemůžete potvrdit a aktualizovat současně.
  • Popisky citlivosti nejsou podporované a export položek s popisky citlivosti může být zakázaný. Pokud chcete potvrdit položky s popisky citlivosti bez popisku citlivosti, požádejte o pomoc správce .
  • Funguje s omezenými položkami. Pokud jsou ve složce nepodporované položky, budou ignorovány.
  • Duplikování názvů není povolené – i když to Power BI povolí, akce aktualizace, potvrzení nebo vrácení zpět se nezdaří.
  • B2B se nepodporuje.
  • Řešení konfliktů se částečně provádí v Gitu.