Objek model (TMSL)

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

Menentukan model tabular. Ada satu model per database, dan hanya satu database yang dapat ditentukan dalam perintah tertentu. Objek Database adalah objek induk.

Definisi model terlalu besar untuk mereproduksi seluruh sintaks dalam satu topik. Untuk alasan ini, sintaksis parsial yang menyoroti bagian utama dapat ditemukan di bawah ini, dengan tautan ke objek anak.

Mungkin cara terbaik untuk memahami definisi model adalah memulai dengan model tabular yang Anda kenal dengan baik. Gunakan opsi Tampilkan Kode di SQL Server Data Tools untuk melihat definisinya. Ingatlah untuk menginstal editor JSON sehingga Anda dapat melihat kode. Anda bisa mendapatkan editor JSON di Visual Studio dengan mengunduh Edisi Komunitas atau edisi Visual Studio lainnya.

Catatan

Dalam skrip apa pun, hanya satu database pada saat itu yang dapat dirujuk. Untuk objek apa pun selain database itu sendiri, properti Database bersifat opsional jika Anda menentukan model. Ada pemetaan satu-ke-satu antara Model dan Database yang dapat digunakan untuk menyimpulkan nama Database jika tidak disediakan secara eksplisit.
Demikian pula, Anda dapat meninggalkan Model, mengatur propertinya di Database.

Definisi objek

Semua objek memiliki sekumpulan properti umum, termasuk nama, jenis, deskripsi, koleksi properti, dan anotasi. Objek model juga memiliki properti berikut.

storageLocation
Lokasi pada disk untuk menempatkan model.

defaultMode
Metode default untuk membuat data tersedia di partisi.

defaultDataView
Untuk model dalam mode DirectQuery, properti ini menentukan partisi mana yang digunakan untuk menjalankan kueri terhadap model. Nilai yang valid termasuk Lengkap dan Sampel.

kultur
Budaya yang digunakan untuk pemformatan.

Pemeriksaan
Urutan kolace.

tabel
Kumpulan lengkap tabel dalam model, termasuk partisi, kolom, pengukuran, KPI, dan anotasi. Lihat Objek tabel (TMSL) untuk detailnya.

hubungan
Menentukan hubungan antara setiap pasangan tabel, termasuk properti yang mengatur arah filter dan keamanan. Lihat Objek hubungan (TMSL) untuk detailnya.

dataSources
Satu atau beberapa koneksi ke database eksternal yang menyediakan data ke model atau digunakan untuk kueri pass through. Lihat Objek DataSources (TMSL) untuk detailnya.

peran
Objek yang mengaitkan izin database, akun anggota, dan secara opsional, filter keamanan di DAX untuk kontrol akses kustom.

Penggunaan

Objek model berisi seluruh model. Anda perlu menentukan satu Model dan/atau objek Database induknya di sebagian besar perintah.

Saat membuat, mengganti, atau mengubah objek model, tentukan semua properti baca-tulis definisi objek. Kelalaian properti baca-tulis dianggap sebagai penghapusan.

Sintaks parsial

Karena definisi objek ini sangat besar, hanya properti tingkat pertama yang terdaftar. Lihat Definisi Objek dalam Tabular Model Scripting Language (TMSL) untuk daftar objek anak.

    "model": {  
      "description": "Model object of a tabular database",  
      "type": "object",  
      "properties": {  
          "name": {  },  
          "description": {  },  
         "storageLocation": {  },  
         "defaultMode":  {  },  
         "defaultDataView": {  },  
         "culture": {  },  
         "collation": {  },  
         "annotations": {  },  
         "tables": {  },  
         "relationships": {  },  
         "dataSources": {  },  
         "perspectives": {  },  
            "cultures": {  },  
         "roles": {  }  
    }