Power BI Desktop projeleri (ÖNİzLEME)

  • Makale

Önemli

Power BI Desktop projeleri şu anda önizleme aşamasındadır.

Power BI Desktop, projelerinizi yazmak, işbirliği yapmak ve kaydetmek için yeni bir yol sunar. Çalışmanızı Power BI Projesi (PBIP) olarak kaydettiğinizde, rapor ve anlam modeli öğe tanımları basit, sezgisel bir klasör yapısında tek tek düz metin dosyaları olarak kaydedilir.

Çalışmanızı proje olarak kaydetmenin aşağıdaki avantajları vardır:

  • Metin düzenleyicisi desteği - Öğe tanımı dosyaları, anlamsal model ve rapor meta verilerini içeren JSON biçimli metin dosyalarıdır. Bunlar genel olarak belgelenmiş ve okunabilir. Proje dosyaları Not Defteri gibi basit metin düzenleme araçlarını desteklese de intellisense, doğrulama ve Git tümleştirmesi gibi zengin bir düzenleme deneyimi sağlayan Visual Studio Code (VS Code) gibi bir kod düzenleyicisi kullanmak daha iyidir.

  • Programlı oluşturma ve öğe tanımlarını düzenleme - Popüler ve kullanımı kolay Tablosal Model Betik Dili 'ni (TMSL) kullanarak betikler oluşturabilir veya öğe tanımlarınızda değişiklik yapmak için kendi özel uygulamalarınızı oluşturabilirsiniz. Uygulamalar, öğe tanımı şemalarının ve/veya istemci kitaplıklarının genel belgelerine dayanabilir.

  • Kaynak denetimi - Power BI anlam modeli ve rapor öğesi tanımları Git gibi bir kaynak denetim sisteminde depolanabilir. Git ile sürüm geçmişini izleyebilir, düzeltmeleri karşılaştırabilir (fark) ve önceki sürümlere geri dönebilirsiniz. Kaynak denetimi, çakışmaları çözmek (birleştirme) ve değişiklikleri gözden geçirmek (çekme istekleri) için tanıdık işbirliği mekanizmalarını kullanarak Power BI Desktop kullanırken işbirliğinin engelini de kaldırabilir. Daha fazla bilgi edinmek için bkz . Git'te sürüm denetimi.

  • Sürekli Tümleştirme ve Sürekli Teslim (CI/CD) - Kuruluşunuzdaki geliştiricilerin CI/CD sistemine önerilen değişikliği gönderdiği sistemleri kullanabilirsiniz. Ardından sistem, değişikliği üretim sistemine uygulamadan önce bir dizi kalite kapısıyla doğrular. Bu kalite geçitleri, diğer geliştiriciler tarafından yapılan kod incelemelerini, otomatik testi ve değişikliklerin bütünlüğünü doğrulamak için otomatik derlemeyi içerebilir. CI/CD sistemleri genellikle mevcut kaynak denetim sistemlerinin üzerine kurulur. Daha fazla bilgi edinmek için bkz . DevOps - Sürekli tümleştirme ve DevOps - Sürekli teslim.

Video

Bkz. Microsoft Build 2023'te sunulan Power BI Desktop projeleri ve diğer geliştirici modu özellikleri.

Önizleme özelliklerini etkinleştir

Power BI Desktop'ta proje olarak kaydetme şu anda önizleme aşamasındadır. Bu özelliği kullanmak için bir Premuim lisansına sahip olmanız ve Önizleme özelliklerinde etkinleştirmeniz gerekir.

Etkinleştirmek için Power BI Desktop >Dosya>Seçenekleri ve ayarları>Seçenekler>Önizleme özellikleri'nde Power BI Projesi (.pbip) kaydetme seçeneğinin onay kutusunu seçin.

Proje olarak kaydetme

Yeni bir proje üzerinde çalışıyorsanız veya mevcut bir Power BI Desktop dosyasını (pbix) açtıysanız, çalışmanızı Power BI proje dosyası (pbip) olarak kaydedebilirsiniz:

Dosyayı Power BI Projesi olarak kaydetmeyi gösteren ekran yakalama

