Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

POST /Data/MDXExecute

MDX クエリを実行して、結果を取得します。

URL パラメータ

なし。要求の本文は必須です。次のセクションを参照してください。

要求の本文の詳細

このサービスでは、要求本文の以下のプロパティが使用されます。

MDX 必須項目。MDX SELECT クエリ。
FILTERS オプション。このクエリに追加するフィルタ。指定されている場合、このプロパティの値は文字列の配列にする必要があり、それぞれの文字列ではフィルタ値を指定します。
WAIT オプション。0 または 1 (既定値) を指定します。このプロパティの値が 0 の場合は、サーバは部分的な結果を送信します。このプロパティの値が 1 の場合、サーバ側では、クライアントが完全な結果が得られるまで待ってから応答を送信することを希望していると想定します。
TIMEOUT オプション。クエリ結果を待つためのタイムアウト時間 (秒単位)。この待機タイムアウト時間の既定値は、セッションのタイムアウト設定値から 2 秒を差し引いた秒数です。

要求の例

  • 要求のメソッド :

    POST

  • 要求の URL :

    http://localhost:57772/api/deepsee/v1/Data/MDXExecute

    URL の有効な形式に関する説明は、“概要とサンプル” の章の “DeepSee 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/PivotExecutePOST /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
      },
      ...]}
}

FeedbackOpens in a new tab