Proyek Power BI Desktop (PRATINJAU)

2025-06-10

Penting

Proyek Power BI Desktop saat ini dalam pratinjau.

Petunjuk / Saran

Untuk panduan tentang cara merencanakan pengembangan Power BI, lihat Perencanaan implementasi Power BI.

Power BI Desktop memperkenalkan cara baru untuk menulis, berkolaborasi, dan menyimpan proyek Anda. Saat Anda menyimpan pekerjaan Anda sebagai Proyek Power BI (PBIP), definisi item model semantik dan laporan disimpan sebagai file teks biasa individual dalam struktur folder yang sederhana dan intuitif.

Menyimpan pekerjaan Anda sebagai proyek memiliki manfaat berikut:

Dukungan editor teks - File PBIP diformat file teks yang berisi model semantik dan metadata laporan. File-file ini didokumenkan secara publik dan dapat dibaca manusia. Meskipun file proyek mendukung alat pengeditan teks sederhana seperti Notepad, lebih baik menggunakan editor kode seperti Visual Studio Code (VS Code), yang memberikan pengalaman pengeditan yang kaya termasuk intellisense, validasi, dan integrasi Git.
Transparansi struktur folder - Folder terpisah untuk model semantik dan laporan, memungkinkan tugas yang kuat namun sederhana seperti menyalin tabel model semantik antara proyek atau menggunakan kembali halaman laporan. Pilihan yang bagus untuk membuat dan menggunakan kembali templat pengembangan.
Siap kontrol sumber - Buka file teks, dirancang untuk integrasi yang mulus dengan Git, memungkinkan riwayat versi dan kolaborasi tim. Untuk mempelajari selengkapnya, lihat Kontrol versi di Git.
Dukungan Integrasi Berkelanjutan dan Pengiriman Berkelanjutan (CI/CD) - Menerapkan praktik CI/CD di atas sistem kontrol sumber yang ada menggunakan file PBIP, menggabungkan gerbang kualitas dan mengotomatiskan penyebaran ke lingkungan produksi. Untuk mempelajari selengkapnya tentang CI/CD di Fabric, lihat Alur kerja Fabric CI/CD.
Pembuatan terprogram dan mengedit definisi item - Anda dapat membuat dan memodifikasi file teks definisi item secara terprogram, memungkinkan operasi batch seperti memperbarui semua visual halaman laporan atau menambahkan serangkaian pengukuran ke setiap tabel. Untuk model semantik, Anda dapat menggunakan Tabular Object Model (TOM) pustaka klien untuk mendeserialisasi metadata model semantik, membuat modifikasi terprogram, dan menserialisasikannya kembali ke file.

Aktifkan fitur pratinjau

Menyimpan sebagai Proyek Power BI di Power BI Desktop saat ini dalam pratinjau, dan Anda harus mengaktifkannya di fitur Pratinjau.

Buka Opsi File > dan pengaturan > Opsi > Fitur pratinjau dan centang kotak di samping opsi simpan Proyek Power BI (.pbip).

Simpan sebagai proyek

Jika Anda sedang mengerjakan proyek baru atau membuka file Power BI Desktop (pbix) yang sudah ada, Anda bisa menyimpan pekerjaan Anda sebagai file proyek Power BI (pbip):

Ambil layar memperlihatkan simpan file sebagai Proyek Power BI

Saat Anda menyimpan sebagai proyek, Power BI Desktop menyimpan laporan dan item model semantik sebagai folder, masing-masing berisi file teks yang menentukan item:

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

Mari kita lihat lebih dekat apa yang Anda lihat di folder akar proyek Anda:

<nama> proyek. SemanticModel

Kumpulan file dan folder yang mewakili model semantik Power BI. Untuk mempelajari selengkapnya tentang file dan subfolder dan file di sini, lihat folder Model Semantik Proyek.

<nama> proyek. Lapor

Kumpulan file dan folder yang mewakili laporan Power BI. Untuk mempelajari selengkapnya tentang file dan subfolder dan file di sini, lihat Folder laporan proyek.

.gitIgnore

Menentukan file yang sengaja tidak dilacak yang harus diabaikan Git untuk file Proyek Power BI, seperti cache.abf dan localSettings.json.

Power BI Desktop membuat file .gitignore hanya jika belum ada di folder penyimpanan yang dipilih atau repositori Git induk.

Konten default .gitignore saat menyimpan sebagai PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf

<project name.pbip>

File PBIP berisi penunjuk ke folder laporan, membuka PBIP membuka laporan dan model yang ditargetkan untuk penulisan.

Untuk informasi selengkapnya, lihat dokumen skema pbip.

Membuka Proyek Power BI

Anda dapat membuka Power BI Desktop dari folder Proyek Power BI baik dengan membuka file pbip atau file pbir di folder laporan. Kedua opsi membuka laporan untuk pengeditan, dan model semantik, jika ada referensi relatif ke model semantik.

