Praca z widokiem TMDL w programie Power BI Desktop (wersja zapoznawcza)

Widok TMDL umożliwia tworzenie skryptów, modyfikowanie i stosowanie zmian w obiektach modelu semantycznego za pomocą nowoczesnego edytora kodu przy użyciu języka TMDL (Tabular Model Definition Language) w programie Power BI Desktop, poprawy wydajności programowania oraz zapewniania pełnej widoczności i kontroli nad metadanymi modelu semantycznego.

Widok TMDL oferuje alternatywne środowisko semantycznego modelowania przy użyciu kodu, zamiast graficznego interfejsu użytkownika, takiego jak widok modelu.

Widok TMDL oferuje następujące korzyści:

• Ulepszona wydajność programowania za pomocą zaawansowanego edytora kodu, który obejmuje wyszukiwanie i zastępowanie, skróty klawiaturowe, edycje wielowierszowe i inne.
• Zwiększanie możliwości ponownego korzystania dzięki łatwemu tworzeniu skryptów, udostępnianiu i ponownemu użyciu skryptów języka TMDL wśród deweloperów modeli semantycznych. Na przykład użyj scentralizowanej witryny programu SharePoint, aby łatwo udostępniać obiekty modelu semantycznego wielokrotnego użytku, takie jak tabele kalendarza lub grupy obliczeń analizy czasowej.
• Uzyskaj większą kontrolę i przejrzystość, pokazując wszystkie obiekty i właściwości modelu semantycznego oraz zezwalając na zmiany elementów niedostępnych w interfejsie użytkownika programu Power BI Desktop, takich jak IsAvailableInMDX lub DetailRowsDefinition.

Włączanie funkcji w wersji zapoznawczej

Aby użyć widoku TMDL, należy włączyć funkcję w wersji zapoznawczej. W programie Power BI Desktop wybierz pozycję Plik > Opcje i ustawienia > Opcje > Funkcje wersji zapoznawczej i wybierz pole obok Widok TMDL.

Skrypt do języka TMDL

W programie Power BI Desktop wybierz ikonę widoku TMDL znajdującą się po lewej stronie okna, jak pokazano na poniższej ilustracji.

Po otwarciu widoku TMDL edytor kodu jest początkowo pusty. Możesz utworzyć skrypty dowolnego obiektu modelu semantycznego, takiego jak tabela, miara lub kolumna, wybierając obiekty z okienka danych i przeciągając je do edytora kodu:

W przypadku korzystania z widoku TMDL i przeciągania obiektu z okienka Dane usługa Power BI skryptuje całe metadane obiektu do bieżącej karty jako TMDL lub otwiera nową kartę, jeśli bieżąca karta nie jest pusta, jako skrypt createOrReplace TMDL wybranych obiektów, jak pokazano na poniższej ilustracji:

Alternatywnie możesz kliknąć prawym przyciskiem myszy obiekt w widoku danych i wybrać pozycję Skrypt TMDL do nowej karty, lub do schowka, co pokazano na poniższej ilustracji.

Napiwek

Wybór wielokrotny jest obsługiwany przez naciśnięcie CTRL przed wykonaniem skryptów obiektów w edytorze kodu widoku TMDL.

Edytor kodu

Po utworzeniu skryptu obiektu modelu semantycznego lub wklejeniu skryptu języka TMDL w edytorze kodu można użyć kompleksowych funkcji środowiska kodu oferowanych przez edytor kodu widoku TMDL. Funkcje środowiska kodu umożliwiają eksplorowanie metadanych modelu lub wprowadzanie modyfikacji, które można później zastosować do modelu semantycznego.

Wyróżnianie semantyczne

Wyróżnianie semantyczne jest wbudowane w edytor kodu, co zwiększa czytelność, stosując różne kolory do części kodu na podstawie znaczenia. Takie kodowanie kolorów ułatwia zrozumienie struktury i funkcjonalności kodu TMDL, jak pokazano na poniższej ilustracji.

Możesz również rozwinąć lub zwinąć sekcje skryptu TMDL, jak pokazano na poniższej ilustracji:

Autouzupełnianie

Autouzupełnianie jest wbudowane w edytor kodu i oferuje inteligentne sugestie podczas wpisywania. Autouzupełnianie może przyspieszyć przepływ pracy, zmniejszyć prawdopodobieństwo wystąpienia błędów i pomóc zrozumieć opcje kodu, dynamicznie sugerując możliwe wartości lub właściwości, biorąc pod uwagę położenie kursora.

Możesz również wyzwolić funkcję autouzupełniania w dowolnej lokalizacji, naciskając Ctrl+Spacja.

Podpowiedzi

Etykietka narzędzia kontekstowego jest wyświetlana po umieszczeniu kursora myszy, podając informacje o każdym obiekcie lub właściwości TMDL.

