Začíname s integráciou systému Git (Preview)

Tento článok vás prevedie nasledujúcimi základnými úlohami v nástroji na integráciu systému Git v službe Microsoft Fabric:

• Pripojenie k odkladacom priestoru Git
• Potvrdiť zmeny
• Aktualizácia z Git
• Odpojenie od systému Git

Skôr než začnete, odporúčame vám prečítať si prehľad integrácie so službou Git.

Dôležité

Táto funkcia je vo verzii Preview.

Požiadavky

Ak chcete integrovať systém Git s pracovným priestorom služby Microsoft Fabric, musíte nastaviť nasledujúce predpoklady pre službu Fabric aj systém Git.

Predpoklady tkaniny

Ak chcete získať prístup k funkcii integrácie Git, budete potrebovať jedno z týchto možností:

• Licencia Power BI Premium. Licencia Power BI Premium podporuje iba všetky položky služby Power BI.
• Kapacita tkaniny. Na používanie všetkých podporovaných položiek služby Fabric sa vyžaduje kapacita služby Fabric. Ak ho ešte nemáte, zaregistrujte si bezplatnú skúšobnú verziu.

Okrem toho musia byť na portáli na správu povolené nasledujúce prepínače nájomníka:

• Používatelia môžu vytvárať položky služby Fabric
• Používatelia môžu synchronizovať položky pracovného priestoru so svojimi odkladacími priestormi Git
• Len pre používateľov služby GitHub: Používatelia môžu synchronizovať položky pracovného priestoru s odkladacími priestormi GitHub

Tieto prepínače môže povoliť správca nájomníka, správca kapacity alebo správca pracovného priestoru v závislosti od nastavení vašej organizácie.

Požiadavky Gitu

Integrácia systému Git je v súčasnosti podporovaná pre služby Azure DevOps a GitHub. Ak chcete používať integráciu systému Git s pracovným priestorom služby Fabric, budete potrebovať nasledujúce informácie v službách Azure DevOps alebo GitHub:

Obmedzenia služby Azure DevOps

• Aktívne konto Azure zaregistrované u toho istého používateľa, ktorý používa pracovný priestor služby Fabric. Vytvorte si bezplatné konto.
• Prístup k existujúcemu odkladaciemu priestoru.

Obmedzenia služby GitHub

• Aktívne konto GitHub. Vytvorte si konto v službe GitHub.

• Jeden z nasledujúcich osobných prístupových tokenov:

  • Diferencovaný token (odporúča sa) s povolením na čítanie a zápis v rámci povolení odkladacieho priestoru:

    

    Ak chcete použiť tento token s aplikáciou GitHub Enterprise, postupujte podľa týchto pokynov.

  • Vytvorenie klasického tokenu GitHubu s povolenými rozsahmi odkladacieho priestoru:

    

Pripojenie pracovného priestoru k odkladacom priestoru Git

Pripojenie k odkladacom priestoru Git

Len správca pracovného priestoru môže pripojiť pracovný priestor k odkladaciemu priestoru, ale po pripojení môže pracovný priestor pracovať ktokoľvek s povolením . Ak nie ste správcom, požiadajte správcu o pomoc s pripojením. Ak chcete pripojiť pracovný priestor k odkladaciemu priestoru Azure alebo GitHub, postupujte podľa týchto krokov:

1. Prihláste sa do služby Fabric a prejdite do pracovného priestoru, ku ktorému sa chcete pripojiť.

2. Prejsť do časti Nastavenia pracovného priestoru

   

3. Vyberte položku Integrácia Git.

4. Vyberte poskytovateľa systému Git. V súčasnosti sú služby Azure DevOps a GitHub podporované.

Azure DevOps Connect

Ak vyberiete položku Azure DevOps, výberom položky Pripojiť sa automaticky prihláste do konta Azure Repos zaregistrovaného na používateľa služby Microsoft Entra prihláseného do služby Fabric.

