Power BI Desktop -projektit (ESIKATSELU)

2025-06-13

Tärkeä

Power BI Desktop -projektit ovat tällä hetkellä esikatseluvaiheessa.

Vihje

Saat lisätietoja Power BI -kehityksen suunnittelusta ohjeartikkelista Power BI:n käyttöönoton suunnittelu.

Power BI Desktop esittelee uuden tavan luoda, tehdä yhteistyötä ja tallentaa projekteja. Kun tallennat työsi Power BI -projektina (PBIP), raportin ja semanttisen mallin kohdemääritykset tallennetaan yksittäisinä vain teksti -tiedostoina yksinkertaisessa, intuitiivisessa kansiorakenteessa.

Työn tallentamisessa projektina on seuraavia etuja:

Tekstieditorin tuki – PBIP-tiedostot ovat semanttista mallia ja raportin metatietoja sisältäviä muotoiltuja tekstitiedostoja. Nämä tiedostot on dokumentoitu julkisesti ja ne ovat ihmisen luettavissa. Vaikka projektitiedostot tukevat yksinkertaisia tekstinmuokkaustyökaluja, kuten Notepadia, on parempi käyttää koodieditoria, kuten Visual Studio Codea (VS Code), joka tarjoaa monipuolisen muokkauskokemuksen, kuten intellisensen, vahvistuksen ja Git-integroinnin.
Kansiorakenteen läpinäkyvyys : erota semanttisen mallin ja raportin kansiot. Ne mahdollistavat tehokkaita mutta yksinkertaisia tehtäviä, kuten semanttisten mallitaulukoiden kopioimisen projektien välillä tai raporttisivujen uudelleenkäyttöä. Hyvä valinta kehitysmallien luomiseen ja uudelleenkäyttämiseen.
Lähdehallinta valmiina : avaa tekstitiedostoja, jotka on suunniteltu integroimaan saumattomasti Git-palvelussa ja mahdollistamaan versiohistoria ja tiimiyhteistyö. Saat lisätietoja ohjeartikkelista Versionhallinta Gitissä.
Jatkuvan integraation ja jatkuvan toimituksen (CI/CD) tuki : sovella CI/CD-käytäntöjä olemassa olevien lähdeohjausjärjestelmiesi päälle käyttämällä PBIP-tiedostoja, sisällyttämällä laatuportteja ja automatisoimalla käyttöönotto tuotantoympäristöihin. Lisätietoja CI/CD:stä On artikkelissa Fabric CI/CD -työnkulut.
Ohjelmallinen luominen ja kohteiden määritelmien muokkaus – Voit luoda ja muokata kohteen määrityksen tekstitiedostoja ohjelmallisesti ottamalla käyttöön eri toimintoja, kuten päivittämällä kaikkien raporttisivujen visualisointeja tai lisäämällä mittareita kuhunkin taulukkoon. Semanttisten mallien kohdalla voit käyttää Taulukkomuotoinen objektimalli (TOM) - asiakaskirjastoa semanttisen mallin metatietojen sarjoittamiseen, ohjelmallisten muutosten tekemiseen ja sarjoittamiseen takaisin tiedostoihin.

Esiversiotoimintojen käyttöönotto

Power BI -projektina tallentaminen Power BI Desktopissa on tällä hetkellä esikatseluvaiheessa, ja se on otettava käyttöön esikatselutoiminnoissa.

Valitse >> ja valitse Power BI Projectin (.pbip) tallennusvaihtoehdon>valintaruutu.

Tallenna projektina

Jos olet tekemässä uutta projektia tai avasit aiemmin luodun Power BI Desktop -tiedoston (pbix), voit tallentaa työsi Power BI -projektitiedostona (pbip):

Näyttökuva, joka näyttää tallenna tiedosto Power BI -projektina

Kun tallennat projektina, Power BI Desktop tallentaa raportti- ja semanttiset mallikohteet kansioiksi, joista jokainen sisältää kohteen määrittäviä tekstitiedostoja:

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

Tutustutaan tarkemmin siihen, mitä näet projektisi pääkansiossa:

<projektin nimi>. SemanticModel