Akcje kodu

Gdy kursor znajduje się na falistej linii lub wybranym tekście, w widoku TMDL jest wyświetlana ikona żarówki wskazująca dostępne akcje dotyczące kodu, takie jak generowanie tagów dziedziczenia lub poprawianie literówek w nazwach właściwości.

Formatowanie kodu

Sformatuj kod TMDL, naciskając Shift + Alt + F lub klikając opcję Format na wstążce.

Możesz także sformatować zaznaczony tekst, korzystając z opcji "Formatuj zaznaczenie" w menu kontekstowym.

Diagnostyka błędów

Wbudowana diagnostyka błędów edytora kodu ułatwia identyfikowanie i rozwiązywanie problemów przez wyróżnianie błędów języka TMDL w edytorze kodu ze szczegółowymi komunikatami, które zawierają wskazówki dotyczące ich rozwiązywania. Ponadto podsumowanie błędu jest dostępne w okienku Problemy, co umożliwia łatwe nawigowanie po lokalizacji błędu w edytorze kodu, jak pokazano na poniższej ilustracji.

Stosowanie zmian do modelu semantycznego

Gdy wszystko będzie gotowe, możesz wybrać przycisk Zastosuj , aby wykonać skrypt TMDL względem modelu semantycznego i zastosować zmiany kodu TMDL.

Kiedy się powiedzie, zostanie wyświetlone powiadomienie, a zmiany modelowania zostaną zastosowane do modelu semantycznego.

W przypadku awarii zostanie wyświetlone powiadomienie o błędzie, aby pokazać, że zmiany modelowania nie zostały zastosowane do modelu semantycznego. Aby wyświetlić więcej informacji o błędzie, wybierz link Pokaż szczegóły w powiadomieniu, który następnie rozwija okienko Dane wyjściowe i wyświetla szczegóły błędu.

Notatka

Widok TMDL modyfikuje tylko metadane modelu semantycznego bez odświeżania danych ani wpływu na raport. Jeśli zmiany wymagają odświeżenia danych, takiego jak zmiana wyrażenia PowerQuery lub wyrażenia kolumny obliczeniowej, należy ręcznie odświeżyć tabelę lub model, aby zmiany zaczęły obowiązywać. Ponadto zmiana nazwy pola w widoku TMDL może spowodować przerwanie wizualizacji w raporcie, które używają tego pola.

Podgląd zmian w modelu semantycznym

Widok TMDL umożliwia wyświetlanie podglądu zmian skryptów przez pokazanie modelu semantycznego przed i po wykonaniu skryptu, co jest wyświetlane jako różnice w kodzie TMDL. Podgląd zmian skryptów jest szczególnie przydatny podczas kopiowania skryptów z innych źródeł, umożliwiając ocenę ich wpływu przed uruchomieniem ich względem modelu semantycznego.

Wybranie przycisku Podgląd powoduje wyświetlenie różnicy TMDL modelu semantycznego przed i po wykonaniu skryptu TMDL na otwartej karcie.

W okienku po prawej stronie zostanie wyświetlone okno obok siebie, jak pokazano na poniższej ilustracji.

Czerwone i zielone pola podkreślają zmiany, z czerwonymi polami oznaczonymi usuniętymi lub zmienionymi liniami oraz zielonymi wskazującymi nowe linie.

Notatka

Porównanie nie jest bezpośrednio względem aktualnie wyświetlanego skryptu TMDL, ale raczej kompleksowego porównania modelu semantycznego przed wykonaniem skryptu i po nim. Dlatego niektóre właściwości mogą być uporządkowane inaczej niż to, co jest wyświetlane na karcie, przylegając do domyślnej kolejności właściwości/obiektu TMDL.

Wersja zapoznawcza jest tylko do odczytu, ale możesz nadal edytować skrypt. Aby odświeżyć podgląd po zmianach, wybierz przycisk Aktualizuj podgląd , jak pokazano na banerze na poniższej ilustracji.

W prawym górnym rogu ekranu podglądu znajduje się pasek narzędzi, który umożliwia nawigację wszystkich różnic kodu, umożliwiając przełączanie się między różnicami w tekście lub obok siebie , wyświetlaniem lub ukrywaniem niezmienionych regionów oraz zamykanie widoku podglądu.

Podczas przeglądania zmian w modelu semantycznym należy wziąć pod uwagę kilka zagadnień:

• Widok TMDL resetuje konfiguracje widoku na ustawienia domyślne przy każdym wykonaniu podglądu.
• Wersja zapoznawcza jest uruchamiana tylko z prawidłową zmianą TMDL. Nieprawidłowe skrypty TMDL nie będą wyświetlać podglądu, a w okienku wyników pojawi się błąd.

