Folder semantycznego modelu projektu programu Power BI Desktop

W tym artykule opisano pliki i podfoldery w folderze Semantic Model projektu programu Microsoft Power BI Desktop. Pliki i podfoldery w tym miejscu reprezentują semantyczny model usługi Power BI. W zależności od projektu folder modelu semantycznego może zawierać następujące elementy:

1 — Ten plik jest wymagany.
2 — Ten plik jest wymagany podczas zapisywania przy użyciu formatu TMSL.
3 — Ten plik jest wymagany podczas zapisywania przy użyciu formatu TMDL.

Nie każdy folder modelu semantycznego projektu zawiera wszystkie pliki i podfoldery opisane tutaj.

Pliki modelu semantycznego

.pbi\localSettings.jsna

Zawiera ustawienia modelu semantycznego, które mają zastosowanie tylko dla bieżącego użytkownika i komputera. Powinien zostać uwzględniony w repozytorium gitIgnore lub w innych wykluczeniach kontroli źródła. Domyślnie usługa Git ignoruje ten plik.

Aby uzyskać więcej informacji, zobacz dokument schematu localSettings.json.

.pbi\editorSettings.jsna

Zawiera ustawienia edytora semantycznego modelu zapisane w ramach semantycznej definicji modelu do użycia między użytkownikami i środowiskami.

Aby uzyskać więcej informacji, zobacz dokument schematu editorSettings.json.

.pbi\cache.abf

Plik kopii zapasowej usług Analysis Services (ABF) zawierający lokalną buforowaną kopię modelu i dane po ostatniej edycji. Powinien zostać uwzględniony w repozytorium gitIgnore lub w innych wykluczeniach kontroli źródła. Domyślnie usługa Git ignoruje ten plik.

Program Power BI Desktop może otwierać projekt bez pliku cache.abf. W takim przypadku otwiera raport połączony z modelem z całą definicją, ale bez danych. Jeśli istnieje plik cache.abf, program Power BI Desktop ładuje dane i zastępuje definicję modelu metadanymi modelu semantycznego w projekcie.

.pbi\unappliedChanges.jsna

Program Power BI Desktop umożliwia zapisywanie zmian wprowadzonych w edytorze przekształcania danych (Power Query) bez uprzedniego stosowania tych zmian w modelu danych.

Obraz przedstawiający okno dialogowe Stosowanie zmiany zapytania.

Po wybraniu pozycji Zastosuj później niezastosowane zmiany zostaną zapisane w pliku unappliedChanges.json. Gdy oczekujące zmiany znajdują się w pliku unappliedChanges, program Power BI Desktop wyświetli monit o zastosowanie lub odrzucenie tych oczekujących zmian:

Obraz przedstawiający ostrzeżenie o oczekujących zmianach.

W przypadku wybrania pozycji Zastosuj zmiany program Power BI Desktop zastępuje zapytania w metadanych modelu semantycznego przy użyciu zapytań z unappliedChanges.json. Jeśli edytowano zapytania poza programem Power BI Desktop i istnieje poprzedni plik unappliedChanges.json, zmiany zostaną utracone i zastąpione zapytaniami w unappliedChanges.json po zastosowaniu tych zmian.

Plik unappliedChanges.json jest automatycznie dołączany do semantycznej definicji modelu i domyślnie zapisywany w usłudze Git. Dzięki temu możesz zatwierdzić swoją będącą w toku pracę w gałęzi rozwojowej, co zapewnia kopię zapasową i udostępnia ją innym członkom zespołu. Można jednak wykluczyć ten plik ze śledzenia usługi Git, uniemożliwiając niedokończone prace zapytań wpływające na innych deweloperów.

Aby uzyskać więcej informacji, zobacz dokument schematu unappliedChanges.json.

definicja.pbism

Zawiera ogólną definicję semantycznego modelu i ustawień podstawowych.

Ten plik określa również obsługiwane formaty definicji modelu semantycznego za pomocą właściwości "version".

Wersja Obsługiwane formaty
1.0 Definicja modelu semantycznego musi być przechowywana jako TMSL w pliku model.bim.
4.0 lub nowsze Definicję modelu semantycznego można przechowywać jako TMSL (plik model.bim) lub TMDL (\definition folder).

Aby uzyskać więcej informacji, zobacz dokument schematu definition.pbism.

model.bim

Ten plik jest dostępny tylko wtedy, gdy projekt usługi Power BI jest zapisywany przy użyciu formatu TMSL. Zawiera definicję obiektu bazy danych modelu projektu w języku TMSL (Tabular Model Scripting Language).

