MON_GET_UTILITY 表関数 - データベースで実行されているユーティリティーの取得

MON_GET_UTILITY 表関数では、データベースで現在実行されているユーティリティーについての情報が戻されます。

許可

以下のいずれかの権限が必要です。
  • ルーチンに対する EXECUTE 特権
  • DATAACCESS 権限
  • DBADM 権限
  • SQLADM 権限

デフォルトの PUBLIC 特権

なし

構文

Read syntax diagramSkip visual syntax diagramMON_GET_UTILITY(member)

スキーマは SYSPROC です。

ルーチン・パラメーター

member
レコードの取り出し元である有効なデータベース・メンバーを指定する、タイプ INTEGER の入力パラメーター。 現行メンバーの場合は -1 または NULL、 すべてのアクティブ・データベース・メンバーからの情報の場合は -2 を指定します。 アクティブ・データベース・メンバーとは、アプリケーションによる接続と使用が可能なデータベースのことです。

戻される情報

表 1. MON_GET_UTILITY ルーチンによって戻される情報
列名 データ・タイプ 説明
メンバー SMALLINT member - データベース・メンバー・モニター・エレメント
COORD_MEMBER SMALLINT coord_member - コーディネーター・メンバー : モニター・エレメント
APPLICATION_HANDLE BIGINT application_handle - アプリケーション・ハンドル : モニター・エレメント
APPLICATION_ID VARCHAR(128) appl_id - アプリケーション ID : モニター・エレメント
APPLICATION_NAME VARCHAR(128) appl_name アプリケーション名 : モニター・エレメント
SESSION_AUTH_ID VARCHAR(128) session_auth_id セッション許可 ID : モニター・エレメント
CLIENT_WRKSTNNAME VARCHAR(255) client_wrkstnname - クライアント・ワークステーション名 : モニター・エレメント
CLIENT_ACCTNG VARCHAR(255) client_acctng - クライアント・アカウンティング・ストリング : モニター・エレメント
CLIENT_USERID VARCHAR(255) client_userid - クライアントのユーザー ID : モニター・エレメント
CLIENT_APPLNAME VARCHAR(255) client_applname - クライアント・アプリケーション名 : モニター・エレメント
UTILITY_INVOCATION_ID VARCHAR(32) FOR BIT DATA utility_invocation_id - ユーティリティー呼び出し ID モニター・エレメント
UTILITY_ID INTEGER utility_id ユーティリティー ID

データベース・パーティションに固有。

UTILITY_START_TIME TIMESTAMP utility_start_time ユーティリティー開始時刻
UTILITY_TYPE VARCHAR(16) utility_type ユーティリティー・タイプ
UTILITY_OPERATION_TYPE CHAR(1) utility_operation_type - ユーティリティー操作タイプのモニター・エレメント
UTILITY_INVOKER_TYPE VARCHAR(4) utility_invoker_type - ユーティリティー呼び出し側タイプ
UTILITY_PRIORITY INTEGER utility_priority ユーティリティー優先度

ユーティリティーがスロットルをサポートする場合には優先順位、それ以外の場合は NULL。

OBJECT_TYPE VARCHAR(16) オブジェクトのタイプ。 以下のいずれか
  • データベース
  • 索引
  • PARTITIONGROUP
  • テーブル
  • TABLESPACE
  • VIEW
OBJECT_SCHEMA VARCHAR(128) object_schema - オブジェクト・スキーマのモニター・エレメント
OBJECT_NAME VARCHAR(128) object_name - オブジェクト名モニター・エレメント
NUM_TBSPS INTEGER num_tbsps - 表スペース数のモニター・エレメント
TBSP_NAMES CLOB(5M) tbsp_names - 表スペース名 : モニター・エレメント
UTILITY_DETAIL CLOB(2M) utility_detail - ユーティリティー詳細 : モニター・エレメント
TENANT_NAME VARCHAR(128) tenant_name - テナント名モニター・エレメント
TENANT_ID BIGINT tenant_id - テナント ID モニター・エレメント

データベース・サーバー上で現在実行中のすべての LOAD コマンドをリストし、コマンドを実行しているアプリケーションとユーザーに関する情報を提供します。
SELECT COORD_MEMBER, APPLICATION_HANDLE AS APPHDL,
   SUBSTR(APPLICATION_NAME, 1, 10) AS APPNAME,
   SUBSTR(SESSION_AUTH_ID, 1, 10) AS USER,
   SUBSTR(UTILITY_DETAIL, 1, 150) AS CMD
FROM TABLE(MON_GET_UTILITY(-2)) AS T
以下の結果が出力されます。
COORD_MEMBER APPHDL               APPNAME    USER       ...
------------ -------------------- ---------- ---------- ... 
           0                  736 db2bp      USER2      ...
           0                  724 db2bp      USER1      ...

... CMD
... ---------------------------------------------------------------------------- ...
... [LOADID: 63.2013-02-01-09.48.42.976823.0 (2;21)] [*LOCAL.user2.130201144359] ...
... [LOADID: 20.2013-02-01-09.43.49.510806.0 (2;20)] [*LOCAL.user1.130201144240] ...

... CMD (continued)
... ----------------------------------------------------------------------------
... OFFLINE LOAD DEL AUTOMATIC INDEXING INSERT COPY NO SCHEMA2.T2
... OFFLINE LOAD DEL AUTOMATIC INDEXING INSERT COPY NO SCHEMA1.T1