Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini menjelaskan file dan subfolder dalam folder Model Semantik proyek Microsoft Power BI Desktop. File dan subfolder di sini mewakili model semantik Power BI. Bergantung pada proyek Anda, folder model semantik dapat mencakup:
- .pbi\
- Folder DAXQueries\
- Folder TMDLScripts\
- definition\ folder3
- model.bim2
- diagramLayout.json
- .platform
- definition.pbism1
1 - File ini diperlukan.
2 - File ini diperlukan saat menyimpan menggunakan format TMSL.
3 - File ini diperlukan saat menyimpan menggunakan format TMDL.
Tidak setiap folder model semantik proyek mencakup semua file dan subfolder yang dijelaskan di sini.
Model Semantik Berkas
.pbi\localSettings.jsaktif
Berisi pengaturan model semantik yang hanya berlaku untuk pengguna dan komputer saat ini. Ini harus disertakan dalam gitIgnore atau pengecualian kontrol sumber lainnya. Secara default, Git mengabaikan file ini.
Untuk informasi selengkapnya, lihat dokumen skema localSettings.json.
.pbi\editorSettings.jsaktif
Berisi pengaturan editor model semantik yang disimpan sebagai bagian dari definisi model semantik untuk digunakan di seluruh pengguna dan lingkungan.
Untuk informasi selengkapnya, lihat dokumen skema editorSettings.json.
.pbi\cache.abf
File Analysis Services Backup (ABF) yang berisi salinan model dan data yang di-cache secara lokal ketika terakhir kali diedit. Ini harus disertakan dalam gitIgnore atau pengecualian kontrol sumber lainnya. Secara default, Git mengabaikan file ini.
Power BI Desktop dapat membuka proyek tanpa file cache.abf. Dalam hal ini, ia membuka laporan yang terhubung ke model dengan seluruh definisinya tetapi tanpa data. Jika cache.abf ada, Power BI Desktop memuat data dan mengganti definisi model dengan metadata semantik model proyek.
.pbi\unappliedChanges.jsaktif
Power BI Desktop memungkinkan Anda menyimpan perubahan yang dibuat di editor Transformasi Data (Power Query) tanpa terlebih dahulu menerapkan perubahan tersebut ke model data.
Saat Anda memilih Terapkan nanti, perubahan yang tidak diterapkan disimpan ke dalam file unappliedChanges.json. Saat perubahan tertunda berada dalam file unappliedChanges, Power BI Desktop meminta Anda untuk menerapkan atau membuang perubahan yang tertunda tersebut:
Jika Anda memilih Terapkan perubahan, Power BI Desktop mengganti kueri dalam metadata model semantik dengan kueri dari unappliedChanges.json. Jika Anda mengedit kueri di luar Power BI Desktop dan ada file unappliedChanges.json sebelumnya, perubahan Anda akan hilang dan digantikan oleh kueri di unappliedChanges.json saat perubahan tersebut diterapkan.
File unappliedChanges.json secara otomatis dimasukkan ke dalam definisi model semantik dan disimpan di Git secara default. Ini memungkinkan Anda untuk mengunggah pekerjaan berjalan Anda ke cabang pengembangan, berfungsi sebagai cadangan dan membuatnya dapat diakses oleh anggota tim lainnya. Namun, Anda dapat mengecualikan file ini dari pelacakan Git, mencegah pekerjaan kueri yang belum selesai memengaruhi pengembang lain.
Untuk informasi selengkapnya, lihat skema dokumen unappliedChanges.json.
definition.pbism
Berisi definisi keseluruhan model semantik dan pengaturan inti.
File ini juga menentukan format definisi model semantik yang didukung melalui properti 'versi'.
| Versi | Format yang didukung |
|---|---|
| 1.0 | Definisi model semantik harus disimpan sebagai TMSL dalam file model.bim. |
| 4.0 atau lebih tinggi | Definisi model semantik dapat disimpan sebagai TMSL (file model.bim) atau TMDL (\folder definisi). |
Untuk informasi selengkapnya, lihat dokumen skema definition.pbism.
model.bim
File ini hanya tersedia jika proyek Power BI disimpan menggunakan format TMSL. Ini berisi definisi objek Database Tabular Model Scripting Language (TMSL) dari model proyek.
folder definisi
Folder ini hanya tersedia jika proyek Power BI disimpan menggunakan format TMDL. Ini menggantikan file model.bim .
Folder ini berisi definisi objek Database Bahasa Definisi Model Tabular (TMDL)dari model proyek.
diagramLayout.json
Berisi metadata diagram yang menentukan struktur model semantik yang terkait dengan laporan. Anda tidak dapat mengedit file ini secara eksternal.
.platform
File platform Fabric yang menyimpan properti penting untuk membangun dan memelihara koneksi antara item Fabric dan Git.
Untuk mempelajari lebih lanjut, lihat file sistem integrasi dengan Git yang dihasilkan secara otomatis.
Folder DAXQueries\
Berisi satu file untuk setiap tab kueri yang terlihat pada tampilan kueri DAX dan disimpan sebagai file DAX.
.pbi\daxQueries.json
Berisi pengaturan editor untuk tampilan kueri DAX seperti defaultTab atau urutan tab.
Folder TMDLScripts\
Berisi file untuk setiap skrip tab tampilan TMDL yang disimpan sebagai file TMDL.
.pbi\tmdlscripts.json
Berisi pengaturan editor tampilan TMDL seperti defaultTab atau urutan tab.
Format TMDL
Dengan tujuan memberikan kontrol sumber dan pengalaman pengembangan bersama yang lebih baik, Anda dapat menyimpan file Proyek Power BI (PBIP) menggunakan Bahasa Definisi Model Tabular (TMDL) sebagai format file model semantik.
Tidak seperti Tabular Model Scripting Language (TMSL), TMDL telah dirancang dari bawah ke atas menjadi ramah manusia, memfasilitasi tidak hanya keterbacaan tetapi juga pengeditan yang mudah di editor teks apa pun. Ini mewakili peningkatan substansial untuk kontrol sumber dan pengalaman pengembangan kolaboratif .
Alih-alih file JSON besar seperti Tabular Model Scripting Language (TMSL), TMDL memiliki struktur folder dengan file terpisah untuk setiap tabel, perspektif, peran, dan budaya. Ini membuatnya lebih mudah untuk bekerja dengan orang lain, dan untuk memahami struktur model semantik hanya dengan melihat folder dan file. Pada akhirnya, ini mengarah pada kontrol sumber yang hebat dan pengalaman pengembangan bersama saat berhadapan dengan konflik git diff dan penggabungan.
Pelajari lebih lanjut tentang TMDL di sini.
Membuat perubahan eksternal pada file TMDL
Anda dapat mengedit file TMDL di Visual Studio Code atau alat eksternal lainnya saat proyek tetap terbuka di Power BI Desktop. Untuk pengalaman pengeditan TMDL yang lebih baik, instal ekstensi TMDL untuk Visual Studio Code.
Sebelum Anda mengedit file secara eksternal, simpan perubahan apa pun di Power BI Desktop. Buka folder PBIP di Visual Studio Code, navigasikan ke folder model definition semantik, dan simpan perubahan TMDL Anda. Power BI Desktop mendeteksi perubahan yang disimpan dan menampilkan banner Terapkan perubahan eksternal. Pilih Terapkan perubahan eksternal untuk memuat ulang model semantik tanpa menutup dan membuka kembali proyek.
Jika Power BI Desktop memiliki perubahan yang belum disimpan, Anda akan diperingatkan bahwa penerapan perubahan eksternal akan menimpa perubahan tersebut. Untuk alur kerja dan batasan lengkap, lihat Mengedit file PBIP di luar Power BI Desktop.
Untuk operasi tulis yang didukung di luar Power BI Desktop, lihat Penulisan model.
Kesalahan TMDL
Jika pengeditan TMDL tidak valid, Power BI Desktop menampilkan kesalahan saat Anda menerapkan perubahan eksternal atau membuka proyek. Kesalahan mengidentifikasi lokasi yang harus Anda perbaiki sebelum Power BI Desktop dapat memuat model semantik yang diperbarui:
