Aloita Git-integrointi

Tässä artikkelissa esitellään seuraavat perustehtävät Microsoft Fabricin Git-integrointityökalussa:

• Yhteyden muodostaminen Git-säilöön
• Vahvista muutokset
• Päivitä Gitistä
• Katkaise yhteys Gitiin

Git-integroinnin yleiskatsaus on suositeltavaa lukea ennen aloittamista.

Edellytykset

Jotta voit integroida Gatin Microsoft Fabric -työtilaan, sinun on määritettävä seuraavat edellytykset sekä Fabricille että Gitille.

Kankaan edellytykset

Tarvitset jonkin seuraavista Git-integrointiominaisuuden käyttämiseksi:

• Power BI Premium -käyttöoikeus. Power BI Premium -käyttöoikeus tukee vain kaikkia Power BI -kohteita.
• Fabric-kapasiteetti. Kaikkien tuettujen Fabric-kohteiden käyttämiseen tarvitaan Fabric-kapasiteetti. Jos sinulla ei vielä ole sellaista, rekisteröidy ilmaiseen kokeiluversioon.

Lisäksi seuraavat vuokraajakytkimet on otettava käyttöön hallintaportaalissa:

• Käyttäjät voivat luoda Fabric-kohteita
• Käyttäjät voivat synkronoida työtilakohteet Git-säilöihinsä
• Vain GitHub-käyttäjät: käyttäjät voivat synkronoida työtilakohteita GitHub-säilöjen kanssa

Vuokraajan järjestelmänvalvoja, kapasiteetin järjestelmänvalvoja tai työtilan järjestelmänvalvoja voi ottaa nämä valitsimet käyttöön organisaatiosi asetusten mukaan.

Git-edellytykset

Git-integrointia tuetaan tällä hetkellä Azure DevOpsissa ja GitHubissa. Jotta voit käyttää Git-integrointia Fabric-työtilasi kanssa, tarvitset seuraavat joko Azure DevOpsissa tai GitHubissa:

Azure DevOps -rajoitukset

• Aktiivinen Azure-tili, joka on rekisteröity samalle käyttäjälle, joka käyttää Fabric-työtilaa. Luo ilmainen tili.
• Olemassa olevan säilön käyttöoikeus.

GitHub-rajoitukset

• Aktiivinen GitHub-tili. Luo GitHub-tili.

• Jokin seuraavista henkilökohtaisista käyttöoikeustietueista:

  • Hienorakeinen tunnus (suositus), jonka sisältö on luku- ja kirjoitusoikeus säilön käyttöoikeuksista:

    

    Jos haluat käyttää tätä tunnusta GitHub Enterprisen kanssa, noudata seuraavia ohjeita.

  • Luo GitHubin perinteinen tunnus, jossa säilön vaikutusalueet ovat käytössä:

    

Työtilan yhdistäminen Git-säilöön

Yhteyden muodostaminen Git-säilöön

Vain työtilan järjestelmänvalvoja voi yhdistää työtilan säilöön, mutta kun se on muodostettu, kuka tahansa, jolla on käyttöoikeus , voi työskennellä työtilassa. Jos et ole järjestelmänvalvoja, pyydä järjestelmänvalvojaltasi apua yhteyden muodostamisessa. Jos haluat yhdistää työtilan Azureen tai GitHub-säilöön, toimi seuraavasti:

1. Kirjaudu sisään Fabriciin ja siirry työtilaan, johon haluat muodostaa yhteyden.

2. Siirry työtilan asetuksiin

   

3. Valitse Git-integrointi.

4. Valitse Git-palvelusi. Tällä hetkellä Azure DevOpsia ja GitHubia tuetaan.

Azure DevOps Connect

Jos valitset Azure DevOpsin, valitse Yhdistä ja kirjaudu automaattisesti Sisään Azure Repos -tilille, joka on rekisteröity Fabriciin kirjautuneena Microsoft Entra -käyttäjälle.

GitHub Connect

Jos valitset GitHubin, sinun on kirjauduttava sisään GitHub-tilillesi.
Valitse Lisää tili , jos olet kirjautuessasi ensimmäistä kertaa Fabricista, tai valitse jokin luetelluista tileistä. Kun olet kirjautunut sisään, valitse Yhdistä , jotta Fabric voi käyttää GitHub-tiliäsi.

Jos yhteys muodostetaan ensimmäistä kertaa, sinun on valtuutettava GitHub-käyttäjä. Anna seuraavat tiedot:

