Del via

Power BI Desktop-prosjekter (FORHÅNDSVERSJON)

  • Artikkel

Viktig

Power BI Desktop-prosjekter er for øyeblikket i forhåndsversjon.

Tips

Hvis du vil ha veiledning om hvordan du planlegger en Power BI-utvikling, kan du se Planlegging av Power BI-implementering.

Power BI Desktop introduserer en ny måte å redigere, samarbeide og lagre prosjektene på. Når du lagrer arbeidet som et Power BI-prosjekt (PBIP), lagres rapport- og semantiske modellelementdefinisjoner som individuelle filer i ren tekst i en enkel, intuitiv mappestruktur.

Lagring av arbeid som prosjekt har følgende fordeler:

  • støtte for tekstredigeringsprogram – Elementdefinisjonsfiler er formatert tekstfiler som inneholder semantiske modell- og rapportmetadata. Disse filene er offentlig dokumentert og lesbare for mennesker. Selv om prosjektfiler støtter enkle tekstredigeringsverktøy som Notisblokk, er det bedre å bruke et koderedigeringsprogram som Visual Studio Code (VS Code), som gir en rik redigeringsopplevelse, inkludert intellisense, validering og Git-integrering.

  • Programmatisk generering og redigering av elementdefinisjoner – Du kan programmatisk generere og endre tekstfiler for elementdefinisjoner, slik at satsvise operasjoner kan oppdatere alle visualobjekter for rapportsider eller legge til et sett med mål i hver tabell. For semantiske modeller kan du bruke Tabellobjektmodell (TOM) klientbibliotek til å deserialisere semantiske modellmetadata, foreta programmatiske endringer og serialisere det tilbake til filene.

  • Kildekontroll – Semantiske modell- og rapportelementdefinisjoner i Power BI kan lagres i et kildekontrollsystem, for eksempel Git. Med Git kan du spore versjonslogg, sammenligne revisjoner (diff) og gå tilbake til tidligere versjoner. Kildekontroll kan også oppheve blokkeringen av samarbeid når du bruker Power BI Desktop ved hjelp av kjente samarbeidsmekanismer for å løse konflikter (slå sammen) og se gjennom endringer (pull-forespørsler). Hvis du vil ha mer informasjon, kan du se Versjonskontroll i Git.

  • Kontinuerlig integrering og kontinuerlig levering (CI/CD) – Du kan bruke systemer der utviklere i organisasjonen sender inn en foreslått endring i CI/CD-systemet. Systemet validerer deretter endringen med en rekke kvalitetsporter før du bruker endringen i produksjonssystemet. Disse kvalitetsportene kan inkludere kodevurderinger fra andre utviklere, automatisert testing og automatisert bygg for å validere integriteten til endringene. CI/CD-systemer er vanligvis bygget oppå eksisterende kildekontrollsystemer. Hvis du vil ha mer informasjon, kan du se DevOps – Kontinuerlig integrasjon og DevOps – kontinuerlig levering.

Aktivere forhåndsvisningsfunksjoner

Lagring som et Power BI-prosjekt i Power BI Desktop er for øyeblikket i forhåndsvisning, og du må aktivere det i forhåndsvisningsfunksjoner.

Gå til Alternativer for filalternativer > og innstillinger > For > forhåndsvisningsfunksjoner , og merk av i boksen ved siden av lagringsalternativet for Power BI Project (PBIP).

Lagre som et prosjekt

Hvis du arbeider med et nytt prosjekt eller åpnet en eksisterende Power BI Desktop-fil (pbix), kan du lagre arbeidet som en Power BI-prosjektfil (pbip):

Skjermbilde som viser lagringsfil som Power BI Project

Når du lagrer som et prosjekt, lagrer Power BI Desktop rapport- og semantiske modellelementer som mapper, som hver inneholder tekstfiler som definerer elementet:

Skjermbilde som viser Power BI Project-filer

Når du har lagret som et prosjekt, kan du se når du arbeider på et prosjekt ved å se på tittellinjen:

Skjermbilde som viser Power BI Desktop-tittelen når du lagrer til prosjektet.

Hvis du velger på tittellinjen, vises en undermeny som er spesifikk for Power BI Project. Med denne undermenyen finner du prosjektfilene og visningsnavninnstillingene for rapporten og den semantiske modellen. Du kan også åpne mappen i filutforskeren ved å klikke på banene.

Skjermbilde som viser power bi desktop-tittel undermeny.

La oss ta en nærmere titt på det du ser i prosjektets rotmappe:

<prosjektnavn>. SemanticModel

En samling filer og mapper som representerer en semantisk Power BI-modell. Hvis du vil lære mer om filene og undermappene og filene her inne, kan du se Project Semantic Model-mappen.

<prosjektnavn>. Rapport

En samling filer og mapper som representerer en Power BI-rapport. Hvis du vil ha mer informasjon om filene og undermappene og filene her, kan du se Prosjektrapport-mappen.

.gitIgnore

Angir filer som git skal ignorere med vilje for Power BI-prosjektfiler, for eksempel cache.abf og localSettings.json.

