Model 物件 (TMSL)

適用于：SQL Server 2016 和更新版本的 Analysis Services Azure Analysis Services Fabric/Power BI Premium

定義表格式模型。 每個資料庫都有一個模型，而且在任何指定的命令中只能指定一個資料庫。 Database 物件是父物件。

模型定義太大，無法重現一個主題中的整個語法。 因此，您可以在下方找到醒目提示主要部分的部分語法，其中包含子物件的連結。

或許瞭解模型定義的最佳方式是從您熟悉的表格式模型開始。 使用 SQL Server Data Tools 中的 [檢視程式碼] 選項來檢視其定義。 請記得安裝 JSON 編輯器，以便檢視程式碼。 您可以 下載 Community 版本 或其他 Visual Studio 版本，在 Visual Studio 中取得 JSON 編輯器。

注意

在任何腳本中，一次只能參考一個資料庫。 對於資料庫本身以外的任何物件，如果您指定模型，Database 屬性是選擇性的。 模型與資料庫之間有一對一對應，可在未明確提供資料庫名稱時用來推算資料庫名稱。
同樣地，您可以省略 Model，並在資料庫上設定其屬性。

物件定義

所有物件都有一組通用的屬性，包括名稱、類型、描述、屬性集合和批註。 模型 物件也有下列屬性。

storageLocation
磁碟上放置模型的位置。

defaultMode
讓資料可在分割區中使用的預設方法。

defaultDataView
對於 DirectQuery 模式中的模型，此屬性會決定使用哪些資料分割來對模型執行查詢。 有效值包括 Full 和 Sample。

culture
要用於格式化的文化特性。

collation
定序序列。

資料表
模型中資料表的完整集合，包括資料分割、資料行、量值、KPI 和批註。 如需詳細資訊，請參閱 Tables 物件 (TMSL) 。

關聯性
指定每對資料表之間的關聯性，包括設定篩選方向和安全性的屬性。 如需詳細資訊 ，請參閱 RELATIONSHIPS 物件 (TMSL) 。

dataSources
一或多個外部資料庫的連線，提供資料給模型，或用於傳遞查詢。 如需詳細資訊 ，請參閱 DataSources 物件 (TMSL) 。

角色
關聯資料庫許可權、成員帳戶，以及選擇性地在 DAX 中建立安全性篩選的物件，以進行自訂存取控制。

使用方式

模型 物件包含整個模型。 您必須在大部分命令中指定一個 Model 和/或其父 Database 物件。

建立、取代或改變模型物件時，請指定物件定義的所有讀寫屬性。 省略讀寫屬性會被視為刪除。

部分語法

因為這個物件定義太大，所以只會列出第一層屬性。 如需子 物件清單，請參閱表格式模型指令碼語言中的物件定義 (TMSL) 。

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