Proje olarak kaydettiğinizde, Power BI Desktop rapor ve anlam modeli öğelerini klasör olarak kaydeder ve her birinde öğeyi tanımlayan metin dosyalarını içerir. Aşağıdakileri görürsünüz:

Power BI Project dosyalarını gösteren ekran yakalama

Proje olarak kaydettikten sonra, başlık çubuğuna bakarak proje üzerinde ne zaman çalıştığınızı görebilirsiniz:

Projeye kaydederken Power BI Desktop başlığını gösteren ekran görüntüsü.

Başlık çubuğuna tıklarsanız Power BI Projesi'ne özgü bir açılır liste görüntülenir. Bu, proje dosyalarının yanı sıra rapor ve anlam modeli için görünen ad ayarlarını bulmanıza olanak tanır. Yollara tıklayarak klasörü dosya gezgininde de açabilirsiniz.

Power BI Desktop başlığı açılır öğesini gösteren ekran görüntüsü.

Şimdi projenizin kök klasöründe gördüklerinize daha yakından bakalım:

<proje adı>. Semantik Model

Power BI anlam modelini temsil eden dosya ve klasör koleksiyonu. Model.bim gibi üzerinde çalışma olasılığınız olan en önemli dosyalardan bazılarını içerir. Buradaki dosyalar ve alt klasörler ve dosyalar hakkında daha fazla bilgi edinmek için bkz . Project Semantic Model klasörü.

<proje adı>. Rapor

Power BI raporunu temsil eden dosya ve klasör koleksiyonu. Buradaki dosyalar, alt klasörler ve dosyalar hakkında daha fazla bilgi edinmek için bkz . Project rapor klasörü.

.gitIgnore

Git'in göz ardı etmesi gereken kasıtlı olarak izlenmeyen dosyaları belirtir. Power BI Desktop, henüz yoksa kaydederken kök klasörde .gitignore dosyasını oluşturur.

Anlam modeli ve rapor alt klasörlerinin her birinde .gitIgnore içinde belirtilen varsayılan git yoksayılan dosyaları vardır:

├── project
│   ├── *.SemanticModel
│   │   ├── .pbi
│   │   │   ├── localSettings.json
│   │   │   └── cache.abf
│   ├── *.Report
│   │   ├── .pbi
│   │   │   └── localSettings.json
<proje adı.pbip>

PBIP dosyası, rapor klasörüne yönelik bir işaretçi içerir ve PBIP açıldığında hedeflenen rapor ve model yazma için açılır.

Daha fazla bilgi için pbip şema belgesine bakın.

Power BI Projesi açma

Power BI Project klasöründeki pbip dosyasını veya rapor klasöründeki pbir dosyasını açarak Power BI Desktop'ı açabilirsiniz. Her iki seçenek de raporu düzenlemek üzere açar ve semantik modele göreli başvuru varsa semantik modeli açar.

Birden çok raporu ve anlamsal modeli aynı klasöre kaydedebilirsiniz. Her raporu doğrudan rapor klasörünün içindeki .pbir dosyasından açabileceğinizden, her rapor için ayrı bir pbip dosyası olması gerekmez.

├── project
│   ├── AdventureWorks-Sales.Report
│   │   └── definition.pbir
│   ├── AdventureWorks-Stocks.Report
│   │   └── definition.pbir
│   ├── AdventureWorks.SemanticModel
|   |   └── *.*
│   .gitignore
└──  AdventureWorks.pbip

Power BI Desktop dışındaki değişiklikler

Proje olarak kaydedildiğinde, yalnızca Power BI Desktop'ta anlam modelinizde ve rapor tanımlarınızda değişiklik yapmak zorunda değilsiniz. VS Code gibi diğer araçları, Tablosal Düzenleyici gibi açık kaynak topluluk araçlarını ve hatta Not Defteri kullanabilirsiniz. Ancak, her dosya veya değişiklik dış, açık kaynak araçlarla düzenlemeyi desteklemez.

Power BI Desktop dışındaki dosya veya özelliklerde yapılan değişiklikler beklenmeyen hatalara neden olabilir, hatta Power BI Desktop'ın açılmasını engelleyebilir. Bu gibi durumlarda, projeyi Power BI Desktop'ta yeniden açmaya çalışmadan önce dosyalardaki sorunları çözmeniz gerekir.