Semanttista Power BI -mallia edustavien tiedostojen ja kansioiden kokoelma. Lisätietoja täällä olevia tiedostoja, alikansioita ja tiedostoja on Project Semantic Model -kansiossa.

<projektin nimi>. Raportti

Kokoelma tiedostoja ja kansioita, jotka edustavat Power BI -raporttia. Lisätietoja täällä olevia tiedostoja, alikansioita ja tiedostoja on Projektiraportti-kansiossa.

.gitIgnore

Määrittää tarkoituksella ei-seuratut tiedostot, jotka Git tulee ohittaa Power BI -projektitiedostoissa, kuten cache.abf ja localSettings.json.

Power BI Desktop luo .gitignore-tiedoston vain, jos sitä ei vielä ole valitussa tallennuskansiossa tai git-pääsäilössä.

.gitignore-oletussisältö, kun tallennetaan PBIP-tiedostona:

**/.pbi/localSettings.json
**/.pbi/cache.abf

<projektin nimi.pbip>

PBIP-tiedosto sisältää osoittimen raporttikansioon. PBIP:n avaaminen avaa kohdennetun raportin ja mallin luomista varten.

Lisätietoja on pbip-rakenneasiakirjassa.

Avaa Power BI -projekti

Voit avata Power BI Desktopin Power BI -projektikansiosta joko avaamalla pbip-tiedoston tai pbir-tiedoston raporttikansiossa. Molemmat asetukset avaavat raportin muokkaamista ja semanttista mallia varten, jos semanttiseen malliin viitataan suhteellisesti.

Voit tallentaa useita raportteja ja semanttisia malleja samaan kansioon. Erillistä pbip-tiedostoa kullekin raportille ei tarvita, koska voit avata kunkin raportin suoraan raporttikansion .pbir-tiedostosta.

project/
├── AdventureWorks-Sales.Report/
│   └── definition.pbir
├── AdventureWorks-Stocks.Report/
│   └── definition.pbir
├── AdventureWorks.SemanticModel/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

Tiedostoihin siirtyminen

Kun olet tallentanut projektina, näet, kun työskentelet projektin parissa, katsomalla otsikkoriviä:

Näyttökuva, jossa näkyy Power BI Desktop -otsikko projektiin tallennettaessa.

Jos valitset otsikkorivin, esiin tulee pikaikkuna, joka koskee Power BI -projektia. Tämän pikaikkunan avulla voit paikantaa projektitiedostot ja raportin ja semanttisen mallin näyttönimiasetukset. Voit avata kansion myös resurssienhallinnassa napsauttamalla polkuja.

Näyttökuva, jossa näkyy Power BI Desktop -otsikon pikaikkuna.

Power BI Desktopin ulkopuoliset muutokset

Kun tallennat projektina, sinun ei ole pakko tehdä muutoksia semanttiseen malliisi ja raporttimäärityksiäsi vain Power BI Desktopissa. Voit käyttää muita työkaluja, kuten VS Codea, avoimen lähdekoodin yhteisötyökaluja, kuten Tabular Editoria tai jopa Muistiota. Kaikki tiedostot tai muutokset eivät kuitenkaan tue muokkaamista ulkoisilla avoimen lähdekoodin työkaluilla.

Muutokset tiedostoihin tai ominaisuuksiin Power BI Desktopin ulkopuolella voivat aiheuttaa odottamattomia virheitä tai jopa estää Power BI Desktopin avautumisen. Näissä tapauksissa sinun on ratkaistava tiedostoissa olevat ongelmat, ennen kuin yrität avata projektin uudelleen Power BI Desktopissa.

Jos mahdollista, Power BI Desktop ilmaisee tiedoston ja virheen sijainnin:

Tiedostoa ei voi avata -virheen näytönkaappaus.

Seuraavien tiedostojen rakenteen tietoja ei dokumentoida. Esikatselun aikana näiden tiedostojen muutoksia Power BI Desktopin ulkopuolella ei tueta:

Raportti\
SemanticModel\
- diagramLayout.json

Käyttöönotto Fabric-työtilassa

Kun käsittelet Power BI -projektitiedostoja, voit ottaa sisällön käyttöön Fabric-työtilassa käyttämällä seuraavia julkaisumekanismeja:

