Lezen in het Engels

Share via

Werken met de TMDL-weergave in Power BI Desktop (preview)

  • Artikel

TMDL-weergave kunt u semantische modelobjecten scripten, wijzigen en toepassen met een moderne code-editor met behulp van TMDL- (Tabular Model Definition Language) in Power BI Desktop, waardoor de ontwikkelingsefficiëntie wordt verbeterd en volledige zichtbaarheid en controle over semantische modelmetagegevens wordt geboden.

TMDL-weergave biedt een alternatieve ervaring voor semantische modellering met behulp van code, in plaats van een grafische gebruikersinterface, zoals modelweergave.

DE TMDL-weergave biedt de volgende voordelen:

  • Verbeterde ontwikkelingsefficiëntie met een uitgebreide code-editor met zoek- en vervangingsfuncties, sneltoetsen, bewerkingen met meerdere regels en meer.
  • de herbruikbaarheid verhogen door eenvoudig TMDL-scripts te scripten, te delen en opnieuw te gebruiken tussen semantische modelontwikkelaars. Gebruik bijvoorbeeld een gecentraliseerde SharePoint-site om eenvoudig herbruikbare semantische modelobjecten zoals agendatabellen of time intelligence-berekeningsgroepen te delen.
  • Meer controle en transparantie, waarbij alle semantische modelobjecten en eigenschappen worden getoond, en wijzigingen kunnen worden aangebracht in items die niet beschikbaar zijn in de gebruikersinterface van Power BI Desktop, zoals IsAvailableInMDX of DetailRowsDefinition.

Preview-functie inschakelen

Als u TMDL-weergavewilt gebruiken, moet u de preview-functie inschakelen. Selecteer in Power BI Desktop Bestand > Opties en instellingen > Opties > Preview-functies en selecteer het selectievakje naast TMDL-weergave.

Script naar TMDL

Selecteer in Power BI Desktop het TMDL-weergave pictogram aan de linkerkant van het venster, zoals wordt weergegeven in de volgende afbeelding.

schermopname van de T-M-D-L-weergave voor tabellaire modeldefinitie.

Wanneer de TMDL-weergave wordt geopend, is de code-editor in eerste instantie leeg. U kunt een semantisch modelobject, zoals een tabel, meting of kolom, scripten door de objecten te selecteren in het deelvenster Gegevens en deze naar de code-editor te slepen:

Schermopname van het slepen van een semantisch modelobject naar het T-M-D-L-weergavecanvas.

Wanneer u de TMDL-weergave gebruikt en het object vanuit het deelvenster Gegevens sleept, worden de volledige objectmetadata in het huidige tabblad gescript als TMDL. Indien het huidige tabblad niet leeg is, wordt een nieuw tabblad geopend met een createOrReplace TMDL-script van de geselecteerde objecten, zoals wordt weergegeven in de volgende afbeelding:

Schermopname van de T-M-D-L-metagegevens die automatisch worden gemaakt.

U kunt ook met de rechtermuisknop op een object in de gegevensweergave klikken en SCRIPT TMDL- selecteren op een nieuw tabblad of op het klembord, weergegeven in de volgende afbeelding:

Schermafbeelding van het klikken met de rechtermuisknop op een object in de gegevensweergave om power BI T-M-D-L-metagegevenscode te laten maken.

Tip

Meerdere selecties worden ondersteund door op Ctrl te drukken voordat u de objecten in de TMDL-weergavecode-editor scriptt.

Code editor

Zodra u een semantisch modelobject hebt gescript of TMDL-script in de code-editor hebt geplakt, kunt u de uitgebreide code-ervaringsfuncties van de TMDL-weergavecode-editor gebruiken. Met de functies voor code-ervaring kunt u de metagegevens van het model verkennen of wijzigingen aanbrengen die later kunnen worden toegepast op het semantische model.

Semantische markering

Semantische markeringen zijn ingebouwd in de code-editor, waardoor de leesbaarheid wordt verbeterd door verschillende kleuren toe te passen op delen van uw code op basis van betekenis. Deze kleurcodering maakt het gemakkelijker om de structuur en functionaliteit van uw TMDL-code te begrijpen, zoals wordt weergegeven in de volgende afbeelding.

Schermopname van kleurcodering en semantische markering voor T-M-D-L-metagegevenscode.

U kunt ook secties van uw TMDL-script uitvouwen of samenvouwen, zoals wordt weergegeven in de volgende afbeelding:

Schermopname van het samenvouwen van secties code in de code-editor.

Automatisch aanvullen

Automatisch aanvullen is ingebouwd in de code-editor en biedt intelligente suggesties terwijl u typt. Automatisch aanvullen kan uw werkstroom versnellen, de kans op fouten verminderen en u helpen inzicht te verkrijgen in uw codeopties door dynamisch mogelijke waarden of eigenschappen voor te stellen door rekening te houden met de cursorpositie.

