Power BI Desktop proje anlam modeli klasörü
Önemli
Power BI Desktop projeleri şu anda önizleme aşamasındadır.
Bu makalede, Bir Microsoft Power BI Desktop projesinin Anlam Modeli klasöründeki dosyalar ve alt klasörler açıklanmaktadır. Buradaki dosyalar ve alt klasörler bir Power BI anlam modelini temsil eder. Projenize bağlı olarak anlam modeli klasörü şunları içerebilir:
1 - Bu dosya gereklidir.
2 - Bu dosya TMSL biçimi kullanılarak kaydedilirken gereklidir.
3 - Bu dosya TMDL biçimi kullanılarak kaydedilirken gereklidir.
Her proje anlam modeli klasörü burada açıklanan tüm dosyaları ve alt klasörleri içermez.
AnlamSal Model dosyaları
.pbi\localSettings.json
Yalnızca geçerli kullanıcı ve bilgisayar için geçerli olan anlam modeli ayarlarını içerir. GitIgnore veya diğer kaynak denetimi dışlamalarına dahil edilmelidir. Varsayılan olarak Git bu dosyayı yoksayar.
Daha fazla bilgi için localSettings.json şema belgesine bakın.
.pbi\editorSettings.json
Kullanıcılar ve ortamlar arasında kullanılmak üzere anlam modeli tanımının bir parçası olarak kaydedilen anlamsal model düzenleyicisi ayarlarını içerir.
Daha fazla bilgi için editorSettings.json şema belgesine bakın.
.pbi\cache.abf
Modelin ve verilerin en son düzenlendiği yerel önbelleğe alınmış kopyasını içeren bir Analysis Services Yedekleme (ABF) dosyası. GitIgnore veya diğer kaynak denetimi dışlamalarına dahil edilmelidir. Varsayılan olarak Git bu dosyayı yoksayar.
Power BI Desktop, cache.abf dosyası olmayan bir projeyi açabilir. Bu durumda, bir modele bağlı raporu tüm tanımıyla ancak verileri olmadan açar. Cache.abf varsa, Power BI Desktop verileri yükler ve model.bim içeriğiyle model tanımının üzerine yazar.
.pbi\unappliedChanges.json
Power BI Desktop, veri modeline bu değişiklikleri uygulamadan Veri Dönüştürme düzenleyicisinde (Power Query) yapılan değişiklikleri kaydetmenizi sağlar.
Daha sonra uygula'yı seçtiğinizde, uygulanmamış değişiklikler unappliedChanges.json dosyasına kaydedilir. Bekleyen değişiklikler unappliedChanges dosyasında olduğunda, Power BI Desktop bekleyen değişiklikleri uygulamanızı veya atmanızı ister:
Değişiklikleri uygula'yı seçerseniz Power BI Desktop, model.bim dosyasındaki sorguların üzerine unappliedChanges.json gelen sorguları yazar. Power BI Desktop'ın dışındaki model.bim dosyasında sorguları düzenlediyseniz ve önceki bir unappliedChanges.json dosyası varsa, değişiklikleriniz kaybolur ve bu değişiklikler uygulandığında unappliedChanges.json sorgular tarafından değiştirilir.
unappliedChanges.json dosyası otomatik olarak anlam modeli tanımına eklenir ve varsayılan olarak Git'e kaydedilir. Bu, devam eden çalışmanızı geliştirme dalı için yürütmenize olanak tanır; bu da yedekleme görevi görür ve diğer ekip üyeleri tarafından erişilebilir hale getirir. Ancak, tamamlanmamış sorgu çalışmalarının diğer geliştiricileri etkilemesini önleyerek bu dosyayı Git'in izlemesinden hariç tutabilirsiniz.
Daha fazla bilgi için unappliedChanges.json şema belgesine bakın.
definition.pbism
Semantik modelin ve çekirdek ayarların genel tanımını içerir.
Bu dosya ayrıca 'version' özelliği aracılığıyla desteklenen anlamsal model tanımı biçimlerini belirtir.
| Sürüm | Desteklenen biçimler |
|---|---|
| 1.0 | Anlamsal model tanımı, model.bim dosyasında TMSL olarak depolanmalıdır. |
| 4.0 veya üzeri | Anlamsal model tanımı TMSL (model.bim dosyası) veya TMDL (\definition klasörü) olarak depolanabilir. |
Daha fazla bilgi için definition.pbism şema belgesine bakın.
model.bim
Bu dosya yalnızca Power BI projesi TMSL biçimi kullanılarak kaydedildiğinde kullanılabilir. Proje modelinin Tablosal Model Betik Dili (TMSL) Veritabanı nesne tanımını içerir.
tanım\ klasör
Bu klasör yalnızca Power BI projesi TMDL biçimi kullanılarak kaydedildiğinde kullanılabilir. model.bim dosyasının yerini alır.
Bu klasör, proje modelinin Tablosal Model Tanım Dili (TMDL) Veritabanı nesne tanımını içerir.
diagramLayout.json
Raporla ilişkili anlam modelinin yapısını tanımlayan diyagram meta verilerini içerir. ÖNİzLEME sırasında bu dosya dış düzenlemeyi desteklemez.
.peron
Doku öğeleri ile Git arasındaki bağlantıyı kurmak ve sürdürmek için hayati öneme sahip özellikleri barındıran doku platformu dosyası.
Daha fazla bilgi edinmek için bkz . Git tümleştirmesi otomatik olarak oluşturulan sistem dosyaları.
TMDL biçimi
Daha iyi bir kaynak denetimi ve birlikte geliştirme deneyimi sağlamak amacıyla, Tablosal Model Tanım Dili'ni (TMDL) kullanarak Power BI Project dosyalarınızı (PBIP) anlamsal model dosya biçimi olarak kaydedebilirsiniz.
Tablosal Model Betik Dilinin (TMSL) aksine, TMDL baştan sona yalnızca okunabilirliği değil, aynı zamanda herhangi bir metin düzenleyicisinde kolay düzenlemeyi kolaylaştıracak şekilde insan dostu olacak şekilde tasarlanmıştır. Bu, kaynak denetimi ve işbirliğine dayalı geliştirme deneyimleri için önemli bir geliştirmeyi temsil eder.
Tablosal Model Betik Dili (TMSL) gibi büyük bir JSON dosyası yerine, TMDL her tablo, perspektif, rol ve kültür için ayrı dosyalar içeren bir klasör yapısına sahiptir. Bu, başkalarıyla çalışmayı ve yalnızca klasöre ve dosyalara bakarak anlam modeli yapısını anlamayı kolaylaştırır. Sonuç olarak bu, git farkları ve birleştirme çakışmalarıyla ilgilenirken harika bir kaynak denetimi ve birlikte geliştirme deneyimine yol açar.
TMDL hakkında daha fazla bilgiyi burada bulabilirsiniz.
TMDL biçimi Önizleme özelliğini etkinleştirme
TMDL kullanarak Power BI Projesi olarak kaydetme işlemi şu anda önizleme aşamasındadır. Kullanmadan önce Önizleme özelliklerinde etkinleştirmeniz gerekir:
Dosya > Seçenekleri ve ayarları > Seçenekler > Önizleme özellikleri'ne gidin ve TMDL biçimini kullanarak anlam modelini depola'nın yanındaki kutuyu işaretleyin.
TMDL kullanarak proje olarak kaydetme
TMDL Önizleme özelliği etkinleştirildiğinde, projeyi kaydettiğinizde semantik modeliniz anlam modeli klasörünün içinde \definition adlı bir TMDL klasörü olarak kaydedilir:
TMDL klasör yapısı hakkında daha fazla bilgi edinin.
Mevcut PBIP'yi TMDL'ye dönüştürme
Semantik model biçimi olarak TMSL kullanan bir PBIP'niz zaten varsa, bunu aşağıdaki gibi TMDL'ye dönüştürebilirsiniz:
Power BI Desktop'ta PBIP'yi açın.
Önizleme Özelliğinin etkinleştirildiğinden emin olun.
Projeyi kaydedin . TMDL'ye yükseltmenizi isteyen bir istem görüntülenir.
Yükselt’i seçin.
Önemli
TMDL'ye yükseltildikten sonra TMSL'ye geri dönemezsiniz. TMSL'ye geri dönmek isteyebileceğinizi düşünüyorsanız, önce PBIP dosyalarınızın bir kopyasını kaydedin.
Mevcut Tablosal Model Betik Dili (TMSL) dosyası (model.bim), anlamsal modelin TMDL gösterimini içeren bir \definition klasörüyle değiştirilir.
Geçerli biçimi koru'ya seçerseniz, Masaüstü yükseltmeyi yeniden istemez.
TMDL dosyalarında dış değişiklikler yapma
TMDL dosyalarınızı okuma ve düzenleme hakkında daha iyi bir deneyim için TMDL - Visual Studio Market Microsoft VS Code uzantısını yükleyin.
VS Code kullanarak PBIP klasörünü açın ve anlamsal model tanımı klasörüne gidin.
Power BI Desktop, diğer araçlar tarafından yapılan proje dosyalarında yapılan değişikliklerin farkında değildir. Bu nedenle, Power BI Desktop dışındaki dosyaları açarken herhangi bir değişiklik yaparsanız, bu değişikliklerin Power BI Desktop'ta gösterilmesi için yeniden başlatmanız gerekir.
Power BI Desktop dışında desteklenen yazma işlemleri için lütfen buraya bakın.
TMDL Hataları
TMDL dosyalarında geçersiz düzenlemeler yapılırsa, Power BI Desktop açıkken hatanın konumuyla birlikte bir hata oluşturur:
TMDL ile ilgili önemli noktalar ve sınırlamalar
Genel Önizleme sırasında Doku Git Tümleştirmesi varsayılan olarak TMSL kullanarak anlam modelini dışarı aktarmaya devam eder. Ancak, anlamsal model TMDL biçimiyle Doku Git Tümleştirmesi kullanılarak Doku'ya aktarılırsa, hizmette herhangi bir anlam modeli değişikliği varsa Doku Git Tümleştirmesi anlam modeli tanımını Git'e aktarmak için TMDL biçimini kullanır.
Önemli
Semantik modelinizi Power BI Desktop Yayımlama gibi başka bir içeri aktarma yöntemi kullanarak içeri aktarırsanız, Doku Git Tümleştirmesi varsayılan TMSL biçimine geri döner.