Käytä Fabric Git -integrointia.
Käytä Fabric -ohjelmointirajapintoja.
Käytä Power BI Desktopin Julkaise -vaihtoehtoa.

Muistiinpano

Julkaiseminen Power BI Desktopin kautta julkaise käyttää tilapäistä PBIX-tiedostoa, joka on julkaistu palveluun. Tämä toimii samalla tavalla kuin PBIX-tiedoston tallentaminen ja julkaiseminen. Toisin kuin muut PBIP-käyttöönottoasetukset, jotka ottavat käyttöön vain metatiedot, tämä julkaisumenetelmä ottaa käyttöön sekä metatiedot että paikallisen tietovälimuistin, muokattavat semanttiset mallit.

Mallin luominen

Voit tehdä muutoksia semanttisen mallin määritykseen käyttämällä ulkoisia työkaluja kahdella tavalla:

Yhdistämällä Power BI Desktopin Analysis Service (AS) -esiintymään ulkoisilla työkaluilla.
Muokkaamalla TMDL-metatietoja kansiossa /definition VS Coden tai muun ulkoisen työkalun avulla.

Kaikkia semanttisia mallin metatietoja voi lukea. Kirjoitustoimintoja tuetaan täysin, mutta ota huomioon, että metatietojen muokkaaminen Power BI Desktopin ulkopuolella voi johtaa odottamattomaan toimintaan tai joissakin harvinaisissa tapauksissa johtaa mallin sisäisiin epäyhtenäisyyksiin. Ole varovainen, kun teet muutoksia ulkoisten työkalujen avulla.

Pidä mielessä:

Kaikki Power BI Desktopin ulkopuolella tehtyjen tiedostojen avaamiseen tehdyt muutokset edellyttävät uudelleenkäynnistämistä, jotta nämä muutokset näytetään Power BI Desktopissa. Power BI Desktop ei ole tietoinen muiden työkalujen tekemiin projektitiedostoihin tehdyistä muutoksista.
Power BI Desktopin luomia automaattisia päivämäärätaulukoita ei tule muuttaa ulkoisten työkalujen avulla.
Jos semanttisessa mallissa automaattinen päivämäärä ja aika -ominaisuus on käytössä ja luot uuden datetime-sarakkeen Power BI Desktopin ulkopuolella, paikallista päivämäärätaulukkoa ei luoda automaattisesti.
Semanttiset mallit, kuten yhdistelmämallit tai Direct Lake , voivat sisältää objekteja ja ominaisuuksia, jotka ovat peräisin muista malleista tai tietolähteistä. Kun mukautat näitä ominaisuuksia tai poistat synkronoituja objekteja, Power BI edellyttää ominaisuuden changedProperties ja PBI_RemovedChildren huomautuksen määrittämistä. Nämä ilmaisimet merkitsevät muutokset käyttäjän mukautuksiksi ja varmistavat, että ne säilytetään seuraavan rakenteen synkronoinnin aikana tietolähteen kanssa. Lisätietoja on artikkelissa Semanttisten Power BI -mallien historiatietojen tunnisteet.
Kaikki lausekkeen muokkaukset Power BI Desktopin ulkopuolella projektissa, jossa unappliedChanges.json , menetetään, kun näitä muutoksia otetaan käyttöön.

JSON-tiedostorakenteet

Useimmat projektitiedostot sisältävät metatietoja JSON-muodossa. Vastaavia JSON-rakenteet voidaan käyttää vahvistukseen ja dokumentointiin.

JSON-rakenteet:

Lue lisätietoja määritettävissä olevat ominaisuudet.
Käytä koodieditorin tarjoamaa sisäistä JSON-vahvistusta.
Sisällön tuottamisen parantaminen syntaksin korostuksen, työkaluvihjeiden ja automaattisen täydennysten avulla.
Käytä ulkoisia työkaluja, joilla on tietoja projektin metatietojen tuetuista ominaisuuksista.

VS Coden avulla voit yhdistää JSON-rakenteet luotuihin tiedostoihin. Projektitiedostojen JSON-rakenteet on annettu json-schemas Git -säilössä.

