MON_GET_TABLE 表関数 - 表メトリックの取得

MON_GET_TABLE 表関数は、1 つ以上の表のモニター・メトリックを戻します。

構文

スキーマは SYSPROC です。

表関数パラメーター

tabschema: この関数を呼び出すときに現在接続されているデータベースで有効な表スキーマ名を指定する、タイプ VARCHAR(128) の入力引数。引数が NULL または空ストリングである場合、データベース内のすべてのスキーマのすべての表についてメトリックが取得されます。引数が指定される場合、メトリックは指定したスキーマ内の表についてのみ戻されます。
tabname: この関数を呼び出すときに現在接続されているデータベースで有効な表名を指定する、タイプ VARCHAR(128) の入力引数。引数が NULL または空ストリングである場合、データベース内のすべての表についてメトリックが取得されます。
member: この関数を呼び出すときに現在接続されているデータベースと同じインスタンス内の有効なメンバーを指定する、タイプ INTEGER の入力引数。現行のデータベース・メンバーには -1、すべてのアクティブ・データベース・メンバーには -2 を指定します。NULL 値を指定すると、-1 が暗黙的に設定されます。

許可

このルーチンを実行するには、以下のいずれかの権限が必要です。

ルーチンに対する EXECUTE 特権
DATAACCESS 権限
DBADM 権限
SQLADM 権限

デフォルトの PUBLIC 特権

なし

戻される情報

