Peruskäsitteet Git-integroinnissa
Tässä artikkelissa kerrotaan Git-peruskäsitteistä ja Gatin integrointiprosessista Microsoft Fabric -työtilan kanssa.
Oikeudet
- Jotta voit käyttää Git-integrointia, organisaatiosi järjestelmänvalvojan on otettava se käyttöön.
- Jos työtila ja Azure-säilö ovat kahdella eri alueella, vuokraajan järjestelmänvalvojan on otettava käyttöön Maantieteellinen vienti. Tämä rajoitus ei koske GitHubia.
- Toiminnot, jotka voit ottaa käyttöön työtilassa, määräytyvät sen mukaan, mitä käyttöoikeuksia sinulla on sekä työtilassa että Gitissä seuraavissa osioissa kuvatulla tavalla.
Git-oikeudet pakollisia suosittuja toimintoja varten
Seuraavassa luettelossa näytetään, mitä eri työtilaroolit voivat tehdä git-säilön käyttöoikeuksista riippuen:
- Järjestelmänvalvoja: Voi suorittaa minkä tahansa toiminnon työtilassa, vain hänen Git-roolinsa rajoittaa.
- Jäsen/osallistuja: Kun jäsen tai osallistuja on muodostanut yhteyden työtilaan, hän voi ottaa muutokset käyttöön ja päivittää niitä Git-roolinsa mukaan. Jos toiminto liittyy työtilayhteyteen (esimerkiksi yhdistä, katkaise yhteys tai vaihda haaraa), pyydä apua järjestelmänvalvojalta.
- Katselija: Mitään toimintoja ei voi suorittaa. Katselija ei näe Gitiin liittyviä tietoja työtilassa.
Pakolliset Fabric-käyttöoikeudet suosituille toiminnoille
Työtilaroolit
Seuraavassa taulukossa kuvataan Fabric-työtilassa tarvittavat käyttöoikeudet erilaisten yleisten toimintojen suorittamiseen:
| Toiminto | Työtilan rooli |
|---|---|
| Yhdistä työtila Git-säilöön | Järjestelmänvalvoja |
| Synkronoi työtila Git-säilön kanssa | Järjestelmänvalvoja |
| Katkaise työtila Git-säilöstä | Järjestelmänvalvoja |
| Vaihda työtilan haaraa (tai mitä tahansa yhteyden asetuksen muutosta) | Järjestelmänvalvoja |
| Git-yhteyden tietojen tarkasteleminen | Järjestelmänvalvoja, jäsen, osallistuja |
| Katso työtilan Git-tila | Järjestelmänvalvoja, jäsen, osallistuja |
| Päivitä Gitistä | Kaikki seuraavat: Työtilan osallistuja (kaikkien kohteiden KIRJOITUS-käyttöoikeus) Kohteen omistaja (jos vuokraajan valitsin estää muut kuin omistajat) KOONTIVERSIO ulkoisista riippuvuuksista (tarvittaessa) |
| Vahvista työtilan muutokset Git-tiedostoon | Kaikki seuraavat: Työtilan osallistuja (kaikkien kohteiden KIRJOITUS-käyttöoikeus) Kohteen omistaja (jos vuokraajan valitsin estää muut kuin omistajat) KOONTIVERSIO ulkoisista riippuvuuksista (tarvittaessa) |
| Uuden Git-haaran luominen Fabricista | Järjestelmänvalvoja |
| Haara ulos uuteen työtilaan | Järjestelmänvalvoja, jäsen, osallistuja |
Git-roolit
Seuraavassa taulukossa kuvataan Git-käyttöoikeudet, joita tarvitaan erilaisten yleisten toimintojen suorittamiseen:
| Toiminto | Git-käyttöoikeudet |
|---|---|
| Yhdistä työtila Git-säilöön | Luku=Salli |
| Synkronoi työtila Git-säilön kanssa | Luku=Salli |
| Katkaise työtila Git-säilöstä | Käyttöoikeuksia ei tarvita |
| Vaihda työtilan haaraa (tai mitä tahansa yhteyden asetuksen muutosta) | Read=Allow (kohdesijainnissa, hakemistossa tai haarassa) |
| Git-yhteyden tietojen tarkasteleminen | Luku tai Ei mitään |
| Katso työtilan Git-tila | Luku=Salli |
| Päivitä Gitistä | Luku=Salli |
| Vahvista työtilan muutokset Git-tiedostoon | Luku=Salli Osallistuja = Salli haarakäytännön tulee sallia suora vahvistus |
| Uuden Git-haaran luominen Fabricista | Rooli = Kirjoittaminen Luo haara = Salli |
| Haara ulos uuteen työtilaan | Luku=Salli Luo haara = Salli |
Yhdistäminen ja synkronointi
Vain työtilan järjestelmänvalvoja voi yhdistää työtilan Git-säilöihin, mutta kun se on muodostettu, kuka tahansa, jolla on käyttöoikeudet, voi työskennellä työtilassa. Jos et ole järjestelmänvalvoja, pyydä järjestelmänvalvojaltasi apua yhteyden muodostamisessa.
Kun yhdistät työtilan Gitiin, Fabric synkronoi näiden kahden sijainnin välillä, jotta niissä on sama sisältö. Jos työtila tai Git-haara on tyhjä tämän ensimmäisen synkronoinnin aikana, kun toisella on sisältöä, sisältö kopioidaan tyhjästä sijainnista tyhjään. Jos sekä työtilassa että Git-haarassa on sisältöä, sinun on päätettävä, mihin suuntaan synkronoinnin tulisi edetä.
- Jos vahvistat työtilasi Git-haaraan, kaikki tuettu työtilan sisältö viedään Gitiin, ja se korvaa nykyisen Git-sisällön.
- Jos päivität työtilaan Git-sisältöä, työtilan sisältö korvataan ja menetät työtilan sisällön. Koska Git-haara voidaan aina palauttaa edelliseen vaiheeseen niin aikaa kuin työtila ei voi, sinua pyydetään vahvistamaan se, jos valitset tämän vaihtoehdon.
Jos et valitse synkronoitettavaa sisältöä, et voi jatkaa toimintaasi.
Jaettuun työtilaan yhdistäminen
Jos yrität muodostaa yhteyden työtilaan, joka on jo yhdistetty Gitiin, saatat saada seuraavan sanoman:
Siirry Tilit-välilehteen Lähde-ohjauspaneelin oikeassa reunassa, valitse tili ja muodosta siihen yhteys.
Gatin tila
Kun yhteys on muodostettu, työtilassa näkyy Git-tilasarake , joka ilmaisee kunkin työtilan kohteen synkronointitilan verrattuna etähaaran kohteisiin.
Kullakin tietoyksiköllä on jokin seuraavista tiluksista:
Synkronoitu (kohde on sama työtilassa ja Git-haarassa)
Ristiriita (kohdetta muutettiin sekä työtilassa että Git-haarassa)
Kohde, jota ei tueta
Työtilan sitomattomien muutosten
Päivitä vaaditaan Gitiltä
Kohde on molemmissa paikoissa samanlainen, mutta se on päivitettävä viimeiseen vahvistukseen
Synkronoi tiedot
Niin kauan kuin olet muodostanut yhteyden, näytön alareunaan tulee näkyviin seuraavat tiedot:
- Yhdistetty haara
- Viimeisimmän synkronoinnin aika
- Linkki viimeiseen vahvistukseen, johon työtila on synkronoitu
Lähteen hallintaruutu
Näytön yläreunassa on Lähde-ohjausobjektin kuvake. Se näyttää niiden kohteiden määrän, jotka ovat erilaiset työtilassa ja Git-haarassa. Kun muutoksia tehdään joko työtilaan tai Git-haaraan, numero päivitetään. Kun työtila on synkronoitu Git-haaran kanssa, Lähde-ohjausobjektin kuvake näyttää arvon 0.
Avaa Lähde-ohjauspaneeli valitsemalla Lähde-ohjausobjektin kuvake.
Lähteen hallintaruudun reunassa on kolme välilehteä:
Vahvistukset ja päivitykset
Kun muutoksia tehdään joko työtilaan tai Git-haaraan, lähteen ohjausobjektin kuvakkeessa näkyy eri kohteiden määrä. Avaa Lähde-ohjauspaneeli valitsemalla lähteen ohjausobjektin kuvake.
Vahvista ja päivitä -paneelissa on kaksi osaa.
Muutokset näyttävät niiden kohteiden määrän, jotka on muutettu työtilassa ja jotka on sidottava Gitille.
Päivitykset näyttävät Git-haarassa muokattujen kohteiden määrän, ja ne on päivitettävä työtilaan.
Jokaisessa osassa näkyvät muutetut kohteet sekä kuvake, joka ilmaisee tilan:
uusi
muunnettu
Poistaa- ristiriita
Paneelin yläosassa oleva Päivitä-painike 
päivittää muutosten ja päivitysten luettelon.
Tehdä
- Muutetut työtilan kohteet luetellaan Muutokset-osassa. Kun on useampi kuin yksi muutettu kohde, voit valita, mitkä kohteet vahvistataan Git-haaraan.
- Jos Git-haaraan on tehty päivityksiä, vahvistukset ovat poissa käytöstä, kunnes päivität työtilasi.
Päivitä
- Toisin kuin vahvistus ja kumoaminen, Päivitä-komento päivittää aina koko haaran ja synkronoi sen uusimpaan vahvistukseen. Et voi valita tiettyjä päivitettavia kohteita.
- Jos työtilaan ja saman kohteen Git-haaraan on tehty muutoksia, päivitykset poistetaan käytöstä, kunnes ristiriita on ratkaistu.
Lue lisää vahvistuksista ja päivittämisestä. Lue lisää päivitysprosessista ja ristiriitojen ratkaisemisesta.
Haarat
Lähde-ohjauspaneelin Haarat-välilehden avulla voit hallita haarojasi ja suorittaa haaraan liittyviä toimintoja. Siinä on kaksi pääosaa:
Toiminnot, jotka voit suorittaa nykyiseen haaraan:
- Haara ulos uuteen työtilaan (mikä tahansa rooli): Luo uuden työtilan ja uuden haaran sen perusteella, mikä on nykyiseen työtilaan yhdistetyn haaran viimeinen vahvistus. Se muodostaa yhteyden uuteen työtilaan ja uuteen haaraan.
- Kuittaa ulos uusi haara (täytyy olla työtilan järjestelmänvalvoja): Luo uuden haaran työtilan viimeisimmän synkronoitun vahvistustoiminnon perusteella ja muuttaa Git-yhteyttä nykyisessä työtilassa. Se ei muuta työtilan sisältöä.
- Vaihda haaraa (oltava työtilan järjestelmänvalvoja): Synkronoi työtilan toisen uuden tai olemassa olevan haaran kanssa ja ohittaa kaikki työtilan kohteet valitun haaran sisällöllä.
Liittyvät haarat.
Haarat-välilehdessä on myös luettelo liittyvistä työtiloista, jotka voit valita ja vaihtaa. Liittyvä työtila on työtila, jolla on samat yhteyden ominaisuudet kuin nykyisellä haaralla, kuten sama organisaatio, projekti, säilö ja Git-kansio.
Näin voit siirtyä työtiloihin, jotka on yhdistetty muihin haaroihin, jotka liittyvät nykyisen työsi kontekstiin, ilman, että sinun tarvitsee etsiä niitä Fabric-työtilojen luettelostasi.
Avaa asianmukainen työtila napsauttamalla luettelon kohdetta.
Lisätietoja on artikkelissa Haarauksen rajoitukset .
Tilin tiedot
Tilitiedot-välilehdessä näkyvät tiedot GitHub-tilistä, johon käyttäjä on yhdistetty. Siinä on kaksi osaa. Yläosassa näytetään Git-palvelu ja tilin nimi. Alaosassa näkyy säilö ja haara, johon työtila on yhdistetty. Tällä hetkellä tämä välilehti on käytettävissä vain GitHubiin yhdistetyissä työtiloissa.
GitHub-tilitiedoissa ovat seuraavat tiedot:
Git-tilin tiedot
- Palvelu
- Asiakkaan nimi
Git-säilö
Branch
Huomioitavat asiat ja rajoitukset
Git-integroinnin yleiset rajoitukset
- Fabric-todennusmenetelmän on oltava vähintään yhtä vahva kuin Gitin todennusmenetelmän. Jos Git esimerkiksi edellyttää monimenetelmäistä todentamista, Fabricin on myös edellytettävä monimenetelmäistä todentamista.
- Analysis Servicesiin yhdistettyjä Power BI -tietojoukkoja ei tueta tällä hetkellä.
- Työtiloja, joihin on asennettu mallisovelluksia, ei voi yhdistää Gitiin.
- Maakohtaisia pilvipalveluita ei tueta.
- Azure DevOps -tili on rekisteröitävä samalle käyttäjälle, joka käyttää Fabric-työtilaa.
- Vuokraajan järjestelmänvalvojan on otettava cross-geo-vienti käyttöön, jos työtila ja Git-säilö ovat kahdella eri maantieteellisellä alueella.
- Vahvistuskoko on rajoitettu 125 Mt:iin.
GitHub Enterprise -rajoitukset
Joitakin GitHub Enterprise -asetuksia ei tueta. Esimerkkejä:
- IP-osoitteiden sallittujen luettelo
- Yksityiset verkkopalvelut
- Mukautetut toimialueet
Työtilan rajoitukset
- Vain työtilan järjestelmänvalvoja voi hallita yhteyksiä Git-säilöön, kuten yhteyden muodostamista, katkaisua tai haaran lisäämistä.
Kun yhteys on muodostettu, kuka tahansa, jolla on käyttöoikeus , voi työskennellä työtilassa. - Työtilan kansiorakenne ei näy Git-säilössä. Kansioissa olevat työtilan kohteet viedään päähakemistoon.
Haara- ja kansiorajoitukset
- Haaran nimen enimmäispituus on 244 merkkiä.
- Tiedostonimien koko polun enimmäispituus on 250 merkkiä. Pidemmät nimet epäonnistuvat.
- Tiedoston enimmäiskoko on 25 Mt.
- Et voi ladata raporttia/tietojoukkoa .pbix-tiedostona palvelusta, kun ne on otettu käyttöön Git-integroinnin avulla.
- Kun nimeät kansion Gitissä, looginen tunnus (GUID) lisätään etuliitteenä tyypin eteen, jos kohteen näyttönimi:
- Sisältää yli 256 merkkiä
- Päättyy :n tai välilyönnin kanssa
- Sisältää jonkin seuraavista merkeistä: " / : ? < > \ * |
Haarauksen rajoitukset
- Haara ulos edellyttää käyttöoikeudet, jotka on lueteltu käyttöoikeustaulukossa.
- Tälle toiminnolle on oltava käytettävissä kapasiteetti.
- Kaikki työtilan ja haaran nimeämisen rajoitukset ovat voimassa, kun haaraat uuteen työtilaan.
- Kun haarautut ulos, uusi työtila luodaan ja alkuperäisen työtilan asetuksia ei kopioida. Säädä asetuksia tai määritelmiä varmistaaksesi, että uusi työtila täyttää organisaatiosi käytännöt.
- Vain Gitin tukemat kohteet ovat käytettävissä uudessa työtilassa.
- Aiheeseen liittyvien haarojen luettelossa näkyvät vain haarat ja työtilat, joita sinulla on oikeus tarkastella.
- Git-integrointi on otettava käyttöön.
Synkronointi- ja vahvistusrajoitukset
- Voit synkronoida vain yhteen suuntaan kerrallaan. Et voi vahvistusta ja päivitystä samanaikaisesti.
- Luottamuksellisuustunnisteita ei tueta, ja luottamuksellisuustunnisteilla varustettujen kohteiden vienti voi olla poistettu käytöstä. Jos haluat sitoa kohteet, joilla on luottamuksellisuustunnisteet ilman luottamuksellisuustunnistetta, pyydä apua järjestelmänvalvojalta .
- Toimii rajoitettujen kohteiden kanssa. Kansiossa olevat kohteet, joita ei tueta, ohitetaan.
- Nimien monistamista ei sallita. Vaikka Power BI sallisi nimien monistamisen, päivitys-, vahvistus- tai kumoamistoiminto epäonnistuu.
- B2B:tä ei tueta.
- Ristiriitojen ratkaisu tehdään osittain Gitissä.
- Vahvista Gitiin -prosessin aikana Fabric-palvelu poistaa tiedostot kohdekansiosta, jotka eivät ole osa kohteen määritystä. Toisiinsa liittymättömiä tiedostoja, jotka eivät ole kohdekansiossa, ei poisteta.
- Kun olet vahvistanut muutokset, saatat huomata odottamattomia muutoksia kohteeseen, jota et ole tehnyt. Nämä muutokset ovat semanttisesti merkityksettömiä, ja ne voivat tapahtua useista syistä. Esimerkki:
- Kohteen määritystiedoston manuaalinen muuttaminen. Nämä muutokset ovat kelvollisia, mutta ne saattavat poiketa muokkaajien kautta tehtävissä muutoksissa. Jos esimerkiksi nimeät semanttisen mallin sarakkeen uudelleen Gitissä ja tuot tämän muutoksen työtilaan, seuraavan kerran vahvistat muutokset semanttiseen malliin, bim-tiedosto rekisteröidään muutettuna ja muokattu sarake työnnetään matriisin takaosaan
columns. Tämä johtuu siitä, että bim-tiedostoja muodostanut AS-moduuli siirtää uudelleennimettyjä sarakkeita matriisin loppuun. Tämä muutos ei vaikuta kohteen toimintaan. - Vahvistat tiedoston, joka käyttää CRLF-rivinvaihtoja . Palvelu käyttää LF (rivinsyötön) rivinvaihtoja. Jos sinulla oli git-säilössä kohdetiedostoja, joissa on CRLF-rivinvaihtoja, kun vahvistat palvelusta, nämä tiedostot muutetaan LF:ksi. Jos esimerkiksi avaat raportin työpöydällä, tallenna .pbip-projekti ja lataa se Gitille CRLF:n avulla.
- Kohteen määritystiedoston manuaalinen muuttaminen. Nämä muutokset ovat kelvollisia, mutta ne saattavat poiketa muokkaajien kautta tehtävissä muutoksissa. Jos esimerkiksi nimeät semanttisen mallin sarakkeen uudelleen Gitissä ja tuot tämän muutoksen työtilaan, seuraavan kerran vahvistat muutokset semanttiseen malliin, bim-tiedosto rekisteröidään muutettuna ja muokattu sarake työnnetään matriisin takaosaan
- Semanttisen mallin päivittäminen käyttämällä parannetun päivityksen ohjelmointirajapintaa aiheuttaa Git-erotuksen kunkin päivityksen jälkeen.