Huomioitavat asiat ja rajoitukset

Power BI Desktop ei ole tietoinen muiden työkalujen tai sovellusten kanssa tehdyistä muutoksista. Ulkoisten työkalujen avulla tehdyt muutokset edellyttävät Power BI Desktopin käynnistämistä uudelleen, ennen kuin kyseiset muutokset näytetään.
Luottamuksellisuustunnisteita ei tueta Power BI -projekteissa.
Kaavionäkymä ohitetaan, kun malleja muokataan palvelussa.
Kun tallennat Power BI -projektina, projektitiedostojen polun enimmäispituus on 260 merkkiä.
Power BI Desktopissa et voi tallentaa suoraan PBIP-käyttäjänä OneDriveen ja SharePointiin. Voit käyttää Tallenna nimellä - tiedostojen tallentamiseen paikallisesti synkronoituun OneDrive-kansioon. Tämä saattaa kuitenkin aiheuttaa tiedostojen lukitusongelmia, jotka saattavat johtaa epäonnistuneiden tallennustoimintojen epäonnistumiseen Power BI Desktopissa.
Kun muokkaat PBIP-tiedostoja Power BI Desktopin ulkopuolella, ne tulee tallentaa käyttämällä UTF-8:aa ilman BOM-koodausta.
Raportin lingvististä rakennetta ei tueta Power BI -projekteissa.
Power BI Desktop käyttää rivin lopussa CRLF:ää. Jos haluat välttää erojen ongelmat, määritä Git käsittelemään rivinpäätteet ottamalla käyttöön automaattinen sisällys.
Power BI -projekteja ei tällä hetkellä tueta Power BI -raporttipalvelimelle optimoidussa Microsoft Power BI Desktop -versiossa.

Usein kysytyt kysymykset

Kysymys: Kun tarkastelet semanttisen mallin ja raporttikohteen kansion määrityksiä, vain muutama tiedosto on merkitty pakolliseksi, mitä tapahtuu, jos poistan ne?

Vastaus: Power BI Desktop luo ne automaattisesti, kun tallennat projektina (PBIP).

Kysymys: Onko Power BI Desktop tietoinen muutoksista, joita teen Power BI -projektitiedostoihin ulkoisesta työkalusta tai sovelluksesta?

Vastaus: Ei. Tiedostoihin tehdyt muutokset edellyttävät, että Power BI Desktop käynnistetään uudelleen kyseisten muutosten mukaisesti.

Kysymys: Jos muunnan PBIX:n PBIP-muotoon, voinko muuntaa sen takaisin PBIX:ksi?

Vastaus: Kyllä. Voit tallentaa PBIX-sisällön PBIP-muodossa tai tallentaa PBIP:n PBIX-muodossa.

Kysymys: Voinko muuntaa PBIX:n PBIP:ksi ja päinvastoin ohjelmallisesti?

Vastaus: Ei. Voit muuntaa PBIX-tiedoston vain PBIP-tiedostoksi ja päinvastoin käyttämällä Power BI Desktopin Tiedosto>Tallenna nimellä -toimintoa.

Kysymys: Voinko ottaa käyttöön Power BI Desktop -projektin Azure Analysis Services (AAS) tai SQL Server Analysis Servicesin (SSAS) kanssa?

Vastaus: Ei. Power BI Desktop -projektiraportin määrityksiä ei tueta AAS- ja SSAS-palveluissa. Mallimääritelmissä käytetään myös Parannettuja metatietoja, jotka ovat yksilöllisiä Power BI:lle. AAS- ja SSAS-projekteissa käytä Microsoft Visual Studiota mallien luomiseen, Git- ja Azure DevOps -integrointiin.

Kysymys: Miksi *.pbip-tiedostoa ei ole, kun yhdistän Fabric-työtilani Gitiin? Miten voin muokata raporttia ja semanttista mallia Power BI Desktopissa?

Vastaus: PBIP-tiedosto on valinnainen, ja se toimii vain pikakuvakkeena raporttikansioon. Voit avata sekä raportin että semanttisen mallin muokkaamista varten Power BI Desktopissa avaamalla raporttikansiossa olevan definition.pbir-tiedoston.