katalog definicji

Ten folder jest dostępny tylko wtedy, gdy projekt usługi Power BI jest zapisywany przy użyciu formatu TMDL. Zastępuje plik model.bim .

Ten folder zawiera definicję obiektu bazy danych języka TMDL (Tabular Model Definition Language)modelu projektu.

diagramLayout.json

Zawiera metadane diagramu definiujące strukturę modelu semantycznego skojarzonego z raportem. Nie można edytować tego pliku zewnętrznie.

.platforma

Plik platformy sieci szkieletowej, który zawiera właściwości niezbędne do ustanawiania i obsługi połączenia między elementami sieci szkieletowej i usługą Git.

Aby dowiedzieć się więcej, zobacz automatycznie generowane pliki przez integrację z Git.

Folder DAXQueries\

Zawiera plik dla każdej karty widoku zapytania DAX zapisanej [Tab name].dax jako plik DAX.

.pbi\daxQueries.json

Zawiera ustawienia edytora widoków zapytań języka DAX , takie jak domyślnatab lub kolejność tabulacji.

Folder TMDLScripts\

Zawiera plik dla każdej karty skryptu widoku TMDL zapisanej [Tab name].tmdl jako plik TMDL.

.pbi\tmdlscripts.json

Zawiera ustawienia edytora widoków TMDL , takie jak domyślnatab lub kolejność tabulacji.

Format TMDL

W celu zapewnienia lepszej kontroli źródła i współtworzenia można zapisać pliki programu Power BI Project (PBIP) przy użyciu języka TMDL (Tabular Model Definition Language) jako formatu pliku modelu semantycznego.

W przeciwieństwie do języka TMSL (Tabular Model Scripting Language), język TMDL został zaprojektowany od podstaw, aby był przyjazny dla człowieka, ułatwiając nie tylko czytelność , ale także łatwe edytowanie w dowolnym edytorze tekstów. Stanowi to znaczne ulepszenie środowiska kontroli źródła i współpracy w zakresie programowania .

Zrzut ekranu przedstawiający przyjazne różnice języka TMDL.

Zamiast dużego pliku JSON, takiego jak Tabular Model Scripting Language (TMSL), język TMDL ma strukturę folderów z oddzielnymi plikami dla każdej tabeli, perspektywy, roli i kultury. Ułatwia to pracę z innymi osobami i zrozumienie struktury modelu semantycznego, patrząc tylko na folder i pliki. Ostatecznie prowadzi to do doskonałego środowiska kontroli źródła i współprogramowania podczas radzenia sobie z konfliktami różnic git i scalania.

Zrzut ekranu przedstawiający różnice TMDL modelu semantycznego.

Dowiedz się więcej o języku TMDL tutaj.

Wprowadzanie zewnętrznych zmian w plikach TMDL

Pliki TMDL można edytować w Visual Studio Code lub innym narzędziu zewnętrznym, gdy projekt pozostaje otwarty w programie Power BI Desktop. Aby uzyskać lepsze środowisko edycji języka TMDL, zainstaluj rozszerzenie TMDL dla Visual Studio Code.

Przed zewnętrzną edycją plików zapisz wszelkie zmiany w programie Power BI Desktop. Otwórz folder PBIP w programie VS Code, przejdź do folderu modelu definition semantycznego i zapisz zmiany TMDL. Power BI Desktop wykrywa zapisane zmiany i wyświetla transparent Zastosuj zmiany zewnętrzne. Wybierz pozycję Zastosuj zmiany zewnętrzne , aby ponownie załadować model semantyczny bez zamykania i ponownego otwierania projektu.

Zrzut ekranu przedstawiający folder definicji modelu semantycznego w programie VS Code.

Jeśli Power BI Desktop ma niezapisane zmiany, ostrzega, że zastosowanie zmian zewnętrznych spowoduje ich zastąpienie. Aby uzyskać pełny przepływ pracy i ograniczenia, zobacz Edytowanie plików PBIP poza programem Power BI Desktop.

Aby uzyskać informacje o obsługiwanych operacjach zapisu poza programem Power BI Desktop, zobacz Tworzenie modelu.

Błędy TMDL

Jeśli edycja TMDL jest nieprawidłowa, Power BI Desktop wyświetla błąd podczas stosowania zmian zewnętrznych lub otwierania projektu. Błąd identyfikuje lokalizację, którą należy naprawić, zanim program Power BI Desktop może załadować zaktualizowany model semantyczny:

Zrzut ekranu przedstawiający komunikat o błędzie nieprawidłowego pliku.

Powiązana zawartość

  • Last updated on