Anda dapat menyimpan beberapa laporan dan model semantik ke folder yang sama. Memiliki file pbip terpisah untuk setiap laporan tidak diperlukan karena Anda dapat membuka setiap laporan langsung dari .pbir dalam folder laporan.

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

Menavigasi ke file

Setelah menyimpan sebagai proyek, Anda dapat melihat kapan Anda mengerjakan proyek dengan melihat bilah judul:

Cuplikan layar memperlihatkan judul Power BI Desktop saat menyimpan ke proyek.

Jika Anda memilih bilah judul, flyout akan muncul yang khusus untuk Proyek Power BI. Flyout ini memungkinkan Anda menemukan file proyek dan pengaturan nama tampilan untuk laporan dan model semantik. Anda juga dapat membuka folder di penjelajah file dengan mengklik jalur.

Cuplikan layar memperlihatkan flyout judul Power BI Desktop.

Perubahan di luar Power BI Desktop

Saat disimpan sebagai proyek, Anda tidak dipaksa untuk membuat perubahan pada model semantik Anda dan melaporkan definisi hanya di Power BI Desktop. Anda dapat menggunakan alat lain seperti Visual Studio Code, alat komunitas sumber terbuka seperti Editor Tabular, atau bahkan Notepad. Namun, tidak setiap file atau perubahan mendukung pengeditan dengan alat sumber terbuka eksternal.

Perubahan pada file atau properti di luar Power BI Desktop dapat menyebabkan kesalahan tak terduga, atau bahkan mencegah Power BI Desktop terbuka. Dalam kasus tersebut, Anda harus mengatasi masalah dalam file sebelum mencoba membuka proyek lagi di Power BI Desktop.

Jika memungkinkan, Power BI Desktop menunjukkan file dan lokasi kesalahan:

Tangkapan layar tidak dapat membuka kesalahan file.

Detail skema untuk file berikut tidak didokumenkan. Selama pratinjau, perubahan pada file-file ini di luar Power BI Desktop tidak didukung:

Lapor\
SemanticModel\
- diagramLayout.json

Menyebarkan ke ruang kerja Fabric

Saat bekerja dengan file proyek Power BI, Anda bisa menyebarkan konten Anda ke ruang kerja Fabric menggunakan mekanisme penerbitan berikut:

GunakanIntegrasi Git Fabric .
Gunakan API Fabric.
Gunakan opsi terbitkan Power BI Desktop.

Nota

Menerbitkan melalui fitur publikasi Power BI Desktop menggunakan file PBIX sementara yang diterbitkan ke layanan, serupa dengan menyimpan dan menerbitkan file PBIX. Tidak seperti opsi penyebaran PBIP lainnya yang hanya menyebarkan metadata, metode penerbitan ini menyebarkan metadata dan cache data lokal model semantik yang sedang diedit.

Penulisan model

Anda dapat membuat perubahan pada definisi model semantik dengan menggunakan alat eksternal dengan dua cara:

Dengan menyambungkan ke instans Analysis Service (AS) Power BI Desktop dengan alat eksternal.
Dengan mengedit metadata TMDL di /definition folder menggunakan Visual Studio Code atau alat eksternal lainnya.

Semua metadata model semantik dapat dibaca. Operasi tulis didukung sepenuhnya, namun, ketahuilah bahwa memodifikasi metadata di luar Power BI Desktop dapat mengakibatkan perilaku yang tidak terduga atau, dalam kasus yang jarang terjadi, menyebabkan inkonsistensi dalam model. Berhati-hatilah saat membuat perubahan melalui alat eksternal.

Perlu diingat:

Setiap perubahan pada file terbuka yang dibuat di luar Power BI Desktop memerlukan mulai ulang agar perubahan tersebut ditampilkan di Power BI Desktop. Power BI Desktop tidak mengetahui perubahan pada file proyek yang dibuat oleh alat lain.
Tabel tanggal otomatis yang dibuat oleh Power BI Desktop tidak boleh diubah dengan menggunakan alat eksternal.
Jika model semantik mengaktifkan fitur Tanggal/waktu otomatis , dan Anda membuat kolom tanggalwaktu baru di luar Power BI Desktop, tabel tanggal lokal tidak dibuat secara otomatis.
Model semantik - seperti model komposit atau Direct Lake - dapat menyertakan objek dan properti yang bersumber dari model atau sumber data lainnya. Saat mengkustomisasi properti ini changedProperties atau menghapus objek yang disinkronkan, Power BI memerlukan properti ini dan PBI_RemovedChildren anotasi untuk diatur. Indikator ini menandai perubahan sebagai kustomisasi pengguna, memastikannya dipertahankan selama sinkronisasi skema berikutnya dengan sumber data. Untuk mempelajari selengkapnya, lihat Tag silsilah untuk model semantik Power BI.
Setiap pengeditan ekspresi di luar Power BI Desktop dalam proyek dengan unappliedChanges.json hilang saat perubahan tersebut diterapkan.

