Power BI Desktop'ta TMDL görünümüyle çalışma (önizleme)

TMDL görünümü, Power BI Desktop'ta Tablosal Model Tanımlama Dili (TMDL) kullanarak modern bir kod düzenleyicisiyle anlamsal model nesnelerini betiklemenize, değiştirmenize ve bu nesnelere değişiklikler uygulamanıza olanak sağlayarak geliştirme verimliliğini artırır ve anlam modeli meta verileri üzerinde tam görünürlük ve denetim sağlar.

TMDL görünümü, Model görünümügibi grafik kullanıcı arabirimi yerine kod kullanarak anlamsal modellemeye alternatif bir deneyim sunar.

TMDL görünümü aşağıdaki avantajları sunar:

• Gelişmiş geliştirme verimliliği, arama ve değiştirme, klavye kısayolları, çok satırlı düzenlemeler ve daha fazlasını içeren zengin bir kod düzenleyicisiyle.
• TMDL betiklerini, anlam modeli geliştiricileri arasında kolayca yazarak, paylaşarak ve yeniden kullanarak yeniden kullanılabilirliğini artırın. Örneğin, takvim tabloları veya akıllı zaman gösterimi hesaplama grupları gibi yeniden kullanılabilir anlamsal model nesnelerini kolayca paylaşmak için merkezi bir SharePoint sitesi kullanın.
• tüm anlam modeli nesnelerini ve özelliklerini gösteren ve IsAvailableInMDX veya DetailRowsDefinitiongibi Power BI Desktop kullanıcı arabiriminde bulunmayan öğelerde değişikliklere izin verendaha fazla denetim ve saydamlık elde edin.

Önizleme özelliğini etkinleştirme

TMDL görünümünü kullanmak için önizleme özelliğini etkinleştirmeniz gerekir. Power BI Desktop'ta Dosya Seçenekleri ve ayarları Seçenekler Önizleme özellikleri'i seçin ve TMDL Görünümüyanındaki kutuyu seçin.

TMDL Komut Dosyası

Power BI Desktop'ta, aşağıdaki görüntüde gösterildiği gibi pencerenin sol tarafında bulunan TMDL görünümü simgesini seçin.

TMDL görünümü açıldığında kod düzenleyicisi başlangıçta boş olur. Veri bölmesinden nesneleri seçip kod düzenleyicisine sürükleyerek tablo, ölçü veya sütun gibi herhangi bir anlam modeli nesnesi betiği oluşturabilirsiniz:

Power BI, TMDL görünümünü kullandığınızda ve nesneyi Veri bölmesinden sürüklediğinizde, nesne meta verilerinin tamamını geçerli sekmeye TMDL olarak yazar. Eğer geçerli sekme boş değilse, aşağıdaki görüntüde gösterildiği gibi, seçili nesnelerin createOrReplace TMDL betiği oluşturularak yeni bir sekme açılır.

Alternatif olarak, Veri görünümünde bir nesneye sağ tıklayabilir ve aşağıdaki görüntüde gösterilen yeni sekmeye veya panoya Betik TMDL seçebilirsiniz:

Bahşiş

Nesneleri TMDL görünüm kodu düzenleyicisinde betik oluşturmadan önce CTRL tuşuna basılarak çoklu seçim desteklenir.

Kod düzenleyicisi

Bir anlam modeli nesnesi betiği oluşturdunuz veya TMDL betiğini kod düzenleyicisine yapıştırdıktan sonra, TMDL görünüm kod düzenleyicisi tarafından sunulan kapsamlı kod deneyimi özelliklerini kullanabilirsiniz. Kod deneyimi özellikleri, model meta verilerini keşfetmenizi veya daha sonra anlam modeline uygulanabilecek değişiklikler yapmanızı sağlar.

Anlamsal vurgulama

Anlamsal vurgulama, kod düzenleyicisinde yerleşik olarak bulunur ve bu da kodunuzun anlam temelinde bölümlerine farklı renkler uygulayarak okunabilirliği artırır. Bu tür renk kodlaması, aşağıdaki görüntüde gösterildiği gibi TMDL kodunuzun yapısını ve işlevselliğini anlamayı kolaylaştırır.

