Začínáme s integrací Gitu

Tento článek vás provede následujícími základními úlohami v nástroji pro integraci Git v Microsoft Fabric:

• Připojení k úložišti Git
• Potvrzení změn
• Aktualizace z Gitu
• Odpojení od Gitu

Než začnete, doporučujeme přečíst si přehled integrace Gitu.

Požadavky

Pokud chcete integrovat Git s pracovním prostorem Microsoft Fabric, musíte pro Microsoft Fabric i Git nastavit následující předpoklady.

Požadavky pro Fabric

Pro přístup k funkci Git integrace potřebujete kapacitu Fabric . Pro použití všech položek podporovaných v systému Fabric je vyžadována kapacita Fabric. Pokud ho ještě nemáte, zaregistrujte si bezplatnou zkušební verzi. Zákazníci, kteří již mají kapacitu Power BI Premium, mohou tuto kapacitu použít, ale mějte na paměti, že určité SKU Power BI podporují pouze určité funkce Power BI.

Kromě toho musí být na portálu pro správu povoleny následující přepínače tenantů :

• Uživatelé mohou vytvářet položky Fabric.
• Uživatelé můžou synchronizovat položky pracovního prostoru se svými úložišti Git.
• Pouze uživatelé GitHubu: Uživatelé můžou synchronizovat položky pracovního prostoru s úložišti GitHub

Tyto přepínače může povolit správce tenanta, správce kapacity nebo správce pracovního prostoru v závislosti na nastavení vaší organizace.

Požadavky Gitu

Integrace Gitu se v současné době podporuje pro Azure DevOps a GitHub. Pokud chcete použít integraci Gitu s pracovním prostorem Fabric, potřebujete v Azure DevOps nebo na GitHubu následující:

Připojení pracovního prostoru k úložišti Git

Připojení k úložišti Git

Pracovní prostor může připojit jenom správce pracovního prostoru k úložišti, ale po připojení může v pracovním prostoru pracovat kdokoli s oprávněním . Pokud nejste správce, požádejte správce o pomoc s připojením. Pokud chcete připojit pracovní prostor k úložišti Azure nebo GitHubu, postupujte takto:

1. Přihlaste se do Fabric a přejděte na pracovní prostor, ke kterému se chcete připojit.

2. Přejít do nastavení pracovního prostoru

   

3. Vyberte Git integraci.

4. Vyberte svého poskytovatele Gitu. V současné době se podporují Azure DevOps a GitHub.

Připojení k pracovnímu prostoru

Pokud už je pracovní prostor připojený k GitHubu, postupujte podle pokynů pro připojení ke sdílenému pracovnímu prostoru.

Vyberte Připojit a synchronizovat.

Pokud je pracovní prostor nebo větev Gitu prázdná, během počáteční synchronizace se obsah zkopíruje z neprázdného umístění do prázdného. Pokud pracovní prostor i větev Gitu obsahují obsah, zobrazí se dotaz, ve kterém směru má synchronizace proběhnout. Další informace o této počáteční synchronizaci najdete v tématu Připojení a synchronizace.

Po připojení se v pracovním prostoru zobrazí informace o správě zdrojového kódu, které uživateli umožní zobrazit připojenou větev, stav každé položky ve větvi a čas poslední synchronizace.

Pokud chcete zachovat synchronizaci pracovního prostoru s větví Git, potvrďte všechny změny provedené v pracovním prostoru do větve Git a aktualizujte pracovní prostor pokaždé, když někdo vytvoří nová potvrzení do větve Gitu.

Potvrzení změn do Gitu

Po úspěšném připojení ke složce Git upravte pracovní prostor obvyklým způsobem. Všechny změny, které uložíte, se uloží jenom v pracovním prostoru. Až budete připravení, můžete potvrdit změny do větve Gitu nebo vrátit změny zpět a vrátit se k předchozímu stavu.

Přečtěte si další informace o commitech.

Aktualizace pracovního prostoru z Gitu

Pokaždé, když někdo potvrdí novou změnu do připojené větve Gitu, zobrazí se v příslušném pracovním prostoru oznámení. Pomocí panelu Správa zdrojového kódu můžete stáhnout nejnovější změny, sloučit je nebo se vrátit do pracovního prostoru a aktualizovat živé položky. Změny ve složkách se také aktualizují. Přečtěte si další informace o aktualizaci.

Pokud chcete aktualizovat pracovní prostor, postupujte takto:

1. Přejděte do pracovního prostoru.
2. Vyberte ikonu správa zdrojů.
3. V ovládacím panelu Zdroj vyberte Aktualizace . Zobrazí se seznam se všemi položkami, které byly změněny ve větvi od poslední aktualizace.
4. Vyberte Aktualizovat vše.

Po úspěšné aktualizaci se odebere seznam položek a pracovní prostor odkazuje na nový pracovní prostor, do kterého se synchronizuje.

Po úspěšném dokončení aktualizace se stav položek změní na Synchronizované.

Odpojení pracovního prostoru od Gitu

Jenom správce pracovního prostoru může odpojit pracovní prostor od úložiště Git. Pokud nejste správce, požádejte správce o pomoc s odpojením. Pokud jste správce a chcete úložiště odpojit, postupujte takto:

1. Přejít do nastavení pracovního prostoru
2. Vyberte integraci Gitu
3. Vyberte Odpojit pracovní prostor
4. Potvrďte dalším výběrem Odpojit.

Oprávnění

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 úložišti Git. Podrobnější diskuzi o oprávněních najdete v tématu Oprávnění.

