Bagikan melalui

Proyek Power BI Desktop (PRATINJAU)

  • Artikel

Penting

Proyek Power BI Desktop saat ini dalam pratinjau.

Tip

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 definisi item adalah file teks berformat JSON 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.

  • Pembuatan terprogram dan mengedit definisi item - Anda dapat membuat skrip menggunakan Bahasa Pembuatan Skrip Model Tabular (TMSL) yang populer dan mudah digunakan, atau membuat aplikasi kustom Anda sendiri untuk membuat perubahan pada definisi item Anda. Aplikasi dapat didasarkan pada dokumentasi publik skema definisi item dan/atau pustaka klien.

  • Kontrol sumber - Model semantik Power BI dan definisi item laporan dapat disimpan dalam sistem kontrol sumber, seperti Git. Dengan Git, Anda dapat melacak riwayat versi, membandingkan revisi (diff), dan kembali ke versi sebelumnya. Kontrol sumber juga dapat membuka blokir kolaborasi saat menggunakan Power BI Desktop dengan menggunakan mekanisme kolaborasi yang familier untuk mengatasi konflik (penggabungan) dan meninjau perubahan (permintaan pull). Untuk mempelajari selengkapnya, lihat Kontrol versi di Git.

  • Integrasi Berkelanjutan dan Pengiriman Berkelanjutan (CI/CD) - Anda dapat menggunakan sistem tempat pengembang di organisasi Anda mengirimkan perubahan yang diusulkan ke sistem CI/CD. Sistem kemudian memvalidasi perubahan dengan serangkaian gerbang kualitas sebelum menerapkan perubahan pada sistem produksi. Gerbang kualitas ini dapat mencakup ulasan kode oleh pengembang lain, pengujian otomatis, dan build otomatis untuk memvalidasi integritas perubahan. Sistem CI/CD biasanya dibangun di atas sistem kontrol sumber yang ada. Untuk mempelajari selengkapnya, lihat DevOps - Integrasi berkelanjutan, dan DevOps - Pengiriman berkelanjutan.

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:

Cuplikan layar memperlihatkan file Proyek Power BI

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.

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
|   |   └── *.*
│   .gitignore
└──  AdventureWorks.pbip

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:

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 JSON dalam file model.bim menggunakan Visual Studio Code atau alat eksternal lainnya.

Tidak setiap objek model mendukung operasi tulis. Menerapkan perubahan di luar yang didukung dapat menyebabkan hasil yang tidak terduga.

Objek yang mendukung operasi tulis:

Objek Menyambungkan ke instans AS Perubahan file
Tabel Tidak Ya
Kolom Ya 1, 2 Ya
Tabel terhitung Ya Ya
Kolom terhitung Ya Ya
Hirarki Ya Ya
Hubungan Ya Ya
Tindakan Ya Ya
KPI Model Ya Ya
Grup perhitungan Ya Ya
Perspektif Ya Ya
Terjemahan Ya Ya
Keamanan Tingkat Baris (RLS) Ya Ya
Keamanan Tingkat Objek (OLS) Ya Ya
Anotasi Ya Ya
Ekspresi M No Ya 3, 4

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.

  • Power BI Desktop tidak mendukung tabel dengan beberapa partisi. Hanya satu partisi untuk setiap tabel yang didukung. Membuat tabel dengan partisi kosong atau lebih dari satu partisi menghasilkan kesalahan saat membuka laporan.

  • Tabel tanggal otomatis yang dibuat oleh Power BI Desktop tidak boleh diubah dengan menggunakan alat eksternal.

  • Saat mengubah model yang menggunakan Kueri Langsung untuk menyambungkan model semantik Power BI atau model Analysis Services, Anda harus memperbarui koleksi ChangedProperties dan PBI_RemovedChildren untuk objek yang diubah agar menyertakan properti yang dimodifikasi atau dihapus. Jika ChangedProperties dan/atau PBI_RemovedChildren tidak diperbarui, Power BI Desktop mungkin menimpa perubahan apa pun saat kueri diedit lain kali atau model disegarkan di Power BI Desktop.

  • 1 - Mengubah jenis data kolom didukung. Namun, mengganti nama kolom tidak didukung saat menyambungkan ke instans AS.

  • 2 - 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.

  • 3 - SourceType Partisi harus Dihitung, M, Entitas, atau Grup Perhitungan. Mode Partisi harus Impor, DirectQuery, atau Ganda.

  • 4 - Setiap pengeditan ekspresi di luar Power BI Desktop dalam proyek dengan unappliedChanges.json hilang saat perubahan tersebut diterapkan.

  • Memodifikasi ekspresi kueri tabel di luar Power BI Desktop menghasilkan penghapusan data tabel saat memulai ulang Power BI Desktop.

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 di repositori Git sampel Power BI Desktop.

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.
  • 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.
  • Laporan koneksi langsung yang disimpan sebagai PBIP mengharuskan Titik Akhir XMLA diaktifkan.

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>Power BI Desktop sebagai.

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.

Konten terkait