Ayrıca, aşağıdaki görüntüde gösterildiği gibi TMDL betiğinizin bölümlerini genişletebilir veya daraltabilirsiniz:

Otomatik Tamamlama

Otomatik tamamlama, kod düzenleyicisinde yerleşiktir ve siz yazarken akıllı öneriler sunar. Otomatik tamamlama, iş akışınızı hızlandırabilir, hata olasılığını azaltabilir ve imleç konumunu dikkate alarak olası değerleri veya özellikleri dinamik olarak önererek kod seçeneklerinizi anlamanıza yardımcı olabilir.

Ayrıca, Ctrl+Ara Çubuğutuşlarına basarak da herhangi bir konumda otomatik tamamlama özelliğini tetikleyebilirsiniz.

Tooltiplar

"Bağlam ipucu fareyle üzerine gelindiğinde gösterilir ve her TMDL nesnesi veya özelliği hakkında bilgi sağlar."

Kod eylemleri

İmleç dalgalı veya seçili bir metin üzerindeyken, TMDL görünümünde köken etiketleri oluşturma veya özellik adı yazım hatalarını düzeltme gibi kullanılabilir Kod Eylemleri'ni gösteren bir ampul simgesi görüntülenir.

Kod biçimlendirme

Shift + Alt + F tuşlarına basarak veya şeritteki Biçim seçeneğine tıklayarak TMDL kodunuzu biçimlendirin.

Bağlam menüsündeki "Seçimi Biçimlendir" seçeneğini kullanarak da seçili metni biçimlendirebilirsiniz.

Hata tanılama

Kod düzenleyicisinin yerleşik hata tanılamaları, kod düzenleyicisinde TMDL dil hatalarını vurgulayarak sorunları belirlemenize ve çözmenize yardımcı olur ve bunları çözme konusunda rehberlik sağlayan ayrıntılı iletiler sunar. Ayrıca, Sorunlar bölmesinde bir hata özeti bulunur, aşağıdaki görüntüde gösterildiği gibi kod düzenleyicisinde hata konumuna kolayca gezinmeye olanak sağlar.

Anlam modeline değişiklikleri uygulama

Hazır olduğunuzda, Uygula düğmesini seçerek TMDL betiğini anlam modeline göre yürütebilir ve TMDL kod değişikliklerinizin uygulanmasını sağlayabilirsiniz.

Başarılı olduğunda bir bildirim görüntülenir ve modelleme değişikliğiniz anlam modeline uygulanır.

Hata durumunda, modelleme değişikliklerinizin anlam modeline uygulanmadığını gösteren bir hata bildirimi görüntülenir. Bildirimde Ayrıntıları göster bağlantısını seçerek hata hakkında daha fazla bilgi görüntüleyebilir ve ardından Çıktı bölmesini genişleterek ve hata ayrıntılarını görüntüleyebilirsiniz.

Not

TMDL görünümü, verileri yenilemeden veya raporu etkilemeden yalnızca anlamsal model meta verilerini değiştirir. Değişiklikleriniz PowerQuery ifadesini veya hesaplanmış sütun ifadesini değiştirme gibi bir veri yenilemesi gerektiriyorsa değişikliklerin etkili olması için tabloyu veya modeli el ile yenilemeniz gerekir. Ayrıca, TMDL görünümünde bir alanı yeniden adlandırmak, raporun içinde bu alanı kullanan görselleri kesebilir.

Semantik modelde değişiklikleri önizleme

TMDL görünümü, TMDL kod farkı olarak gösterilen betik yürütme öncesi ve sonrası semantik modelin önizlemesini göstererek betik değişikliklerini önizlemenize olanak tanır. Betik değişikliklerini önizlemek, diğer kaynaklardan betikleri kopyalarken bunları semantik modelinizde çalıştırmadan önce etkilerini değerlendirmenizi sağlar ve bu durum özellikle yararlıdır.

