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.
Penting
Proyek Power BI Desktop saat ini dalam pratinjau.
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. Selama PRATINJAU, file ini tidak mendukung pengeditan 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.
Mengaktifkan fitur Pratinjau format TMDL
Menyimpan sebagai Proyek Power BI menggunakan TMDL saat ini dalam tahap pratinjau. Sebelum menggunakannya, Anda harus terlebih dahulu mengaktifkannya di fitur Pratinjau:
Buka > Opsi File dan Pengaturan > Opsi > Fitur Pratinjau dan centang kotak di samping Simpan model semantik menggunakan format TMDL.
Simpan sebagai proyek menggunakan TMDL
Dengan fitur Pratinjau TMDL diaktifkan, saat Anda menyimpan proyek, model semantik Anda disimpan sebagai folder TMDL bernama \definition di dalam folder model semantik:
Pelajari selengkapnya tentang struktur folder TMDL.
Mengonversi PBIP yang ada ke TMDL
Jika Anda sudah memiliki PBIP menggunakan TMSL sebagai format model semantik, Anda dapat mengonversinya ke TMDL sebagai berikut:
Buka PBIP di Power BI Desktop.
Pastikan Fitur Pratinjau diaktifkan.
Simpan proyek. Perintah muncul meminta Anda untuk meningkatkan ke TMDL.
Pilih Tingkatkan.
Penting
Setelah meningkatkan ke TMDL, Anda tidak dapat kembali ke TMSL. Jika Anda merasa ingin kembali ke TMSL, simpan salinan file PBIP Anda terlebih dahulu.
File Tabular Model Scripting Language (TMSL) yang ada (model.bim) diganti dengan folder \definition yang berisi representasi TMDL dari model semantik.
Jika Anda memilih untuk Mempertahankan format saat ini , Desktop tidak akan meminta lagi untuk memutakhirkan.
Membuat perubahan eksternal pada file TMDL
Untuk pengalaman yang lebih baik membaca dan mengedit file TMDL Anda, instal ekstensi TMDL - Visual Studio Marketplace Microsoft VS Code.
Buka folder PBIP menggunakan Visual Studio Code dan navigasikan ke folder definisi model semantik.
Power BI Desktop tidak mengetahui perubahan pada file proyek yang dibuat oleh alat lain. Oleh karena itu, jika Anda membuat perubahan untuk membuka file di luar Power BI Desktop, Anda perlu memulai ulang agar perubahan tersebut ditampilkan di Power BI Desktop.
Silakan lihat di sini untuk operasi tulis yang didukung di luar Power BI Desktop.
Kesalahan TMDL
Jika ada pengeditan yang tidak valid yang dilakukan pada file TMDL, Power BI Desktop akan menampilkan kesalahan saat terbuka, dengan lokasi kesalahan:
