Semantische modelmap van Power BI Desktop-project

In dit artikel worden de bestanden en submappen in de Semantische modelmap van een Microsoft Power BI Desktop-project beschreven. De bestanden en submappen hier vertegenwoordigen een semantisch Power BI-model. Afhankelijk van uw project kan de semantische modelmap het volgende omvatten:

1 - Dit bestand is nodig.
2 - Dit bestand is vereist bij het opslaan met de TMSL-indeling.
3 - Dit bestand is vereist bij het opslaan met de TMDL-indeling.

Niet elke semantische projectmodelmap bevat alle bestanden en submappen die hier worden beschreven.

Semantische modelbestanden

.pbi\localSettings.jsaan

Bevat semantische modelinstellingen die alleen van toepassing zijn op de huidige gebruiker en computer. Deze moet worden opgenomen in gitIgnore of andere uitsluitingen voor broncodebeheer. Standaard negeert Git dit bestand.

Zie het localSettings.json schemadocument voor meer informatie.

.pbi\editorSettings.jsop

Bevat semantische editorinstellingen voor modellen die zijn opgeslagen als onderdeel van de semantische modeldefinitie voor gebruik in gebruikers en omgevingen.

Zie het editorSettings.json schemadocument voor meer informatie.

.pbi\cache.abf

Een ABF-bestand (Analysis Services Backup) met een lokale kopie van het model en de gegevens in de cache toen het voor het laatst werd bewerkt. Deze moet worden opgenomen in gitIgnore of andere uitsluitingen voor broncodebeheer. Standaard negeert Git dit bestand.

Power BI Desktop kan een project openen zonder een cache.abf-bestand. In dat geval wordt het rapport geopend dat is verbonden met een model met de volledige definitie, maar zonder gegevens. Als er een cache.abf bestaat, worden de gegevens in Power BI Desktop geladen en wordt de modeldefinitie overschreven met de semantische modelmetagegevens in het project.

.pbi\unappliedChanges.jsop

Met Power BI Desktop kunt u wijzigingen opslaan die zijn aangebracht in de transformatiegegevenseditor (Power Query) zonder deze wijzigingen eerst toe te passen op het gegevensmodel.

Afbeelding van het dialoogvenster Querywijziging toepassen.

Wanneer u Later toepassen selecteert, worden de niet-toegepaste wijzigingen opgeslagen in het unappliedChanges.json-bestand. Wanneer er wijzigingen in behandeling zijn in het bestand 'unappliedChanges', vraagt Power BI Desktop u deze wijzigingen toe te passen of te verwerpen.

Afbeelding met waarschuwing over wijzigingen in afwachting.

Als u Wijzigingen toepassen selecteert, overschrijft Power BI Desktop de query's in semantische modelmetagegevens met de query's uit unappliedChanges.json. Als u query's buiten Power BI Desktop hebt bewerkt en er een eerder unappliedChanges.json bestand is, gaan uw wijzigingen verloren en worden deze vervangen door de query's in unappliedChanges.json wanneer deze wijzigingen worden toegepast.

Het unappliedChanges.json-bestand wordt automatisch opgenomen in de definitie van het semantische model en standaard opgeslagen in Git. Hiermee kunt u uw doorlopende werkzaamheden committeren aan de ontwikkelingsbranch, die als back-up fungeert en deze toegankelijk maakt voor andere teamleden. U kunt dit bestand echter uitsluiten van het bijhouden van Git, waardoor het niet-voltooide querywerk niet van invloed is op andere ontwikkelaars.

Zie het unappliedChanges.json schemadocument voor meer informatie.

definitie.pbism

Bevat de algemene definitie van een semantisch model en kerninstellingen.

Dit bestand geeft ook de ondersteunde semantische modeldefinitieindelingen op via de eigenschap 'version'.

Versie Ondersteunde indelingen
1.0 Semantische modeldefinitie moet worden opgeslagen als TMSL in het bestand model.bim.
4.0 of hoger Semantische modeldefinitie kan worden opgeslagen als TMSL (model.bim-bestand) of TMDL (\definition folder).

Zie het schemadocument definition.pbism voor meer informatie.

model.bim

Dit bestand is alleen beschikbaar als het Power BI-project wordt opgeslagen met de TMSL-indeling. Het bevat een TMSL-databaseobjectdefinitie (Tabular Model Scripting Language) van het projectmodel.

definitie\ map

