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 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.
Temukan perintah yang ingin Anda gunakan: Referensi TMSL - Perintah
Periksa referensi definisi objek untuk objek yang digunakan dalam perintah: Referensi TMSL - Objek
Pilih metode untuk menjalankan skrip TMSL:
Jendela XMLA di SSMS
Invoke-ASCmd Cmdlet PowerShell
Tugas DDL Eksekusi Analysis Services di SSIS.
Skema definisi model
Cuplikan layar berikut menunjukkan versi singkat dari skema, diciutkan untuk menampilkan objek utama.
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 |