Folder semantycznego modelu projektu programu Power BI Desktop

Ważne

Projekty programu Power BI Desktop są obecnie dostępne w wersji zapoznawczej.

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:

• .pbi\
  • localSettings.json
  • editorSettings.json
  • cache.abf
  • unappliedChanges.json
• definition.pbism¹
• model.bim²
• definition\ folder³
• diagramLayout.json
• .podest

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.json

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.json

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 zawartością w pliku model.bim.

.pbi\unappliedChanges.json

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

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:

W przypadku wybrania pozycji Zastosuj zmiany program Power BI Desktop zastępuje zapytania w pliku model.bim zapytaniami z unappliedChanges.json. Jeśli edytowano zapytania w pliku model.bim 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ć ciągłą pracę w gałęzi deweloperów, służąc jako kopię zapasową i udostępniając 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.

definition.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 języka TMSL (Tabular Model Scripting Language) modelu projektu.

definition\ folder

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. W wersji zapoznawczej ten plik nie obsługuje edycji zewnętrznej.

.podest

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 Integracja usługi Git automatycznie wygenerowanych plików systemowych.

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 .

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.

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

Włączanie funkcji podglądu formatu TMDL

Zapisywanie jako projekt usługi Power BI przy użyciu języka TMDL jest obecnie dostępne w wersji zapoznawczej. Przed użyciem należy najpierw włączyć ją w funkcjach w wersji zapoznawczej:

Przejdź do pozycji Opcje plików > i ustawienia > Opcje > w wersji zapoznawczej i zaznacz pole wyboru obok pozycji Store semantic model using TMDL format (Zapisz model semantyczny przy użyciu formatu TMDL).

Zapisywanie jako projekt przy użyciu języka TMDL

Po włączeniu funkcji TMDL Preview podczas zapisywania projektu model semantyczny jest zapisywany jako folder TMDL o nazwie \definition wewnątrz folderu modelu semantycznego:

Dowiedz się więcej o strukturze folderów TMDL.

Konwertowanie istniejącej usługi PBIP na język TMDL

Jeśli masz już usługę PBIP przy użyciu języka TMSL jako format modelu semantycznego, możesz przekonwertować go na język TMDL w następujący sposób:

1. Otwórz usługę PBIP w programie Power BI Desktop.

2. Upewnij się, że funkcja w wersji zapoznawczej jest włączona.

3. Zapisz projekt. Zostanie wyświetlony monit z prośbą o uaktualnienie do języka TMDL.

4. Wybierz pozycję Uaktualnij.

   Ważne

   Po uaktualnieniu do języka TMDL nie można powrócić do języka TMSL. Jeśli uważasz, że warto wrócić do TMSL, najpierw zapisz kopię plików PBIP.

   

Istniejący plik TMSL (Tabular Model Scripting Language) (model.bim) jest zastępowany folderem \definition zawierającym reprezentację języka TMDL modelu semantycznego.

Jeśli wybierzesz opcję Zachowaj bieżący format, program Desktop nie wyświetli monitu o uaktualnienie.

Wprowadzanie zewnętrznych zmian w plikach TMDL

Aby uzyskać lepsze środowisko odczytu i edytowania plików TMDL, zainstaluj rozszerzenie TMDL — Visual Studio Marketplace programu Microsoft VS Code.

Otwórz folder PBIP przy użyciu programu VS Code i przejdź do folderu definicji modelu semantycznego.

Program Power BI Desktop nie zna zmian w plikach projektu wprowadzonych przez inne narzędzia. W związku z tym w przypadku wprowadzania zmian w otwieraniu plików spoza programu Power BI Desktop należy ponownie uruchomić, aby te zmiany były wyświetlane w programie Power BI Desktop.

Zapoznaj się z tym artykułem, aby zapoznać się z obsługiwanymi operacjami zapisu poza programem Power BI Desktop.

Błędy języka TMDL

Jeśli w plikach TMDL zostaną wprowadzone nieprawidłowe zmiany, program Power BI Desktop zgłasza błąd podczas otwierania z lokalizacją błędu:

Zagadnienia i ograniczenia języka TMDL

W publicznej wersji zapoznawczej integracja z usługą Git w sieci szkieletowej nadal będzie domyślnie eksportować model semantyczny przy użyciu języka TMSL. Jeśli jednak model semantyczny zostanie zaimportowany do sieci szkieletowej przy użyciu formatu Git Integration with TMDL, usługa Fabric Git Integration użyje formatu TMDL, aby wyeksportować definicję modelu semantycznego do usługi Git, jeśli w usłudze wprowadzono jakiekolwiek zmiany modelu semantycznego.

Ważne

Jeśli zaimportujesz model semantyczny przy użyciu dowolnej innej metody importowania, takiej jak Publikowanie w programie Power BI Desktop, integracja z usługą Fabric Git powróci do domyślnego formatu TMSL.

Powiązana zawartość

• Folder raportu projektu programu Power BI Desktop
• Projekty programu Power BI Desktop
• Język TMSL (Tabular Model Scripting Language)