Jaa

Git-integroinnin lähdekoodin muoto

  • Artikkeli

Microsoft Fabric -kohteet tallennetaan -kansioon. Kohteen sisältävä kansio voi olla joko päähakemistossa tai alihakemistossa. Kun yhdistät työtilan Gitiin, muodosta yhteys kohteita sisältävään kansioon. Jokainen kansiossa oleva kohde on edustettuna omassa alihakemistossaan.

Hakemiston nimi

Kun tallennat uuden kohteen Gitissä, Git-integrointi luo automaattisesti hakemiston kyseiselle kohteelle.

Kohdehakemiston nimi perustuu seuraaviin sääntöihin:

  • Nimen malli on {display name}.{public facing type}.
  • Näyttönimeen tehdään tarvittaessa seuraavat muutokset:
    • Virheelliset merkit korvataan HTML-numerolla.
    • Edeltävä välilyönti korvataan sen HTML-numerolla.
    • Lopussa oleva välilyönti tai piste korvataan sen HTML-numerolla.
  • Jos tämä kansion nimi ei ole käytettävissä, käytetään kohteen loogisen tunnuksen (GUID) nimeä näyttönimen sijaan.

Jos sinulla on esimerkiksi seuraavat kohteet työtilassa (huomaa, että ensimmäisellä ja kolmannella kohteella on näkymätön edeltävä ja lopussa oleva tila):

Näyttökuva Fabric-työtilan kohdeluettelosta.

Git-säilöön luodaan seuraavat hakemistot:

Näyttökuva Fabric-kohteita sisältävien Git-hakemistojen nimistä.

  • Kun Git-integrointi on luotu, se ei koskaan muuta hakemiston nimeä. Vaikka muuttaisit kohteen nimeä, hakemiston nimi pysyy samana.
  • Jos muutat manuaalisesti kohdehakemiston nimeä, muista ottaa kohteen riippuvuudet huomioon. Jos esimerkiksi muutat semanttisen mallin hakemistoa, muista päivittää semanttisen mallin polku raportin riippuvuustiedostossa. Muista, että riippuvuussijainnit vaihtelevat Fabric-käyttökokemuksen välillä. Hakemiston nimen muuttaminen ei aiheuta saapuvaa muutosta työtilaan.

Hakemiston sisältö

Jokainen kohdehakemisto sisältää kohteen määritystiedostot ja automaattisesti luodut järjestelmätiedostot.

Kohteen määritystiedostot

Kunkin kohteen hakemistossa on tiettyjä pakollisia tiedostoja, jotka määrittävät kyseisen kohteen.

Microsoft Fabric tukee tällä hetkellä seuraavia kohteita:

Muistikirjatiedostot

Muistikirjakansiot sisältävät .py tiedoston:

Ohjeet Git-integroinnin käyttämiseen muistikirjojen kanssa löytyvät kohdasta Muistikirjan lähteen hallinta ja käyttöönotto.

Sivutetut raporttitiedostot

Sivutetut raporttikansiot sisältävät .rdl-tiedoston , joka määrittää sivutetun raportin. RDL (Report Definition Language) on sivutetun raportin määrityksen XML-esitys.

Jos haluat lisätietoja, o RDL, katso Report Definition Language (RDL) . Ohjeet Git-integroinnin käyttämiseen sivutettujen raporttien kanssa annetaan artikkelissa Sivutettujen raporttien Git-integrointi.

Raporttitiedostot

Raporttikansiot sisältävät seuraavat tiedostot:

  • definition.pbir
  • report.json

Saat lisätietoja raporttikansioista ja niiden koko sisältöluettelosta Power BI Desktopin projektiraporttikansiosta.

Semanttiset mallitiedostot

Semanttiset mallikansiot sisältävät seuraavat tiedostot:

  • definition.pbidataset
  • model.bim-tiedosto (TMSL-muoto) OR \definition folder (TMDL-muoto)

Lisätietoja semanttisen mallin kansioista ja niiden koko sisältöluettelosta on Power BI Desktop -projektin semanttisen mallin kansiossa.

Automaattisesti luodut järjestelmätiedostot

Kohdemääritystiedostojen lisäksi kukin kohdehakemisto sisältää yhden tai kaksi automaattisesti luotua järjestelmätiedostoa käyttämästäsi versiosta riippuen:

  • Versio 1 -hakemisto sisältää item.metadata.json ja item.config.json. V1:ssä molempien tiedostojen on oltava -hakemistossa.
  • Versio 2 -hakemisto sisältää .platformin. Tämä tiedosto sisältää sekä item.metadata.json- että item.config.json tiedostojen sisällön. Jos sinulla on tämä tiedosto, sinulla ei voi olla kahta muuta tiedostoa. Jos käytössäsi on versio 1 ja vahvistat muutokset, järjestelmätiedostosi päivitetään automaattisesti tähän versioon.

Huomautus

Hakemiston on sisällettävä joko - ja item.config.json -item.metadata.jsontiedostot tai -.platformtiedosto. Sinulla ei voi olla kaikkia kolmea tiedostoa.

Käyttöympäristötiedosto

Versiossa 2 .platform-tiedosto yhdistää kaikki tiedot yhdeksi tiedostoksi yhdessä $schema-ominaisuuden kanssa sen sijaan, että jokaisessa kohdehakemistossa olisi kaksi lähdetiedostoa. Jos sinulla on tämä tiedosto, sinulla ei voi olla kahta muuta tiedostoa.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

Tiedosto .platform sisältää seuraavat määritteet:

  • version: Järjestelmätiedostojen versionumero. Tätä lukua käytetään yhteensopivuuden mahdollistamiseen taaksepäin. Kohteen versionumero voi olla erilainen.
  • logicalId: Automaattisesti luotu työtilojen välinen tunniste, joka edustaa kohdetta ja sen lähteen hallinnan esitystä.
  • type: (merkkijono) Kohteen tyyppi (semanttinen malli, raportti jne.)
  • displayName: (merkkijono) Kohteen nimi.
  • description: (valinnainen merkkijono) Kohteen kuvaus.

Huomautus

  • Tyypin kentässä kirjainkoko on merkitsevä. Älä muuta tapaa, jolla se luodaan automaattisesti tai se voi epäonnistua.
  • Vaikka sinun ei yleensä pitäisi muuttaa kohteen logicalId - tai näyttönimeä , yksi poikkeus voi olla, jos luot uuden kohteen kopioimalla olemassa olevan kohdehakemiston. Tässä tapauksessa sinun on muutettava looginen tunnus ja näyttönimi niin, että se on jotain yksilöivää säilössä.

Liittyvä sisältö

Aloita Git-integrointi.