Önizleme düğmesinin seçilmesi, açılan sekmede TMDL betiğini yürütmeden önce ve çalıştırdıktan sonra semantik modelin TMDL farkını görüntüler.

Aşağıdaki görüntüde gösterildiği gibi, sağ bölmede yan yana bir pencere görüntülenir.

Kırmızı ve yeşil kutular değişiklikleri vurgular; kırmızı kutular kaldırılmış veya değiştirilmiş çizgileri, yeşil ise yeni çizgileri gösterir.

Not

Karşılaştırma, şu anda görüntülenen TMDL betiğiyle doğrudan değil, betiği yürütmeden önce ve sonra kapsamlı bir anlam modeli karşılaştırmasıdır. Bu nedenle bazı özellikler, varsayılan TMDL özelliğine/nesne sıralamasına bağlı olarak sekmede gösterilenden farklı şekilde sıralanabilir.

Önizleme salt okunurdur, ancak betiğinizi düzenlemeye devam edebilirsiniz. Değişikliklerden sonra önizlemeyi yenilemek için, aşağıdaki görüntüdeki başlıkta gösterildiği gibi Önizlemeyi Güncelleştir düğmesini seçin.

Önizleme ekranının sağ üst köşesinde, tüm kod farklarında gezinmeyi sağlayan, satır içi veya yan yana fark arasında geçiş yapmanıza, değişmemiş bölgeleri görüntülemenize veya gizlemenize ve önizleme görünümünü kapatmanıza olanak tanıyan bir araç çubuğu vardır.

Anlamsal modelde yapılan değişikliklerin önizlemesini yaparken dikkat edilmesi gereken birkaç nokta vardır:

• TMDL görünümü, her önizleme yürütmesinde görünüm yapılandırmalarını varsayılan olarak sıfırlar.
• Önizleme yalnızca geçerli bir TMDL değişikliğiyle çalışır. Geçersiz TMDL betikleri önizleme yürütmez ve Çıkış bölmesinde bir hata görüntülenir.

TMDL komut dosyası sekmeleri

TMDL görünümünde aynı anda birden çok betik sekmeniz olabilir ve bu sekmelerden herhangi biri yeniden adlandırılabilir veya kaldırılabilir.

TMDL görünümünün sekmelerinin içeriği, Power BI Desktop raporunu kaydettiğinizde rapor dosyasına kaydedilir; böylece Power BI Desktop rapor dosyasını bir sonraki açışınızda kaldığınız yerden devam edebilirsiniz. bir Power BI Projesine (PBIP) kaydederken, aşağıdaki görüntüde gösterildiği gibi her betik sekmesi \TMDLScripts klasörüne bir .tmdl dosyası olarak kaydedilir.

Bahşiş

Visual Studio Code'da TMDL betiklerini açabilir ve düzenleyebilirsiniz. Power BI Desktop yeniden başlatıldıktan sonra düzgün bir şekilde yeniden yüklenirler.

Sorunları ve Çıktı bölmeleri, şu anda seçili olan ve görüntülenen betik sekmesine özgü hataları ve iletileri görüntüler. Farklı bir TMDL betik sekmesine geçmek, bu bölmelerin her ikisini de seçili ve şu anda gösterilen sekmeye özgü bilgilerle yeniler.

Temizle düğmesini seçerek Çıktı bölme iletilerini boşaltabilirsiniz.

İletiler yalnızca her Power BI Desktop oturumu için tutulur, bu nedenle Power BI Desktop'ın yeniden başlatılması tüm betik sekmeleri için tüm çıkış iletilerini temizler.

Uyumluluk düzeyi yükseltme istemi

Power BI anlam modelinin uyumluluk düzeyi , erişilebilir özellikleri belirler. TMDL görünümü, geçerli uyumluluk düzeyinde kullanılamasa bile herhangi bir Analysis Services nesnesi veya özelliği eklemenize olanak tanır. Uyumluluk düzeyi yükseltmesi gerektiren bir değişiklik uygulanırken, TMDL görünümü yükseltmeyi gerektiren nesne veya nesneleri belirten bir istem sağlar.

