Folder model semantik proyek Power BI Desktop
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:
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.
File Model Semantik
.pbi\localSettings.json
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.json
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 lokal saat terakhir 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 menimpa definisi model dengan konten di model.bim.
.pbi\unappliedChanges.json
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 menimpa kueri di model.bim dengan kueri dari unappliedChanges.json. Jika Anda mengedit kueri di model.bim 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 melakukan pekerjaan berkelanjutan Anda ke cabang pengembangan, berfungsi sebagai cadangan dan membuatnya dapat diakses oleh anggota tim lain. Namun, Anda dapat mengecualikan file ini dari pelacakan Git, mencegah pekerjaan kueri yang belum selesai memengaruhi pengembang lain.
Untuk informasi selengkapnya, lihat dokumen skema 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 definition\
Folder ini hanya tersedia jika proyek Power BI disimpan menggunakan format TMDL. Ini menggantikan file model.bim .
Folder ini berisi definisi objek Tabular Model Definition Language (TMDL)Database 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 Integrasi Git file sistem yang dibuat secara otomatis.
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 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 Peningkatan.
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:
Pertimbangan dan batasan TMDL
Selama Pratinjau Umum, Integrasi Fabric Git masih akan mengekspor model semantik menggunakan TMSL secara default. Namun, jika model semantik diimpor ke Fabric menggunakan Fabric Git Integration dengan format TMDL, maka Fabric Git Integration akan menggunakan format TMDL untuk mengekspor definisi model semantik ke Git jika ada perubahan model semantik dalam layanan.
Penting
Jika Anda mengimpor model semantik menggunakan metode impor lainnya, seperti Power BI Desktop Publish, Fabric Git Integration akan beralih kembali ke format TMSL default.