Udostępnij za pośrednictwem

Projekty programu Power BI Desktop (WERSJA ZAPOZNAWCZA)

Ważne

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

Napiwek

Aby uzyskać wskazówki dotyczące planowania programowania w usłudze Power BI, zobacz Planowanie implementacji usługi Power BI.

Program Power BI Desktop wprowadza nowy sposób tworzenia, współpracy i zapisywania projektów. Podczas zapisywania pracy jako projektu usługi Power BI (PBIP) definicje elementów raportu i semantycznego modelu są zapisywane jako pojedyncze pliki zwykłego tekstu w prostej, intuicyjnej strukturze folderów.

Zapisanie pracy jako projektu ma następujące korzyści:

  • Obsługa edytora tekstu — pliki PBIP są formatowane pliki tekstowe zawierające semantyczny model i metadane raportu. Te pliki są publicznie udokumentowane i czytelne dla człowieka. Chociaż pliki projektu obsługują proste narzędzia do edycji tekstu, takie jak Notatnik, lepiej jest użyć edytora kodu, takiego jak Visual Studio Code (VS Code), który zapewnia zaawansowane środowisko edycji, w tym funkcję IntelliSense, walidację i integrację z usługą Git.

  • Przezroczystość struktury folderów — oddzielne foldery dla modelu semantycznego i raportu, umożliwiając zaawansowane, ale proste zadania, takie jak kopiowanie tabel modelu semantycznego między projektami lub ponowne korzystanie ze stron raportu. Doskonały wybór do tworzenia i ponownego tworzenia szablonów programistycznych.

  • Kontrola wersji gotowa — pliki tekstowe, przeznaczone do bezproblemowej integracji z usługą Git, umożliwiających śledzenie historii wersji oraz współpracę zespołową. Aby dowiedzieć się więcej, zobacz Kontrola wersji w usłudze Git.

  • Obsługa ciągłej integracji i ciągłego dostarczania (CI/CD) — stosowanie praktyk ciągłej integracji/ciągłego wdrażania na podstawie istniejących systemów kontroli źródła przy użyciu plików PBIP, obejmujących bramy jakości i automatyzowanie wdrażania w środowiskach produkcyjnych. Aby dowiedzieć się więcej na temat CI/CD w Fabric, zobacz Przepływy pracy CI/CD w Fabric.

  • programowe generowanie i edytowanie definicji elementów — można programowo generować i modyfikować pliki tekstowe definicji elementu, włączając operacje wsadowe, takie jak aktualizowanie wszystkich wizualizacji stron raportu lub dodawanie zestawu miar do każdej tabeli. W przypadku modeli semantycznych można użyć tabelarycznego modelu obiektów (TOM) biblioteki klienta, aby deserializować metadane modelu semantycznego, wprowadzać modyfikacje programowe i serializować je z powrotem do plików.

Włącz funkcje w wersji zapoznawczej

Zapisywanie jako projekt usługi Power BI w programie Power BI Desktop jest obecnie w wersji zapoznawczej i należy je włączyć w funkcjach w wersji zapoznawczej.

Przejdź do pozycji Opcje plików > i ustawienia > Opcje > w wersji zapoznawczej i zaznacz pole wyboru obok opcji zapisywania programu Power BI Project (pbip).

Zapisywanie jako projekt

Jeśli pracujesz nad nowym projektem lub otwarto istniejący plik programu Power BI Desktop (pbix), możesz zapisać pracę jako plik projektu usługi Power BI (pbip):

Zrzut ekranu przedstawiający zapisywanie pliku jako projektu usługi Power BI

Podczas zapisywania jako projektu program Power BI Desktop zapisuje elementy raportu i semantycznego modelu jako foldery, z których każdy zawiera pliki tekstowe definiujące element:

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

Przyjrzyjmy się bliżej temu, co widzisz w folderze głównym projektu:

<nazwa> projektu. SemanticModel

Kolekcja plików i folderów reprezentujących model semantyczny usługi Power BI. Aby dowiedzieć się więcej o plikach i podfolderach i plikach w tym miejscu, zobacz folder Project Semantic Model.

<nazwa> projektu. Sprawozdanie

Kolekcja plików i folderów reprezentujących raport usługi Power BI. Aby dowiedzieć się więcej o plikach i podfolderach i plikach w tym miejscu, zobacz Folder raportu projektu.

.gitIgnore - plik konfiguracyjny służący do określania, które pliki i katalogi powinny być ignorowane przez system kontroli wersji git.

Określa celowo nieśledzone pliki Git powinny być ignorowane dla plików programu Power BI Project, takich jak cache.abf i localSettings.json.

Program Power BI Desktop tworzy plik gitignore tylko wtedy, gdy jeszcze nie istnieje w wybranym folderze zapisywania lub nadrzędnym repozytorium Git.

Domyślna zawartość pliku gitignore podczas zapisywania jako PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<nazwa> projektu.pbip

Plik PBIP zawiera wskaźnik do folderu raportu, otwarcie pliku PBIP otwiera docelowy raport i model do tworzenia.

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

Otwieranie projektu usługi Power BI

Program Power BI Desktop można otworzyć z folderu programu Power BI Project, otwierając plik pbip lub plik pbir w folderze raportu. Obie opcje otwierają raport do edycji i semantyczny model, jeśli istnieje względne odwołanie do modelu semantycznego.

Można zapisać wiele raportów i modeli semantycznych w tym samym folderze. Posiadanie oddzielnego pliku pbip dla każdego raportu nie jest wymagane, ponieważ można otworzyć każdy raport bezpośrednio z pliku pbir w folderze raportu.

project/
├── AdventureWorks-Sales.Report/
│   └── definition.pbir
├── AdventureWorks-Stocks.Report/
│   └── definition.pbir
├── AdventureWorks.SemanticModel/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

Po zapisaniu jako projektu możesz zobaczyć, kiedy pracujesz nad projektem, przeglądając pasek tytułu:

Zrzut ekranu przedstawiający tytuł programu Power BI Desktop podczas zapisywania w projekcie.

Jeśli wybierzesz pasek tytułu, zostanie wyświetlone okno wysuwane specyficzne dla projektu usługi Power BI. To okno wysuwane umożliwia zlokalizowanie plików projektu oraz ustawień nazwy wyświetlanej raportu i modelu semantycznego. Folder można również otworzyć w Eksploratorze plików, klikając ścieżki.

Zrzut ekranu przedstawiający wysuwane okno wysuwane tytułu programu Power BI Desktop.

Zmiany poza programem Power BI Desktop

Po zapisaniu jako projektu nie musisz wprowadzać zmian w semantycznym modelu i definicjach raportów tylko w programie Power BI Desktop. Możesz użyć innych narzędzi, takich jak VS Code, narzędzia społeczności typu open source, takie jak Edytor tabelaryczny, a nawet Notatnik. Jednak nie każdy plik lub zmiana obsługuje edycję za pomocą zewnętrznych narzędzi typu open source.

Zmiany plików lub właściwości spoza programu Power BI Desktop mogą powodować nieoczekiwane błędy, a nawet uniemożliwić otwieranie programu Power BI Desktop. W takich przypadkach należy rozwiązać problemy z plikami przed ponownym otwarciem projektu w programie Power BI Desktop.

Jeśli to możliwe, program Power BI Desktop wskazuje plik i lokalizację błędu:

Zrzut ekranu uniemożliwiający otwarcie pliku.

Szczegóły schematu dla następujących plików nie są udokumentowane. Podczas podglądu zmiany tych plików poza programem Power BI Desktop nie są obsługiwane:

Wdróż do obszaru roboczego Fabric

Podczas pracy z projektami Power BI możesz wdrożyć zawartość w obszarze roboczym Fabric przy użyciu następujących mechanizmów publikowania:

  • Użyj Fabric Git Integration.
  • Użyj interfejsów API Fabric .
  • Użyj opcji publikowania programu Power BI Desktop.

Notatka

Publikowanie za pomocą programu Power BI Desktop używa tymczasowego pliku PBIX, który jest publikowany w usłudze, podobnie jak w przypadku zapisywania i publikowania pliku PBIX. W przeciwieństwie do innych opcji wdrażania usługi PBIP, które wdrażają tylko metadane, ta metoda publikowania wdraża zarówno metadane, jak i lokalnej pamięci podręcznej danych edytowanego modelu semantycznego.

Tworzenie modelu

Możesz wprowadzić zmiany w definicji modelu semantycznego przy użyciu narzędzi zewnętrznych na dwa sposoby:

  • Łącząc się z wystąpieniem usługi Analysis Service (AS) programu Power BI Desktop za pomocą narzędzi zewnętrznych.
  • Edytując metadane języka TMDL w folderze /definition przy użyciu programu VS Code lub innego narzędzia zewnętrznego.

Wszystkie metadane modelu semantycznego są dostępne do odczytu. Operacje zapisu są w pełni obsługiwane, jednak należy pamiętać, że modyfikowanie metadanych poza programem Power BI Desktop może spowodować nieoczekiwane zachowanie lub, w rzadkich przypadkach, prowadzić do niespójności w modelu. Należy zachować ostrożność podczas wprowadzania zmian za pośrednictwem narzędzi zewnętrznych.

Pamiętaj:

  • Wszelkie zmiany dotyczące otwierania plików wprowadzonych poza programem Power BI Desktop wymagają ponownego uruchomienia tych zmian, które mają być wyświetlane w programie Power BI Desktop. Program Power BI Desktop nie zna zmian w plikach projektu wprowadzonych przez inne narzędzia.

  • Automatyczne tabele dat utworzone przez program Power BI Desktop nie powinny być zmieniane przy użyciu narzędzi zewnętrznych.

  • Jeśli model semantyczny ma włączoną funkcję Automatyczna data/godzina i tworzysz nową kolumnę data/godzina poza programem Power BI Desktop, lokalna tabela dat nie jest generowana automatycznie.

  • Modele semantyczne — takie jak modele złożone lub Direct Lake — mogą obejmować obiekty i właściwości pochodzące z innych modeli lub źródeł danych. Podczas dostosowywania tych właściwości lub usuwania zsynchronizowanych obiektów usługa Power BI wymaga ustawienia właściwości changedProperties oraz adnotacji PBI_RemovedChildren. Te wskaźniki oznaczają zmiany jako dostosowania użytkownika, zapewniając ich zachowanie podczas następnej synchronizacji schematu ze źródłem danych. Aby dowiedzieć się więcej, zobacz Tagi pochodzenia dla modeli semantycznych usługi Power BI.

  • Wszystkie edycje wyrażeń wykonywane poza Power BI Desktop w projekcie z unappliedChanges.json zostaną utracone po zastosowaniu tych zmian.

Schematy plików JSON

Większość plików projektu zawiera metadane w formacie JSON. Odpowiednie schematy JSON mogą służyć do walidacji i dokumentacji.

Schematy JSON umożliwiają:

  • Dowiedz się więcej o konfigurowalnych właściwościach.
  • Użyj wbudowanej weryfikacji kodu JSON dostarczonej przez edytor kodu.
  • Ulepszanie tworzenia za pomocą wyróżniania składni, etykietek narzędzi i autouzupełniania.
  • Użyj narzędzi zewnętrznych z wiedzą na temat obsługiwanych właściwości w metadanych projektu.

Użyj programu VS Code, aby mapować schematy JSON na tworzone pliki. Schematy JSON dla plików projektu znajdują się w repozytorium Git json-schemas.

