Tablosal Model Betik Dili (TMSL) Referansı

Şunlar için geçerlidir: SQL Server 2016 ve üzeri Analysis Services Azure Analysis Services Fabric/Power BI Premium

Tablosal Model Betik Dili (TMSL), uyumluluk düzeyi 1200 veya üzeri olan tablosal veri modelleri için komut ve nesne modeli tanımı söz dizimidir. TMSL, XMLA protokolü aracılığıyla Analysis Services ile iletişim kurar. Burada XMLA.Execute yöntem hem TMSL'deki JSON tabanlı deyim betiklerini hem de Analysis Services Betik Dili'ndeki (XMLA için ASSL) geleneksel XML tabanlı betikleri kabul eder.

TMSL'nin temel öğeleri:

  • Tablosal model semantiğine dayalı tablo meta verileri.

    Tablosal model tablolardan, sütunlardan ve ilişkilerden oluşur. TMSL'deki eşdeğer nesne tanımları artık şaşırtıcı değildir; tablolar, sütunlar, ilişkiler vb. Yeni meta veri altyapısı bu tanımları destekler.

  • Nesne tanımları XML yerine JSON olarak yapılandırılır.

    Yükün nasıl biçimlendirildiğinin (JSON veya XML'de) dışında, hem TMSL hem de ASSL, sunucu iletişimi ve veri aktarımı için kullanılan XMLA yöntemlerine komut ve meta veri sağlama yöntemleriyle işlevsel olarak eşdeğerdir.

TMSL'yi kullanma

TMSL betiğini keşfetmenin en kolay yolu, zaten bildiğiniz bir modelde SQL Server Management Studio'da (SSMS) CREATE, ALTER, DELETE veya Process komutlarını kullanmaktır.

  1. Kullanmak istediğiniz komutu bulun: TMSL Referans - Komutlar

  2. Komutta kullanılan nesneler için nesne tanımı başvurusunu denetleyin: TMSL Başvurusu - Nesneler

  3. TMSL betiğini yürütmek için bir yöntem seçin:

Model tanımı şeması

Aşağıdaki kod parçacığı, veritabanı uyumluluk düzeyi 1200 ve üzeri için şemanın kısaltılmış bir sürümünü gösterir ve ana nesneleri gösterecek şekilde daraltılır.

"database": {
  "description": "Database object of Tabular Object Model (TOM)",
  "type": "object",
  "properties": {
    "name": {...},
    "id": {...},
    "description": {...},
    "compatibilityLevel": {...},
    "readWriteMode": {...},
    "model": {
      "description": "Model object of Tabular Object Model (TOM)",
      "type": "object",
      "properties": {
        "name": {...},
        "description": {...},
        "storageLocation": {...},
        "defaultMode": {...},
        "defaultDataView": {...},
        "culture": {...},
        "collation": {...},
        "annotations": {...},
        "tables": {...},
        "relationships": {...},
        "dataSources": {...},
        "perspectives": {...},
        "cultures": {...},
        "roles": {...},
        // "functions": {...}, // For database compatibility level 1702 and above
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Analiz Hizmetleri'nde betik dilleri

Analysis Services, ASSL ve TMSL betik dillerini destekler. TMS'de yalnızca 1200 veya üzeri uyumluluk düzeyinde oluşturulan tablosal modeller JSON biçiminde açıklanmıştır.

Analysis Services Betik Dili (XMLA için ASSL) ilk betik diliydi ve yine de çok boyutlu modeller ve tablosal modeller için daha düşük uyumluluk düzeylerinde (1100 veya 1103) tek betik dilidir. ASSL'de 110x'teki tablosal modeller küp (model için) ve ölçü grubu (tablo için) gibi çok boyutlu terimlerle açıklanmıştır.

Uyarı

[SQL Server Veri Araçları'nda (SSDT), CompatibilityLevel'i 1200 veya üzeri bir sürüme geçirerek TMSL kullanmak için önceki bir sürüm tablosal modeli yükseltebilirsiniz. Yükseltmenin geri alınamaz olduğunu unutmayın. Yükseltmeden önce, daha sonra özgün sürüme ihtiyacınız olması durumunda modelinizi yedekleyin.

Aşağıdaki tabloda, belirli uyumluluk düzeylerinde farklı platformlarda/sürümlerde Analysis Services veri modelleri için betik dili matrisi yer alır.

Sürüm Çok boyutlu Tablosal 110x Tablosal 1200 Tablosal 1400 Tablo 1500 Tablosal 1600
Power BI Premium NA NA NA NA TMSL TMSL
Azure Analysis Services NA NA TMSL TMSL TMSL TMSL
SQL Server 2022 Analysis Services ASSL ASSL TMSL TMSL TMSL TMSL
SQL Server 2019 Analysis Services ASSL ASSL TMSL TMSL TMSL NA
SQL Server 2017 Analysis Services ASSL ASSL TMSL TMSL NA NA
SQL Server 2016 Analysis Services ASSL ASSL TMSL NA NA NA
SQL Server 2014 Analysis Services ASSL ASSL NA NA NA NA
SQL Server 2012 Analysis Services ASSL ASSL NA NA NA NA
  • Last updated on