ADMIN_UTL_MONITOR ストアード・プロシージャー

SYSPROC.ADMIN_UTL_MONITOR は、データベース統計を分析できる機能を提供するオートノミック・ストアード・プロシージャーです。これらの機能には、非現行の統計、欠落している統計、または競合する統計に関するアラート、生成された RUNSTATS ステートメントを説明する要約レポートおよび詳細な表レベルのレポートが含まれます。このストアード・プロシージャーは、オートノミック統計を使用する場合に必要です。

汎用プログラミング・インターフェース情報の開始
ADMIN_UTL_MONITOR ストアード・プロシージャーは、以下の機能を提供して、データベース統計の分析を可能にします。
  • 非現行の統計に対し RUNSTATS アラートを発行する。非現行の統計を示すために SYSIBM.SYSTABLESPACESTATS 表内のカウンターが使用されます。クローン表スペース、作業ファイル表スペース、およびディレクトリー表スペースは AUTOSTATS 処理からは除外されます。
  • 欠落または競合するデータベース統計 (列、列グループ、および索引に関する統計を含む) に対して RUNSTATS アラートを発行する。
  • 分析された表の数、および生成された RUNSTATS アラートの数に関する要約レポートを生成する。
  • 説明を含む、RUNSTATS コマンドに関する詳細な表レベルのレポートを生成する。
  • 管理タスク・スケジューラーで ADMIN_UTL_EXECUTE ストアード・プロシージャーの実行をスケジュールし、アラートを解決する。

環境

ADMIN_UTL_MONITOR ストアード・プロシージャーは、WLM が確立したアドレス・スペース内で実行され、リソース・リカバリー・サービス接続機能を使用して、Db2® に接続します。ADMIN_UTL_MONITOR ストアード・プロシージャーは必須で、インストールし実行可能にしておく必要があります。

stand-alone オプションが NO に設定されている場合、ストアード・プロシージャーを呼び出したユーザーの RACF® パスチケットを取得するために、ADMIN_UTL_MONITOR ストアード・プロシージャーを、RACF でトラステッド・コンテキストとして定義する必要があり、また特定のトラステッド WLM 環境で実行する必要があります。ADMIN_UTL_MONITOR ストアード・プロシージャーは、以下のインターフェース・ルーチンを呼び出します。

  • SYSPROC.ADMIN_TASK_ADD
  • SYSPROC.ADMIN_TASK_REMOVE
  • SYSPROC.ADMIN_TASK_UPDATE
  • DSNADM.ADMIN_TASK_LIST
  • DSNADM.ADMIN_TASK_STATUS

必要な許可

CALL ステートメントを実行するには、CALL ステートメントを含むパッケージまたは計画の所有者は、 DBADM またはそれ以上の権限を持っている必要があります。

構文

次の構文図は、ADMIN_UTL_MONITOR ストアード・プロシージャーを呼び出すための SQL CALL ステートメントを示します。
構文図を読む
>>-CALL--ADMIN_UTL_MONITOR--(----monitor-options---,------------>

>----history-entry-id---,----return-code---,----message---)----><

オプションの説明

ADMIN_UTIL_MONITOR ストアード・プロシージャーには、以下のオプションがあります。

monitor-options
ADMIN_UTIL_MONITOR ストアード・プロシージャーの構成パラメーターを表すストリングです。構成パラメーターは、コンマで区切られた「NAME = VALUE」のペアにより構成されます。 空白、等号、およびコンマを含む値は、一重引用符または二重引用符で囲む必要があります。例えば、次のようになります。
  • restrict-ts='partition=1' は有効です。
  • restrict-ts="partition=1" は有効です。
  • restrict-ts=partition=1 は無効です。

一重引用符を含む値は二重引用符で囲む必要があり、二重引用符を含む値は一重引用符で囲む必要があります。例えば、restrict-ts="DBNAME='DSNDB06'" は、値で使用されている一重引用符が二重引用符で囲まれているため、有効です。