TMDL görünümüyle nesne yeniden adlandırma

TMDL görünümündeki bir nesneyi yeniden adlandırmak için üst öğesinin betiği yazılmalıdır. Örneğin, bir sütunu yeniden adlandırmak için tablonun betiğinin yazılması gerekirken, bir tablonun yeniden adlandırılması ise tüm anlamsal modelin betiğinin yazılması gerekir. Aşağıdaki belgede tablosal nesne modeli hiyerarşisi hakkında daha fazla bilgi edinin: Tablosal nesne modeli hiyerarşisi.

TMDL görünümüyle, basit bulma ve değiştirme desenleri kullanılarak toplu yeniden adlandırma verimli bir şekilde gerçekleştirilebilir. Örneğin, aşağıdaki adımları izleyerek tüm tablo sütunlarını küçük harfle yeniden adlandırabilirsiniz.

TMDL görünümünü açın, değiştirmek istediğiniz tablonun betiğini yazın.

Bul ve değiştir iletişim kutusunu açmak için CTRL+F tuşlarına basın, Normal İfade seçeneğinin etkinleştirildiğinden emin olun.

Bul ve değiştir alanlarına aşağıdaki desenleri girin ve Tümünü Değiştir'i seçin.

Eylem	Desen/Değiştirme
Bulmak	(^\s+column\s+)(.+)
Değiştir	$1\L$2

TMDL betiğinizi çalıştırarak tüm tablo sütunlarını anında küçük harfle yeniden adlandırın:

Sütun adının sourceColumn özelliğinden farklı olduğuna dikkat edin.

Anlam modeli tablosu ile Power Query sorgusu arasındaki eşitleme sourceColumn'a dayanır ve adları bağımsız tutar. Power Query düzenleyicisini açtığınızda, model sütun adı yerine sourceColumn ile eşleşen sütun adları görüntülenir. Ayrıca, kullanıcı arabirimindeki bir sütunu yeniden adlandırmak, sourceColumn ve sütun adı aynı olana kadar sorguya otomatik olarak yeniden adlandırma adımı eklemez.

TMDL görünümü ve Power BI projesi

Çalışmanızı bir Power BI projesi (PBIP) olarak kaydettiğinizde,TMDL dosyaları olarak anlam modeli tanımı meta verilerinize erişim sağlar, yararlı bir kaynak denetimi ve birlikte geliştirme deneyimi sunar ve ayrıca Power BI Desktop dışında anlamsal model üzerinde değişiklikler yapabilmenize olanak tanır. Ancak PBIP içindeki TMDL dosyalarını değiştirirseniz, bu değişiklikleri yeniden yüklemek için Power BI Desktop'ı yeniden başlatmanız gerekir. Buna karşılık, TMDL yaklaşımı betik tabanlı bir zihinsel modeli takip eder ve dosya biçiminin PBIX ya da PBIP olması fark etmeksizin, TMDL kullanarak Power BI Desktop üzerinde düzenlenen anlamsal modele değişiklikleri doğrudan ve verimli bir şekilde uygulamanıza olanak tanır.

Her iki deneyimi de sorunsuz bir şekilde tümleştirebilirsiniz. Örneğin, Power BI Desktop'ı başlatmadan hızlı değişiklikler için PBIP'deki TMDL tanımını güncelleştirebilir ve TMDL kullanarak anlam modelinde bir dizi değişikliği verimli bir şekilde uygulamak için Power BI Desktop zaten açıkken TMDL görünümünü kullanabilirsiniz. Her iki yaklaşım da zengin ve tutarlı bir TMDL kodlama deneyimi sunar.

TMDL görünümü için yaygın kullanım örnekleri

Senaryosu: bir anlam modeli tablosunu sütunlar, Power Query ifadesi ve yapılandırmaya göre sıralama ve başka bir anlam modelindeki diğerleri gibi tam tanımıyla yeniden kullanmam veya paylaşmam gerekir.

