Buat perintah (TMSL)

Artikel
12/23/2023

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

Membuat objek yang ditentukan dan semua objek turunan yang ditentukan. Jika objek sudah ada, perintah akan menimbulkan kesalahan.

Minta

Struktur permintaan bervariasi berdasarkan objek . Objek yang merupakan induk harus mencakup semua turunannya, meskipun definisi objek lengkap dari saudara dan induk tidak diperlukan.

Objek database (TMSL) Menambahkan database ke server.

{   
  "create": {   
    "database": {   
      "name": "AdventureworksDW2016",   
      "description": "<description>"   
    }   
  }   
}

Objek DataSources (TMSL)

{  
  "create": {  
    "parentObject": {  
      "database": "AdventureworksDW2016"  
    },  
    "dataSource": {  
      "name": "SqlServer localhost AdventureworksDW2016",  
      "connectionString": "Provider=SQLNCLI11;Data Source=localhost;Initial Catalog=AdventureworksDW2016;Integrated Security=SSPI;Persist Security Info=false",  
      "impersonationMode": "impersonateAccount",  
      "account": "<account name>",  
      "annotations": [  
        {  
          "name": "ConnectionEditUISource",  
          "value": "SqlServer"  
        }  
      ]  
    }  
  }  
}

Objek partisi (TMSL) Tambahkan partisi ke objek tabel induk.

{  
  "create": {  
    "parentObject": {  
      "database": "AdventureWorksTabular1200",  
      "table": "Date"  
    },  
    "partition": {  
      "name": "Date 2",  
      "source": {  
        "query": "SELECT [dbo].[DimDate].* FROM [dbo].[DimDate]",  
        "dataSource": "SqlServer localhost AdventureworksDW2016"  
      }  
    }  
  }  
}

Objek peran (TMSL) Tambahkan peran ke database secara minimal, tetapi tanpa keanggotaan atau filter.

{  
  "create": {  
    "parentObject": {  
      "database": "AdventureWorksDW2016"  
    },  
    "role": {  
      "name": "DataReader",  
      "modelPermission": "read"  
    }  
  }  
}

Kecuali untuk objek Database , objek yang sedang dibuat adalah turunan dari parentObject tertentu. Induk objek Database selalu merupakan objek Server .

Server diasumsikan dari konteks. Misalnya, jika Anda menjalankan skrip dari Management Studio atau AMO PowerShell, koneksi server akan ditentukan dalam sesi atau sebagai parameter.

Respons

Mengembalikan hasil kosong saat perintah berhasil. Jika tidak, pengecualian XMLA dikembalikan.

Contoh

Contoh 1 - Tambahkan peran yang menentukan keanggotaan dan filter.

{   
   "create":{   
      "parentObject":{   
         "database":"AdventureWorksTabular1200"  
      },  
      "role":{  
         "name":"DataReader",  
         "modelPermission":"read",  
         "members":[   
            {  
               "memberName": "account-01",  
               "memberId":"S-1-5-21-1111111111-2222222222-33333333-444444"  
            },  
            {   
               "memberName": "account-02",  
               "memberId":"S-2-5-21-1111111111-2222222222-33333333-444444"  
            }  
         ],  
         "tablePermissions":[   
            {   
               "name":"Date",  
               "filterExpression":"CalendarYear('2011')"  
            }  
         ]  
      }  
   }  
}

Penggunaan (titik akhir)

Elemen perintah ini digunakan dalam pernyataan panggilan Metode Eksekusi (XMLA) melalui titik akhir XMLA, diekspos dengan cara berikut:

Sebagai jendela XMLA di SQL Server Management Studio (SSMS)
Sebagai file input ke cmdlet PowerShell invoke-ascmd
Sebagai input ke tugas SSIS atau pekerjaan SQL Server Agent

Anda dapat membuat skrip siap pakai untuk perintah ini dari SQL Server Management Directory. Misalnya, Anda bisa mengklik kanan Database Skrip Skrip> database > yang sudah adasebagai>CREATE To.

Bagikan melalui