Referensi Bahasa Skrip Model Tabular (TMSL)

  • Artikel

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 tradisional berbasis XML dalam Analysis Services Scripting Language (ASSL untuk XMLA).

Elemen kunci TMSL:

  • Metadata tabular berdasarkan semantik model tabular.

    Model tabular terdiri dari tabel, kolom, dan hubungan. Definisi objek yang setara dalam TMSL sekarang, tidak mengherankan, tabel, kolom, hubungan, dan sebagainya. Mesin metadata baru mendukung definisi ini.

  • Definisi objek disusun sebagai JSON alih-alih XML.

    Dengan pengecualian tentang bagaimana payload diformat (baik dalam 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 termampu 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 gunakan: 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 layar berikut menunjukkan versi singkat dari skema, diciutkan untuk menampilkan objek utama.

SSAS_TabularMetadata

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 for XMLA) adalah bahasa pembuatan skrip pertama, dan masih merupakan satu-satunya bahasa pembuatan skrip untuk model Multidmensional dan model Tabular pada tingkat kompatibilitas yang lebih rendah (1100 atau 1103). Dalam ASSL, model tabular pada 110x dijelaskan dalam istilah multidmensional, seperti kubus (untuk model) dan measuregroup (untuk tabel).

Catatan

Di [SQL Server Data Tools (SSDT), Anda dapat meningkatkan model tabular versi yang lebih lama untuk menggunakan TMSL dengan mengalihkan CompatibilityLevel ke 1200 atau lebih tinggi. Ingat bahwa peningkatan tidak dapat dibatalkan. Sebelum memutakhirkan, cadangkan model Anda jika Anda memerlukan versi aslinya nanti.

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