表 1. MON_GET_TABLE について戻される情報
列名	データ・タイプ	説明
TABSCHEMA	VARCHAR(128)	table_schema - 表スキーマ名
TABNAME	VARCHAR(128)	table_name - 表名
MEMBER	SMALLINT	member - データベース・メンバー
TAB_TYPE	VARCHAR(14)	table_type - 表タイプ
TAB_FILE_ID	BIGINT	table_file_id - 表ファイル ID
DATA_PARTITION_ID	INTEGER	data_partition_id - データ・パーティション ID
TBSP_ID	BIGINT	tablespace_id - 表スペース ID
INDEX_TBSP_ID	BIGINT	index_tbsp_id - 索引表スペース ID
LONG_TBSP_ID	BIGINT	long_tbsp_id - 長い表スペース ID
TABLE_SCANS	BIGINT	table_scans - 表スキャン
ROWS_READ	BIGINT	rows_read - 読み取り行数
ROWS_INSERTED	BIGINT	rows_inserted - 挿入行数
ROWS_UPDATED	BIGINT	rows_updated - 更新行数
ROWS_DELETED	BIGINT	rows_deleted - 削除行数
OVERFLOW_ACCESSES	BIGINT	overflow_accesses - オーバーフロー・レコードへのアクセス
OVERFLOW_CREATES	BIGINT	overflow_creates - オーバーフローの作成
PAGE_REORGS	BIGINT	page_reorgs - ページ再編成
DATA_OBJECT_L_PAGES	BIGINT	data_object_l_pages - 論理データ・オブジェクト・ページ数
LOB_OBJECT_L_PAGES	BIGINT	lob_object_l_pages - 論理 LOB オブジェクト・ページ数
LONG_OBJECT_L_PAGES	BIGINT	long_object_l_pages - 論理 LONG オブジェクト・ページ数
INDEX_OBJECT_L_PAGES	BIGINT	index_object_l_pages - 論理索引オブジェクト・ページ数
XDA_OBJECT_L_PAGES	BIGINT	xda_object_l_pages - 論理 XDA オブジェクト・ページ数
DBPARTITIONNUM	SMALLINT	dbpartitionnum - データベース・パーティション番号
NO_CHANGE_UPDATES	BIGINT	no_change_updates - 無変更の行更新の数
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 - グローバル・ロック・エスカレーション数
DATA_SHARING_STATE	VARCHAR(19)	data_sharing_state - データ共有の状態モニター・エレメント
DATA_SHARING_STATE_CHANGE_TIME	TIMESTAMP	data_sharing_state_change_time - データ共有の状態変更時間モニター・エレメント
DATA_SHARING_REMOTE_LOCKWAIT_COUNT	BIGINT	data_sharing_remote_lockwait_count - データ共有のリモート・ロック待機カウント・モニター・エレメント
DATA_SHARING_REMOTE_LOCKWAIT_TIME	BIGINT	data_sharing_remote_lockwait_time - データ共有のリモート・ロック待機時間モニター・エレメント
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 - 表のグループ・バッファー・プール・データの論理読み取り
OBJECT_DATA_GBP_P_READS	BIGINT	object_data_gbp_p_reads - 表のグループ・バッファー・プール・データの物理読み取り
OBJECT_DATA_GBP_INVALID_PAGES	BIGINT	object_data_gbp_invalid_pages - 表に関するグループ・バッファー・プールの無効なデータ・ページ
OBJECT_DATA_LBP_PAGES_FOUND	BIGINT	object_data_lbp_pages_found - 表に関して検出されたローカル・バッファー・プールのデータ・ページ
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 - 表のグループ・バッファー・プール XDA データの論理読み取り要求
OBJECT_XDA_GBP_P_READS	BIGINT	object_xda_gbp_p_reads - 表のグループ・バッファー・プール XDA データの物理読み取り要求
OBJECT_XDA_GBP_INVALID_PAGES	BIGINT	object_xda_gbp_invalid_pages - 表に関するグループ・バッファー・プールの無効な XDA データ・ページ
OBJECT_XDA_LBP_PAGES_FOUND	BIGINT	object_xda_lbp_pages_found - 表に関して検出されたローカル・バッファー・プールの XDA データ・ページ
OBJECT_XDA_GBP_INDEP_PAGES_FOUND_IN_LBP	BIGINT	object_xda_gbp_indep_pages_found_in_lbp - ローカル・バッファー・プールで検出されたグループ・バッファー・プール XDA 非依存ページ
NUM_PAGE_DICT_BUILT	BIGINT	num_page_dict_built - 作成または再作成されたページ・レベルのコンプレッション・ディクショナリーの数
STATS_ROWS_MODIFIED	BIGINT	stats_rows_modified - 最終 RUNSTATS 以降に変更された行数
RTS_ROWS_MODIFIED	BIGINT	rts_rows_modified - 最終リアルタイム統計以降に変更された行数
COL_OBJECT_L_PAGES	BIGINT	col_object_l_pages - カラム・オーガナイズ論理ページ
TAB_ORGANIZATION	CHAR(1)	tab_organization - 表のデータ編成
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 - ローカル・バッファー・プールで検出されたグループ・バッファー・プールのカラム・オーガナイズ索引ページ
NUM_COLUMNS_REFERENCED	BIGINT	num_columns_referenced - 参照される列の数
SECTION_EXEC_WITH_COL_REFERENCES	BIGINT	section_exec_with_col_references - カラム・オーガナイズ参照でのセクション実行
OBJECT_DATA_CACHING_TIER_L_READS	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	将来の利用のために予約済み。
OBJECT_XDA_CACHING_TIER_L_READS	BIGINT	将来の利用のために予約済み。
OBJECT_XDA_CACHING_TIER_PAGES_FOUND	BIGINT	将来の利用のために予約済み。
OBJECT_XDA_CACHING_TIER_GBP_INVALID_PAGES	BIGINT	将来の利用のために予約済み。
OBJECT_XDA_CACHING_TIER_GBP_INDEP_PAGES_FOUND	BIGINT	将来の利用のために予約済み。
OBJECT_COL_CACHING_TIER_L_READS	BIGINT	将来の利用のために予約済み。
OBJECT_COL_CACHING_TIER_PAGES_FOUND	BIGINT	将来の利用のために予約済み。
OBJECT_COL_CACHING_TIER_GBP_INVALID_PAGES	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 - 外部表書き込みプログラムが書き込んだ合計データ量のモニター・エレメント

使用上の注意