以下のオプション・パラメーターを使用可能です。
  • 以下のパラメーターは、一般的なモニター・オプションを指定します。
    restrict-ts
    チェックする必要のある表スペースを指定します。使用できる値は、SYSIBM.SYSTABLESPACESTATS カタログ表の WHERE 節に対して有効なコンテンツを含むストリングです。以下に例を示します。
    DBNAME LIKE 'MYDB%'
    制限が指定されていない場合、すべての表スペースがチェックされます。
    stand-alone
    アラートにより ADMIN_UTL_EXECUTE ストアード・プロシージャーをトリガーするかどうかを指定します。
    NO
    アラートが書き込まれ、アラートを解決するために ADMIN_UTL_EXECUTE ストアード・プロシージャーが呼び出されます。NO がデフォルト値です。
    YES
    アラートは書き込まれますが、ADMIN_UTL_EXECUTE ストアード・プロシージャーは呼び出されません。
    statistics-scope
    ADMIN_UTL_MONITOR ストアード・プロシージャーでチェックする統計の有効範囲を指定します。
    BASIC
    最後の LOAD 操作または REORG 操作以降、RUNSTATS が実行されたかどうか、表スペースでの変更の数およびパーセンテージが定義済みのしきい値より大きいかどうかなど、非現行の統計がチェックされます。BASIC がデフォルト値です。
    PROFILE
    表プロファイルのすべての統計が収集されているかどうかなど、非現行の統計および統計の完全性がチェックされます。
    PROFILE-CONSISTENCY
    非現行の統計、統計の完全性、および統計の整合性がチェックされます。
  • 以下のオプション・パラメーターは、RUNSTATS による表サンプリングの使用に関するしきい値および設定を指定します。
    sampling-rate
    索引なしの列に関する統計を収集する場合に、RUNSTATS でサンプリングする行のパーセンテージを指定します。1 から 100 までの値を指定できます。sampling-rate が指定されていない場合、AUTO が使用されます。sampling-rate が指定されていない場合、単一表表スペースの RUNSTATS アラートに対し TABLESAMPLE SYSTEM AUTO オプションが使用され、複数表表スペースの RUNSTATS アラートに対し SAMPLE 25 オプションが使用されます。
    sampling-threshold
    表内の行の絶対数を示すしきい値を指定します。 しきい値を超えると、サンプリング・オプションが RUNSTATS アラートに記録され、後で RUNSTATS が実行され、アラートを解決するときに、そのオプションが使用されます。正整数を指定できます。sampling-threshold が指定されていない場合、値として 500,000 が使用されます。 指定された sampling-rate は、sampling-threshold=0 の指定時にすべての表に使用されます。
  • 以下のオプション・パラメーターは、非現行の統計のしきい値を指定します。しきい値を超えた場合、RUNSTATS アラートが書き込まれる場合があります。
    表 1. 非現行の統計のパラメーター
    オプション 説明 許可値 デフォルト値
    num-changes 表スペース内に挿入された行、表スペース内で更新された行、または削除された行の絶対数。num-changes と pct-changes の両方のしきい値を超えた場合、RUNSTATS アラートが書き込まれます。 0 から 2,147,483,647 の範囲内の正整数 0
    num-mass-deletes 大量削除操作の絶対数。num-mass-deletes しきい値を超えると、RUNSTATS アラートが書き込まれます。 0 から 2,147,483,647 の範囲内の正整数 0
    pct-changes 表スペース内に挿入された行、表スペース内で更新された行、または削除された行のパーセンテージ。num-changes と pct-changes の両方のしきい値を超えた場合、RUNSTATS アラートが書き込まれます。 0.0 より大きく、100.0 以下の実数浮動小数点値 20.0
  • 以下のパラメーターは、不整合の統計のしきい値を指定します。statistics-scope に対して profile-consistency の値が指定されている場合に限り、しきい値は適用されます。しきい値を超えた場合、RUNSTATS アラートが書き込まれます。以下の表で説明されているように、関連する統計が比較される場合、各しきい値はパーセンテージの差となります。
    表 2. 統計の整合性のしきい値のパラメーター
    オプション 説明 許可値 デフォルト値
    colgroup-card-greater-than-superset-colgroup-card 列グループのカーディナリティーが、そのスーパーセット列グループのカーディナリティーより大きい。 0.0 から 100.0 の範囲内の実数 0.1
    different-colgroup-card-from-coldist-and-index 同じ列を含んでいる索引列グループと表列グループのカーディナリティーが一致しない。 0.0 から 100.0 の範囲内の実数 0.1
    different-colgroup-card-from-indexes 同じ列 (順序は無関係) を含んでいる 2 つの索引列グループのカーディナリティーが一致しない。 0.0 から 100.0 の範囲内の実数 0.1
    different-single-col-colgroup-card-from-coldist-and-index 索引の先頭キーのカーディナリティーが、対応する列のカーディナリティーと異なる。 0.0 から 100.0 の範囲内の実数 0.1
    different-single-col-colgroup-card-from-indexes 索引の先頭キーのカーディナリティーが、同じ列の他の索引の先頭キーのカーディナリティーと異なる。 0.0 から 100.0 の範囲内の実数 0.1
    drf-greater-than-tabcard 表の索引のデータ反復係数が、この表のカーディナリティーより大きい。 0.0 から 100.0 の範囲内の実数 0.1
    drf-less-than-npages 表の索引のデータ反復係数が、ページ数より小さい。 0.0 から 100.0 の範囲内の実数 0.1
    frequency-out-of-range 表の列グループ頻度が 1 より大きいか 0 より小さい。 0.0 から 100.0 の範囲内の実数 0.1
    index-fullkeycard-less-than-any-key-card 索引の全キー・カーディナリティーが、索引に関連する列のカーディナリティーより小さい。 0.0 から 100.0 の範囲内の実数 0.1
    index-fullkeycard-less-than-firstkeycard 索引の全キー・カーディナリティーが、同じ索引の先頭キー・カーディナリティーより小さい。 0.0 から 100.0 の範囲内の実数 0
    maximum-frequency-less-than-reciprocal-of-colgroup-card 列グループの最大頻度が、列グループのカーディナリティーで除算した 1 より小さい。 0.0 から 100.0 の範囲内の実数 0.1
    number-of-frequency-records-greater-than-colgroup-card 列グループの頻度レコードの数が、列グループのカーディナリティーより大きい。 0.0 から 100.0 の範囲内の実数 0.1
    product-of-colcard-less-than-colgroup-card 列グループの列のカーディナリティーの積が、列グループのカーディナリティーより小さい。 0.0 から 100.0 の範囲内の実数 0
    quantile-card-greater-than-colcard 列グループの変位値のカーディナリティーが、列のカーディナリティーより大きい。 0.0 から 100.0 の範囲内の実数 0.1
    quantile-card-greater-than-colgroup-card 表の列の変位値のカーディナリティーが、同じ列のカーディナリティーより大きい。 0.0 から 100.0 の範囲内の実数 0.1
    quantile-frequency-out-of-range 列グループ変位値のカーディナリティーが、0 より小さいか 1 より大きい。 0.0 から 100.0 の範囲内の実数 0
    single-col-index-fullkeycard-not-equal-firstkeycard 単一列の索引の全キー・カーディナリティーが、先頭キー・カーディナリティーと異なる。 0.0 から 100.0 の範囲内の実数 0.1
    sum-of-frequency-greater-than-one 表の列グループのすべての頻度の合計が 1 より大きい。 0.0 から 100.0 の範囲内の実数 0.1
    sum-of-histogram-frequency-greater-than-one 列グループのすべてのヒストグラム頻度の合計が 1 より大きい。 0.0 から 100.0 の範囲内の実数 0
    sum-of-histogram-greater-than-colcard 列グループの列のヒストグラム・カーディナリティーの合計が 1 より大きい。 0.0 から 100.0 の範囲内の実数 0.1
    sum-of-histogram-greater-than-colgroup-card 列グループのヒストグラム・カーディナリティーの合計が、同じ列グループのカーディナリティーより大きい。 0.0 から 100.0 の範囲内の実数 0.1
    tabcard-less-than-colcard 表のカーディナリティーが、同じ表の列のカーディナリティーより小さい。 0.0 から 100.0 の範囲内の実数 0.1
    tabcard-less-than-colgroup-card 表のカーディナリティーが、この同じ表の列グループのカーディナリティーより小さい。 0.0 から 100.0 の範囲内の実数 0.1
    tabcard-less-than-index-keycard 表のカーディナリティーが、この表の索引のカーディナリティーより小さい。 0.0 から 100.0 の範囲内の実数 0.1
    tabcard-not-equal-unique-index-fullkeycard 表のカーディナリティーが、その表のユニーク索引のカーディナリティーと異なる。 0.0 から 100.0 の範囲内の実数 0.1