GitHub Connect

Ak vyberiete možnosť GitHub, musíte sa prihlásiť do svojho konta GitHub.
Ak sa prihlasujete z služby Fabric prvýkrát, vyberte položku Pridať konto alebo vyberte jedno z uvedených kont. Po prihlásení vyberte položku Pripojiť a povoľte službe Fabric prístup k vášmu kontu GitHub.

Ak sa pripájate prvýkrát, musíte oprávniť používateľa služby GitHub. Zadajte nasledujúce informácie:

• Zobrazovaný názov – musí byť jedinečný pre každého používateľa služby GitHub
• Osobný prístupový token - vášho klasického alebo diferencovaného osobného prístupového tokenu.
• URL adresa odkladacieho priestoru (voliteľné) – ak nezadáte URL adresu, môžete sa pripojiť k ľubovoľnému odkladaciemu priestoru, ku ktorému máte prístup. Ak zadáte URL adresu, môžete sa pripojiť len k tomuto odkladaciemu priestoru.

Pripojenie k pracovnému priestoru

Ak je už pracovný priestor pripojený k službe GitHub, postupujte podľa pokynov na pripojenie k zdieľanému pracovnému priestoru.

Pripojenie vetvy Azure DevOps

1. V rozbaľovacej ponuke zadajte nasledujúce podrobnosti o vetve, ku ktorému sa chcete pripojiť:

   Poznámka

   Pracovný priestor môžete pripojiť len k jednej vetve a jednému priečinku súčasne.

   • Organizácia
   • Projekt
   • Odkladací priestor Git.
   • Vetva (Vyberte existujúcu vetvu pomocou rozbaľovacej ponuky alebo vyberte položku + Nová vetva a vytvorte novú vetvu. Súčasne sa môžete pripojiť len k jednej vetve.)
   • Priečinok (zadajte názov existujúceho priečinka alebo zadajte názov na vytvorenie nového priečinka. Ak názov priečinka ponecháte prázdny, obsah sa vytvorí v koreňovom priečinku. Naraz sa môžete pripojiť len k jednému priečinku.)

Pripojenie vetvy GitHub

1. V rozbaľovacej ponuke zadajte nasledujúce podrobnosti o vetve, ku ktorému sa chcete pripojiť:

   Poznámka

   Pracovný priestor môžete pripojiť len k jednej vetve a jednému priečinku súčasne.

   • URL adresa odkladacieho priestoru. Ak ste sa pripojili k GitHubu pomocou tokenu obmedzeného na rozsah, URL adresa sa automaticky vyplní a môžete sa pripojiť len k tomuto odkladaciemu priestoru.
   • Vetva (Vyberte existujúcu vetvu pomocou rozbaľovacej ponuky alebo vyberte položku + Nová vetva a vytvorte novú vetvu. Súčasne sa môžete pripojiť len k jednej vetve.)
   • Priečinok (zadajte názov existujúceho priečinka alebo zadajte názov na vytvorenie nového priečinka. Ak názov priečinka ponecháte prázdny, obsah sa vytvorí v koreňovom priečinku. Naraz sa môžete pripojiť len k jednému priečinku.)

Vyberte položku Pripojiť a synchronizovať.

Ak je v počiatočnej synchronizácii pracovný priestor alebo vetva systému Git prázdna, obsah sa skopíruje z umiestnenia nonempty do prázdneho. Ak vetva pracovného priestoru aj Git obsahujú obsah, zobrazí sa výzva, ktorým smerom by mala prejsť synchronizácia. Ďalšie informácie o tejto počiatočnej synchronizácii nájdete v téme Pripojenie a synchronizácia.

Po pripojení pracovný priestor zobrazí informácie o ovládaní zdroja, ktoré používateľovi umožňujú zobraziť pripojenú vetvu, stav jednotlivých položiek vo vetve a čas poslednej synchronizácie.

