Základné koncepty v integrácii Git
Tento článok vysvetľuje základné koncepty systému Git a proces integrácie služby Git s pracovným priestorom služby Microsoft Fabric.
Povolenia
- Ak chcete používať integráciu systému Git, správca vašej organizácie ju musí povoliť správcom vašej organizácie.
- Ak sa pracovný priestor a odkladací priestor Azure nachádzajú v dvoch rôznych oblastiach, správca nájomníka musí povoliť export medzi geografickými oblasťami. Toto obmedzenie sa nevzťahuje na GitHub.
- Akcie, ktoré môžete vykonať v pracovnom priestore, závisia od povolení, ktoré máte v pracovnom priestore aj v službe Git, ako sú uvedené v nasledujúcich sekciách.
Požadované povolenia Git pre obľúbené akcie
Nasledujúci zoznam uvádza, aké rôzne roly pracovného priestoru môžu vykonávať v závislosti od ich povolení v odkladacom priestore Git:
- Správca: Môže vykonať akúkoľvek operáciu v pracovnom priestore obmedzenú iba jeho rolou Git.
- Člen alebo prispievateľ: Po pripojení k pracovnému priestoru môže člen/prispievateľ potvrdiť a aktualizovať zmeny v závislosti od jeho roly Git. V prípade akcií súvisiacich s pripojením pracovného priestoru (napríklad pripojenie, odpojenie alebo prepnutie vetiev) požiadajte správcu o pomoc.
- Čitateľ: nemôže vykonávať žiadne akcie. Divák nemôže v pracovnom priestore vidieť žiadne informácie súvisiace so službou Git.
Požadované povolenia na štruktúru pre obľúbené akcie
Roly pracovného priestoru
Nasledujúca tabuľka popisuje povolenia potrebné v pracovnom priestore služby Fabric na vykonávanie rôznych bežných operácií:
| Operácia | Rola pracovného priestoru |
|---|---|
| Pripojenie pracovného priestoru k odkladacom priestoru Git | Správca |
| Synchronizácia pracovného priestoru s odkladacím priestorom Git | Správca |
| Odpojenie pracovného priestoru od odkladacieho priestoru Git | Správca |
| Prepnutie vetvy v pracovnom priestore (alebo akákoľvek zmena nastavenia pripojenia) | Správca |
| Zobraziť podrobnosti o pripojení Git | Správca, člen, prispievateľ |
| Pozrite si tému Stav Git pracovného priestoru | Správca, člen, prispievateľ |
| Aktualizácia z Git | Všetky tieto: Prispievateľ do pracovného priestoru (povolenie ZAPISOVAŤ do všetkých položiek) Vlastník položky (ak prepnutie nájomníka blokuje aktualizácie pre nevlastníkov) STAVAŤ na externých závislostiach (tam, kde je to možné) |
| Potvrdiť zmeny pracovného priestoru v Git | Všetky tieto: Prispievateľ do pracovného priestoru (povolenie ZAPISOVAŤ do všetkých položiek) Vlastník položky (ak prepnutie nájomníka blokuje aktualizácie pre nevlastníkov) STAVAŤ na externých závislostiach (tam, kde je to možné) |
| Vytvorenie novej vetvy Git z prostredia služby Fabric | Správca |
| Vetvenie na nový pracovný priestor | Správca, člen, prispievateľ |
Roly gitu
Nasledujúca tabuľka popisuje povolenia Git potrebné na vykonávanie rôznych bežných operácií:
| Operácia | Povolenia Git |
|---|---|
| Pripojenie pracovného priestoru k odkladacom priestoru Git | Čítať=Povoliť |
| Synchronizácia pracovného priestoru s odkladacím priestorom Git | Čítať=Povoliť |
| Odpojenie pracovného priestoru od odkladacieho priestoru Git | Nie sú potrebné žiadne povolenia |
| Prepnutie vetvy v pracovnom priestore (alebo akákoľvek zmena nastavenia pripojenia) | Read=Allow (v cieľovom odkladacom priestore/adresári/vetve) |
| Zobraziť podrobnosti o pripojení Git | Čítať alebo Žiadne |
| Pozrite si tému Stav Git pracovného priestoru | Čítať=Povoliť |
| Aktualizácia z Git | Čítať=Povoliť |
| Potvrdiť zmeny pracovného priestoru v Git | Čítať=Povoliť Prispieť= Povoliť vetva politika by mala povoliť priame potvrdenie |
| Vytvorenie novej vetvy Git z prostredia služby Fabric | Role=Write Vytvorenie vetvy=Povoliť |
| Vetvenie na nový pracovný priestor | Čítať=Povoliť Vytvorenie vetvy=Povoliť |
Pripojenie a synchronizácia
Len správca pracovného priestoru môže pripojiť pracovný priestor k odkladaným priestorom Git, ale po pripojení môže v pracovnom priestore pracovať ktokoľvek s povoleniami. Ak nie ste správcom, požiadajte správcu o pomoc s pripojením.
Keď pripojíte pracovný priestor k službe Git, služba Fabric sa synchronizuje medzi týmito dvomi miestami, aby mali rovnaký obsah. V rámci tejto počiatočnej synchronizácie, ak je vetva pracovného priestoru alebo Git prázdna, zatiaľ čo druhá časť obsahuje obsah, obsah sa skopíruje z umiestnenia nonempty do prázdneho. Ak vetva pracovného priestoru aj Git obsahujú obsah, musíte sa rozhodnúť, ktorým smerom by mala prejsť synchronizácia.
- Ak potvrdíte svoj pracovný priestor vetve Git, všetok podporovaný obsah pracovného priestoru sa exportuje do Git a prepíše aktuálny obsah Git.
- Ak aktualizujete pracovný priestor obsahom Git, obsah pracovného priestoru sa prepíše a stratíte obsah pracovného priestoru. Keďže vetvu systému Git môžete vždy obnoviť do predchádzajúcej fázy, zatiaľ čo pracovný priestor nie je možné, ak vyberiete túto možnosť, zobrazí sa výzva na potvrdenie.
Ak nevyberiete, ktorý obsah sa má synchronizovať, nebudete môcť naďalej pracovať.
Pripojenie k zdieľanému pracovnému priestoru
Ak sa pokúsite pripojiť k pracovnému priestoru, ktorý je už pripojený k službe Git, môže sa zobraziť toto hlásenie:
Prejdite na kartu Kontá na pravej strane ovládacieho panela Zdroj, vyberte konto a pripojte sa k nemu.
Stav Gitu
Po pripojení pracovný priestor zobrazí stĺpec stavu Git, ktorý označuje stav synchronizácie každej položky v pracovnom priestore vo vzťahu k položkám vo vzdialenej vetve.
Každá položka má jeden z nasledujúcich stavov:
Synchronizované (položka je rovnaká vo vetve pracovného priestoru a Git)
Konflikt (položka sa zmenila v pracovnom priestore aj vetve Git)
Nepodporovaná položka
Neupustené zmeny v pracovnom priestore
Aktualizácia vyžadovaná od Git
Položka je identická na oboch miestach, ale musí sa aktualizovať na posledné potvrdenie.
Synchronizovať informácie
Po pripojení sa v dolnej časti obrazovky zobrazia nasledujúce informácie:
- Pripojená vetva
- Čas poslednej synchronizácie
- Prepojenie na posledné potvrdenie, že pracovný priestor je synchronizovaný s
Tabla ovládacieho prvku Zdroj
V hornej časti obrazovky sa nachádza ikona ovládacieho prvku Zdroj. Zobrazuje počet položiek, ktoré sa líšia vo vetve pracovného priestoru a Git. Po vykonaní zmien v pracovnom priestore alebo vetve Git sa číslo aktualizuje. Po synchronizácii pracovného priestoru s vetvou Git sa na ikone ovládacieho prvku Zdroj zobrazí 0.
Vyberte ikonu ovládacieho prvku Zdroj a otvorte ovládací panel Zdroj.
Tabla ovládacieho prvku Zdroj má na bočnej strane tri karty:
Potvrdenia a aktualizácie
Po vykonaní zmien v pracovnom priestore alebo vetve Git sa na ikone ovládacieho prvku zdroja zobrazí počet položiek, ktoré sa líšia. Výberom ikony zdrojového ovládacieho prvku otvorte ovládací panel Zdroj.
Panel Potvrdiť a aktualizácia má dve sekcie.
Zmeny zobrazujú počet položiek, ktoré sa zmenili v pracovnom priestore a je potrebné zaviazať sa použiť Git.
Aktualizácie zobrazujú počet položiek, ktoré boli upravené vo vetve Git a je potrebné ich aktualizovať do pracovného priestoru.
V každej časti sú zmenené položky uvedené s ikonou označujúcou stav:
nový
modifikovaný
Odstránené- konflikt
Tlačidlo 
Obnoviť v hornej časti panela aktualizuje zoznam zmien a aktualizácií.
Spáchať
- Položky v pracovnom priestore, ktoré sa zmenili, sú uvedené v časti Zmeny . Ak sa vyskytla viac ako jedna zmenená položka, môžete vybrať, ktoré položky sa majú potvrdiť vetve Git.
- Ak sa vo vetve Git vykonali aktualizácie, potvrdenia sú zakázané, kým pracovný priestor neaktualizujete.
Aktualizovať
- Na rozdiel od potvrdenia a vrátenia zmeny vykoná príkaz Update vždy celú vetvu a synchronizuje najnovšie potvrdenie. Nie je možné vybrať konkrétne položky, ktoré sa majú aktualizovať.
- Ak boli zmeny vykonané v pracovnom priestore a vo vetve Git na rovnakej položke, aktualizácie sa vypnú, kým sa konflikt nevyrieši.
Prečítajte si viac o tom, ako potvrdiť a aktualizovať. Prečítajte si viac o procese aktualizácie a o tom, ako riešiť konflikty.
Vetvy
Karta Vetvy ovládacieho panela Zdroj umožňuje spravovať vetvy a vykonávať súvisiace akcie vetvy. Má dve hlavné časti:
Akcie, ktoré môžete vykonať s aktuálnou vetvou:
- Vetvenie do nového pracovného priestoru (ľubovoľná rola): Vytvorí nový pracovný priestor a novú vetvu na základe posledného potvrdenia vetvy pripojenej k aktuálnemu pracovnému priestoru. Pripojí sa k novému pracovnému priestoru a novej vetve.
- Vzatie z projektu do novej vetvy (musí byť správcom pracovného priestoru): Vytvorí novú vetvu na základe posledného synchronizovaného potvrdenia v pracovnom priestore a zmení pripojenie Git v aktuálnom pracovnom priestore. Obsah pracovného priestoru sa nezmení.
- Prepnúť vetvu (musí byť správcom pracovného priestoru): Synchronizuje pracovný priestor s inou novou alebo existujúcou vetvou a prepíše všetky položky v pracovnom priestore s obsahom vybratej vetvy.
Súvisiace vetvy.
Karta Vetvy obsahuje aj zoznam súvisiacich pracovných priestorov, ktoré môžete vybrať a prepnúť na ne. Súvisiaci pracovný priestor má rovnaké vlastnosti pripojenia ako aktuálna vetva, napríklad tá istá organizácia, projekt, odkladací priestor a priečinok git.
Umožní vám to prejsť do pracovných priestorov prepojených s inými vetvami súvisiacimi s kontextom vašej aktuálnej práce bez toho, aby ste ich museli hľadať vo svojom zozname pracovných priestorov služby Fabric.
Kliknutím na položku v zozname otvorte príslušný pracovný priestor.
Ďalšie informácie nájdete v téme Obmedzenia vetvenia.
Podrobnosti obchodného vzťahu
Na karte Podrobnosti o konte sa zobrazujú podrobnosti o konte GitHub, ku ktorému je používateľ pripojený. Má dve sekcie. V hornej časti sa zobrazuje poskytovateľ Git a názov konta. V dolnej časti sa zobrazuje odkladací priestor a vetva, ku ktorým je pracovný priestor pripojený. Táto karta je momentálne k dispozícii len pre pracovné priestory pripojené k službe GitHub.
Podrobnosti o konte GitHub zahŕňajú:
Podrobnosti o konte služby Git
- Poskytovateľ
- Názov obchodného vzťahu
Odkladací priestor Git
Pobočka
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ú.
- Pracovné priestory s nainštalovanými aplikáciami šablón nie je možné pripojiť k systému Git.
- Suverénne cloudy nie sú podporované.
- 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 Enterprise
Niektoré nastavenia služby GitHub Enterprise nie sú podporované. Napríklad:
- Zoznam povolených IP adries
- Súkromné siete
- Vlastné domény
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
columnspoľ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.
- 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
- Obnovenie sémantického modelu pomocou rozšíreného rozhrania API obnovenia spôsobí po každom obnovení rozdiel Git.