MON_GET_ACTIVITY_DETAILS 表関数 - アクティビティーに関する情報を XML 文書として戻す

許可

デフォルトの PUBLIC 特権

なし

構文

スキーマは SYSPROC です。

ルーチン・パラメーター

application_handle

有効なアプリケーション・ハンドルを指定する、タイプ BIGINT の入力引数。 引数が NULL の場合、行はこの関数から戻されず、SQL0171N エラーが戻されます。

uow_id

アプリケーション内で固有の有効な作業単位 ID を指定する、タイプ INTEGER の入力引数。 引数が NULL の場合、行はこの関数から戻されず、SQL0171N エラーが戻されます。

activity_id

作業単位内で固有の有効なアクティビティー ID を指定する、タイプ INTEGER の入力引数。 引数が NULL の場合、行はこの関数から戻されず、SQL0171N エラーが戻されます。

member

この関数を呼び出すときに現在接続されているデータベースと同じインスタンス内の有効なメンバー番号を指定する、タイプ INTEGER の入力引数。 現行のデータベース・メンバーには -1、すべてのアクティブ・データベース・メンバーには -2 を指定します。 NULL 値を指定すると、-1 が暗黙的に設定されます。

戻される情報

<db2_activity_details xmlns="http://www.ibm.com/xmlns/prod/db2/mon" release="90700000">
  <member>0</member>
  <application_handle>70</application_handle>
  <activity_id>1</activity_id>
  <activity_state>IDLE</activity_state>
  <activity_type>READ_DML</activity_type>
  <uow_id>1</uow_id>
  ...
  <activity_metrics release="90700000">
    <lock_wait_time>2000</lock_wait_time>
    ...
  </activity_metrics>
</db2_activity_details>

<xs:simpleType name = "executable_id_type" >
  <xs:annotation>
     <xs:documentation>
       The binary Executable ID
     </xs:documentation>
  </xs:annotation>
   <xs:restriction base = "xs:hexBinary" >
      <xs:maxLength value = "32" />
   </xs:restriction>
</xs:simpleType>

戻される詳細メトリック

使用上の注意

MON_GET_ACTIVITY_DETAILS 関数は、単一のアクティビティーの詳細情報を 1 つの XML 文書として戻すため、出力フォーマットを最大限柔軟性のあるものにします。 XML 出力には、記述情報 (例えば、ステートメント・テキスト) とメトリックの両方が含まれます。 出力は XML パーサーで直接解析でき、例に示すように XMLTABLE 関数でリレーショナル形式に変換することもできます。

この関数で報告されるメトリック (例えば、CPU 使用率) は、アクティビティーの存続期間中、定期的にアクティビティーにロールアップされます。 したがって、この表関数で報告される値は、直前の ROLLUP 時のシステムの現行状態を反映しています。

アクティビティー・メトリックは、ワークロードの COLLECT ACTIVITY METRICS 節、またはデータベース・レベルの mon_act_metrics データベース構成パラメーターで制御されます。 メトリックは、アクティビティーをサブミットする接続が、アクティビティー・メトリックが使用可能なワークロードまたはデータベースに関連付けられている場合に収集されます。 アクティビティー・メトリックが、アクティビティーについて収集されない場合、すべてのメトリックが 0 として報告されます。

MON_GET_ACTIVITY_DETAILS 表関数は、アクティビティーが存在するメンバーごとに 1 行のデータを戻します。 メトリックについて、メンバー全体の集約は実行されません。 しかし、SQL 照会を使用して集約を実行できます。

DETAILS 列で返される XML 文書のスキーマは、sqllib/misc/DB2MonRoutines.xsd ファイルにあります。 詳細については、sqllib/misc/DB2MonCommon.xsd ファイルを参照してください。

例

長時間実行される照会を確認し、時間を要しているのが実行または待機のどちらであるかを判別します (例えば、ロックまたは入出力のどちらでブロックされているかなど)。

注: 以下の照会を結合して 1 つのステートメントにすることができますが、分かりやすくするために 2 ステップで示されています。 さらに、テキスト全体を検索したい場合には、実行可能 ID を使って MON_GET_PKG_CACHE_STMT 表関数からステートメント・テキストを取得できます。

1. まず、WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES 表関数を使用して、アクティビティーとそれらの開始時刻をリストします。

   SELECT application_handle, 
          activity_id, 
          uow_id, 
          local_start_time 
   FROM TABLE(
      WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES(
         cast(NULL as bigint), -1)
   ) AS T

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

   APPLICATION_HANDLE   ACTIVITY_ID UOW_ID      LOCAL_START_TIME          
   -------------------- ----------- ----------- --------------------------
                      7           1           2 2008-06-10-10.06.55.675668
                     16           1           7 2008-06-10-10.08.38.613610
   
     2 record(s) selected.
   

