Aracılığıyla paylaş

Power BI Desktop projeleri (ÖNİzLEME)

  • Makale

Önemli

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

İpucu

Power BI geliştirmesini planlama hakkında yönergeler için bkz . Power BI uygulama planlaması.

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ı, anlam modeli ve rapor meta verileri içeren biçimlendirilmiş metin dosyalarıdır. Bu dosyalar genel olarak belgelenir ve insan tarafından 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.

  • Program aracılığıyla oluşturma ve öğe tanımlarını düzenleme - Tüm rapor sayfası görsellerini güncelleştirme veya her tabloya ölçü kümesi ekleme gibi toplu işlemleri etkinleştirerek, öğe tanımı metin dosyalarını program aracılığıyla oluşturabilir ve değiştirebilirsiniz. Anlamsal modeller için, anlam modeli meta verilerini seri durumdan çıkarmak, programlı değişiklikler yapmak ve dosyalara geri seri hale getirmek için Tablosal Nesne Modeli (TOM) istemci kitaplığını kullanabilirsiniz.

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

Önizleme özelliklerini etkinleştir

Power BI Desktop'ta Power BI Projesi olarak kaydetme şu anda önizleme aşamasındadır ve önizleme özelliklerinde etkinleştirmeniz gerekir.

Dosya > Seçenekleri ve ayarları > Seçenekler > Önizleme özellikleri'ne gidin ve Power BI Projesi (.pbip) kaydetme seçeneğinin yanındaki kutuyu işaretleyin.

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:

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ğunu seçerseniz Power BI Projesi'ne özgü bir açılır liste görüntülenir. Bu açılır öğe, rapor ve anlam modeli için proje dosyalarını ve 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. 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

Cache.abf ve localSettings.json gibi Git'in Power BI Project dosyaları için göz ardı etmesi gereken kasıtlı olarak izlenmeyen dosyaları belirtir.

Power BI Desktop .gitignore dosyasını yalnızca seçilen kaydetme klasöründe veya üst Git deposunda mevcut değilse oluşturur.

PBIP olarak kaydederken varsayılan .gitignore içeriği:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<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 şeması 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'ni 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:

Fabric çalışma alanına dağıt

Power BI proje dosyalarıyla çalışırken, aşağıdaki yayımlama mekanizmalarını kullanarak içeriğinizi bir Doku çalışma alanına dağıtabilirsiniz:

Not

Power BI Desktop yayımlama özelliği üzerinden, PBIX dosyasını kaydetme ve yayımlamaya benzer şekilde, hizmete yayımlanan geçici bir PBIX dosyası kullanır. Yalnızca meta verileri dağıtan diğer PBIP dağıtım seçeneklerinin aksine, bu yayımlama yöntemi hem meta verileri hem de düzenlenen anlam modelinin yerel veri önbelleğini dağıtır.

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ğlanma Dosya değişikliği / TMDL görünümü
Tablolar Hayır Evet
Sütunlar Evet 1, 2 Evet
Hesaplanan tablolar Evet Evet
Hesaplanmış sütunlar Evet Evet
Hiyerarşiler Evet Evet
İlişki Evet Evet
Ölçümler Evet Evet
Model KPI'leri Evet Evet
Hesaplama grupları Evet Evet
Perspectives Evet Evet
Çeviriler Evet Evet
Satır Düzeyi Güvenlik (RLS) Evet Evet
Nesne Düzeyi Güvenliği (OLS) Evet Evet
Ek Açıklamalar Evet Evet
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

  • 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 Power BI Rapor Sunucusu için iyileştirilmiş Microsoft Power BI Desktop sürümünde desteklenmiyor.
  • PBIP olarak kaydedilen canlı bağlantı raporları, XMLA Uç Noktasının etkinleştirilmesini gerektirir.

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

Soru: Fabric çalışma alanımı Git'e bağladığımda neden bir *.pbip dosyası yok? Power BI Desktop'ta raporumu ve anlam modelimi nasıl düzenleyebilirim?

Yanıt: PBIP dosyası isteğe bağlıdır ve yalnızca rapor klasörüne kısayol görevi görür. Rapor klasöründe bulunan definition.pbir dosyasını açarak Power BI Desktop'ta hem raporu hem de düzenleme için anlam modelini açabilirsiniz.

İlgili içerik