Power BI Desktop proje anlam modeli klasö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:

• .pbi\
  • localSettings.json
  • editorSettings.json
  • cache.abf
  • unappliedChanges.json
• DAXQueries\ klasörü
• TMDLScripts\ klasörü
• tanım\ klasör³
• model.bim²
• diagramLayout.json
• .platform
• definition.pbism¹

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.jsaçık konumda

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.jsaçık

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 tanımını projedeki anlamsal model meta verileriyle üzerine yazar.

.pbi\unappliedChanges.jsaçık

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, anlam modeli meta verilerindeki sorguları unappliedChanges.json'dan alınan sorgularla değiştirecektir. Power BI Desktop dışındaki sorguları düzenlediyseniz ve önceki bir unappliedChanges.json dosyası varsa, değişiklikleriniz kaybolur ve bu değişiklikler uygulandığında unappliedChanges.json içindeki 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.

tanım.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. Bu dosyayı harici olarak düzenleyemezsiniz.

.platform

Git ile Doku öğeleri arasındaki bağlantıyı kurmak ve sürdürmek için hayati öneme sahip özellikleri barındıran Doku platform dosyası.

Daha fazla bilgi edinmek için Git tümleştirmesi ile otomatik olarak oluşturulan sistem dosyaları'na bakın.

DAXQueries\ klasörü

DAX dosyası olarak kaydedilen her DAX sorgu görünümü sorgu sekmesi için bir [Tab name].dax dosya içerir.

.pbi\daxQueries.json

Varsayılan sekme veya sekme sırası gibi DAX sorgu görünümü düzenleyicisi ayarlarını içerir.

TMDLScripts\ klasörü

TMDL dosyası olarak kaydedilen her TMDL görünümü betik sekmesi için bir [Tab name].tmdl dosya içerir.

.pbi\tmdlscripts.json

Varsayılan sekme veya sekme sırası gibi ayarları içeren TMDL görünüm düzenleyicisi.

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 dosyalarında dış değişiklikler yapma

Proje Power BI Desktop'ta açık kalırken TMDL dosyalarını Visual Studio Code veya başka bir dış araçta düzenleyebilirsiniz. Daha iyi bir TMDL düzenleme deneyimi için Visual Studio Code için TMDL uzantısını yükleyin.

Dosyaları harici olarak düzenlemeden önce, Power BI Desktop'ta değişiklikleri kaydedin. VS Code'da PBIP klasörünü açın, anlam modeli definition klasörüne gidin ve TMDL değişikliklerinizi kaydedin. Power BI Desktop, kaydedilen değişiklikleri algılar ve Dış değişiklikleri uygula başlığını görüntüler. Semantik modeli projeyi kapatıp yeniden açmadan yeniden yüklemek için Dış değişiklikleri uygula'yı seçin.

Power BI Desktop'ta kaydedilmemiş değişiklikler varsa, dış değişikliklerin uygulanmasının bunların üzerine yazılacağı konusunda sizi uyarır. İş akışının tamamı ve sınırlamalar için bkz. Power BI Desktop dışında PBIP dosyalarını düzenleme.

Power BI Desktop dışında desteklenen yazma işlemleri için bkz. Model yazma.

TMDL hataları

TMDL düzenlemesi geçersizse, dış değişiklikleri uyguladığınızda veya projeyi açtığınızda Power BI Desktop bir hata görüntüler. Hata, Power BI Desktop'ın güncelleştirilmiş anlam modelini yükleyebilmesi için düzeltmeniz gereken konumu tanımlar:

İlgili içerik

• Power BI Desktop proje raporu klasörü
• Power BI Desktop projeleri
• Tablosal Model Betik Dili (TMSL)