MON_GET_TABLE 表関数は、データベース表ごとおよびデータベース・メンバーごとに 1 行のデータを戻します。範囲パーティション表が使用される場合、データベース・メンバーごとに、各表パーティションについて 1 行が戻されます。データベース・メンバー全体からの集約は実行されません。ただし、集約は例に示されるように SQL 照会を使用して実行できます。

メトリックは、データベースのアクティブ化後にアクセスされた表についてのみ戻されます。

この関数によって戻されるメトリックは、2 つのレベルで収集されます。一部のメトリックは常時収集されますが、その他のメトリック収集は mon_obj_metrics 構成パラメーターを使用してデータベース・レベルで制御されます。特定のメトリックのデータを収集するために設定をアクティブにする必要があるかどうかを判別するには、上記の表の説明を参照してください。

例

すべてのデータベース・メンバー全体で集約し、読み取り数の高い順に、データベースのアクティブ化後にアクセスされたすべての表のアクティビティーをリストします。

SELECT varchar(tabschema,20) as tabschema, 
       varchar(tabname,20) as tabname, 
       sum(rows_read) as total_rows_read, 
       sum(rows_inserted) as total_rows_inserted, 
       sum(rows_updated) as total_rows_updated, 
       sum(rows_deleted) as total_rows_deleted 
FROM TABLE(MON_GET_TABLE('','',-2)) AS t 
GROUP BY tabschema, tabname 
ORDER BY total_rows_read DESC

以下はこの照会の出力例です。

TABSCHEMA            TABNAME              TOTAL_ROWS_READ      ... 
-------------------- -------------------- -------------------- ... 
SYSIBM               SYSHISTO                              113 ... 
SYSIBM               SYSWORKL                               22 ... 
SYSIBM               SYSROUTI                               13 ... 
SYSIBM               SYSSERVI                               13 ... 
SYSIBM               SYSTHRES                                6 ... 
SYSIBM               SYSTABLE                                3 ... 
SYSIBM               SYSCONTE                                2 ... 
SYSIBM               SYSDBAUT                                2 ... 
SYSIBM               SYSEVENT                                2 ... 
SYSIBM               SYSPLAN                                 1 ... 
SYSIBM               SYSSURRO                                1 ... 
SYSIBM               SYSVERSI                                1 ... 
SYSIBM               SYSXMLST                                1 ... 
SYSIBM               SYSAUDIT                                0 ... 
SYSIBM               SYSROLEA                                0 ... 
SYSIBM               SYSROLES                                0 ... 
SYSIBM               SYSTASKS                                0 ... 
SYSIBM               SYSWORKA                                0 ... 
SYSIBM               SYSXMLPA                                0 ... 

  19 record(s) selected.

照会の出力 (続き)。

... TOTAL_ROWS_INSERTED  TOTAL_ROWS_UPDATED   TOTAL_ROWS_DELETED  
... -------------------- -------------------- --------------------
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0
...                    0                    0                    0

メンバー 1 からスキーマ JOE の表の明示的階層ロッキング状態を取得します。

SELECT SUBSTR(TABNAME,1,8) AS TABNAME,
       MEMBER,
       DATA_SHARING_STATE AS DS_STATE,
       DATA_SHARING_REMOTE_LOCKWAIT_COUNT AS DSRL_COUNT,
       DATA_SHARING_REMOTE_LOCKWAIT_TIME AS DSRL_TIME
     FROM
       TABLE(MON_GET_TABLE('JOE','',1))

この照会は、以下の出力を戻します。

TABNAME  MEMBER DS_STATE            DSRL_COUNT           DSRL_TIME
-------- ------ ------------------- -------------------- --------------------
T1            1 NOT_SHARED                             0                    0
T2            1 SHARED                                 2                21844
T3            1 SHARED                                 0                    0

この出力では、表 T1 が現在「NOT_SHARED」状態であり、現在のデータベース・アクティブ化中に強制的にこの状態以外にされたことがないことが示されています。表 T3 は「NOT_SHARED」状態になったことがありません。表 T2 は「NOT_SHARED」状態に 2 回なっており、2 回とも終了する必要がありました。