• Näyttönimi – jokaisen GitHub-käyttäjän on oltava yksilöllinen
• Henkilökohtainen käyttöoikeustietue - perinteinen tai hienosäädetty henkilökohtainen käyttöoikeustietue
• Säilön URL-osoite (valinnainen) – Jos et anna URL-osoitetta, voit muodostaa yhteyden mihin tahansa säilöön, johon sinulla on käyttöoikeus. Jos kirjoitat URL-osoitteen, voit muodostaa yhteyden vain tähän säilöön.

Yhdistäminen työtilaan

Jos työtila on jo yhdistetty GitHubiin, noudata ohjeita yhteyden muodostamiseen jaettuun työtilaan.

Azure DevOps -haaran yhdistäminen

1. Määritä avattavasta valikosta seuraavat tiedot haarasta, johon haluat muodostaa yhteyden:

   Muistiinpano

   Voit yhdistää työtilan vain yhteen haaraan ja yhteen kansioon kerrallaan.

   • Organisaatio
   • Projekti
   • Git-säilö.
   • Haara (Valitse aiemmin luotu haara avattavan valikon avulla tai luo uusi haara valitsemalla + Uusi haara . Voit muodostaa yhteyden vain yhteen haaraan kerrallaan.)
   • Kansio (Kirjoita olemassa olevan kansion nimi tai luo uusi kansio kirjoittamalla nimi. Jos jätät kansion nimen tyhjäksi, sisältö luodaan pääkansioon. Voit muodostaa yhteyden vain yhteen kansioon kerrallaan.)

GitHub-haaran yhdistäminen

1. Määritä avattavasta valikosta seuraavat tiedot haarasta, johon haluat muodostaa yhteyden:

   Muistiinpano

   Voit yhdistää työtilan vain yhteen haaraan ja yhteen kansioon kerrallaan.

   • Säilön URL-osoite. Jos olet muodostanut yhteyden GitHubiin laajuustunnuksen avulla, URL-osoite täytetään automaattisesti ja voit muodostaa yhteyden vain kyseiseen säilöön.
   • Haara (Valitse aiemmin luotu haara avattavan valikon avulla tai luo uusi haara valitsemalla + Uusi haara . Voit muodostaa yhteyden vain yhteen haaraan kerrallaan.)
   • Kansio (Kirjoita olemassa olevan kansion nimi tai luo uusi kansio kirjoittamalla nimi. Jos jätät kansion nimen tyhjäksi, sisältö luodaan pääkansioon. Voit muodostaa yhteyden vain yhteen kansioon kerrallaan.)

Valitse Yhdistä ja synkronoi.

Jos työtila tai Git-haara on tyhjä alkuperäisen synkronoinnin aikana, sisältö kopioidaan tyhjästä sijainnista tyhjään. Jos sekä työtilassa että Git-haarassa on sisältöä, sinulta kysytään, mihin suuntaan synkronoinnin tulisi edetä. Lisätietoja tästä alkuperäisestä synkronoinnista on kohdassa Yhdistä ja synkronoi.

Kun yhteys on muodostettu, työtila näyttää tietoja lähteen ohjausobjektista, jonka avulla käyttäjä voi tarkastella yhdistettyä haaraa, haaran kunkin kohteen tilan ja viimeisen synkronoinnin ajan.

Jos haluat pitää työtilasi synkronoituna Git-haaraan, vahvista työtilassa tekemäsi muutokset Git-haaraan ja päivitä työtilasi aina, kun joku luo uusia vahvistuksia Git-haaraan.

Vahvista muutokset Gitiin

Kun olet muodostanut yhteyden Git-kansioon, muokkaa työtilaa tavalliseen tapaan. Kaikki tallentamallasi muutokset tallennetaan vain työtilaan. Kun olet valmis, voit sitoa muutokset Git-haaraan tai kumota muutokset ja palauttaa edellisen tilan. Lue lisätietoja vahvistuksista.

Lähetä Gitille

Vahvista muutoksesi Git-haaraan seuraavasti:

1. Siirry työtilaan.

2. Valitse Lähde-ohjausobjektikuvake. Tämä kuvake näyttää sitomattomien muutosten määrän.

3. Valitse Source-ohjauspaneelista Muutokset. Näkyviin tulee luettelo, jossa näkyvät kaikki muuttamasi kohteet sekä kuvake, joka ilmaisee, onko kohde uusi , muokattu , ristiriita tai poistettu .

4. Valitse vahvistuskohteet. Jos haluat valita kaikki kohteet, valitse yläruutu.

