Referensi Bahasa Skrip Model Tabular (TMSL)

Berlaku untuk: SQL Server 2016 dan yang lebih baru Analysis Services Azure Analysis Services Fabric/Power BI Premium

Tabular Model Scripting Language (TMSL) adalah sintaks definisi model perintah dan objek untuk model data tabular pada tingkat kompatibilitas 1200 atau lebih tinggi. TMSL berkomunikasi dengan Analysis Services melalui protokol XMLA, di mana XMLA.Execute metode menerima skrip pernyataan berbasis JSON di TMSL serta skrip berbasis XML tradisional dalam Analysis Services Scripting Language (ASSL untuk XMLA).

Elemen utama TMSL:

  • Metadata berbentuk tabel berdasarkan semantik model tabel.

    Model tabular terdiri dari tabel, kolom, dan hubungan. Definisi objek yang setara dalam TMSL sekarang, seperti yang diharapkan, tabel, kolom, hubungan, dan lain-lain. Mesin metadata baru mendukung definisi ini.

  • Definisi objek disusun sebagai JSON alih-alih XML.

    Dengan pengecualian tentang bagaimana payload diformat (baik di JSON atau XML), TMSL dan ASSL secara fungsional setara dalam cara mereka menyediakan perintah dan metadata ke metode XMLA yang digunakan untuk komunikasi server dan transfer data.

Cara menggunakan TMSL

Cara term mudah untuk menjelajahi skrip TMSL adalah menggunakan perintah CREATE, ALTER, DELETE, atau Process di SQL Server Management Studio (SSMS) pada model yang sudah Anda ketahui.

  1. Temukan perintah yang ingin Anda pakai: Referensi TMSL - Perintah

  2. Periksa referensi definisi objek untuk objek yang digunakan dalam perintah: Referensi TMSL - Objek

  3. Pilih metode untuk menjalankan skrip TMSL:

Skema definisi model

Cuplikan berikut menunjukkan versi singkat skema untuk kompatibilitas database tingkat 1200 ke atas, diciutkan untuk menampilkan objek utama.

"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
}

Bahasa pembuatan skrip di Analysis Services

Analysis Services mendukung bahasa skrip ASSL dan TMSL. Hanya model tabular yang dibuat pada tingkat kompatibilitas 1200 atau lebih tinggi yang dijelaskan dalam TMS dalam format JSON.

Analysis Services Scripting Language (ASSL untuk XMLA) adalah bahasa pembuatan skrip pertama, dan masih merupakan satu-satunya bahasa pembuatan skrip untuk model Multidirmansional dan model Tabular pada tingkat kompatibilitas yang lebih rendah (1100 atau 1103). Di ASSL, model tabular pada 110x dijelaskan dalam istilah multidmensional, seperti kubus (untuk model) dan grup ukuran (untuk tabel).

Nota

Di [SQL Server Data Tools (SSDT), Anda dapat meningkatkan model tabular versi sebelumnya untuk menggunakan TMSL dengan mengalihkan CompatibilityLevel ke 1200 atau lebih tinggi. Ingat bahwa peningkatan tidak dapat dikembalikan. Sebelum memutakhirkan, buat cadangan model Anda jaga-jaga jika nanti memerlukan versi aslinya.

Tabel berikut adalah matriks bahasa pembuatan skrip untuk model data Analysis Services di berbagai platform/versi pada tingkat kompatibilitas tertentu.

Versi Multidimensi Tabular 110x Tabular 1200 Tabular 1400 Tabular 1500 Tabular 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