Skema file JSON

Sebagian besar file proyek berisi metadata dalam format JSON. Skema JSON yang sesuai dapat digunakan untuk validasi dan dokumentasi.

Dengan skema JSON, Anda dapat:

Pelajari tentang properti yang dapat dikonfigurasi.
Gunakan validasi JSON sebaris yang disediakan oleh editor kode.
Tingkatkan penulisan dengan penyorotan sintaksis, tipsalat, dan lengkapi otomatis.
Gunakan alat eksternal dengan pengetahuan tentang properti yang didukung dalam metadata proyek.

Gunakan Visual Studio Code untuk memetakan skema JSON ke file yang sedang ditulis. Skema JSON untuk file proyek disediakan dalam repositori Git json-schemas.

Pertimbangan dan batasan

Power BI Desktop tidak mengetahui perubahan yang dibuat dengan alat atau aplikasi lain. Perubahan yang dibuat dengan menggunakan alat eksternal mengharuskan Anda memulai ulang Power BI Desktop sebelum perubahan tersebut ditampilkan.
Label sensitivitas tidak didukung dengan proyek Power BI.
Tampilan diagram diabaikan saat mengedit model di Layanan.
Saat menyimpan sebagai Proyek Power BI, panjang maksimum jalur file proyek adalah 260 karakter.
Di Power BI Desktop, Anda tidak dapat menyimpan sebagai PBIP langsung ke OneDrive dan SharePoint. Anda bisa menggunakan Simpan Sebagai untuk menyimpan file ke folder OneDrive yang disinkronkan secara lokal; namun, ini dapat menyebabkan masalah penguncian file, berpotensi menyebabkan operasi penyimpanan gagal di Power BI Desktop.
Saat mengedit file PBIP di luar Power BI Desktop, file tersebut harus disimpan menggunakan UTF-8 tanpa pengodean BOM.
Skema Linguistik Laporan tidak didukung dengan proyek Power BI.
Power BI Desktop menggunakan CRLF sebagai akhir baris. Untuk menghindari masalah dalam perbedaan Anda, konfigurasikan Git untuk menangani akhiran baris dengan mengaktifkan autocrlf.
Proyek Power BI saat ini tidak didukung dalam versi Microsoft Power BI Desktop yang dioptimalkan untuk Server Laporan Power BI.

Tanya jawab umum

Pertanyaan: Melihat model semantik dan definisi folder item laporan hanya beberapa file yang ditandai sebagaimana diperlukan, apa yang terjadi jika saya menghapusnya?

Jawaban: Power BI Desktop secara otomatis membuatnya saat Anda menyimpan sebagai proyek (PBIP).

Pertanyaan: Apakah Power BI Desktop mengetahui perubahan yang saya buat pada file Proyek Power BI dari alat atau aplikasi eksternal?

Jawaban: Tidak. Setiap perubahan yang dilakukan pada file mengharuskan Power BI Desktop dimulai ulang untuk mencerminkan perubahan tersebut.

Pertanyaan: Jika saya mengonversi PBIX ke PBIP, dapatkah saya mengonversinya kembali ke PBIX?

Jawaban: Ya. Anda dapat menyimpan PBIX sebagai PBIP, atau menyimpan PBIP sebagai PBIX.

Pertanyaan: Dapatkah saya mengonversi PBIX menjadi PBIP dan sebaliknya secara terprogram?

Jawaban: Tidak. Anda hanya dapat mengonversi PBIX menjadi PBIP dan sebaliknya menggunakan Simpan File

Pertanyaan: Bisakah saya menyebarkan proyek Power BI Desktop ke Azure Analysis Services (AAS) atau SQL Server Analysis Services (SSAS)?

Jawaban: Tidak. Definisi laporan proyek Power BI Desktop tidak didukung di AAS dan SSAS. Dan definisi model menggunakan metadata yang disempurnakan yang unik untuk Power BI. Untuk proyek AAS dan SSAS, gunakan Microsoft Visual Studio untuk penulisan model, Git, dan integrasi Azure DevOps.

Pertanyaan: Mengapa tidak ada file *.pbip saat saya menghubungkan ruang kerja Fabric saya ke Git? Bagaimana cara mengedit laporan dan model semantik saya di Power BI Desktop?

Jawaban: File PBIP bersifat opsional dan hanya berfungsi sebagai pintasan ke folder laporan. Anda dapat membuka laporan dan model semantik untuk pengeditan di Power BI Desktop dengan membuka file definition.pbir yang terletak di folder laporan.