5. Lisää kommentti ruutuun. Jos et lisää kommenttia, oletusviesti lisätään automaattisesti.

6. Valitse Vahvista.

   

Kun muutokset on tehty, vahvistetut kohteet poistetaan luettelosta ja työtila osoittaa uuteen vahvistukseen, johon se on synkronoitu.

Kun vahvistus on suoritettu onnistuneesti, valittujen kohteiden tilaksi tulee Sitomaton ja Synkronoitu.

Kumoa tallennettu muutos

Kun olet tallentanut muutokset työtilaan ja päätät, että et halua sitoa näitä muutoksia Git-gitiin, voit kumota muutokset ja palauttaa kyseiset kohteet edelliseen tilaan. Jos haluat kumota tekemäsi muutokset, toimi seuraavasti:

1. Siirry työtilaan.

2. Valitse Lähde-ohjausobjektin painike. Tämä painike näyttää myös sitomattomien muutosten määrän.

3. Valitse Ohjausobjektin Lähde -paneelista Muutokset. Näkyviin tulee luettelo kaikista muuttamistasi kohteista sekä kuvake, joka ilmaisee, onko muutettu kohde uusi , muokattu , ristiriita tai poistettu .

4. Valitse kumottavat muutokset.

5. Valitse Kumoa.

   

6. Vahvista valitsemalla Kumoa uudelleen.

   

Työtilan valitut kohteet palaavat siihen, miten ne olivat, kun työtila synkronoitiin viimeksi.

Tärkeä

Jos poistat kohteen ja sitten kumoat muutokset, kohde luodaan uudelleen ja osa metatiedoista voi kadota. Esimerkiksi luottamuksellisuustunnisteita ei säilytetä ja ne tulee nollata, ja kohteen omistajaksi määritetään nykyinen käyttäjä.

Päivitä työtila Gitistä

Aina, kun joku tekee uuden muutoksen yhdistettyyn Git-haaraan, kyseiseen työtilaan tulee ilmoitus. Hae uusimmat muutokset, yhdistä tai palauta tiedot työtilaan ja päivitä reaaliaikaiset kohteet Lähde-ohjauspaneelin avulla. Lue lisää päivittämisestä.

Jos haluat päivittää työtilan, toimi seuraavasti:

1. Siirry työtilaan.
2. Valitse Lähde-ohjausobjektikuvake.
3. Valitse Source-ohjauspaneelista Päivitykset . Esiin tulee luettelo kaikista kohteista, joita on muutettu haarassa viimeisimmän päivityksen jälkeen.
4. Valitse Päivitä kaikki.

Kun päivitys on onnistunut, kohdeluettelo poistetaan ja työtila osoittaa uuteen vahvistukseen, johon se on synkronoitu.

Kun päivitys on valmis, kohteiden tilaksi muuttuu Synkronoitu.

Työtilan katkaiseminen Gitistä

Vain työtilan järjestelmänvalvoja voi katkaista työtilan yhteyden Git-säilöön. Jos et ole järjestelmänvalvoja, pyydä järjestelmänvalvojalta apua yhteyden katkaisemiseen. Jos olet järjestelmänvalvoja ja haluat katkaista säilön yhteyden, toimi seuraavasti:

1. Siirry työtilan asetuksiin
2. Valitse Git-integrointi
3. Valitse Katkaise työtila
4. Vahvista valitsemalla Katkaise yhteys uudelleen.

Oikeudet

Toiminnot, jotka voit ottaa käyttöön työtilassa, riippuvat käyttöoikeuksista, joita sinulla on sekä työtilassa että Git-säilössä. Tarkempia tietoja käyttöoikeuksista on artikkelissa Käyttöoikeudet.

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 -rajoitukset

• 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-rajoitukset

• GitHub ei voi pakottaa geovälisia vahvistuksia.
• Kerralla tehtäväjen tiedostojen yhteenlaskettu koko on rajoitettu 50 megatavuun. Jos siis vahvistat useita kohteita, saatat joskus joutua erottamaan ne muutamiin erillisiin vahvistuksiin. Lisätietoja tiedostojen vahvistamisesta on vianmääritysoppaassa.

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.
• Semanttisen mallin päivittäminen käyttämällä parannetun päivityksen ohjelmointirajapintaa aiheuttaa Git-erotuksen kunkin päivityksen jälkeen.

Liittyvä sisältö

• Tutustu Git-integrointiprosessiin
• Git-haarojen hallinta
• Git-integroinnin parhaat käytännöt