Model オブジェクト (TMSL)

[アーティクル]
04/18/2022

適用対象:SQL Server 2016 以降のAnalysis Services Azure Analysis Services Power BI Premium

表形式モデルを定義します。データベースごとにモデルが 1 つ、特定のコマンドで指定できるデータベースは 1 つのみです。 Database オブジェクトは親オブジェクトです。

モデル定義が大きすぎて、1 つのトピックで構文全体を再現するには大きすぎます。このため、主な部分を強調表示する部分的な構文を、子オブジェクトへのリンクと一緒に以下に示します。

おそらく、モデル定義を理解する最善の方法は、よく知っている表形式モデルから始める方法です。 [コードの表示] オプションを使用SQL Server Data Tools定義を表示します。コードを表示できるよう、JSON エディターをインストールしてください。 JSON エディターは、Visual Studio エディションまたは他のエディションCommunityダウンロードすることで、Visual Studio。

注意

どのスクリプトでも、その時点で参照できるデータベースは 1 つのみです。データベース自体以外のオブジェクトの場合、モデルを指定する場合、Database プロパティは省略可能です。モデルとデータベースの間には 1 対 1 のマッピングがあります。このマッピングを使用すると、明示的に指定されていない場合にデータベース名を見分けることができます。
同様に、モデルを削除して、データベースのプロパティを設定できます。

オブジェクト定義

すべてのオブジェクトには、名前、型、説明、プロパティコレクション、注釈など、共通のプロパティセットがあります。 モデル オブジェクトには、次のプロパティがあります。

storageLocation
モデルを配置するディスク上の場所です。

defaultMode
データをパーティションで利用できるようにする既定のメソッドです。

defaultDataView
DirectQuery モードのモデルの場合、このプロパティは、モデルに対してクエリを実行するために使用されるパーティションを決定します。有効な値には、Full と Sample が含まれます。

culture
書式設定に使用するカルチャ。

照合順序 (collation)
照合順序です。

テーブル
パーティション、列、メジャー、KPI、注釈など、モデル内のテーブルの完全なコレクション。詳細については、「Tables オブジェクト (TMSL)」を参照してください。

relationships
フィルターの方向とセキュリティを設定するプロパティを含む、テーブルの各ペア間のリレーションシップを指定します。詳細については、リレーションシップオブジェクト (TMSL) に関するページを参照してください。

データソース
モデルにデータを提供する外部データベースへの 1 つ以上の接続、またはパススルークエリに使用されます。詳細については、「DataSources オブジェクト (TMSL)」を参照してください。

roles
データベース権限、メンバーアカウント、および必要に応じて、DAX のカスタムアクセス制御用のセキュリティフィルターを関連付けるオブジェクト。

使用

モデル オブジェクトには、モデル全体が含まれます。ほとんどのコマンドでは、1 つの 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": {  }  
    }