Çözümü: Tabloyla anlamsal modeli açın, TMDL görünümünü kullanarak betikleyin. Betiği diğer Power BI Desktop penceresine kopyalayın, TMDL görünüm sekmesini açın ve betiği uygulayın.

---

Senaryosu: tüm tablolarımı "dim_" veya "fact_" ön ekleriyle adlandırdım. 100'den fazla tablonun her birini el ile güncelleştirmeden bu ön ekleri kaldırmak istiyorum.

Çözümü: TMDL görünümünü açın, anlam modelini betikleyin, ön eki arayın (normal ifadeler desteklenir) ve boş bir metinle değiştirin.

---

Senaryosu:kişiselleştirilmiş görseller özelliğini kullanmak için anlam modelimde bir perspektif oluşturmam gerekir. Ancak, Power BI Desktop'ın grafik arabirimini kullanarak oluşturamıyorum veya düzenleyemiyorum.

Çözüm: TMDL görünümünü açın, yeni bir boş sekme oluşturun (veya mevcut bir perspektiften betiği kullanın), ardından TMDL kullanarak perspektifi oluşturun veya düzenleyin. Bu yöntem çeviriler, ayrıntı satırı ifadeleri ve diğerleri gibi grafik arabirim içermeyen diğer anlamsal model meta verileri için de geçerlidir.

createOrReplace
      perspective SalesView
        perspectiveTable Sales
            perspectiveMeasure 'Sales Amount'
            perspectiveMeasure 'Sales Qty'
            perspectiveColumn Quantity
            perspectiveColumn 'Amount'

---

Senaryosu: yenileme tetiklemeden tablomun Power Query ifadesini değiştirmem gerekiyor.

Çözümü: Tabloyu betikle, Power Query ifadesini değiştir ve değişiklikleri uygula. TMDL görünümü, verilerinizin yenilenmesini gerektirmez.

---

Senaryosu: Tablomun depolama modunu DirectQuery'den İçeri Aktarma'ya (veya tersi) değiştirmem gerekiyor

Çözümü: Tabloyu betikleyin, bölme modunu güncelleyin ve değişiklikleri uygulayın.

---

Senaryosu: önemli değişiklikler yapmadan önce anlam modeli tanımımı yedeklemem ve gerekirse önceki bir tanıma kolayca geri dönmem gerekiyor.

Çözüm: Yedeklemek istediğiniz semantik modeli veya belirli bölümleri betikleyin, değişikliklerinizi diğer görünümlerde yapın ve gerekirse, kaydedilmiş betiği çalıştırarak önceki meta verileri geri yüklemek için TMDL görünümüne dönün.

---

Dikkat edilmesi gerekenler ve sınırlamalar

TMDL görünümü şu anda önizleme aşamasında olduğundan aşağıdaki sınırlamaları göz önünde bulundurun:

• Anlamsal model içindeki herhangi bir nesneyi veya özelliği düzenlemek için TMDL görünümünü kullanabilirsiniz. Ancak eksik veya yanlış değişiklikler beklenmeyen davranışlara yol açabilir. Bu işlemler hakkında daha fazla kılavuz için Model Yazma makalesine bakın.
• Komut paleti şu anda desteklenmeyen bazı komutları görüntüler.
• Çalışma alanının ilk Git tümleştirme ayarlanması, yayımlanan anlam modelinde kaydedilen TMDL Görünümü betiklerini içermez. Fabric Git tümleştirmesi makalesinde daha fazla bilgi edinin.
• Ölçüler, Sütunlar ve benzeri model gezgini gruplarını betikleyemezsiniz.

İlgili içerik

Aşağıdaki makalelerde TMDL ve kullanımları hakkında daha fazla bilgi ve bulabilirsiniz.

• TMDL kullanmaya başlama
• Tablosal Model Tanım Dili (TMDL)
• Power BI Desktop projelerini (önizleme)
• Power BI Desktop proje anlamsal modeli klasörü