この URL を使用して、以下のキーと値のペアを API に渡します。 https://localhost/tuning/compareworkload
| カテゴリー | キー | 値 | 使用可能な値 | オプション? |
|---|---|---|---|---|
| 接続 1 | dbType | データ・サーバーのタイプ。 | ZOS | いいえ |
| dbHost | データ・サーバーのホスト。 | ドメイン・ネームまたは IP アドレス | いいえ | |
| dbPort | データ・サーバーのポート番号 | いいえ | ||
| dbName | データ・サーバーの名前 | いいえ | ||
| dbUser | データ・サーバーに接続するときに使用する ID。 | いいえ | ||
| dbPassword | データ・サーバーに接続するときに使用するパスワード。 | いいえ | ||
| 接続 2 | dbHost2 | データ・サーバーのホスト。 | タイプ 3 の比較のみ。 | |
| dbPort2 | データ・サーバーのポート番号 | タイプ 3 の比較のみ。 | ||
| dbName2 | データ・サーバーの名前 | タイプ 3 の比較のみ。 | ||
| dbUser2 | データ・サーバーに接続するときに使用する ID。 | タイプ 3 の比較のみ。 | ||
| dbPassword2 | データ・サーバーに接続するときに使用するパスワード。 | タイプ 3 の比較のみ。 | ||
| 照会ワークロード | ワークロード | 比較に使用される旧 EXPLAIN スナップショットがある照会ワークロードの名前。 | いいえ | |
| workload2 | 比較に使用される新規 EXPLAIN スナップショットがある照会ワークロードの名前。 この名前は、1 つの照会ワークロードの 2 つの EXPLAIN スナップショットを比較する場合は最初の名前と同じにすることができます。 | タイプ 1 およびタイプ 2 の比較のみ。 | ||
| SQL ステートメントをフィルタリングするためのオプション | apChanged | これは、アクセス・プランが変更されたときの対象となる SQL ステートメントを表示するように指定します。 | true または false。 大/小文字の区別はありません。 | はい |
| costRegressed | これは、指定されたパーセント以上に見積もりコストが増加した SQL ステートメントを表示するように指定します。 | 0 から 100 までの整数。 | ||
| 演算子 | これは、apChangedキーと costRegressed キーの両方に対して設定された値に適合する SQL ステートメントを表示するのか、 どちらかのキーに対して設定された値に適合する SQL ステートメントを表示するかを指定します。 | and または or。 大/小文字の区別はありません。 | および |
API は以下のキーと値のペアを返します。
| キー | 値 |
|---|---|
| code | web API からの戻りコード。
|
| state |
|
| link | 2 つの EXPLAIN スナップショット内のアクセス・プランを比較するレポートの URL。 リンクはデフォルトで 7 日後に期限切れになります。 この期間は、tuning_service.properties ファイルで変更できます。 |
| output | フィルタリング基準を満たす SQL ステートメント (そのステートメントに関する情報がレポートに含まれているもの) の 数。 |
| message | エラー・メッセージまたは警告メッセージ。 |
| 例外 | 例外に関する情報 (例外が発生した場合)。 この情報は、お客様が IBM サポートと連携して問題解決にあたる場合に IBM サポートの参考になる可能性があります。 |
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:host,
dbPort:port_number,
dbName:subsystem,
dbUser:user_ID,
dbPassword:password,
workload:Sample_Workload_1,
apChanged:¥"true¥"
costRegressed:30,
operator:¥"and¥"
}"
https://localhost/tuning/compareworkload
{
"code" :4 ,
"state" :2,
"output" :"11" ,
"link" :"http://localhost:8080/tuning/download/wapc/1394687451884-
14798931739894/ComparisonReport_1.html"}
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:host,
dbPort:port_number,
dbName:subsystem,
dbUser:user_ID,
dbPassword:password,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:20,
apChanged:¥"true¥"
}"
https://localhost/tuning/compareworkload
API からの出力は、例 1 に示されている出力と同じです。
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:host_for_the_first_connection,
dbPort:port_number,
dbName:subsystem,
dbUser:user_ID,
dbPassword:password,
dbHost2:host_for_the_second_connection,
dbPort2:port_number,
dbName2:subsystem,
dbUser2:user_ID,
dbPassword2:password,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:50,
apChanged:¥"true¥",
operator:¥"or¥"
}"
https://localhost/tuning/compareworkload
API からの出力は、例 1 に示されている出力と同じです。