monitor-options は、タイプ VARCHAR(30000) の入力パラメーターです。

history-entry-id
SYSPROC.ADMIN_UTL_MONITOR ストアード・プロシージャーの実行時に、SYSIBM.SYSAUTORUNS_HIST 表内の実行ログおよび SYSIBM.SYSAUTOALERTS 表内のアラートを読み取るのに使用できるユニーク ID を返します。これは、タイプ BIGINT の出力パラメーターです。
return-code
ストアード・プロシージャーからの戻りコードが格納されています。可能な値は、以下のとおりです。
0
呼び出しは正常に完了しました。
4
呼び出しは正常に完了しました。メッセージ出力パラメーターに、警告メッセージが含まれています。
12
呼び出しは正常に完了しませんでした。メッセージ出力パラメーターに、エラーを説明するメッセージが含まれています。

return-code パラメーターは、タイプ INTEGER の出力パラメーターです。

message
ストアード・プロシージャーが検出したエラーを説明するメッセージが含まれます。

message パラメーターは、タイプ VARCHAR(1331) の出力パラメーターです。

例

以下に、ADMIN_UTL_MONITOR ストアード・プロシージャーの Java 呼び出しの例を示します。

CallableStatement callStmt =
con.prepareCall("CALL SYSPROC.ADMIN_UTL_MONITOR(?, ?, ?, ?)");
callStmt.setString(1, "");
callStmt.registerOutParameter(2,Types.INTEGER);
callStmt.registerOutParameter(3,Types.INTEGER);
callStmt.registerOutParameter(4,Types.LONGVARCHAR);
callStmt.execute();
if ( callStmt.getInt(3) > 0 )
{
System.err.println("Error: " + callStmt.getString(4));
}

外部入力

ADMIN_UTL_MONITOR ストアード・プロシージャーは、以下のカタログ表から追加入力を読み取ります。
  • SYSIBM.SYSTABLESPACESTATS
  • SYSIBM.SYSTABLESPACE
  • SYSIBM.SYSTABLES
  • SYSIBM.SYSCOLUMNS
  • SYSIBM.SYSCOLDIST
  • SYSIBM.SYSINDEXES
  • SYSIBM.SYSKEYS
  • SYSIBM.SYSTABLES_PROFILES

出力

ADMIN_UTL_MONITOR ストアード・プロシージャーは、以下の出力パラメーターを返します。

  • history-entry-id
  • return-code
  • message

また、ADMIN_UTL_MONITOR ストアード・プロシージャーは、データの行を以下のカタログ表に挿入します。

  • SYSIBM.SYSAUTOALERTS カタログ表には、発行された RUNSTATS アラートごとに、以下の列の値を含むデータ行が挿入されます。
    • HISTORY_ENTRY_ID
    • ACTION
    • TARGET_QUALIFIER
    • TARGET_OBJECT
    • TARGET_PARTITION
    • OPTIONS
    • DURATION
    • STATUS
  • SYSIBM.SYSTABLES_PROFILES カタログ表には、プロファイルのまだないモニター表ごとに、以下の列の値を含むデータ行が挿入されます。
    • SCHEMA
    • TBNAME
    • PROFILE_TYPE
    • PROFILE_MODE
    • PROFILE_TEXT
    • PROFILE_UPDATE
    • PROFILE_USED
  • SYSIBM.SYSAUTORUNS_HIST ストアード・プロシージャーでは、1 行のデータが追加され、アクティビティーがログとして記録されます。
    汎用プログラミング・インターフェース情報の終了