Deze map is alleen beschikbaar als het Power BI-project wordt opgeslagen met de TMDL-indeling. Het bestand model.bim wordt vervangen.

Deze map bevat een TMDL-databaseobjectdefinitie (Tabular Model Definition Language)van het projectmodel.

diagramLayout.json

Bevat diagrammetagegevens die de structuur van het semantische model definiëren dat aan het rapport is gekoppeld. U kunt dit bestand niet extern bewerken.

.platform

Fabric-platformbestand met eigenschappen die essentieel zijn voor het tot stand brengen en onderhouden van de verbinding tussen Fabric-items en Git.

Zie git-integratie automatisch gegenereerde systeembestanden voor meer informatie.

DAXQueries\ map

Bevat een bestand voor elk querytabblad van de DAX-queryweergave dat is opgeslagen als EEN [Tab name].dax DAX-bestand.

.pbi\daxQueries.json

Bevat editorinstellingen voor DAX-queryweergaven , zoals defaultTab of tabvolgorde.

TMDLScripts\ map

Bevat een bestand voor elk tmDL-weergavescripttabblad dat is opgeslagen als een [Tab name].tmdl TMDL-bestand.

.pbi\tmdlscripts.json

Bevat instellingen voor DE TMDL-weergaveeditor , zoals defaultTab of tabvolgorde.

TMDL-indeling

Met als doel een betere bronbeheer- en mede-ontwikkelingservaring te bieden, kunt u uw Power BI Project-bestanden (PBIP) opslaan met behulp van TMDL (Tabular Model Definition Language) als bestandsindeling voor het semantische model.

In tegenstelling tot Tabular Model Scripting Language (TMSL) is TMDL vanaf het begin ontworpen met het oog op gebruiksvriendelijkheid, waardoor het niet alleen de leesbaarheid verbetert, maar ook eenvoudig kan worden bewerkt in een teksteditor. Dit is een aanzienlijke verbetering voor broncodebeheer en samenwerkings-ontwikkelingservaringen.

Schermopname van gebruiksvriendelijke TMDL-verschillen.

In plaats van een groot JSON-bestand, zoals Tabular Model Scripting Language (TMSL), heeft TMDL een mapstructuur met afzonderlijke bestanden voor elke tabel, perspectief, rol en cultuur. Dit maakt het gemakkelijker om met anderen te werken en de semantische modelstructuur te begrijpen door alleen de map en bestanden te bekijken. Uiteindelijk leidt dit tot een geweldige ervaring voor broncodebeheer en co-ontwikkeling bij het omgaan met git-diff's en samenvoegingsconflicten.

Schermopname van de verschillen in het semantisch model TMDL.

Meer informatie over TMDL vindt u hier.

Externe wijzigingen aanbrengen in TMDL-bestanden

U kunt TMDL-bestanden bewerken in Visual Studio Code of een ander extern hulpprogramma terwijl het project geopend blijft in Power BI Desktop. Installeer de TMDL-extensie voor Visual Studio Code voor een betere TMDL-bewerkingservaring.

Voordat u de bestanden extern bewerkt, slaat u eventuele wijzigingen op in Power BI Desktop. Open de PBIP-map in VS Code, navigeer naar de semantische modelmap definition en sla uw TMDL-wijzigingen op. Power BI Desktop detecteert de opgeslagen wijzigingen en geeft u de banner Externe wijzigingen toepassen weer. Selecteer Externe wijzigingen toepassen om het semantische model opnieuw te laden zonder het project te sluiten en opnieuw te openen.

Schermopname van een semantische modeldefinitiemap in VS Code.

Als Power BI Desktop niet-opgeslagen wijzigingen heeft, wordt u gewaarschuwd dat het toepassen van de externe wijzigingen deze overschrijft. Zie PBIP-bestanden bewerken buiten Power BI Desktop voor de volledige werkstroom en beperkingen.

Zie Modelcreatie voor ondersteunde schrijfbewerkingen buiten Power BI Desktop.

TMDL-fouten

Als een TMDL-bewerking ongeldig is, geeft Power BI Desktop een fout weer wanneer u de externe wijzigingen toepast of het project opent. De fout identificeert de locatie die u moet oplossen voordat Power BI Desktop het bijgewerkte semantische model kan laden:

Schermopname van een foutbericht voor een ongeldig bestand.

Gerelateerde inhoud

  • Last updated on