Oracle Essbase REST API

問合せトラッキングのインポート

post

/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/settings/querytracking/import

テキスト・ファイルからEssbase集約ストレージ(ASO)データベースに問合せトラッキング・データをインポートします。Essbaseは問合せデータを追跡し、使用状況に基づいて集約ビューを最適化します。

ASOキューブがリフレッシュまたは再起動されると、問合せデータは永続化されません。最適化手法として、リフレッシュまたは再起動の前に、問合せトラッキング・データをテキスト・ファイルにエクスポートできます。リフレッシュまたは再起動の後に集約ビューを再構築するには、テキスト・ファイルから問合せトラッキング・データをインポートします。Essbaseにより、問合せデータを使用して最も適切な一連の集約ビューが選択されて生成されます。

この操作を実行するには、現在のASOキューブに対して問合せトラッキングを有効にする必要があります。問合せトラッキングは、デフォルトで有効になっています。問合せトラッキングが有効になっていることを確認するには、「一般設定の取得」を使用して、queryTrackingがtrueであることを確認します。

リクエスト

パス・パラメータ

applicationName(required): string

アプリケーション名。
databaseName(required): string

データベース名。

ファイル名。

ルート・スキーマ : QueryTrackingInputs

型: object

ソースの表示

fileName: string

{
    "type":"object",
    "properties":{
        "fileName":{
            "type":"string"
        }
    }
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

application/json
application/xml

200 レスポンス

問合せデータは正常にインポートされました。

400 レスポンス

不正なリクエスト

問合せデータのインポートに失敗しました。

500 レスポンス

サーバーの内部エラーです。

先頭に戻る

例

次の例では、Essbase集約ストレージ・キューブの問合せトラッキング・データをエクスポートおよびインポートする方法を示します。

問合せトラッキングをエクスポート/インポートするワークフロー

問合せトラッキングが有効になっていることを確認します。

curl -X GET "https://myserver.example.com:9001/essbase/rest/v1/applications/ASOSamp/databases/Basic/settings?links=none" -H "Accept:application/json"

レスポンスは次のようになります:

{
  "general" : {
    "description" : "",
    "queryTracking" : true
  }
}

テスト環境でいくつかの問合せを実行します(または、通常の使用問合せがパターンを確立するまでしばらく待機します)。

問合せデータに基づいて集約を実行します。

curl -X POST "https://myserver.example.com:9001/essbase/rest/v1/jobs?links=none" -H "Accept:application/json" -H "Content-Type:application/json" -d '{"application": "ASOSamp", "db": "Basic", "jobtype": "buildAggregation", "parameters": {"ratioToStop": "1.1", "basedOnQueryData": "true", "enableAlternateRollups": "false" }}' -u %User%:%Password%

問合せトラッキング・データをファイルにエクスポートします。

curl -X POST https://myserver.example.com:9001/essbase/rest/v1/applications/ASOSamp/databases/Basic/settings/querytracking/export -H "accept: application/json" -H "Content-Type: application/json" -d '{ "fileName": "exportfile" }' -u %User%:%Password%

キューブのリフレッシュまたは再起動後に集約ビューを再構築するには、保存されたエクスポート・ファイルから問合せトラッキング・データをインポートします。

curl -X POST https://myserver.example.com:9001/essbase/rest/v1/applications/ASOSamp/databases/Basic/settings/querytracking/import -H "accept: application/json" -H "Content-Type: application/json" -d '{ "fileName": "exportfile.txt" }' -u %User%:%Password%

先頭に戻る