Doğrulama için Power BI Projesi (PBIP) ve Azure DevOps derleme işlem hatları

Doku Git Tümleştirmesi'nin Azure DevOps ile birleştirilmesi, çalışma alanını Azure DevOps deposundaki bir dala bağlamanızı ve bunlar arasında otomatik olarak eşitlemenizi sağlar.

PBIP biçimini Azure DevOps ile tümleştirmek, Sürekli Tümleştirme/Sürekli Dağıtım (CI/CD) işlem hatlarını otomatikleştirmek için Azure Pipelines'ı kullanmanıza olanak tanır. Bu işlem hatları PBIP meta veri dosyalarını işler ve üretim sistemine dağıtmadan önce geliştirmenize bir dizi kalite denetimi uygular.

Bu makalede sürekli tümleştirmeye odaklanacak ve bir Doku çalışma alanı içindeki tüm anlamsal modeller ve raporlar için en iyi yöntemleri garanti eden bir Azure DevOps işlem hattı oluşturmayı açıklayacağız. Otomatik kalite testleri uygulayarak yaygın hataları önleyebilir ve ekip verimliliğini artırabilirsiniz. Örneğin, bu yaklaşım yeni ekip üyelerinin anlam modeli ve rapor geliştirme için belirlenmiş standartlara uymasını sağlar.

Projeye genel bakış ve Doku Git tümleştirmesinde PBIP ve Doku Git Tümleştirmesi hakkında daha fazla bilgi edinin.

Aşağıdaki diyagramda, geliştirme kalitesini doğrulamak için Azure DevOps işlem hattını tetikleyen iki geliştirme iş akışı içeren uçtan uca senaryo gösterilmektedir. İşlem hattı yürütme aşağıdaki eylemleri gerçekleştirir:

1. Kullanıcı 1, Power BI Desktop kullanılarak geliştirilmiştir.

   1. VS Code kullanarak main'dan dal oluşturma (özellik/veri kümesi değişimi)
   2. Power BI Desktop'ı kullanarak anlam modellerinde değişiklik yapma
   3. VS Code kullanarak uzak depo dalında değişiklikleri işleme
   4. Azure DevOps kullanarak ana dala Çekme İsteği oluşturma

2. Aynı zamanda, Kullanıcı 2 başka bir Doku çalışma alanı kullanarak geliştirir.

   1. Doku Git kullanarak ana bilgisayardan dal oluşturma (özellik/rapor değişimi)
   2. Doku çalışma alanında rapor değişiklikleri yapma
   3. Doku Git'i kullanarak uzak depo dalında değişiklikleri işleme
   4. Azure DevOps kullanarak ana dala Çekme İsteği oluşturma

3. Ekip lideri Çekme İsteklerini inceler ve Doku Git'i kullanarak değişiklikleri ekip çalışma alanına eşitler.

4. Çekme İsteği, semantik modeli incelemek ve geliştirme kalitesini raporlamak için Azure DevOps işlem hattını tetikler.

Not

Bu örnekte işlem hattı, bir geliştiricinin Power BI Project klasöründeki anlamsal model ve raporların meta verilerine en iyi yöntem kurallarını (özelleştirilebilir) uygulamasını sağlayan iki açık kaynak topluluk aracı kullanır:

• Tablosal Düzenleyici ve En İyi Yöntem Kuralları
• PBI Denetçisi

Bu makaledeki örneğe benzer bir yaklaşım diğer topluluk araçları için de geçerlidir. Bu makale, topluluk araçlarının ayrıntılarını ve kural oluşturma ve düzenleme konularını ele almaz. Bu konular hakkında ayrıntılı bilgi için sağlanan bağlantılara bakın. Bu makalenin odak noktası, kaynak denetimi ile Doku Çalışma Alanı arasında kalite kapısı oluşturma sürecidir. Bahsedilen topluluk araçlarının üçüncü taraf katkıda bulunanlar tarafından geliştirildiğini ve Microsoft'un bunlar için destek veya belge sunmadığını unutmayın.

1. Adım - Doku çalışma alanını Azure DevOps'a bağlama

Doku çalışma alanınızı Azure DevOps'a bağlama:

Doku Git tümleştirmesi çalışma alanı öğelerinizi dışarı aktarmayı tamamladığında, Azure DevOps dalınız çalışma alanınızdaki her öğe için bir klasör içerir:

2. Adım - Azure DevOps işlem hattı oluşturma ve çalıştırma

Yeni işlem hattı oluşturmak için:

1. Sol gezinti menüsünün İşlem Hatları sekmesinde İşlem Hattı Oluştur'u seçin:

   

2. Azure Repos Git seçin ve ilk depoyu (Fabric çalışma alanına bağlı depo) seçin:

   

   

3. Başlangıç işlem hattı'ı seçin.

   

   Düzenleyicide aşağıdaki YAML kodu görüntülenir:

   

4. YaML kodunu Power BI geliştirici modu işlem hattından kopyalayıp oluşturduğunuz işlem hattına yapıştırın:

   

   

5. Yeni işlem hattınızı depoya işlemek için Kaydet ve Çalıştır'ı seçin.

   

   

Azure DevOps işlem hattını çalıştırır ve iki derleme işini paralel olarak başlatır:

• Build_Datasets
  • Tablosal Düzenleyici ikili dosyalarını indirir.
  • En İyi Yöntem Çözümleyicisi varsayılan kurallarını indirin. Kuralları özelleştirmek için deponun köküne bir Rules-Dataset.json ekleyin.
  • Tüm anlamsal model öğesi klasörleri arasında geçiş yapın ve Tablosal Düzenleyici BPA Kuralları'nı çalıştırın.
• Build_Reports
  • PBI Denetçisi ikili dosyalarını indirin.
  • PBI Denetçisi varsayılan kurallarını indirin. Kuralları özelleştirmek için deponun köküne bir Rules-Report.json ekleyin.
  • Tüm rapor öğesi klasörleri arasında geçiş yapın ve Power BI Denetçisi kurallarını çalıştırın.

Tamamlandığında Azure DevOps, karşılaştığı tüm uyarıları ve hataları içeren bir rapor oluşturur:

İki işin daha ayrıntılı bir görünümünü açmak için bağlantıyı seçin:

Raporunuz veya anlam modeliniz daha yüksek önem düzeyine sahip bir kuralda başarısız olursa derleme başarısız olur ve hata vurgulanır:

3. Adım - Dal ilkelerini tanımlama

İşlem hattı çalışır duruma geçtikten sonra ana dalda Dal İlkeleri'ni etkinleştirin. Bu adım, doğrudan main'a işleme yapılamamasını sağlar. Değişiklikleri tekrar main ile birleştirmek için her zaman bir "çekme isteği" gerekir ve işlem hattını her çekme isteğiyle çalışacak şekilde yapılandırabilirsiniz.

1. Dallar>>

   

2. Oluşturulan işlem hattını dal için Derleme İlkesi olarak yapılandırın:

   

   

4. Adım - Çekme isteği oluşturma

Doku Çalışma Alanınıza döner, raporlardan veya anlam modellerinden birinde değişiklik yapar ve değişikliği işlemeye çalışırsanız aşağıdaki hatayı alırsınız:

Ana dalda yalnızca bir çekme isteği aracılığıyla değişiklik yapabilirsiniz. Çekme isteği oluşturmak için değişiklikleri yapmak üzere yeni bir dalı kullanıma alma:

Doğrudan Doku Çalışma Alanı'ndan bir dal oluşturun:

1. Kaynak Denetimi bölmesinde Yeni dalı kullanıma alma'yı seçin ve dal için bir ad belirtin.

   

   

   Alternatif olarak, ayrı, yalıtılmış bir çalışma alanında veya Power BI Desktop'ta geliştirmeyi seçebilirsiniz. Daha fazla bilgi için bkz. git dallarını yönetme

2. Değişikliklerinizi bu yeni dala işleyin.

   

3. İşlemenin ardından Azure DevOps portalından ana dala bir çekme isteği oluşturun.

   

   

Çekme isteği iş akışı yalnızca değişiklikleri doğrulamanıza ve gözden geçirmenize izin vermekle kalmaz, aynı zamanda işlem hattını otomatik olarak tetikler.

Kurallardan birinde yüksek önem derecesinde bir hata varsa çekme isteğini sonlandıramaz ve değişiklikleri ana dalda birleştiremezsiniz.

İlgili içerik

• Çalışma alanınızı güncelleştirme ve Değişiklikleri Git'e işleme dahil olmak üzere çalışma alanınızı Git dalı ile eşitleme hakkında bilgi için bkz. git tümleştirmesini kullanmaya başlama.

• Yaygın müşteri senaryolarına dayalı olarak Doku'da CI/CD işlemleri oluşturmaya yönelik farklı seçenekler hakkında ipuçları için bkz. için en iyi Doku CI/CD iş akışı seçeneğini belirleme.