MON_GET_CONNECTION 表関数 - 接続メトリックの取得

許可

デフォルトの PUBLIC 特権

なし

構文

スキーマは SYSPROC です。

ルーチン・パラメーター

application_handle

メトリックが戻される特定のアプリケーション・ハンドル (接続を識別する) を指定する、タイプ BIGINT の入力パラメーター。 引数が NULL の場合、すべての接続のメトリックが戻されます。

member

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

システム・アプリケーション

システム・アプリケーションの情報が戻されるかどうかを指定する、データ・タイプ SMALLINT の入力パラメーター。 以下の値が有効です。

• 0 または NULL: システム・アプリケーションの情報は戻されません。 NULL は、system_appls の値が指定されていない場合のデフォルトです。
• 1: ユーザーおよびシステム・アプリケーションの情報が返されます。

戻される情報

使用上の注意

MON_GET_CONNECTION 表関数で戻されるメトリック は、接続によってサブミットされた要求のすべてのメトリックの累計を表します。 メトリックは、作業単位境界でロールアップされ、要求の実行中には定期的にロールアップされます。 したがって、この表関数で報告される値は、直前の ROLLUP 時のシステムの現行状態を反映しています。 メトリックの値は確実に増加します。 ある時間間隔に対する指定されたメトリックの値を判別するには、MON_GET_CONNECTION 表関数を使用してその間隔の始めと終わりのメトリックを照会し、差異を計算します。

要求メトリックは、サービス・スーパークラスに対する COLLECT REQUEST METRICS 節、およびデータベース・レベルの mon_req_metrics データベース構成パラメーターを介して制御されます。 親サービス・スーパークラスで要求メトリックを使用可能にしているサービス・サブクラスのエージェントが要求を処理する場合にのみ、またはデータベース全体で要求メトリック・コレクションが有効な場合にのみ、その要求に対しメトリックが収集されます。 デフォルトでは、要求メトリックはデータベース・レベルで使用可能です。 要求メトリックがデータベース・レベルでもサービス・スーパークラスに対しても使用不可になっている場合、そのサービス・スーパークラスにマッピングされた接続ごとに報告されるメトリックは増加を停止します (または、要求メトリックがデータベースのアクティブ化時に無効であった場合には 0 のままになります)。

MON_GET_CONNECTION 表関数は、接続ごとおよびメンバーごとに 1 行のデータを戻します。 (1 つ以上のサービス・クラスの) メンバー全体の集約は実行されません。 しかし、SQL 照会を使用して集約を実行できます。

例

戻される行で順序付けられた、最も大きなデータ・ボリュームをクライアントに戻す接続を表示します。

SELECT application_handle, 
       rows_returned, 
       tcpip_send_volume 
FROM TABLE(MON_GET_CONNECTION(cast(NULL as bigint), -2)) AS t 
ORDER BY rows_returned DESC

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

APPLICATION_HANDLE   ROWS_RETURNED        TCPIP_SEND_VOLUME   
-------------------- -------------------- --------------------
                  55                    6                    0

  1 record(s) selected.