Karty skryptów języka TMDL

W widoku TMDL można jednocześnie mieć wiele kart skryptów, z których dowolna może zostać zmieniona lub usunięta.

Zawartość kart widoku TMDL jest zapisywana w pliku raportu podczas zapisywania raportu Power BI Desktop, dzięki czemu możesz kontynuować w miejscu, w którym ją przerwałeś, przy następnym otwarciu pliku raportu Power BI Desktop. Podczas zapisywania w projekcie usługi Power BI (PBIP) każda karta skryptu jest zapisywana jako plik tmdl w folderze \TMDLScripts , jak pokazano na poniższej ilustracji.

Napiwek

Skrypty języka TMDL można otwierać i edytować w programie Visual Studio Code. Po ponownym uruchomieniu programu Power BI Desktop będą one prawidłowo ładowane ponownie.

Okienka Problemy i dane wyjściowe wyświetlają błędy i komunikaty specyficzne dla aktualnie wybranej i wyświetlanej karty skryptu. Przełączenie do innej karty skryptu TMDL odświeża oba okienka z informacjami specyficznymi dla wybranej i aktualnie wyświetlanej karty.

Możesz wybrać przycisk Wyczyść , aby opróżnić komunikaty okienka Danych wyjściowych .

Komunikaty są przechowywane tylko dla każdej sesji programu Power BI Desktop, więc ponowne uruchomienie programu Power BI Desktop czyści wszystkie komunikaty wyjściowe dla wszystkich kart skryptów.

Komunikat o uaktualnieniu na poziomie zgodności

Poziom zgodności modelu semantycznego usługi Power BI określa dostępne funkcje. Widok TMDL umożliwia dodanie dowolnego obiektu lub właściwości usług Analysis Services, nawet jeśli nie jest dostępny na bieżącym poziomie zgodności. Podczas stosowania zmiany, która wymaga uaktualnienia poziomu zgodności, widok TMDL wyświetla monit wskazujący, który obiekt lub obiekty wymagają uaktualnienia.

Zmiana nazwy obiektu za pomocą widoku TMDL

Aby zmienić nazwę obiektu w widoku TMDL, należy zaskryptować jego obiekt nadrzędny. Na przykład zmiana nazwy kolumny wymaga utworzenia skryptu tabeli, podczas gdy zmiana nazwy tabeli wymaga skryptów całego modelu semantycznego. Dowiedz się więcej o hierarchii modelu obiektów tabelarycznych w następującym dokumencie: Hierarchia modelu obiektów tabelarycznych.

W widoku TMDL można wydajnie przeprowadzić zmianę nazw zbiorczych przy użyciu prostych wzorców znajdowania i zastępowania. Na przykład możesz zmienić nazwę wszystkich kolumn tabeli na małe litery, wykonując następujące kroki.

Otwórz widok TMDL, skrypt tabeli, którą zamierzasz zmodyfikować.

Naciśnij CTRL+F, aby otworzyć okno dialogowe 'Znajdź i zamień'. Upewnij się, że opcja 'Wyrażenie regularne' jest włączona.

Wprowadź następujące wzorce w polach znajdź i zamień, a następnie wybierz pozycję Zamień wszystko.

Akcja	Wzorzec/wymiana
Znajdź	(^\s+column\s+)(.+)
Zamień	$1\L$2

Uruchom skrypt TMDL, aby natychmiast zmienić nazwę wszystkich kolumn tabeli na małe litery:

Zwróć uwagę, że nazwa kolumny różni się od właściwości sourceColumn.

Synchronizacja między semantyczną tabelą modelu a zapytaniem Power Query opiera się na kolumnie sourceColumn, zachowując niezależne nazwy. Po otwarciu edytora Power Query zostaną wyświetlone nazwy kolumn, które pasują do kolumny sourceColumn, a nie nazwy kolumny modelu. Ponadto zmiana nazwy kolumny w interfejsie użytkownika nie spowoduje automatycznego dodania kroku zmiany nazwy do zapytania, dopóki nazwa kolumny źródłowej i kolumny nie będą identyczne.

Widok TMDL i projekt usługi Power BI

Podczas zapisywania pracy jako projektu usługi Power BI (PBIP) uzyskujesz dostęp do metadanych definicji modelu semantycznego jako plików TMDL, zapewniając przydatną kontrolę źródła i współtworzenie, a jednocześnie umożliwiając wprowadzanie zmian w modelu semantycznym poza programem Power BI Desktop. Jeśli jednak zmodyfikujesz pliki TMDL w usłudze PBIP, musisz ponownie uruchomić program Power BI Desktop, aby ponownie załadować te zmiany. Z kolei widok TMDL jest zgodny z modelem mentalnym skryptów, który umożliwia efektywne stosowanie zmian bezpośrednio do modelu semantycznego edytowanego w programie Power BI Desktop przy użyciu języka TMDL, niezależnie od tego, czy format pliku to PBIX, czy PBIP.