Mümkünse, Power BI Desktop hatanın dosyasını ve konumunu gösterir:

Dosya açılamıyor hatasının ekran görüntüsü.

Aşağıdaki dosyaların şema ayrıntıları belgelenmez. Önizleme sırasında, Power BI Desktop dışında bu dosyalarda yapılan değişiklikler desteklenmez:

Model yazma

Semantik model tanımında, dış araçları iki şekilde kullanarak değişiklik yapabilirsiniz:

  • Dış araçlarla Power BI Desktop'ın Analysis Service (AS) örneğine bağlanarak.
  • VS Code veya başka bir dış araç kullanarak model.bim dosyasındaki JSON meta verilerini düzenleyerek.

Her model nesnesi yazma işlemlerini desteklemez. Değişiklikleri desteklenenlerin dışında uygulamak beklenmeyen sonuçlara neden olabilir.

Yazma işlemlerini destekleyen nesneler:

Object AS örneğine Bağlan Dosya değişikliği
Tablolar Hayır Evet
Sütunlar Evet 1, 2 Yes
Hesaplanan tablolar Yes Yes
Hesaplanmış sütunlar Yes Yes
Hiyerarşiler Yes Yes
İlişki Yes Yes
Ölçümler Yes Yes
Model KPI'leri Yes Yes
Hesaplama grupları Yes Yes
Perspectives Yes Yes
Çeviriler Yes Yes
Satır Düzeyi Güvenlik (RLS) Yes Yes
Nesne Düzeyi Güvenliği (OLS) Yes Yes
Ek Açıklamalar Yes Yes
M ifadeleri Hayır Evet 3, 4

Şunları unutmayın:

  • Power BI Desktop dışında yapılan açık dosyalarda yapılan tüm değişiklikler, bu değişikliklerin Power BI Desktop'ta gösterilmesi için yeniden başlatma gerektirir. Power BI Desktop, diğer araçlar tarafından yapılan proje dosyalarında yapılan değişikliklerin farkında değildir.

  • Power BI Desktop, birden çok bölümü olan tabloları desteklemez. Her tablo için yalnızca tek bir bölüm desteklenir. Boş bölümler veya birden fazla bölüm içeren tablolar oluşturmak, raporu açarken hataya neden olur.

  • Power BI Desktop tarafından oluşturulan otomatik tarih tabloları, dış araçlar kullanılarak değiştirilmemelidir.

  • Power BI anlam modeline veya Analysis Services modeline bağlanmak için Direct Query kullanan bir modeli değiştirirken değiştirilen nesnenin ChangedProperties ve PBI_RemovedChildren koleksiyonunu değiştirilmiş veya kaldırılmış özellikleri içerecek şekilde güncelleştirmeniz gerekir. ChangedProperties ve/veya PBI_RemovedChildren güncelleştirilmezse, Sorgu bir sonraki düzenlendiğinde veya model Power BI Desktop'ta yenilendiğinde Power BI Desktop değişikliklerin üzerine yazabilir.

  • 1 - Sütunun veri türünün değiştirilmesi desteklenir. Ancak AS örneğine bağlanırken sütunların yeniden adlandırılması desteklenmez.

  • 2 - Anlam modelinde Otomatik tarih/saat özelliği etkinse ve Power BI Desktop'ın dışında yeni bir tarih saat sütunu oluşturursanız, yerel tarih tablosu otomatik olarak oluşturulmaz.

  • 3 - Bölüm Kaynağı Türü Hesaplanmış, M, Varlık veya Hesaplama Grubu olmalıdır. Bölüm Modu İçeri Aktarma, DirectQuery veya İkili olmalıdır.

  • 4 - unappliedChanges.json içeren bir projede Power BI Desktop dışında yapılan tüm ifade düzenlemeleri, bu değişiklikler uygulandığında kaybolur.

  • Power BI Desktop dışındaki tablo sorgu ifadelerinin değiştirilmesi, Power BI Desktop yeniden başlatıldıktan sonra tablo verilerinin kaldırılmasına neden olur.

