Jaa

Mikä on Microsoft Fabric Git -integrointi?

Tässä artikkelissa kerrotaan kehittäjille, miten git-versionhallinta integroidaan Microsoft Fabric Application Lifecycle Management (ALM) -työkalun kanssa.

Huomautus

Jotkin Git-integroinnin kohteista ovat esikatseluvaiheessa. Lisätietoja on tuettujen kohteiden luettelossa.

Microsoft Fabricin Git-integraation avulla kehittäjät voivat integroida kehitysprosessinsa, työkalunsa ja parhaat käytäntönsä suoraan Fabric-ympäristöön. Sen avulla Fabricissa kehittyvät kehittäjät voivat

  • Varmuuskopioi ja versioi heidän työnsä
  • Palaa edellisiin vaiheisiin tarpeen mukaan
  • Yhteistyön tekeminen muiden kanssa tai yksin työskentely Git-haarojen avulla
  • Käytä tutun lähdeohjaustyökalujen ominaisuuksia Fabric-kohteiden hallintaan

Lähdeohjausobjektin integrointi on työtilatasolla. Kehittäjät voivat versioita kehittäjään kohteita työtilassa yhdessä prosessissa ja täydet näkyvyys kaikkiin kohteisiinsa. Työtilan rakenne, mukaan lukien alikansioiden , säilytetään Git-säilössä.

Katso luettelo tuetuista kohteista.

  • Lue lisää Git- ja -perusversion hallinnasta käsitteistä.

  • Lue lisää Git-integrointiprosessista.

  • Lue artikkelista paras tapa hallita Git-haaroja.

Tietosuojatiedot

Ennen kuin otat Git-integroinnin käyttöön, varmista, että tarkistat seuraavat tietosuojatiedot:

Tuetut Git-palveluntarjoajat

Seuraavia Git-palveluntarjoajia tuetaan:

Tuetut kohteet

Seuraavat kohteet tukevat tällä hetkellä Git-integrointia:

Jos työtilassa tai Git-hakemistossa on kohteita, joita ei tueta, se voidaan silti yhdistää, mutta kohteet, joita ei tueta, ohitetaan. Niitä ei tallenneta tai synkronoida, mutta niitäkään ei poisteta. Ne näkyvät lähteen hallintapaneelissa, mutta et voi sitoa tai päivittää niitä.

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ä.
  • Jos käytät työtilan käyttäjätietoja yhdessä artefaktissa ja vahvistat sen Gitille, se voidaan päivittää (takaisin Fabric-työtilaan) vain samoihin käyttäjätietoihin yhdistetyssä työtilassa. Ole varovainen, sillä se vaikuttaa myös ominaisuuksiin, kuten haaraulotteisiin.
  • Alimalleja ei tueta.
  • Maakohtaisia pilvipalveluita ei tueta.
  • Azure DevOps -tili on rekisteröitävä samalle käyttäjälle, joka käyttää Fabric-työtilaa.
  • Azure DevOpsia ei tueta, jos Ota IP-osoite käyttöön ehdollisen käyttöoikeuden käytännön vahvistus on käytössä.
  • Vuokraajan järjestelmänvalvojan on otettava cross-geo-vienti käyttöön, jos työtila ja Git-säilö ovat kahdella eri maantieteellisellä alueella.
  • Jos organisaatiosi on määrittänyt ehdollisen käyttöoikeuden, varmista, että Power BI -palvelun todennukselle määritetään samat ehdot, toimimaan odotetulla tavalla.
  • Vahvistuskoko on rajoitettu 125 Mt:iin.

GitHub Enterprise -rajoitukset

Joitakin GitHub Enterprise -versioita ja -asetuksia ei tueta. Esimerkkejä:

  • GitHub Enterprise Cloud, jossa on tietojen tallennussijainti (ghe.com)
  • GitHub Enterprise Server -palvelinta, jolla on mukautettu toimialue, ei tueta, vaikka esiintymä olisi julkisesti käytettävissä
  • Github Enterprise Server, jota isännöidään yksityisessä verkossa
  • IP-osoitteiden sallittujen luettelo

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ötiloja, joihin on asennettu mallisovelluksia, ei voi yhdistää Gitiin.
  • MyWorkspace ei voi muodostaa yhteyttä Git-palveluun.

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.
  • Kansiorakennetta säilytetään enintään 10 tasoa syvällä.
  • Raportin/tietojoukon lataamista .pbix-tiedostona palvelusta sen jälkeen, kun ne on otettu käyttöön Git-integroinnin avulla, ei suositella, koska tulokset ovat epäluotettavia. Suosittelemme lataamaan raportteja/tietojoukkoja .pbix-tiedostoina PowerBI Desktopin avulla.
  • Jos kohteen näyttönimellä on jokin näistä ominaisuuksista, Git-kansion nimeksi annetaan looginen tunnus (Guid) ja tyyppi:
  • Kun yhdistät git-kansioita sisältävän työtilan, sinun on tehtävä muutoksia Git-säilöön, jos kansiorakenne eroaa.

Hakemiston nimen rajoitukset

  • Git-säilöön yhdistävän hakemiston nimellä on seuraavat nimeämisrajoitukset:

    • Hakemiston nimi ei voi alkaa tai päättyä välilyönnillä tai välilehdellä.
    • Hakemiston nimi ei voi sisältää mitään seuraavista merkeistä: "/:<>\*?|

  • Kohdekansio (kansio, joka sisältää kohdetiedostot) ei voi sisältää mitään seuraavista merkeistä: ":<>\*?|. Jos nimeät kansion uudelleen niin, että se sisältää jonkin näistä merkeistä, Git ei voi muodostaa yhteyttä tai synkronoida sitä työtilan kanssa, ja tapahtuu virhe.

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.
  • 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.
  • Kun haarautut ulos, uusi haara luodaan ja alkuperäisen haaran asetuksia ei kopioida. Säädä mitä tahansa asetuksia tai määritelmiä varmistaaksesi, että uusi täyttää organisaatiosi käytännöt.
  • Kun haarat ulos aiemmin luotuun työtilaan:
    • Kohdetyötilan on tuettava Git-yhteyttä.
    • Käyttäjän on oltava kohdetyötilan järjestelmänvalvoja.
    • Kohdetyötilassa on oltava kapasiteettia.
    • Työtilassa ei voi olla mallisovelluksia.
  • Huomaa, että kun haarautut työtilaan, kaikki kohteet, joita ei tallenneta Gitille, voivat kadota. Suosittelemme, että vahvistat vahvistat kaikki kohteet, jotka haluat säilyttää, ennen haarautumista.

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 projektitiedosto (.pbip) ja lataa se Gitiin käyttämällä CRLF-.
  • Semanttisen mallin päivittäminen käyttämällä parannetun päivityksen ohjelmointirajapintaa aiheuttaa Git-erotuksen kunkin päivityksen jälkeen.

Liittyvä sisältö