2. 次に、MON_GET_ACTIVITY_DETAILS 表関数を使用してアクティビティーが待機に要した時間のパーセントを表示します。

   SELECT actmetrics.application_handle,
     actmetrics.activity_id,
     actmetrics.uow_id,
     varchar(actmetrics.stmt_text, 50) as stmt_text,
     actmetrics.total_act_time,
     actmetrics.total_act_wait_time,
     CASE WHEN actmetrics.total_act_time > 0
       THEN DEC((
         FLOAT(actmetrics.total_act_wait_time) / 
         FLOAT(actmetrics.total_act_time)) * 100, 5, 2)
       ELSE NULL
     END AS PERCENTAGE_WAIT_TIME 
   FROM TABLE(MON_GET_ACTIVITY_DETAILS(7, 2, 1, -2)) AS ACTDETAILS,
   XMLTABLE (XMLNAMESPACES( DEFAULT 'http://www.ibm.com/xmlns/prod/db2/mon'),
     '$actmetrics/db2_activity_details' 
     PASSING XMLPARSE(DOCUMENT ACTDETAILS.DETAILS) as "actmetrics"
     COLUMNS "APPLICATION_HANDLE" INTEGER PATH 'application_handle', 
       "ACTIVITY_ID" INTEGER PATH 'activity_id',
       "UOW_ID" INTEGER PATH 'uow_id',
       "STMT_TEXT" VARCHAR(1024) PATH 'stmt_text',
       "TOTAL_ACT_TIME" INTEGER PATH 'activity_metrics/total_act_time',
       "TOTAL_ACT_WAIT_TIME" INTEGER PATH 'activity_metrics/total_act_wait_time'
     ) AS ACTMETRICS;
   

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

   APPLICATION_HANDLE ACTIVITY_ID UOW_ID      ... 
   ------------------ ----------- ----------- ... 
                    7           1           2 ... 
   
     1 record(s) selected.
   

   照会の出力 (続き)。

   ... STMT_TEXT                                          ... 
   ... -------------------------------------------------- ... 
   ... select * from syscat.tables optimize for 1 row     ... 

   照会の出力 (続き)。

   ... TOTAL_ACT_TIME TOTAL_ACT_WAIT_TIME PERCENTAGE_WAIT_TIME
   ... -------------- ------------------- --------------------
   ...            459                   0                 0.00

MON_GET_ACTIVITY_DETAILS 表関数を使用することにより、システムで現在実行中のすべてのアクティビティーについての情報をキャプチャーする照会を作成します。

• 例 1: コマンド行プロセッサー (CLP) を使って以下のコマンドを実行します。

  WITH A1 AS 
     (SELECT * FROM TABLE(wlm_get_workload_occurrence_activities(null, -1)) 
      WHERE activity_id > 0 ) 
  SELECT A1.application_handle, 
    A1.activity_id, 
    A1.uow_id, 
    total_act_time, 
    total_act_wait_time, 
    varchar(actmetrics.stmt_text, 50) AS stmt_text FROM A1, 
  TABLE(MON_GET_ACTIVITY_DETAILS(A1.application_handle, A1.uow_id,A1.activity_id, -1)) 
      AS ACTDETAILS, 
  XMLTABLE (XMLNAMESPACES( DEFAULT 'http://www.ibm.com/xmlns/prod/db2/mon'), 
   '$actmetrics/db2_activity_details' 
   PASSING XMLPARSE(DOCUMENT ACTDETAILS.DETAILS) AS "actmetrics" 
   COLUMNS "STMT_TEXT" VARCHAR(1024) PATH 'stmt_text', 
   "TOTAL_ACT_TIME" INTEGER PATH 'activity_metrics/total_act_time', 
   "TOTAL_ACT_WAIT_TIME" INTEGER PATH 'activity_metrics/total_act_wait_time' ) 
   AS ACTMETRICS

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

  APP...HANDLE  A..._ID  UOW_ID  T...ACT_TIME  T...WAIT_TIME  
  ------------  -------  ------  ------------  -------------  
  15            1        5       16            5              
  15            1        3       17            5              
  7             1        49      0             0              
  SQL0445W Value "with A1 as (select * from table(wlm_get_workload
  3 record(s) selected with 1 warning messages printed.

  以下は、この照会の出力例の続きを示しています。

  ... STMT_TEXT
  ... -------------------------------------------------
  ... select name from sysibm.systables
  ... select * from sysibm.systables
  ... with A1 as (select * from table(wlm_get_workload_o
  _occurrence_" has been truncated. SQLSTATE=01004
  
  3 record(s) selected with 1 warning messages printed.