Schermopname van automatisch aanvullen in de code-editor.

U kunt de functie voor automatisch aanvullen ook op elke locatie activeren door op Ctrl+spatiebalkte drukken.

Foutdiagnostiek

Met de ingebouwde foutdiagnose van de code-editor kunt u problemen identificeren en oplossen door TMDL-taalfouten in de code-editor te markeren, met gedetailleerde berichten die richtlijnen bieden voor het oplossen ervan. Daarnaast is er een foutoverzicht beschikbaar in het deelvenster Problemen, zodat u eenvoudig kunt navigeren naar de foutlocatie in de code-editor, zoals wordt weergegeven in de volgende afbeelding.

Schermopname van foutdiagnose in de code-editor.

Wijzigingen toepassen op het semantische model

Wanneer u klaar bent, kunt u de knop Toepassen selecteren om het TMDL-script uit te voeren op het semantische model en de wijzigingen in de TMDL-code laten toepassen.

Schermopname van het toepassen van uw script met behulp van de knop Toepassen in de code-editor.

Wanneer dit lukt, wordt er een melding weergegeven en wordt uw modelwijziging toegepast op het semantische model.

Schermopname van de banner met succes in de code-editor die aangeeft dat wijzigingen zijn toegepast.

In het geval van een fout wordt er een foutmelding weergegeven om aan te geven dat uw modelleringswijzigingen niet zijn toegepast op het semantische model. U kunt meer informatie over de fout bekijken door de koppeling Details weergeven koppeling in de melding te selecteren. Vervolgens wordt het deelvenster Uitvoer uitgebreid en worden foutdetails weergegeven.

schermopname van de banner met fouten in de code-editor die aangeeft dat de wijzigingen niet zijn geslaagd.

Notitie

De TMDL-weergave wijzigt alleen de metagegevens van het semantische model, zonder gegevens te vernieuwen of het rapport te beïnvloeden. Als uw wijzigingen een gegevensvernieuwing vereisen, zoals het wijzigen van een PowerQuery-expressie of berekende kolomexpressie, moet u de tabel of het model handmatig vernieuwen om de wijzigingen van kracht te laten worden. Daarnaast kan het wijzigen van de naam van een veld in de TMDL-weergave visuele elementen in het rapport dat dat veld gebruikt, verbreken.

TMDL-scripttabbladen

In de TMDL-weergave kunt u meerdere scripttabbladen tegelijk hebben, waarvan de naam kan worden gewijzigd of verwijderd.

Schermopname van meerdere tabbladen in de weergave T-M-D-L.

De inhoud van de TMDL-weergave tabbladen worden opgeslagen in het rapportbestand wanneer u het Power BI Desktop-rapport opslaat, zodat u kunt doorgaan waar u de volgende keer bent gebleven wanneer u het Power BI Desktop-rapportbestand opent. Wanneer u een Power BI Project (PBIP)opslaat, wordt elk scripttabblad als een .tmdl-bestand opgeslagen in de map \TMDLScripts, zoals te zien is in de volgende afbeelding.

Schermopname van de bestandsstructuur voor het opslaan van tabbladen in een Power BI Desktop-bestand.

Tip

U kunt TMDL-scripts openen en bewerken in Visual Studio Code en ze worden na het opnieuw opstarten van Power BI Desktop opnieuw geladen.

In de deelvensters Problemen en Uitvoer worden fouten en berichten weergegeven die specifiek zijn voor het scripttabblad dat momenteel is geselecteerd en weergegeven. Als u overschakelt naar een ander TMDL-tabblad, worden beide deelvensters vernieuwd met informatie die specifiek is voor het geselecteerde en momenteel weergegeven tabblad.

U kunt de knop Wissen selecteren om de berichten in het deelvenster Uitvoer leeg te maken.

Schermopname van de knop 'Wissen' waarmee berichten in het uitvoervenster worden gewist.

Berichten worden alleen bewaard voor elke Power BI Desktop-sessie, dus als u Power BI Desktop opnieuw start, worden alle uitvoerberichten voor alle scripttabbladen gewist.

TMDL-weergave en Power BI-project

Wanneer u uw werk opslaat als een Power BI-project (PBIP), krijgt u toegang tot de metagegevens van uw semantische modeldefinitie als TMDL-bestanden, wat een handige ervaring voor broncodebeheer en co-ontwikkeling biedt, terwijl u ook kunt wijzigingen aanbrengt in het semantische model buiten Power BI Desktop. Als u echter de TMDL-bestanden in het PBIP wijzigt, moet u Power BI Desktop opnieuw starten om deze wijzigingen opnieuw te laden. De TMDL-weergave volgt daarentegen een mentaal scriptmodel, zodat u efficiënt wijzigingen rechtstreeks kunt toepassen op het semantische model dat in Power BI Desktop wordt bewerkt met TMDL, ongeacht of de bestandsindeling PBIX of PBIP is.