Power BI Desktop oppretter .gitignore-filen bare hvis det ikke allerede finnes en lagringsmappe eller overordnet Git-repositorium.

Standardinnhold for GITIGNORE når du lagrer som PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<project name.pbip>

PBIP-filen inneholder en peker til en rapportmappe. Når du åpner en PBIP, åpnes den målrettede rapporten og modellen for redigering.

Hvis du vil ha mer informasjon, kan du se pbip-skjemadokumentet.

Åpne et Power BI-prosjekt

Du kan åpne Power BI Desktop fra Power BI Project-mappen enten ved å åpne pbip-filen eller pbir-filen i rapportmappen. Begge alternativene åpner rapporten for redigering og semantisk modell hvis det finnes en relativ referanse til en semantisk modell.

Du kan lagre flere rapporter og semantiske modeller i samme mappe. Det er ikke nødvendig å ha en egen pbip-fil for hver rapport fordi du kan åpne hver rapport direkte fra PBIR-filen i rapportmappen.

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

Endringer utenfor Power BI Desktop

Når du lagres som et prosjekt, blir du ikke tvunget til å gjøre endringer i semantiske modell- og rapportdefinisjoner bare i Power BI Desktop. Du kan bruke andre verktøy, for eksempel VS Code, fellesskapsverktøy med åpen kildekode, for eksempel Tabellredigering eller notisblokk. Men ikke alle filer eller endringer støtter redigering av eksterne verktøy med åpen kildekode.

Endringer i filer eller egenskaper utenfor Power BI Desktop kan forårsake uventede feil, eller til og med hindre at Power BI Desktop åpnes. I slike tilfeller må du løse problemene i filene før du prøver å åpne prosjektet på nytt i Power BI Desktop.

Hvis det er mulig, angir Power BI Desktop filen og plasseringen av feilen:

Skjermbilde av kan ikke åpne filfeil.

Skjemadetaljer for følgende filer er ikke dokumentert. Under forhåndsvisningen støttes ikke endringer i disse filene utenfor Power BI Desktop:

Distribuer til Fabric-arbeidsområdet

Når du arbeider med Power BI-prosjektfiler, kan du distribuere innholdet til et Stoff-arbeidsområde ved hjelp av følgende publiseringsmekanismer:

Notat

Publisering gjennom Power BI Desktop publiserer bruker en midlertidig PBIX-fil som publiseres til tjenesten, på samme måte som lagring og publisering av en PBIX-fil. I motsetning til andre alternativer for PBIP-distribusjon som bare distribuerer metadata, distribuerer denne publiseringsmetoden både metadataene og den lokale databufferen av den semantiske modellen som redigeres.

Modellredigering

Du kan gjøre endringer i den semantiske modelldefinisjonen ved hjelp av eksterne verktøy på to måter:

  • Ved å koble til Power BI Desktops Analysis Service (AS)-forekomst med eksterne verktøy.
  • Ved å redigere JSON-metadata i model.bim-filen ved hjelp av VS Code eller et annet eksternt verktøy.

Ikke alle modellobjekter støtter skriveoperasjoner. Bruk av endringer utenfor disse som støttes, kan føre til uventede resultater.

Objekter som støtter skriveoperasjoner:

Object Koble til AS-forekomst Filendring / TMDL-visning
Tabeller Nei Ja
Kolonner Ja 1, 2 Ja
Beregnede tabeller Ja Ja
Beregnede kolonner Ja Ja
Hierarkier Ja Ja
Relasjoner Ja Ja
Measures Ja Ja
Modell-KPI-er Ja Ja
Beregningsgrupper Ja Ja
Perspektiver Ja Ja
Oversettelser Ja Ja
Sikkerhet på radnivå (RLS) Ja Ja
Sikkerhet på objektnivå (OLS) Ja Ja
Merknader Ja Ja
M-uttrykk Nei Ja 3, 4

Husk:

  • Eventuelle endringer for å åpne filer som er gjort utenfor Power BI Desktop, krever en omstart for at disse endringene skal vises i Power BI Desktop. Power BI Desktop er ikke klar over endringer i prosjektfiler som er gjort av andre verktøy.

  • Power BI Desktop støtter ikke tabeller med flere partisjoner. Bare én enkelt partisjon for hver tabell støttes. Oppretting av tabeller med tomme partisjoner eller mer enn én partisjon resulterer i en feil når du åpner rapporten.

  • Automatiske datotabeller opprettet av Power BI Desktop bør ikke endres ved hjelp av eksterne verktøy.

  • Når du endrer en modell som bruker Direct Query til å koble til en Semantisk Power BI-modell eller Analysis Services-modell, må du oppdatere ChangedProperties og PBI_RemovedChildren samling for det endrede objektet for å inkludere eventuelle endrede eller fjernede egenskaper. Hvis ChangedProperties og/eller PBI_RemovedChildren ikke oppdateres, kan Power BI Desktop overskrive eventuelle endringer neste gang spørringen redigeres eller modellen oppdateres i Power BI Desktop.

  • 1 – Endring av datatypen for en kolonne støttes. Gi nytt navn til kolonner støttes imidlertid ikke når du kobler til AS-forekomsten.

  • 2 – Hvis den semantiske modellen har automatisk dato/klokkeslett-funksjonen aktivert, og du oppretter en ny datetime-kolonne utenfor Power BI Desktop, genereres ikke den lokale datotabellen automatisk.

  • 3 – Partition SourceType må beregnes, M, Entity eller CalculationGroup. Partisjonsmodus må være Import, DirectQuery eller Dobbel.

  • 4 – Alle uttrykk redigerer utenfor Power BI Desktop i et prosjekt med unappliedChanges.json går tapt når disse endringene brukes.

  • Hvis du endrer tabellspørringsuttrykk utenfor Power BI Desktop, fjernes tabelldataene når du starter Power BI Desktop på nytt.

