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

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

構文

Read syntax diagramSkip visual syntax diagramMON_GET_TABLE(tabschema, tabname,member)

スキーマは 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 表名
メンバー 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 - LONG 表スペース 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 - データ共有状態 : モニター・エレメント
データ共有の状態の変更時刻 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 - カラム・オーガナイズの参照があるセクション実行
オブジェクト・データ・キャッシュ中の層の読み取り 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 - 外部表ライターによって書き込まれたデータの合計 : モニター・エレメント

使用上の注意

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

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

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

例

  1. すべてのデータベース・メンバー全体で集約し、読み取り数の高い順に、データベースのアクティブ化後にアクセスされたすべての表のアクティビティーをリストします。
    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
  2. メンバー 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 回とも終了する必要がありました。