JSON dosya şemaları

Proje dosyalarının çoğu JSON biçiminde meta veriler içerir. Doğrulama ve belgeler için karşılık gelen JSON şemaları kullanılabilir.

JSON şemaları ile şunları yapabilirsiniz:

  • Yapılandırılabilir özellikler hakkında bilgi edinin.
  • Kod düzenleyicisi tarafından sağlanan satır içi JSON doğrulamasını kullanın.
  • Söz dizimi vurgulama, araç ipuçları ve otomatik tamamlama ile yazmayı geliştirin.
  • Proje meta verileri içinde desteklenen özellikler hakkında bilgi sahibi olan dış araçları kullanın.

JSON şemalarını yazılan dosyalarla eşlemek için VS Code kullanın. Proje dosyaları için JSON şemaları Power BI Desktop örnekleri Git deposunda sağlanır.

Dikkat edilecekler ve sınırlamalar

  • Bu özellik için Premium lisans gerekir.
  • Power BI Desktop, diğer araçlar veya uygulamalarla yapılan değişikliklerin farkında değildir. Dış araçlar kullanılarak yapılan değişiklikler, bu değişiklikler gösterilmeden önce Power BI Desktop'ı yeniden başlatmanızı gerektirir.
  • Duyarlılık etiketleri Power BI projeleriyle desteklenmez.
  • Hizmetteki modeller düzenlenirken diyagram görünümü yoksayılır.
  • Power BI Projesi olarak kaydederken, proje dosyaları yolunun uzunluğu üst sınırı 260 karakterdir.
  • Power BI Desktop'ta PBIP olarak doğrudan OneDrive ve SharePoint'e kaydedemezsiniz.
  • PBIP dosyalarını Power BI Desktop dışında düzenlerken, ürün reçetesi kodlaması olmadan UTF-8 kullanılarak kaydedilmelidir.
  • Rapor Dil Şeması Power BI projeleriyle desteklenmez.
  • Power BI Desktop satır sonu olarak CRLF kullanır. Farklarınızdaki sorunları önlemek için Git'i otomatik haritayı etkinleştirerek satır sonlarını işleyecek şekilde yapılandırın.
  • Power BI Projeleri şu anda Microsoft Power BI Desktop'ta desteklenmemektedir (Power BI Rapor Sunucusu için iyileştirilmiş).

Sık sorulan sorular

Soru: Anlamsal model ve rapor öğesi klasör tanımlarına baktığımızda yalnızca birkaç dosya gerekli olarak işaretleniyor, bunları silersem ne olur?

Yanıt: Power BI Desktop, proje olarak kaydettiğinizde (PBIP) bunları otomatik olarak oluşturur.

Soru: Power BI Desktop, dış bir araç veya uygulamadan Power BI Project dosyalarında yaptığım değişikliklerin farkında mı?

Yanıt: Hayır. Dosyalarda yapılan tüm değişiklikler, bu değişiklikleri yansıtacak şekilde Power BI Desktop'ın yeniden başlatılmasını gerektirir.

Soru: PBIX'i PBIP'e dönüştürürsem PBIX'e geri dönüştürebilir miyim?

Yanıt: Evet. PBIX'i PBIP olarak kaydedebilir veya PBIP'yi PBIX olarak kaydedebilirsiniz.

Soru: PBIX'i PBIP'e dönüştürebilir miyim ve tam tersi de program aracılığıyla yapılabilir mi?

Yanıt: Hayır. Power BI Desktop'ın Dosya>Farklı Kaydet'ini kullanarak PBIX'i yalnızca PBIP'ye dönüştürebilir ve tam tersi de yapabilirsiniz.

Soru: Power BI Desktop projesini Azure Analysis Services'e (AAS) veya SQL Server Analysis Services'e (SSAS) dağıtabilir miyim?

Yanıt: Hayır. Power BI Desktop proje raporu tanımları AAS ve SSAS'de desteklenmez. Model tanımları, Power BI'a özgü gelişmiş meta verileri kullanır. AAS ve SSAS projeleri için model yazma, Git ve Azure DevOps tümleştirmesi için Microsoft Visual Studio'yu kullanın.

İlgili içerik