POST /Data/MDXExecute
MDX クエリを実行して、結果を取得します。
URL パラメータ
なし。要求の本文は必須です。次のセクションを参照してください。
要求の本文の詳細
このサービスでは、要求本文の以下のプロパティが使用されます。
MDX | 必須項目。MDX SELECT クエリ。 |
FILTERS | オプション。このクエリに追加するフィルタ。指定されている場合、このプロパティの値は文字列の配列にする必要があり、それぞれの文字列ではフィルタ値を指定します。 |
WAIT | オプション。0 または 1 (既定値) を指定します。このプロパティの値が 0 の場合は、サーバは部分的な結果を送信します。このプロパティの値が 1 の場合、サーバ側では、クライアントが完全な結果が得られるまで待ってから応答を送信することを希望していると想定します。 |
TIMEOUT | オプション。クエリ結果を待つためのタイムアウト時間 (秒単位)。この待機タイムアウト時間の既定値は、セッションのタイムアウト設定値から 2 秒を差し引いた秒数です。 |
要求の例
-
要求のメソッド :
POST
-
要求の URL :
https://localhost/api/deepsee/v1/Data/MDXExecute
URL の有効な形式に関する説明は、"Business Intelligence REST API の概要" を参照してください。
-
要求の本文 :
{"MDX": "SELECT aged.[age group].MEMBERS ON 0 FROM PATIENTS"}
別の例を示します。
{"MDX": "SELECT FROM PATIENTS"}
別の例を示します。
{"MDX": "SELECT birthd.date.members on 0 FROM PATIENTS", "WAIT":1, "TIMEOUT":30}
別の例を示します。
{ "MDX": "SELECT FROM PATIENTS", "FILTERS": [ "[HomeD].[H1].[ZIP].&[32006]","[HomeD].[H1].[ZIP].&[32007]"], "WAIT":1, "TIMEOUT":30 }
応答の例
MDX クエリの応答
POST /Data/PivotExecute と POST /Data/MDXUpdateResults は同じ応答本文を返します。
Info.QueryID プロパティに含まれているクエリ ID は、POST /Data/MDXCancelQuery サービスと POST /Data/MDXUpdateResults サービスの入力として必要です。Info.ResultsComplete プロパティの値が 1 の場合は、MDX クエリが完了していることを示します。Info.PendingResults プロパティの値が 1 の場合、プラグインはまだ計算処理中です。ただし、クエリの他の部分は完了している可能性があります。Info.PendingResults プロパティの値が 0 の場合は、プラグインが計算を終了していることを示します。
すべての応答オブジェクトに適用される情報は、"応答オブジェクトに関する注意事項" を参照してください。
{
"Info":{
"Error":"",
"MDXText":"SELECT [AGED].[AGE GROUP].MEMBERS ON 0 FROM [PATIENTS]",
"QueryKey":"en2772997983",
"CubeKey":"PATIENTS",
"QueryID":"PATIENTS||en2772997983",
"Cube":"PATIENTS",
"ResultsComplete":1,
"Pivot":"",
"QueryType":"SELECT",
"ListingSource":"",
"ColCount":3,
"RowCount":0,
"TimeStamp":"2016-08-14 16:05:16"
},
"AxesInfo":[
{"%ID":"SlicerInfo","Text":""},
{"%ID":"AxisInfo_1","Text":"[AGED].[AGE GROUP].MEMBERS"},
{"%ID":"AxisInfo_2","Text":"[%SEARCH]"}
],
"Result": {
"Axes":[
{"%ID":"Axis_1","Tuples": [
{"%ID":"Tuple_1",
"Members":[
{"%ID":"Member_1","Name":"0 to 29"}
],
"MemberInfo": [
{"%ID":"MemberInfo_1",
"nodeNo":3,"text":"0 to 29",
"dimName":"AgeD",
"hierName":"H1",
"levelName":"Age Group",
"memberKey":"0 to 29",
"dimNo":2,
"hierNo":1,
"levelNo":2,
"aggregate":"",
"orSpec":""}
]
},
{"%ID":"Tuple_2",...},
{"%ID":"Tuple_3",...}
],
"TupleInfo":[
{"%ID":"TupleInfo_1","childSpec":"[AgeD].[H1].[Age Group].&[0 to 29].children"},
{"%ID":"TupleInfo_2","childSpec":"[AgeD].[H1].[Age Group].&[30 to 59].children"}
...],
"CellData":[
{"%ID":"Cell_1","ValueLogical":418,"Format":"","ValueFormatted":"418"},
{"%ID":"Cell_2","ValueLogical":421,"Format":"","ValueFormatted":"421"},
...]
}
}
応答が不完全な場合は、応答には次のようなセル・データ・オブジェクトが含まれます。
{"%ID":"Cell_9","ValueLogical":"@Computing
0.00%","Format":"","ValueFormatted":"@Computing 0.00%"}
MDX DRILLTHROUGH クエリの応答
{
"Info": {
"Error": "",
"TimeStamp": "2017-09-26 15:31:23",
"ResultsComplete": 1,
"MDXText": "DRILLTHROUGH SELECT [AGED].[AGE GROUP].[0 TO 29] ON 0 FROM [PATIENTS]",
"QueryKey": "en2983351588",
"CubeKey": "PATIENTS",
"QueryID": "PATIENTS||en2983351588",
"Cube": "PATIENTS",
"Pivot": "",
"QueryType": "DRILLTHROUGH",
"ListingSource": "source",
"ColCount": 5,
"RowCount": 0
},
"AxesInfo": [
{"%ID": "SlicerInfo",
"Text": ""},
{"%ID": "AxisInfo_1",
"Text": "[AGED].[AGE GROUP].[0 TO 29]"},
{"%ID": "AxisInfo_2",
"Text": "[%SEARCH]"}
],
"Result": {
"children": [
{"PatientID": "SUBJ_100786",
"Age": 0,
"Gender": "Female",
"Home City": "Centerville",
"Test Score": 77},
{"PatientID": "SUBJ_100960",
"Age": 0,
"Gender": "Female",
"Home City": "Elm Heights",
"Test Score": 62},
{"PatientID": "SUBJ_100977",
"Age": 0,
"Gender": "Female",
"Home City": "Elm Heights",
"Test Score": 54},
...]
}
}