Git ile sürüm denetimi panoları

Bu sayfada, sürüm denetimi ve işbirliğine dayalı pano geliştirme için Databricks Git klasörlerinin nasıl kullanılacağı açıklanmaktadır. Ayrıca farklı çalışma alanlarında pano geliştirmek ve dağıtmak için CI/CD işlemlerinin nasıl uygulandığı da açıklanır.

Genel bakış

Bu özellik Genel Önizleme aşamasındadır.

Databricks Git klasörleri pano değişikliklerini ve geçmişini izler, ekip işbirliğini destekler ve panoları üretim ortamına dağıtmanıza ve önceki sürümleri kurtarmanıza olanak tanır.

Pano kaynak denetimini etkinleştirme

Çalışma alanı yöneticileri Önizlemeler sayfasından Genel Önizleme'ye çalışma alanı erişimini denetleyebilir. Varsayılan olarak Git klasörü önizlemesindeki Destek PanolarıAçık'tır.

Alternatif: El ile sürüm denetimi

Genel Önizleme'yi etkinleştiremiyorsanız, pano sürümlerini izlemek için aşağıdaki el ile iş akışını kullanın:

1. Panonuzu JSON dosyası olarak dışarı aktarın. Dosya biçimi lvdash.json. Dışarı aktarma yönergeleri için bkz. Panoyu dışarı aktarma, içeri aktarma veya değiştirme .
2. Bu dosyayı Git gibi bir sürüm denetim sistemine ekleyin.
3. Dosyayı düzenleyin. Metin dosyasındaki değerleri doğrudan düzenleyebilir veya çalışma alanınıza geri yükleyip kullanıcı arabiriminde değişiklik yapabilirsiniz.
4. Yeni dosyayı kaydedin. Kullanıcı arabiriminde değişiklik yaptıysanız yeni dosyanızı dışarı aktarın. Pano değişikliklerini ve sürümlerini izlemek için sürüm denetim sisteminizi kullanın.
5. Mevcut panoyu güncelleştirin. Mevcut taslak panodan:
   1. Sağ üst köşedeki Kebap menüsüne ve ardından Panoyu değiştir'e tıklayın.
   2. Panoyu dosyadan değiştir iletişim kutusunda Dosya seç'e tıklayın. Ardından Yaz seçeneğine tıklayın.

Git tümleştirmesi panolarla nasıl çalışır?

Databricks Git klasörleri taslak panolarda yapılan değişiklikleri izler ve yönetir. Pano taslağı, izlenen bir panodaki tüm değişiklikleri yansıtır. Git, ambar seçimi ve zamanlama oluşturma gibi yayımlama ve zamanlama yapılandırmalarını izlemez. Bu yapılandırmaları yönetmek için kullanıcı arabirimini kullanın veya Databricks Varlık Paketleri veya AI/BI REST API'siyle değişiklikleri otomatikleştirin.

• Pano yönetimi için paketleri kullanmak için bkz. pano.
• REST API ile panoları yayımlamak ve zamanlamak için bkz. Lakeview API referansı.

Uyarı

Lakeview API'sinde yapay zeka/BI panoları için önceki ad kullanılır.

Databricks Git klasörleri, panolar ve diğer çalışma alanı nesneleri için yaygın Git işlemlerini yönetir. Daha fazla bilgi edinmek için bkz. Azure Databricks Git klasörleri.

Panolara kaynak denetimi uygulama

Git ile panoları izlemek için onları bir Databricks Git klasörünün içine yerleştirin. Aşağıdaki seçeneklerden birini kullanın:

• Yeni panolar: Başlangıçtan itibaren kaynak denetimi uygulamak için mevcut bir Databricks Git klasöründe panonuzu oluşturun.
• Mevcut panolar: Mevcut bir panoyu Git ile izlemek için Databricks Git klasörüne taşıyın.

Kaynak denetimindeki panolar için izinleri yönetme