Ak chcete zachovať synchronizáciu pracovného priestoru s vetvou Git, potvrďte všetky zmeny vykonané v pracovnom priestore vo vetve Git a aktualizujte pracovný priestor vždy, keď niekto vytvorí nové záväzky do vetvy Git.

Potvrdiť zmeny v gitu

Po úspešnom pripojení k priečinku Git upravte pracovný priestor ako zvyčajne. Všetky zmeny, ktoré uložíte, sa uložia iba v pracovnom priestore. Keď budete pripravení, môžete potvrdiť zmeny do vetvy Git alebo môžete zrušiť zmeny a vrátiť sa k predchádzajúcemu stavu. Prečítajte si viac o potvrdeniach.

Potvrdiť systému Git

Ak chcete potvrdiť zmeny vo vetve Git, postupujte podľa týchto krokov:

1. Prejdite do pracovného priestoru.

2. Vyberte ikonu ovládacieho prvku Zdroj. Táto ikona zobrazuje počet nekomprimovaných zmien.

3. Vyberte položku Zmeny na ovládacom paneli Zdroj. Zobrazí sa zoznam so všetkými položkami, ktoré ste zmenili, a ikona označujúca, či je položka nová , upravená, konfliktná alebo odstránená .

4. Vyberte položky, ktoré chcete potvrdiť. Ak chcete vybrať všetky položky, začiarknite horné políčko.

5. Pridajte do poľa komentár. Ak nepridáte komentár, automaticky sa pridá predvolená správa.

6. Vyberte položku Potvrdiť.

   

Po spáchaných zmenách sa položky, ktoré sa dopustili, odstránia zo zoznamu a pracovný priestor bude odkazovať na nové potvrdenie, do ktorého bola synchronizovaná.

Po úspešnom dokončení potvrdenia sa stav vybratých položiek zmení z hodnoty Uncommitted na Synchronizované.

Zrušiť zmenu uložené

Ak sa po uložení zmien do pracovného priestoru rozhodnete, že nechcete potvrdiť tieto zmeny do služby git, môžete vrátiť zmeny a vrátiť tieto položky na predchádzajúci stav. Ak chcete zmeny vrátiť späť, postupujte podľa týchto krokov:

1. Prejdite do pracovného priestoru.

2. Vyberte tlačidlo Ovládací prvok Zdroj. Toto tlačidlo tiež zobrazuje počet nekomprimovaných zmien.

3. Vyberte položku Zmeny na ovládacom paneli Zdroj. Zobrazí sa zoznam so všetkými položkami, ktoré ste zmenili, a ikona označujúca, či je zmenená položka nová , upravená, konfliktná alebo odstránená .

4. Vyberte zmeny, ktoré chcete vrátiť späť.

5. Vyberte položku Zrušiť zmenu.

   

6. Ak to chcete potvrdiť, opäť vyberte položku Zrušiť zmenu.

   

Vybraté položky v pracovnom priestore sa vrátia k tomu, ako boli naposledy synchronizované.

Dôležité

Ak odstránite položku a potom zrušíte zmeny, položka sa vytvorí nanovo a niektoré metaúdaje sa môžu stratiť. Napríklad označenia citlivosti nie sú uložené a mali by sa obnoviť a vlastník položky sa nastaví na aktuálneho používateľa.

Aktualizácia pracovného priestoru z Git

Vždy, keď niekto potvrdí novú zmenu pripojenej vetve Git, v príslušnom pracovnom priestore sa zobrazí oznámenie. Pomocou ovládacieho panela Zdroj načítajte najnovšie zmeny, zlúčenia alebo zmeny do pracovného priestoru a aktualizáciu dynamických položiek. Prečítajte si viac o aktualizácii.

Ak chcete aktualizovať pracovný priestor, postupujte podľa týchto krokov:

1. Prejdite do pracovného priestoru.
2. Vyberte ikonu ovládacieho prvku Zdroj.
3. Na ovládacom paneli Zdroj vyberte položku Aktualizácie . Zobrazí sa zoznam so všetkými položkami, ktoré boli vo vetve zmenené od poslednej aktualizácie.
4. Vyberte položku Aktualizovať všetko.

Po úspešnom aktualizácii sa odstráni zoznam položiek a pracovný priestor bude smerovať na nové potvrdenie, že sa synchronizuje s.

Po úspešnom dokončení aktualizácie sa stav položiek zmení na Synchronizované.

Odpojenie pracovného priestoru od systému Git

Pracovný priestor od odkladacieho priestoru Git môže odpojiť len správca pracovného priestoru. Ak nie ste správcom, požiadajte o pomoc s odpojením svojho správcu. Ak ste správcom a chcete odpojiť odkladací priestor, postupujte podľa týchto krokov:

1. Prejsť do časti Nastavenia pracovného priestoru
2. Vyberte integráciu Git
3. Vyberte položku Odpojiť pracovný priestor
4. Ak to chcete potvrdiť, znova vyberte položku Odpojiť .

Povolenia

Akcie, ktoré môžete vykonať v pracovnom priestore, závisia od povolení, ktoré máte v pracovnom priestore aj v odkladacom priestore Git. Podrobnejšie informácie o povoleniach nájdete v téme Povolenia.

Dôležité informácie a obmedzenia

Všeobecné obmedzenia integrácie systému Git

• Metóda overovania v službe Fabric musí byť aspoň rovnako silná ako metóda overovania pre Git. Ak napríklad Git vyžaduje viacfaktorové overenie, fabric musí vyžadovať aj viacfaktorové overovanie.
• Množiny údajov služby Power BI pripojené k službe Analysis Services sa momentálne nepodporujú.
• Suverénne cloudy nie sú podporované.

Obmedzenia služby Azure DevOps

• Konto Azure DevOps musí byť zaregistrované u toho istého používateľa, ktorý používa pracovný priestor služby Fabric.
• Správca nájomníka musí povoliť exporty krížových geografických oblastí, ak sa pracovný priestor a odkladací priestor Git nachádzajú v dvoch rôznych geografických oblastiach.
• Veľkosť potvrdenia je obmedzená na 125 MB.

Obmedzenia služby GitHub

• GitHub nemôže vynútiť overenie krížovej geografickej polohy.
• Celková kombinovaná veľkosť súborov, ktoré sa majú potvrdiť naraz, je obmedzená na 50 MB. Preto ak máte viacero položiek na potvrdenie, niekedy môže byť potrebné rozdeliť ich na niekoľko samostatných potvrdení. Ďalšie informácie o páchaní súborov nájdete v našom sprievodcovi riešením problémov.

Obmedzenia služby GitHub Enterprise

Niektoré nastavenia služby GitHub Enterprise nie sú podporované. Napríklad:

• Zoznam povolených IP adries
• Súkromné siete

Obmedzenia pracovného priestoru

• Pripojenia k odkladaciemu priestoru Git môže spravovať len správca pracovného priestoru, ako je napríklad pripojenie, odpojenie alebo pridanie vetvy.
  Po pripojení môže v pracovnom priestore pracovať ktokoľvek s povolením .
• Štruktúra priečinkov pracovného priestoru sa neprejaví v odkladacom priestore Git. Položky pracovného priestoru v priečinkoch sa exportujú do koreňového adresára.

Obmedzenia vetiev a priečinkov

• Maximálna dĺžka názvu vetvy je 244 znakov.
• Maximálna dĺžka úplnej cesty k názvom súborov je 250 znakov. Dlhšie názvy zlyhajú.
• Maximálna veľkosť súboru je 25 MB.
• Zostavu alebo množinu údajov nie je možné stiahnuť ako .pbix zo služby po ich nasadení s integráciou Git.
• Pri pomenovaní priečinka v službe Git sa logické ID (GUID) pridá ako predpona pred typ, ak zobrazovaný názov položky:
  • Má viac ako 256 znakov
  • Končí reťazcom . alebo medzerou
  • Obsahuje niektorý z nasledujúcich znakov: " / : ? < > \ * |

Obmedzenia vetvenia

• Vetvenie vyžaduje povolenia uvedené v tabuľke povolení.
• Pre túto akciu musí byť dostupná kapacita.
• Obmedzenia pomenovania všetkých pracovných priestorov a vetiev platia pri vetvení do nového pracovného priestoru.
• Pri vetvení sa vytvorí nový pracovný priestor a nastavenia z pôvodného pracovného priestoru sa neskopírujú. Upravte všetky nastavenia alebo definície a ubezpečte sa, že nový pracovný priestor spĺňa politiky vašej organizácie.
• V novom pracovnom priestore sú k dispozícii iba položky podporované v službe Git.
• Zoznam súvisiacich vetiev zobrazuje iba vetvy a pracovné priestory, na ktoré máte povolenie na zobrazenie.
• Integrácia systému Git musí byť povolená.

Obmedzenia synchronizácie a potvrdenia

• Synchronizovať môžete iba v jednom smere. Nemôžete potvrdiť a aktualizovať naraz.
• Označenia citlivosti nie sú podporované a exportovanie položiek s označeniami citlivosti môže byť zakázané. Ak chcete potvrdiť položky, ktoré majú označenia citlivosti bez označenia citlivosti, požiadajte o pomoc svojho správcu .
• Funguje s obmedzenými položkami. Nepodporované položky v priečinku sa ignorujú.
• Duplikovanie názvov nie je povolené. Dokonca aj vtedy, ak služba Power BI umožňuje duplicitu názvov, akcia aktualizácie, potvrdenia alebo vrátenia zmeny zlyhá.
• B2B nie je podporovaná.
• Riešenie konfliktu sa čiastočne vykonáva v službe Git.
• Počas procesu Potvrdiť v Git služba Fabric odstráni súbory vo vnútri priečinka položky, ktoré nie sú súčasťou definície položky. Nesúvisiace súbory, ktoré nie sú v priečinku položiek, sa neodstránia.
• Po potvrdení zmien si môžete všimnúť neočakávané zmeny položky, ktoré ste nevytvorili. Tieto zmeny sú sémanticky nevýznamné a môžu sa vyskytnúť z viacerých dôvodov. Napríklad:
  • Manuálna zmena súboru definície položky. Tieto zmeny sú platné, ale môžu sa líšiť od toho, ak sa vykonali prostredníctvom editorov. Ak napríklad premenujete stĺpec sémantického modelu v službe Git a importujete túto zmenu do pracovného priestoru, pri ďalšom potvrdení zmien do sémantického modelu sa súbor BIM zaregistruje ako zmenený a upravený stĺpec sa presunie do zadnej časti columns poľa. Dôvodom je, že nástroj AS, ktorý generuje súbory BIM odosiela premenované stĺpce na koniec poľa. Táto zmena nemá vplyv na spôsob, akým položka funguje.
  • Spáchanie súboru, ktorý používa zlomy riadkov CRLF . Služba používa zlomy riadkov LF (posun riadka). Ak ste v odkladacom priestore Git mali súbory položiek s zlomami riadkov CRLF , pri potvrdení zo služby sa tieto súbory zmenia na LF. Ak napríklad otvoríte zostavu v počítači, uložte projekt .pbip a nahrajte ho do Git pomocou funkcie CRLF.
• Obnovenie sémantického modelu pomocou rozšíreného rozhrania API obnovenia spôsobí po každom obnovení rozdiel Git.

Súvisiaci obsah

• Vysvetlenie procesu integrácie systému Git
• Spravovanie vetiev systému Git
• Najvhodnejšie postupy integrácie so službou Git