Sdílet prostřednictvím

Co je integrace Microsoft Fabric Git?

Tento článek vysvětluje vývojářům, jak integrovat správu verzí Gitu s nástrojem pro správu životního cyklu aplikací Microsoft Fabric (ALM).

Poznámka:

Některé položky integrace Gitu jsou ve verzi Preview. Další informace najdete v seznamu podporovaných položek.

Integrace Gitu v Microsoft Fabric umožňuje vývojářům integrovat své vývojové procesy, nástroje a osvědčené postupy přímo do platformy Fabric. Umožňuje vývojářům, kteří vyvíjejí ve Fabric,

  • Zálohujte a vytvářejte verze své práce
  • Podle potřeby se vraťte k předchozím fázím.
  • Spolupracujte s ostatními nebo pracujte samostatně pomocí větví Gitu
  • Použijte funkce známých nástrojů pro správu zdrojového kódu ke správě položek Fabric.

Integrace se správou zdrojového kódu je na úrovni pracovního prostoru. Vývojáři můžou verzovat položky, které vyvíjejí, v rámci pracovního prostoru v jednom procesu, s plnou viditelností všech svých položek. Struktura pracovního prostoru, včetně podsložek, se zachová v úložišti Git.

Podívejte se na seznam podporovaných položek.

  • Přečtěte si základní koncepty Gitu a správy verzí.

  • Přečtěte si další informace o procesu integrace Gitu.

  • Přečtěte si o tom, jak nejlépe spravovat větve Gitu.

Informace o ochraně osobních údajů

Před povolením integrace Gitu zkontrolujte následující prohlášení o zásadách ochrany osobních údajů:

Podporovaní poskytovatelé Gitu

Podporují se následující poskytovatelé Gitu:

  • Azure DevOps s týmž tenantem jako tenant Fabric
  • GitHubu (jenom cloudové verze)
  • GitHub Enterprise (jenom cloudové verze)

Podporované položky

Integrace Gitu v současné době podporují následující položky:

Pokud má pracovní prostor nebo adresář Git nepodporované položky, může být stále připojený, ale nepodporované položky se ignorují. Neuloží se ani nesynchronizují, ale neodstraní se ani. Zobrazí se na panelu správy zdrojového kódu, ale nemůžete je potvrdit ani aktualizovat.

Ú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í Fabric vyžadovat také vícefaktorové ověřování.
  • Datové sady Power BI připojené ke službě Analysis Services se v tuto chvíli nepodporují.
  • Pokud používáte identitu pracovního prostoru v jednom artefaktu a commitujete to do Git, můžete to aktualizovat (zpět do fabric pracovního prostoru) jenom v pracovním prostoru připojeném ke stejné identitě. Buďte opatrní, protože to také ovlivňuje funkce, jako je rozvětvování.
  • Dílčí moduly nejsou podporovány.
  • Suverénní cloudové služby nejsou podporovány.
  • Účet Azure DevOps musí být zaregistrovaný pro stejného uživatele, který používá pracovní prostor Fabric.
  • Azure DevOps není podporován, pokud je povoleno ověřování zásad podmíněného přístupu IP.
  • Pokud se pracovní prostor a úložiště Git nacházejí ve dvou různých geografických oblastech, musí správce tenanta povolit křížové exporty .
  • Pokud vaše organizace nakonfigurovala podmíněný přístup, ujistěte se, že služba Power BI má nastavené stejné podmínky , aby ověřování fungovalo podle očekávání.
  • Velikost commitu je omezená na 125 MB.

Omezení GitHubu Enterprise

Některé verze a nastavení GitHubu Enterprise nejsou podporované. Příklad:

  • GitHub Enterprise Cloud s rezidencí dat (ghe.com)
  • GitHub Enterprise Server s vlastní doménou se nepodporuje, i když je instance veřejně přístupná.
  • GitHub Enterprise Server hostovaný v privátní síti
  • Seznam povolených IP adres

Omezení pracovního prostoru

  • Připojení k úložišti Git 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.
  • Pracovní prostory s nainstalovanými aplikacemi šablon se nedají připojit k Gitu.
  • MyWorkspace se nemůže připojit k poskytovateli Gitu.

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 nefungují.
  • Maximální velikost souboru je 25 MB.
  • Adresářová struktura se zachovává až do hloubky deseti úrovní.
  • Stažení sestavy nebo datové sady jako .pbix ze služby po jejich nasazení pomocí integrace s Gitem se nedoporučuje, protože výsledky jsou nespolehlivé. Ke stažení sestav nebo datových sad jako .pbix doporučujeme použít PowerBI Desktop.
  • Pokud má zobrazovaný název položky některou z těchto charakteristik, složka Git je přejmenována na logické ID (GUID) a typ.
    • Má více než 256 znaků.
    • Končí znakem . 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 tabem.
    • 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 vztahují 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 rozšiřování 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 mohou ztratit položky, které nejsou uložené na Git. Před rozvětvením doporučujeme potvrdit všechny položky, které chcete zachovat.

Omezení synchronizace a potvrzení

  • Synchronizovat můžete 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.
    • Commitovat soubor, který používá konce řádků CRLF. Služba používá znaky pro nové řádky LF (line feed). Pokud jste měli soubory položek v úložišti Git s konci řádků CRLF, při potvrzení ze služby Git se tyto soubory změní na LF. Pokud například otevřete sestavu v desktopové verzi, uložte soubor projektu (.pbip) a nahrajte ji do Gitu pomocí CRLF.
  • Aktualizace sémantického modelu pomocí API pro vylepšenou obnovu způsobí Git diff po každé aktualizaci.

Související obsah