Úvahy a omezení

Obecná omezení integrace Gitu

• Metoda ověřování ve Fabricu musí být alespoň tak silná jako metoda ověřování pro Git. Například, pokud Git vyžaduje vícefaktorové ověřování, musí také Fabric vyžadovat vícefaktorové ověřování.
• Datové sady Power BI připojené ke službě Analysis Services se v tuto chvíli nepodporují.
• Pracovní prostory s nainstalovanými aplikacemi šablon se nedají připojit k Gitu.
• Submoduly nejsou podporovány.
• Suverénní cloudy nejsou podporovány.

Omezení GitHubu Enterprise

Některá nastavení GitHub Enterprise se nepodporují. Příklad:

• Seznam povolených IP adres
• Privátní sítě
• Vlastní domény

Omezení pracovního prostoru

• Pouze správce pracovního prostoru může spravovat připojení k Git repozitáři, jako je připojování, odpojování nebo přidávání větví.
  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.
• Struktura složek se udržuje až do hloubky 10 úrovní.
• Po nasazení sestavy/datové sady pomocí integrace s Gitem je už nemůžete stáhnout ze služby jako .pbix.
• Pokud má zobrazovaný název položky některou z těchto charakteristik, složka Git se přejmenuje na logické ID (Guid) a typ:
  • Má více než 256 znaků.
  • Končí . nebo mezerou
  • Obsahuje všechny zakázané znaky, jak je popsáno v omezeních názvu adresáře
• Když připojíte pracovní prostor, který má složky k Gitu, budete muset potvrdit změny v úložišti Git, pokud se tato struktura složek liší.

Omezení názvů adresářů

• Název adresáře, který se připojuje k úložišti Git, má následující omezení pojmenování:

  • Název adresáře nemůže začínat ani končit mezerou nebo tabulátorem.
  • Název adresáře nemůže obsahovat žádný z následujících znaků: "/:<>\*?|

• Složka položky (složka obsahující soubory položek) nemůže obsahovat žádný z následujících znaků: ":<>\*?|. Pokud složku přejmenujete na něco, co obsahuje jeden z těchto znaků, Git se nemůže připojit nebo synchronizovat s pracovním prostorem a dojde k chybě.

Rozšiřování omezení

• Větvení vyžaduje oprávnění uvedená v tabulce oprávnění.
• Pro tuto akci musí být k dispozici kapacita.
• Při větvení na nový pracovní prostor se uplatňují všechna omezení pojmenování pracovních prostorů a větví.
• V novém pracovním prostoru jsou dostupné jenom podporované položky Gitu.
• Seznam souvisejících větví zobrazuje jenom větve a pracovní prostory, ke kterým máte oprávnění k zobrazení.
• Musí být povolená integrace Gitu.
• Při větvení se vytvoří nová větev a nastavení z původní větve se nezkopíruje. Upravte všechna nastavení nebo definice, abyste měli jistotu, že nové vyhovuje zásadám vaší organizace.
• Při větvení do existujícího pracovního prostoru:
  • Cílový pracovní prostor musí podporovat připojení Git.
  • Uživatel musí být správcem cílového pracovního prostoru.
  • Cílový pracovní prostor musí mít kapacitu.
  • Pracovní prostor nemůže mít šablonové aplikace.
• Mějte na paměti, že při větvení do pracovního prostoru se můžou ztratit jakékoli položky, které nejsou uložené v Git. Doporučujeme, abyste uložili všechny položky, které chcete zachovat, předtím než vytvoříte větev.

Omezení synchronizace a potvrzení

• Můžete synchronizovat pouze v jednom směru najednou. 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. Nepodporované položky ve složce se ignorují.
• Duplikování názvů není povoleno. I když Power BI povolí duplikaci názvů, selže akce aktualizace, potvrzení nebo vrácení zpět.
• B2B se nepodporuje.
• Řešení konfliktů se částečně provádí v Gitu.
• Během procesu Potvrzení do Gitu služba Fabric odstraní soubory ve složce položek, které nejsou součástí definice položky. Nesouvisející soubory, které nejsou ve složce položek, se neodstraní.
• Po potvrzení změn si můžete všimnout neočekávaných změn položky, kterou jste neudělali. Tyto změny jsou séanticky nevýznamné a mohou k tomu dojít z několika důvodů. Příklad:
  • Ruční změna definičního souboru položky Tyto změny jsou platné, ale můžou se lišit od toho, co se provádí prostřednictvím editorů. Pokud například přejmenujete sloupec sémantického modelu v Gitu a naimportujete tuto změnu do pracovního prostoru, při příštím potvrzení změn do sémantického modelu se soubor bim zaregistruje jako změněný a upravený sloupec se vloží do zadní části columns pole. Důvodem je to, že modul AS, který generuje soubory BIM , odesílá přejmenované sloupce na konec pole. Tato změna nemá vliv na způsob fungování položky.
  • Commitování souboru, který používá konce řádků CRLF. Služba používá LF (znak pro nový řádek) konce řádků. Pokud jste měli soubory položek v úložišti Git s konci řádků CRLF, při potvrzení ze služby se tyto soubory změní na LF. Pokud například otevřete sestavu na Desktopu, uložte soubor projektu (.pbip) a nahrajte ho do Gitu pomocí CRLF.
• Aktualizace sémantického modelu pomocí rozhraní API pro vylepšenou aktualizaci způsobí Git diff po každé aktualizaci.

Související obsah

• Vysvětlení procesu integrace Gitu
• Správa gitových větví
• Osvědčené postupy integrace Gitu