Git-integroinnin lähdekoodin muoto

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 kohteen Gitissä, Git-integrointi luo automaattisesti hakemiston kyseiselle kohteelle.

Kohdehakemiston <item name>.<item type> nimeä seuraa kohdetyyppi. Jos tämä nimi ei ole käytettävissä, kohteen loogisen tunnuksen (GUID) nimeä seuraa kohdetyyppi.

• 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 kuormitustyyppien välillä.

Hakemiston sisältö

Jokainen kohdehakemisto sisältää kohteen määritystiedostot ja joko yhden tai kaksi automaattisesti luotua järjestelmätiedostoa.

Kohteen määritystiedostot

Kunkin kohteen hakemisto sisältää tiettyjä pakollisia tiedostoja, jotka määrittävät kyseisen kohteen.

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

• Notebook
• Sivutettu raportti
• Raportti
• Semanttinen malli

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.

Muistiinpano

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

Versio 2

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.

Versio 1

Jos käytössäsi on versio 1, kullakin kohdehakemistolla on kaksi tiedostoa:

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

Metatietotiedosto

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

item.metadata.json-tiedosto sisältää seuraavat määritteet:

• type: (merkkijono) Kohteen tyyppi (semanttinen malli, raportti jne.)
• displayName: (merkkijono) Kohteen nimi
• description: (valinnainen merkkijono) Kohteen kuvaus

Jos haluat nimetä kohteen uudelleen, muuta item.metadata.json displayName -tiedostossa. Kansion nimen muuttaminen ei muuta työtilassa olevan kohteen näyttönimeä.

Määritystiedosto

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

Tiedosto item.config.json 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ä.

LogicalId-tunnus yhdistää työtilan kohteen sitä vastaavaan kohteeseen Git-haarassa. Kohteiden, joilla on samat logicalId-tunnuksen, oletetaan olevan samat. LogicalId säilyttää linkin, vaikka nimi tai hakemisto muuttuisi. Koska haara voidaan synkronoida useisiin työtiloihin, eri työtiloissa on mahdollista olla kohteita, joilla on sama looginen tunnus, mutta yksittäisessä työtilassa ei voi olla kahta kohdetta, joilla on sama looginen tunnus. LogicalId luodaan, kun työtila on yhdistetty Git-haaraan tai uusi kohde synkronoidaan. LogicalId on välttämätön, jotta Git-integrointi toimisi oikein. Siksi on tärkeää, ettei sitä muuteta millään tavalla.

Muistiinpano

Kun vahvistat Muutokset Git-versioon versiossa 1, järjestelmätiedostot päivitetään automaattisesti versioon 2 muutosten ohella. Lisäksi Power BI Desktopin kehittäjätilasta viedyt uudet tiedostot tallennetaan versio 2 -tiedostomuodossa.

Muistiinpano

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