U kunt beide ervaringen naadloos integreren. U kunt bijvoorbeeld de TMDL-definitie in PBIP bijwerken voor snelle wijzigingen zonder Power BI Desktop te starten en de TMDL-weergave te gebruiken wanneer Power BI Desktop al is geopend om efficiënt een reeks wijzigingen in het semantische model te implementeren met TMDL. Beide benaderingen bieden een rijke en consistente TMDL-coderingservaring.

Veelvoorkomende gebruiksvoorbeelden voor de TMDL-weergave

scenario: ik een semantische modeltabel opnieuw moet gebruiken of delen met de volledige definitie, waaronder kolommen, Power Query-expressies en sorteren op configuratie, en andere in een ander semantisch model.

Oplossing: Open het semantische model met de tabel en script het met behulp van de TMDL-weergave. Kopieer het script naar het andere Power BI Desktop-venster, open het tabblad TMDL-weergave en pas het script toe.


Scenario: Ik heb al mijn tabellen benoemd met de voorvoegsels 'dim_' of 'fact_'. Ik wil deze voorvoegsels verwijderen zonder elk van de meer dan 100 tabellen handmatig bij te werken.

Oplossing: De TMDL-weergave openen, het semantische model scripten, het voorvoegsel zoeken (reguliere expressies worden ondersteund) en vervangen door een lege tekst.


Scenario: Ik moet een perspectief maken in mijn semantische model om de functie voor gepersonaliseerde visualste kunnen gebruiken. Ik kan het echter niet maken of bewerken met behulp van de grafische interface van Power BI Desktop.

Oplossing: Open de TMDL-weergave, maak een nieuw leeg tabblad (of gebruik het script vanuit een bestaand perspectief) en maak of bewerk het perspectief met TMDL. Deze methode is ook van toepassing op andere semantische modelmetagegevens die geen grafische interface hebben, zoals vertalingen, detailrijexpressies en andere.

tmdl 
createOrReplace
      perspective SalesView
        perspectiveTable Sales
            perspectiveMeasure 'Sales Amount'
            perspectiveMeasure 'Sales Qty'
            perspectiveColumn Quantity
            perspectiveColumn 'Amount'

Scenario: Moet ik de Power Query-expressie van mijn tabel wijzigen zonder een vernieuwing te activeren.

Oplossing: de tabel scripten, de Power Query-expressie wijzigen en de wijzigingen toepassen. Voor de TMDL-weergave hoeven uw gegevens niet te worden vernieuwd.


Scenario: Moet ik de opslagmodus van mijn tabel overschakelen van DirectQuery naar Import en omgekeerd?

Oplossing: De tabel scripten, de partitiemodus bijwerken en wijzigingen toepassen.


scenario: moet ik een back-up maken van mijn semantische modeldefinitie voordat ik belangrijke wijzigingen aanbrengt en zo nodig eenvoudig terugdraai naar een vorige definitie.

Oplossing: script het semantische model of specifieke onderdelen waarnaar u een back-up wilt maken, breng uw wijzigingen aan in andere weergaven en ga, indien nodig, terug naar de TMDL-weergave om de vorige metagegevens te herstellen door het opgeslagen script uit te voeren.


Overwegingen en beperkingen

TMDL-weergave is momenteel beschikbaar als preview-versie. Houd daarom rekening met de volgende beperkingen:

  • Niet alle modelleringswijzigingen worden ondersteund. Tijdens de preview worden dezelfde validaties uitgevoerd voor elke Toepassen wijziging als bij het openen van een Power BI-project (PBIP). Raadpleeg het artikel over het ontwerpen van modellen (kolom bestandswijziging) voor een lijst met ondersteunde wijzigingen. Het uitvoeren van niet-ondersteunde wijzigingen kan leiden tot onverwacht gedrag.
  • In het opdrachtpalet worden enkele opdrachten weergegeven die momenteel niet worden ondersteund.
  • Het instellen van de eerste Git-integratie vanuit de werkruimte zal geen TMDL View-scripts omvatten die in het gepubliceerde semantische model zijn opgeslagen. Meer informatie vindt u in het Fabric Git-integratieartikel.
  • U kunt geen script uitvoeren voor modelverkennergroepen zoals Metingen, Kolommen, enzovoort.
  • De TMDL-weergave is niet beschikbaar bij het bewerken van Direct Lake semantische modellen .

Verwante inhoud

In de volgende artikelen wordt meer beschreven over TMDL en het gebruik ervan.