Partitions オブジェクト (TMSL)

[アーティクル]
12/23/2023

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

テーブル行セットのパーティション (論理セグメント化) を定義します。パーティションは、データのインポート、モデリング環境でのサンプルデータ、または DirectQuery を使用したパススルークエリ実行の完全なデータクエリとして使用される、Power Query M または SQL クエリで構成されます。

パーティションのプロパティによって、テーブルのデータのソース方法が決まります。オブジェクト階層では、パーティションの親オブジェクトはテーブルオブジェクトです。

オブジェクト定義

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

型
パーティションの種類。有効な値は数値であり、次のものが含まれます。

クエリ (1) – このパーティション内のデータは、 DataSource に対してクエリを実行することによって取得されます。 DataSource は、model.bim ファイルで定義されているデータソースである必要があります。
計算 (2) – このパーティション内のデータは、計算式を実行することによって設定されます。
なし (3) – このパーティション内のデータは、更新操作の一環としてデータの行セットをサーバーにプッシュすることによって設定されます。

mode
パーティションのクエリモードを定義します。有効な値は、 インポート、 DirectQuery、または 既定値 (継承) です。この値は必須です。

値	説明
[インポート]	インポートされたデータを格納するメモリ内分析エンジンに対してクエリ要求が発行されたことを示します。
DirectQuery	クエリ実行を外部リレーショナルデータベースに渡します。 DirectQuery モードでは、パーティションを使用して、モデルの設計時に使用されるサンプルデータが提供されます。運用サーバーにデプロイする場合は、フルデータビューに戻る必要があります。 DirectQuery モードでは、テーブルごとに 1 つのパーティションと、モデルごとに 1 つのデータソースが必要であることを思い出してください。
default	モデルまたはデータベースレベルでオブジェクトツリーの上位にモードを切り替える場合は、これを設定します。既定を選択すると、クエリモードはインポートまたは DirectQuery になります。

source
クエリを実行するデータの場所を識別します。有効な値は 、クエリ、計算、または なしです。この値は必須です。

値	説明
"なし"	データが読み込まれ、メモリに格納されるインポートモードに使用されます。
query	DirectQuery モードの場合、これはモデルの DataSource で指定されたリレーショナルデータベースに対して実行される SQL クエリです。 DataSources オブジェクト (TMSL) を参照してください。
計算	計算テーブルは、テーブルの作成時に指定された式から取得されます。この式は、計算テーブル用に作成されたパーティションのソースと見なされます。

Dataview
DirectQuery パーティションの場合、追加の dataView プロパティは、データを取得するクエリがサンプルか完全なデータセットかをさらに指定します。有効な値は 、完全、 サンプル、または 既定値 (継承) です。前に示したように、サンプルはデータモデリングとテスト中にのみ使用されます。

使用

パーティションオブジェクトは、 Alter コマンド (TMSL)、 Create コマンド (TMSL)、 CreateOrReplace コマンド (TMSL)、 Delete コマンド (TMSL)、 Refresh コマンド (TMSL)、 MergePartitions コマンド (TMSL) で使用されます。

パーティションオブジェクトを作成、置換、または変更する場合は、オブジェクト定義のすべての読み取り/書き込みプロパティを指定します。読み取り/書き込みプロパティの省略は削除と見なされます。読み取り/書き込みプロパティには、名前、説明、モード、およびソースが含まれます。

例

例 1 - (ファクトテーブルではなく) テーブルの単純なパーティション構造。

"partitions": [  
          {  
            "name": "Customer",  
            "source": {  
              "query": "SELECT [dbo].[Customer].* FROM [dbo].[Customer]",  
              "dataSource": "SqlServer localhost FoodmartDB"  
            }  
]

例 2 - パーティション分割されたファクトデータは、通常、同じテーブルのデータに対して重複しないパーティションを作成する WHERE 句に基づいています。

"partitions": [  
          {  
            "name": "sales_fact_2015",  
            "source": {  
              "query": "SELECT [dbo].[sales_fact_2015].* FROM [dbo].[sales_fact_2015] WHERE [dbo].[sales_fact_2015].[Quarter]=4",                                                                                          
              "dataSource": "SqlServer localhost FoodmartDB"  
            },  
          }  
        ]

例 3 - DAX 式に基づく計算テーブル。

"partitions": [  
          {  
            "name": "CalcTable1",  
            "source": {  
              "type": "calculated",  
              "expression": "'Product Class'"  
            },  
            }  
]

完全な構文

パーティションオブジェクトのスキーマ表現を次に示します。

"partitions": {  
                "type": "array",  
                "items": {  
                  "description": "Partition object of Tabular Object Model (TOM)",  
                  "type": "object",  
                  "properties": {  
                    "name": {  
                      "type": "string"  
                    },  
                    "description": {  
                      "anyOf": [  
                        {  
                          "type": "string"  
                        },  
                        {  
                          "type": "array",  
                          "items": {  
                            "type": "string"  
                          }  
                        }  
                      ]  
                    },  
                    "mode": {  
                      "enum": [  
                        "import",  
                        "directQuery",  
                        "default"  
                      ]  
                    },  
                    "dataView": {  
                      "enum": [  
                        "full",  
                        "sample",  
                        "default"  
                      ]  
                    },  
                    "source": {  
                      "anyOf": [  
                        {  
                          "description": "QueryPartitionSource object of Tabular Object Model (TOM)",  
                          "type": "object",  
                          "properties": {  
                            "type": {  
                              "enum": [  
                                "query",  
                                "calculated",  
                                "none"  
                              ]  
                            },  
                            "query": {  
                              "anyOf": [  
                                {  
                                  "type": "string"  
                                },  
                                {  
                                  "type": "array",  
                                  "items": {  
                                    "type": "string"  
                                  }  
                                }  
                              ]  
                            },  
                            "dataSource": {  
                              "type": "string"  
                            }  
                          },  
                          "additionalProperties": false  
                        },  
                        {  
                          "description": "CalculatedPartitionSource object of Tabular Object Model (TOM)",  
                          "type": "object",  
                          "properties": {  
                            "type": {  
                              "enum": [  
                                "query",  
                                "calculated",  
                                "none"  
                              ]  
                            },  
                            "expression": {  
                              "anyOf": [  
                                {  
                                  "type": "string"  
                                },  
                                {  
                                  "type": "array",  
                                  "items": {  
                                    "type": "string"  
                                  }  
                                }  
                              ]  
                            }  
                          },  
                          "additionalProperties": false  
                        }  
                      ]  
                    },  
                    "annotations": {  
                      "type": "array",  
                      "items": {  
                        "description": "Annotation object of Tabular Object Model (TOM)",  
                        "type": "object",  
                        "properties": {  
                          "name": {  
                            "type": "string"  
                          },  
                          "value": {  
                            "anyOf": [  
                              {  
                                "type": "string"  
                              },  
                              {  
                                "type": "array",  
                                "items": {  
                                  "type": "string"  
                                }  
                              }  
                            ]  
                          }  
                        },  
                        "additionalProperties": false  
                      }  
                    }  
                  },  
                  "additionalProperties": false  
                }  
              },

次の方法で共有

Partitions オブジェクト (TMSL)

オブジェクト定義

使用

例

完全な構文

フィードバック

その他のリソース