Możesz bezproblemowo zintegrować oba środowiska. Na przykład możesz zaktualizować definicję języka TMDL w usłudze PBIP, aby szybko wprowadzić zmiany bez uruchamiania programu Power BI Desktop, i użyć widoku TMDL, gdy program Power BI Desktop jest już otwarty, aby efektywnie wdrożyć serię zmian w modelu semantycznym przy użyciu języka TMDL. Oba podejścia oferują bogate i spójne środowisko kodowania TMDL.

Typowe przypadki użycia widoku TMDL

Scenariusz: Chcę ponownie użyć lub udostępnić tabelę modelu semantycznego z pełną definicją, w tym kolumnami, wyrażeniem Power Query i sortowaniem według konfiguracji, a także innymi w innym modelu semantycznym.

Rozwiązanie: Otwórz model semantyczny z tabelą, a następnie utwórz skrypt przy użyciu widoku TMDL. Skopiuj skrypt do innego okna programu Power BI Desktop, otwórz kartę Widok TMDL i zastosuj skrypt.

---

Scenariusz: Ja nazwałem wszystkie moje tabele prefiksami "dim_" lub "fact_". Chcę usunąć te prefiksy bez ręcznego aktualizowania każdej z ponad 100 tabel.

Rozwiązanie: Otwórz widok TMDL, utwórz skrypt modelu semantycznego, wyszukaj prefiks (obsługiwane są wyrażenia regularne) i zastąp go pustym tekstem.

---

Scenariusz: Chcę utworzyć perspektywę w moim modelu semantycznym, aby korzystać z funkcji spersonalizowanych wizualizacji. Nie mogę jednak utworzyć ani edytować go przy użyciu interfejsu graficznego programu Power BI Desktop.

Rozwiązanie: Otwórz widok TMDL, utwórz nową pustą kartę (lub użyj skryptu z istniejącej perspektywy), a następnie utwórz lub edytuj perspektywę przy użyciu języka TMDL. Ta metoda dotyczy również innych metadanych modelu semantycznego, które nie mają interfejsu graficznego, takich jak tłumaczenia, wyrażenia wierszy szczegółów i inne.

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

---

Scenariusz: Muszę zmodyfikować wyrażenie Power Query dotyczące mojej tabeli bez wyzwalania odświeżania.

Rozwiązanie: Utwórz skrypt tabeli, zmodyfikuj wyrażenie Dodatku Power Query i zastosuj zmiany. Widok TMDL nie wymaga odświeżania danych.

---

Scenariusz: Chcę przełączyć tryb przechowywania tabeli z trybu DirectQuery na import i na odwrót

Rozwiązanie: Utwórz skrypt tabeli, zaktualizuj tryb partycji i zastosuj zmiany.

---

Scenariusz: Muszę utworzyć kopię zapasową definicji modelu semantycznego przed wprowadzeniem znaczących zmian i w razie potrzeby łatwo przywrócić poprzednią definicję.

Rozwiązanie: Wykonaj skrypt modelu semantycznego lub określonych części, które chcesz utworzyć kopię zapasową, wprowadź zmiany w innych widokach i w razie potrzeby wróć do widoku TMDL, aby przywrócić poprzednie metadane, uruchamiając zapisany skrypt.

---

Zagadnienia i ograniczenia

Widok TMDL jest obecnie w wersji zapoznawczej, dlatego należy pamiętać o następujących ograniczeniach:

• Widok TMDL umożliwia edytowanie dowolnego obiektu lub właściwości w modelu semantycznym. Jednak niekompletne lub nieprawidłowe modyfikacje mogą prowadzić do nieoczekiwanego zachowania. Aby uzyskać więcej wskazówek dotyczących tych operacji, zapoznaj się z artykułem Tworzenie modelu.
• Paleta poleceń wyświetla niektóre polecenia, które nie są obecnie obsługiwane.
• Skonfigurowanie początkowej integracji usługi Git z obszaru roboczego nie będzie obejmować skryptów widoku TMDL zapisanych w opublikowanym modelu semantycznym. Dowiedz się więcej w artykule Fabric Integration (Integracja z usługą Git w usłudze Fabric).
• Nie można tworzyć skryptów dla grup w eksploratorze modeli, takich jak Miary, Kolumny itd.

Powiązana zawartość

W poniższych artykułach opisano więcej informacji na temat języka TMDL i jego zastosowań.

• Wprowadzenie do języka TMDL
• Tabelaryczny język definicji modelu (TMDL)
• Projekty programu Power BI Desktop (wersja zapoznawcza)
• Folder semantycznego modelu projektu programu Power BI Desktop