Klasör düzeyinde izinler, panolar da dahil olmak üzere bu klasördeki tüm nesnelere uygulanır. Git klasöründeki panolar, panoya özgü izinlere ek olarak üst klasörün izinlerini devralır. Git işlemlerinin çoğu CAN MANAGE izni gerektirir. Daha fazla bilgi için bkz . Klasör ACL'leri ve Git klasörü ACL'leri.

Önerilen geliştirme iş akışı

Depoyu kendi Databricks Git klasörünüzde kopyalayın, özellik dallarını kullanın ve çekme istekleri gönderin. Aşağıdaki tabloda, geliştirme ve dağıtımın farklı aşamalarında panoları yönetmek için Git klasörlerinin nasıl kullanılacağı özetlenmiştir.

Önemli

Git dalları arasında geçiş yapmak panolar için zararlı bir işlemdir. Azure Databricks, hedef dalda mevcut olmayan panoları kaldırır. Önceki duruma geri dönerseniz, panolar yeni URL ve kimliklerle tekrar görünür hâle gelir ve bu, yayımlanan bağlantılar, yer işaretleri ve API tümleştirmelerinin çalışmamasına neden olur. Değiştirmeden önce hedef dalı doğrulayın ve ardından tüm başvuruları güncelleştirin.

Proje aşaması	İş akışı	Beklenen sonuç	Bilinen sınırlamalar
İlk taahhüt	Panoyu çalışma alanında bir Git klasörüne taşıyın. Uzak Git deposuna commit ve push yap.	Git, uzak bir depodaki gösterge panelini izler.
Gelişme	Geliştiriciler, git klasörlerini genellikle kendi ana klasörlerinde, ayrı geliştirme dallarında oluşturur. Değişiklikleri geliştirme dalına teslim edin. Çekme isteklerini kullanarak geliştirme dallarını ana dal ile birleştirin.	Geliştiriciler bağımsız olarak çalışır. Git, dashboard sürümlerini izler.	Pano dosyaları JSON biçimini kullanır. SQL sorguları tek bir satır olarak görünür, bu da çekme isteklerinde değişikliklerin incelenmesini zorlaştırabilir.
Dağıtım	Kullanıcı olmayan üst düzey bir klasörde dağıtım dalında bir Git klasörü oluşturun. Databricks Git klasörleriyle CI/CD'yi inceleyin. Değişiklikleri dağıtım klasörüne çekin. Panoları bu klasörden yayımlayın. Edit+ erişimini kaldırın ve Git güncelleştirmelerini kısıtlayın. Panoları tüketicilerle paylaşın.	Tüketiciler panonun tutarlı ve yayımlanmış bir sürümüne erişer. Panoları aynı klasörde farklı hedef kitlelerle paylaşabilirsiniz.	Databricks, uzak bir dalı çalışma alanında bir Git klasörüyle eşitlemek veya Databricks Varlık Paketlerini uzak bir pano kaynağıyla dağıtmak için yerleşik destek sağlamaz. CI/CD otomasyonunu otomatikleştirmek için ayarlayın: Uzak depodan güncelleştirmeleri çekme. Senkronizasyondan sonra panoların yayımlanması. Güncelleştirmeden sonra Databricks Varlık Paketlerini dağıtma.

Databricks Git klasörlerinde işbirliği hakkında daha fazla en iyi yöntem için bkz. Git klasörlerini kullanarak işbirliği yapma.

Sınırlamalar

AI/BI panolarıyla kaynak denetimi aşağıdaki sınırlamalara sahiptir:

• Tek bir Git klasörüne en fazla 100 pano kaydedebilirsiniz. Bu sınır Genel Önizleme sırasında değişebilir.
• Çalışma alanı varlık kimlikleri veya yolları yerine Git URL'lerine başvuran işler gibi Git tabanlı işler panolarla çalışmaz.
• Dashboard serileştirmesi, çekme istekleri sırasında farkların okunmasını ve gözden geçirilmesini zorlaştıran uzun dizeler oluşturur.
• Pano dosyası biçimi, yeni alanları ve diğer geliştirmeleri içerecek şekilde düzenli aralıklarla değişir. Genel Önizleme sırasında, bu değişiklikler Git'te başlatmadığınız farklılıklar olarak görünebilir.