Dasbor kontrol versi dengan Git

Halaman ini menjelaskan cara menggunakan folder Databricks Git untuk kontrol versi dan pengembangan dasbor kolaboratif. Ini juga menjelaskan cara menerapkan proses CI/CD untuk mengembangkan dan menyebarkan dasbor di berbagai ruang kerja.

Penting

Fitur ini ada di Pratinjau Publik.

Ikhtisar

Folder Databricks Git melacak perubahan dan riwayat dasbor, mendukung kolaborasi tim, dan memungkinkan Anda menyebarkan dasbor untuk produksi dan memulihkan versi sebelumnya.

Mengaktifkan pengendalian sumber daya dasbor

Admin ruang kerja dapat mengontrol akses ruang kerja ke Pratinjau Publik dari halaman Pratinjau. Secara bawaan, pratinjau Dasbor Dukungan di folder GitAktif.

Bagaimana integrasi Git bekerja dengan dasbor

Folder Git Databricks memantau dan mengelola perubahan pada dasbor draf. Draf dasbor mencerminkan semua perubahan di dasbor yang dilacak. Git tidak melacak konfigurasi penerbitan dan penjadwalan, seperti pemilihan gudang dan pembuatan jadwal. Untuk mengelola konfigurasi ini, gunakan UI atau otomatiskan perubahan dengan Bundel Aset Databricks atau REST API AI/BI.

• Untuk menggunakan bundel untuk manajemen dasbor, lihat dasbor.
• Untuk menerbitkan dan menjadwalkan dasbor dengan REST API, lihat referensi API Lakeview .

Nota

Lakeview API menggunakan nama sebelumnya untuk dasbor AI/BI.

Direktori Git Databricks mengelola fungsi Git yang umum untuk papan kendali dan objek lain dalam ruang kerja. Untuk mempelajari selengkapnya, lihat Folder Git Azure Databricks.

Menerapkan kontrol sumber ke dasbor

Anda dapat melacak dasbor dengan Git dengan menempatkannya di folder Databricks Git. Gunakan salah satu opsi berikut:

• Dasbor baru: Buat dasbor Anda dalam folder Databricks Git yang ada untuk menerapkan kontrol sumber dari awal.
• Dasbor yang sudah ada: Pindahkan dasbor yang ada ke folder Databricks Git untuk melacaknya dengan Git.

Mengelola izin untuk dasbor yang dikontrol sumber

Izin tingkat folder berlaku untuk semua objek dalam folder tersebut, termasuk dasbor. Dasbor dalam folder Git mewarisi izin folder induk selain izin khusus dasbor apa pun. Sebagian besar operasi Git memerlukan izin CAN MANAGE. Untuk mempelajari selengkapnya, lihat ACL folder dan ACL folder Git.

Alur kerja pengembangan yang direkomendasikan

Kloning repositori ke folder Databricks Git Anda sendiri, gunakan cabang fitur, dan kirim permintaan pull. Tabel berikut menguraikan cara menggunakan folder Git untuk mengelola dasbor selama fase pengembangan dan penyebaran yang berbeda.

Penting

Beralih antara cabang Git adalah proses yang merusak untuk dasbor. Azure Databricks menghapus dasbor yang tidak ada di cabang target. Jika Anda beralih kembali, dasbor muncul kembali dengan URL dan ID baru, yang mengganggu fungsi tautan, bookmark, dan integrasi API yang diterbitkan. Periksa cabang sasaran sebelum beralih dan perbarui semua referensi setelahnya.

Fase proyek	Alur kerja	Hasil yang diharapkan	Batasan yang diketahui
Penerapan awal	Pindahkan dasbor ke folder Git di ruang kerja. Terapkan dan dorong ke repositori Git jarak jauh.	Git melacak dasbor di repositori jarak jauh.
Pengembangan	Pengembang membuat folder Git di cabang pengembangan terpisah, biasanya di direktori home mereka. Terapkan perubahan pada cabang pengembangan. Gabungkan branch pengembangan ke main menggunakan pull request.	Pengembang bekerja secara independen. Git melacak versi papan kendali.	File dasbor menggunakan JSON format. Kueri SQL muncul sebagai satu baris, yang dapat membuat perbedaan sulit ditinjau dalam permintaan pull.
Penyebaran	Buat folder Git di cabang penggelaran di folder tingkat atas yang bukan milik pengguna. Lihat CI/CD dengan Git folder di Databricks. Tarik perubahan ke folder penyebaran. Terbitkan dasbor dari folder ini. Hapus akses edit+ dan batasi pembaruan ke Git. Bagikan dasbor dengan pengguna.	Konsumen mengakses dasbor versi konsisten yang telah diterbitkan. Anda dapat berbagi dasbor di folder yang sama dengan audiens yang berbeda.	Databricks tidak menyediakan dukungan bawaan untuk menyinkronkan cabang jarak jauh dengan folder Git di ruang kerja, atau menyebarkan Bundel Aset Databricks dengan sumber daya dasbor dari jarak jauh. Siapkan otomatisasi CI/CD untuk mengotomatiskan: Menarik pembaruan dari repositori jarak jauh. Menerbitkan dasbor setelah sinkronisasi. Mendistribusikan Bundel Aset Databricks setelah selesai pembaruan.

Untuk praktik terbaik lainnya tentang kolaborasi di folder Databricks Git, lihat Berkolaborasi menggunakan folder Git.

Keterbatasan

Kontrol sumber dengan dasbor AI/BI memiliki batasan berikut:

• Anda dapat menerapkan maksimal 100 dasbor dalam satu folder Git. Batas ini mungkin berubah selama Pratinjau Umum.
• Pekerjaan berbasis Git, seperti pekerjaan yang merujuk pada URL Git alih-alih ID aset atau jalur aset ruang kerja, tidak dapat berfungsi dengan papan dasbor.
• Serialisasi dasbor menghasilkan string panjang, yang membuat membaca dan meninjau perbedaan selama pull request sulit.
• Format file dasbor berubah secara berkala untuk menyertakan bidang baru dan peningkatan lainnya. Selama Pratinjau Publik, perubahan ini mungkin muncul sebagai perbedaan dalam Git yang tidak Anda mulai.