分析サービスは、指定されたデータソースに従って集計データを計算するAPIを提供します。クライアントアプリケーションは、Analysis APIを使用してデータソースの集計データを取得するためのHTTP要求をサービスアプリケーションに送信します。

分析サービスの要求スキーマ

データソースの集計データを表示するには、POSTメソッドを使用する必要があります。データソース情報は、次のような要求URLで指定します。

POST: http://<host>[:port]/api/dataengine/{datasourcekey}/analyses

応答は、分析結果を指定するIAnalysisオブジェクトです。これは、状態および結果を含めます。状態は「完了」の場合、結果が配列であり、集計された結果を示します。そうでない場合は、結果はnullです。

次の図は、データソース情報が指定された要求URLを示しています。

URLパラメータ

パラメータ	説明
Data Source	分析するデータソースを指定する際に使用されます。
View Definition	ビュー定義の指定に使用します。 次に例を示します。 {   fields:[    {"binding":"Active","dataType":3},    {"binding":"Country","dataType":1},    {"binding":"Date","dataType":4},    {"binding":"Discount","dataType":2},    {"binding":"Downloads","dataType":2},    {"binding":"ID","dataType":2},    {"binding":"Product","dataType":1},    {"binding":"Sales","dataType":2}   ],   rowFields:{items:["Product"]},   columnFields:{items:["Country"]},   valueFields:{items:["Sales"]} }

レスポンスメッセージ

HTTPステータスコード	原因
201	分析結果情報を指定するために、IAnalysisオブジェクトが返されます。 IAnalysisオブジェクトには、ステータスと結果データが含まれます。 executionStatusが「Completed」の場合、結果データは集約結果データを表す配列になります。 それ以外の場合、結果データは常にNULLです。 応答のヘッダーには、分析インスタンスにアクセスするためのURLが表示されます。
404	無効な{datasource}です。

DataEngineサービスの詳細については、WebApiExplorerのデモを参照してください。