MON_GET_TABLE_USAGE_LIST 表関数 - 表の使用量リストからの情報を戻す
MON_GET_TABLE_USAGE_LIST 表関数は、表に関して定義された使用量リストからの情報を戻します。
許可
このルーチンを実行するには、以下のいずれかの権限が必要です。
- ルーチンに対する EXECUTE 特権
- DATAACCESS 権限
- DBADM 権限
- SQLADM 権限
デフォルトの PUBLIC 特権
なし
構文
スキーマは SYSPROC です。
ルーチン・パラメーター
- USAGELISTSCHEMA
- この関数を呼び出すときに現在接続されているデータベース内の有効なスキーマ名を指定する、タイプ VARCHAR(128) の入力引数。 引数が NULL または空ストリングである場合、データベース内のすべてのスキーマの使用量リストが取得されます。 引数を指定した場合は、指定したスキーマの使用量リストのみが戻されます。
- USAGELISTNAME
- この関数を呼び出すときに現在接続されているデータベース内の表に対して定義された使用量リストを指定する、タイプ VARCHAR(128) の入力引数。 usagelistname が NULL または空ストリングである場合、usagelistschema で識別されるスキーマにある表に対して定義された、存在するすべての使用量リストが取得されます。 これを指定した場合は、usagelistschema で識別されるスキーマの、指定した使用量リストのみが戻されます。
- member
- この関数を呼び出すときに現在接続されているデータベースと同じインスタンス内の有効なメンバーを指定する、タイプ INTEGER の入力引数。 現行のデータベース・メンバーには -1、すべてのアクティブ・データベース・メンバーには -2 を指定します。 NULL 値を指定すると、-1 が暗黙的に設定されます。
戻される情報
| 列名 | データ・タイプ | 説明 |
|---|---|---|
| USAGELISTSCHEMA | VARCHAR (128) | usage_list_schema - 使用リスト・スキーマ |
| USAGELISTNAME | VARCHAR (128) | usage_list_name - 使用リスト名 |
| TABSCHEMA | VARCHAR(128) | table_schema 表スキーマ名 |
| TABNAME | VARCHAR(128) | table_name 表名 |
| メンバー | SMALLINT | member - データベース・メンバー |
| DATA_PARTITION_ID | INTEGER | data_partition_id - データ・パーティション ID |
| EXECUTABLE_ID | VARCHAR(32) FOR BIT DATA | executable_id 実行可能 ID |
| MON_INTERVAL_ID | BIGINT | mon_interval_id - モニター間隔 ID |
| LAST_UPDATED | TIMESTAMP | last_updated - 最終更新タイム・スタンプ |
| NUM_REFERENCES | BIGINT | num_references - 参照回数 |
| NUM_REF_WITH_METRICS | BIGINT | num_ref_with_metrics - メトリックに関する参照回数 |
| ROWS_INSERTED | BIGINT | rows_inserted 挿入行数 |
| ROWS_DELETED | BIGINT | rows_deleted 削除行数 |
| ROWS_UPDATED | BIGINT | rows_updated 更新行数 |
| ROWS_READ | BIGINT | rows_read 読み取り行数 |
| OVERFLOW_CREATES | BIGINT | overflow_creates - オーバーフローの作成 |
| OVERFLOW_ACCESSES | BIGINT | overflow_accesses オーバーフロー・レコードへのアクセス |
| LOCK_WAIT_TIME | BIGINT | lock_wait_time ロック待機中の時間 |
| LOCK_WAIT_TIME_GLOBAL | BIGINT | lock_wait_time_global - グローバル・ロック待機時間 |
| LOCK_WAITS | BIGINT | lock_waits ロック待機数 |
| LOCK_WAITS_GLOBAL | BIGINT | lock_waits_global - グローバル・ロック待機 |
| LOCK_ESCALS | BIGINT | lock_escals ロック・エスカレーション数 |
| LOCK_ESCALS_GLOBAL | BIGINT | lock_escals_global - グローバル・ロック・エスカレーション数 |
| DIRECT_WRITES | BIGINT | direct_writes データベースへの直接書き込み |
| DIRECT_WRITE_REQS | BIGINT | direct_write_reqs 直接書き込み要求 |
| DIRECT_READS | BIGINT | direct_reads データベースからの直接読み取り |
| DIRECT_READ_REQS | BIGINT | direct_read_reqs 直接読み取り要求 |
| OBJECT_DATA_L_READS | BIGINT | object_data_l_reads - 表のバッファー・プール・データの論理読み取り |
| OBJECT_DATA_P_READS | BIGINT | object_data_p_reads - 表のバッファー・プールの物理データ読み取り |
| OBJECT_DATA_GBP_L_READS | BIGINT | object_data_gbp_l_reads - 表の GBP データの論理読み取り |
| OBJECT_DATA_GBP_P_READS | BIGINT | object_data_gbp_p_reads - 表の GBP データの物理読み取り |
| OBJECT_DATA_GBP_INVALID_PAGES | BIGINT | object_data_gbp_invalid_pages - 表に関する GBP の無効なデータ・ページ |
| OBJECT_DATA_LBP_PAGES_FOUND | BIGINT | object_data_lbp_pages_found - 表の検出済み LBP データ・ページ |
| object_data_gbp_indep_pages_found_in_lbp | BIGINT | object_data_gbp_indep_pages_found_in_lbp - ローカル・バッファー・プールで検出されたグループ・バッファー・プール非従属データ・ページ |
| OBJECT_XDA_L_READS | BIGINT | object_xda_l_reads - 表のバッファー・プール XDA データの論理読み取り |
| OBJECT_XDA_P_READS | BIGINT | object_xda_p_reads - 表のバッファー・プール XDA データの物理読み取り |
| OBJECT_XDA_GBP_L_READS | BIGINT | object_xda_gbp_l_reads - 表の GBP XDA データの論理読み取り要求 |
| OBJECT_XDA_GBP_P_READS | BIGINT | object_xda_gbp_p_reads - 表の GBP XDA データの物理読み取り要求 |
| OBJECT_XDA_GBP_INVALID_PAGES | BIGINT | object_xda_gbp_invalid_pages - 表に関する GBP の無効な XDA データ・ページ |
| OBJECT_XDA_LBP_PAGES_FOUND | BIGINT | object_xda_lbp_pages_found - 表の検出済み LBP XDA データ・ページ |
| object_xda_gbp_indep_pages_found_in_lbp | BIGINT | object_xda_gbp_indep_pages_found_in_lbp - ローカル・バッファー・プールで検出されたグループ・バッファー・プール XDA 非従属ページ |
| OBJECT_COL_L_READS | BIGINT | object_col_l_reads - カラム・オーガナイズの論理読み取り |
| OBJECT_COL_P_READS | BIGINT | object_col_p_reads - カラム・オーガナイズの物理読み取り数 |
| OBJECT_COL_GBP_L_READS | BIGINT | object_col_gbp_l_reads - グループ・バッファー・プール・データのカラム・オーガナイズの論理読み取り |
| OBJECT_COL_GBP_P_READS | BIGINT | object_col_gbp_p_reads - グループ・バッファー・プール・データのカラム・オーガナイズの物理読み取り |
| OBJECT_COL_GBP_INVALID_PAGES | BIGINT | object_col_gbp_invalid_pages - グループ・バッファー・プールのカラム・オーガナイズの無効なデータ・ページ |
| OBJECT_COL_LBP_PAGES_FOUND | BIGINT | object_col_lbp_pages_found - ローカル・バッファー・プールのカラム・オーガナイズのページ検出 |
| OBJECT_COL_GBP_INDEP_PAGES_FOUND_IN_LBP | BIGINT | object_col_gbp_indep_pages_found_in_lbp - ローカル・バッファー・プールで検出されたグループ・バッファー・プールのカラム・オーガナイズ索引ページ |
| オブジェクト・データ・キャッシュ中の層の読み取り | BIGINT | 将来の利用のために予約済み。 |
| OBJECT_DATA_CACHING_TIER_PAGES_FOUND | BIGINT | 将来の利用のために予約済み。 |
| OBJECT_DATA_CACHING_TIER_GBP_INVALID_PAGES | BIGINT | 将来の利用のために予約済み。 |
| OBJECT_DATA_CACHING_TIER_GBP_INDEP_PAGES_FOUND | BIGINT | 将来の利用のために予約済み。 |
| オブジェクト・データベース・キャッシュの層の読み取り | BIGINT | 将来の利用のために予約済み。 |
| オブジェクトの xda_caching_tier_pages_found | BIGINT | 将来の利用のために予約済み。 |
| OBJECT_XDA_CACHING_TIER_GBP_INVALID_PAGES | BIGINT | 将来の利用のために予約済み。 |
| OBJECT_XDA_CACHING_TIER_GBP_INDEP_PAGES_FOUND | BIGINT | 将来の利用のために予約済み。 |
| オブジェクト・コールド・キャッシュの層の読み取り | BIGINT | 将来の利用のために予約済み。 |
| OBJECT_COL_CACHING_TIER_PAGES_FOUND | BIGINT | 将来の利用のために予約済み。 |
| オブジェクト・コールド・キャッシュの層_GBP_INバリデーター・ページ | BIGINT | 将来の利用のために予約済み。 |
| OBJECT_COL_CACHING_TIER_GBP_INDEP_PAGES_FOUND | BIGINT | 将来の利用のために予約済み。 |
| EXT_TABLE_RECV_WAIT_TIME | BIGINT | ext_table_recv_wait_time - エージェントが外部表リーダーを待機していた合計時間 : モニター・エレメント |
| EXT_TABLE_RECVS_TOTAL | BIGINT | ext_table_recvs_total - 外部表リーダーから受信した行バッチの合計 : モニター・エレメント |
| EXT_TABLE_RECV_VOLUME | BIGINT | ext_table_recv_volume - 外部表リーダーから受信したデータの合計 : モニター・エレメント |
| EXT_TABLE_READ_VOLUME | BIGINT | ext_table_read_volume - 外部表リーダーによって読み取られるデータの合計 : モニター・エレメント |
| EXT_TABLE_SEND_WAIT_TIME | BIGINT | ext_table_send_wait_time - エージェントが外部表ライターを待機していた合計時間 : モニター・エレメント |
| EXT_TABLE_SENDS_TOTAL | BIGINT | ext_table_sends_total - 外部表ライターに送信された行バッチの合計 : モニター・エレメント |
| EXT_TABLE_SEND_VOLUME | BIGINT | ext_table_send_volume - 外部表ライターに送信されたデータの合計 : モニター・エレメント |
| EXT_TABLE_WRITE_VOLUME | BIGINT | ext_table_write_volume - 外部表ライターによって書き込まれたデータの合計 : モニター・エレメント |
使用上の注意
この関数によって戻される各行は、リストに追加されて以降、特定の時間間隔 (モニター・インターバル ID) 中に固有のセクション (DML ステートメントのみ、実行可能 ID) が特定のオブジェクトを参照した合計回数 (num_references) を表します。 この行に関して収集された統計は、その時間間隔中のこれらの実行にわたる総計値を表します。
平均を計算するときには、num_references 列ではなく num_ref_with_metrics 列を使用してください。報告されるメトリックにセクション実行が寄与したかどうかにかかわらず、num_references 列ではセクションのすべての実行がカウントされるためです。
この関数によって収集されるメトリックは、 mon_obj_metrics 構成パラメーターを使用してデータベース・レベルで制御されます。 デフォルトでは、メトリック収集は有効になります。
例
メンバー 3 から使用量リスト USL_MON_PAYROLL を取得します。
SELECT * FROM TABLE(
MON_GET_TABLE_USAGE_LIST(NULL, 'USL_MON_PAYROLL', 3))
USAGELISTSCHEMA USAGELISTNAME TABSCHEMA TABNAME
--------------- --------------- --------- -------
ISAYYID USL_MON_PAYROLL ISAYYID T1
ISAYYID USL_MON_PAYROLL ISAYYID T1
MEMBER . . . LAST_UPDATED . . .
------ . . . -------------------------- . . .
3 . . . 2011-07-06-10.20.22.727803 . . .
3 . . . 2011-07-06-10.20.58.202161 . . .
2 record(s) selected.