Database オブジェクト (TMSL)

  • [アーティクル]

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

同じレベルのモデルに基づいて、互換性レベル 1200 以上の表形式データベースを定義します。 このトピックでは、データベースのオブジェクト定義について説明し、データベース管理タスクを作成、変更、削除、および実行する要求のペイロードを提供します。

注意

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

オブジェクト定義

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

compatibilitylevel 現在、有効な値は 1200、1400 です。 互換性レベルが低いほど、異なるメタデータ エンジンが使用されます。

readwritemode データベースのモードを列挙します。 高可用性またはスケーラビリティの構成では、データベースを読み取り専用にするのが一般的です。 有効な値には readWrite、
Readonly
または readOnlyExclusive。

使用

データベース オブジェクトは、ほぼすべてのコマンドで使用されます。 一覧については、「 表形式モデル スクリプト言語 (TMSL) のコマンド」 を参照してください。 Database オブジェクトは、Server オブジェクトの子です。

データベース オブジェクトを作成、置換、または変更する場合は、オブジェクト定義のすべての読み取り/書き込みプロパティを指定します。 読み取り/書き込みプロパティの省略は削除と見なされます。

部分的な構文

このオブジェクト定義は非常に大きいため、直接プロパティのみが一覧表示されます。 Model オブジェクトは、データベース定義の大部分を提供します。 オブジェクトの定義方法の詳細については、「 Model オブジェクト (TMSL)」 を参照してください。

    "database": {  
      "type": "object",  
      "properties": {  
        "name": {  
          "type": "string"  
        },  
        "id": {  
          "type": "string"  
        },  
        "description": {  
          "type": "string"  
        },  
        "compatibilityLevel": {  
          "type": "integer"  
        },  
        "readWriteMode": {  
          "enum": [  
            "readWrite",  
            "readOnly",  
            "readOnlyExclusive"  
          ]  
        },  
        "model": {  
          "type": "object",  
          ...  
        }  
    }