Rozważania i ograniczenia

  • Program Power BI Desktop nie zna zmian wprowadzonych w innych narzędziach lub aplikacjach. Zmiany wprowadzone przy użyciu narzędzi zewnętrznych wymagają ponownego uruchomienia programu Power BI Desktop przed pokazanymi zmianami.
  • Etykiety poufności nie są obsługiwane w projektach usługi Power BI.
  • Widok diagramu jest ignorowany podczas edytowania modeli w usłudze.
  • Podczas zapisywania jako projektu usługi Power BI maksymalna długość ścieżki plików projektu wynosi 260 znaków.
  • W programie Power BI Desktop nie można zapisać pliku PBIP bezpośrednio w usłudze OneDrive i programie SharePoint. Możesz użyć funkcji Zapisz jako , aby zapisać pliki w zsynchronizowanym lokalnie folderze usługi OneDrive; Może to jednak spowodować problemy z blokowaniem plików, co potencjalnie może prowadzić do niepowodzenia operacji zapisywania w programie Power BI Desktop.
  • Podczas edytowania plików PBIP poza programem Power BI Desktop należy je zapisać przy użyciu kodowania UTF-8 bez kodowania BOM.
  • Schemat językowy raportu nie jest obsługiwany w projektach usługi Power BI.
  • Program Power BI Desktop używa listy CRLF jako końca wiersza. Aby uniknąć problemów z różnicami, skonfiguruj usługę Git do obsługi zakończeń wierszy, włączając autocrlf.
  • Projekty usługi Power BI nie są obecnie obsługiwane w wersji programu Microsoft Power BI Desktop zoptymalizowanej pod kątem Serwer raportów usługi Power BI.

Często zadawane pytania

Pytanie: Patrząc na definicje semantycznego modelu i folderu elementów raportu tylko kilka plików jest oznaczonych jako wymagane, co się stanie w przypadku ich usunięcia?

Odpowiedź: Program Power BI Desktop automatycznie tworzy je podczas zapisywania jako projektu (PBIP).

Pytanie: Czy program Power BI Desktop ma świadomość zmian w plikach programu Power BI Project z zewnętrznego narzędzia lub aplikacji?

Odpowiedź: Nie. Wszelkie zmiany wprowadzone w plikach wymagają ponownego uruchomienia programu Power BI Desktop w celu odzwierciedlenia tych zmian.

Pytanie: Jeśli przekonwertuję plik PBIX na pbIP, czy mogę przekonwertować go z powrotem na pbIX?

Odpowiedź: Tak. Plik PBIX można zapisać jako plik PBIP lub zapisać element PBIP jako plik PBIX.

Pytanie: Czy można przekonwertować plik PBIX na pbIP i odwrotnie programowo?

Odpowiedź: Nie. Plik PBIX można przekonwertować tylko na plik PBIP i odwrotnie przy użyciu funkcji Zapisz plik

Pytanie: Czy mogę wdrożyć projekt programu Power BI Desktop w usługach Azure Analysis Services (AAS) lub SQL Server Analysis Services (SSAS)?

Odpowiedź: Nie. Definicje raportów projektu programu Power BI Desktop nie są obsługiwane w usługach AAS i SSAS. Definicje modeli używają rozszerzonych metadanych unikatowych dla usługi Power BI. W przypadku projektów usług AAS i SSAS użyj programu Microsoft Visual Studio do tworzenia modeli, usługi Git i integracji z usługą Azure DevOps.

Pytanie: Dlaczego nie ma pliku *.pbip podczas łączenia obszaru roboczego usługi Fabric z usługą Git? Jak mogę edytować mój raport i model semantyczny w programie Power BI Desktop?

Odpowiedź: Plik PBIP jest opcjonalny i po prostu służy jako skrót do folderu raportu. Możesz otworzyć zarówno raport, jak i model semantyczny do edycji w programie Power BI Desktop, otwierając plik definition.pbir znajdujący się w folderze raportu.

Powiązana zawartość