JSON-filskjemaer

De fleste prosjektfiler inneholder metadata i JSON-format. Tilsvarende JSON-skjemaer kan brukes til validering og dokumentasjon.

Med JSON-skjemaer kan du:

  • Finn ut mer om konfigurerbare egenskaper.
  • Bruk innebygd JSON-validering levert av koderedigeringsprogrammet.
  • Forbedre redigering med syntaksutheving, verktøytips og autofullføring.
  • Bruk eksterne verktøy med kjennskap til støttede egenskaper i prosjektmetadata.

Bruk VS Code til å tilordne JSON-skjemaer til filene som redigeres. JSON-skjemaer for prosjektfiler leveres i Git-repositoriet for Power BI Desktop-eksempler.

Hensyn og begrensninger

  • Power BI Desktop er ikke klar over endringer som er gjort med andre verktøy eller programmer. Endringer som gjøres ved hjelp av eksterne verktøy, krever at du starter Power BI Desktop på nytt før disse endringene vises.
  • Følsomhetsetiketter støttes ikke med Power BI-prosjekter.
  • Diagramvisning ignoreres når du redigerer modeller i tjenesten.
  • Når du lagrer som et Power BI-prosjekt, er maksimal lengde på banen til prosjektfilene 260 tegn.
  • I Power BI Desktop kan du ikke lagre som en PBIP direkte til OneDrive og SharePoint.
  • Når du redigerer PBIP-filer utenfor Power BI Desktop, bør de lagres ved hjelp av UTF-8 uten stykklistekoding.
  • Rapportlingvistisk skjema støttes ikke med Power BI-prosjekter.
  • Power BI Desktop bruker CRLF som sluttlinje. Hvis du vil unngå problemer i diffs, konfigurerer du Git til å håndtere linjeavslutninger ved å aktivere autocrlf.
  • Power BI-prosjekter støttes for øyeblikket ikke i Microsoft Power BI Desktop-versjonen som er optimalisert for rapportserver for Power BI.
  • Live connect-rapporter som er lagret som PBIP, krever at XMLA-endepunktet aktiveres.

Vanlige spørsmål

Spørsmål: Hvis du ser på semantiske modell- og rapportelementmappedefinisjoner, merkes bare noen få filer som påkrevd, hva skjer hvis jeg sletter dem?

Svar: Power BI Desktop oppretter dem automatisk når du lagrer som et prosjekt (PBIP).

Spørsmål: Er Power BI Desktop oppmerksom på endringer jeg gjør i Power BI Project-filene fra et eksternt verktøy eller program?

Svar: Nei. Alle endringer i filene krever at Power BI Desktop startes på nytt for å gjenspeile disse endringene.

Spørsmål: Hvis jeg konverterer en PBIX til en PBIP, kan jeg konvertere den tilbake til PBIX?

Svar: Ja. Du kan lagre en PBIX som en PBIP, eller lagre en PBIP som en PBIX.

Spørsmål: Kan jeg konvertere PBIX til PBIP og omvendt programmatisk?

Svar: Nei. Du kan bare konvertere en PBIX til en PBIP og omvendt ved hjelp av Power BI Desktops Fillagring>som.

Spørsmål: Kan jeg distribuere et Power BI Desktop-prosjekt til Azure Analysis Services (AAS) eller SQL Server Analysis Services (SSAS)?

Svar: Nei. Rapportdefinisjoner for Power BI Desktop-prosjekter støttes ikke i AAS og SSAS. Og modelldefinisjoner bruker forbedrede metadata som er unike for Power BI. For AAS- og SSAS-prosjekter kan du bruke Microsoft Visual Studio til modellredigering, Git- og Azure DevOps-integrering.

Spørsmål: Hvorfor er det ikke en *.pbip-fil når jeg kobler Fabric-arbeidsområdet til Git? Hvordan kan jeg redigere rapporten og semantisk modell i Power BI Desktop?

Svar: PBIP-filen er valgfri og fungerer ganske enkelt som en snarvei til rapportmappen. Du kan åpne både rapporten og den semantiske modellen for redigering i Power BI Desktop ved å åpne definition.pbir-filen i rapportmappen.

Relatert innhold