MON_SAMPLE_SERVICE_CLASS_METRICS - サービス・クラス・メトリックのサンプルの取得
MON_SAMPLE_SERVICE_CLASS_METRICS 表関数は、1 つ以上のデータベースにおいて、1 つ以上のサービス・クラスのシステム・メトリックを 2 つの時点 (この関数が呼び出された時点と、指定された時間の経過後) で読み取ります。
この関数は、これらのメトリックからさまざまな統計を計算します。
許可
このルーチンを実行するには、以下のいずれかの権限が必要です。
- ルーチンに対する EXECUTE 特権
- DATAACCESS 権限
- DBADM 権限
- SQLADM 権限
デフォルトの PUBLIC 特権
なし
構文
スキーマは SYSPROC です。
表関数パラメーター
- hostname
- レポートの生成元となるノードの完全修飾ホスト名または IP アドレスを指定する、タイプ VARCHAR(255) の入力引数。 引数が NULL または空ストリングの場合、インスタンス内のアクティブなデータベースすべてからメトリックが取得されます。
- db_name
- この関数を呼び出すときに現在接続されているデータベースと同じインスタンス内の有効なデータベース名を指定する、 タイプ VARCHAR(128) の入力引数。 データベースのディレクトリー項目タイプは、(LIST DATABASE DIRECTORY コマンドによって戻される)「Indirect」または「Home」のどちらかでなければなりません。 引数が NULL または空ストリングである場合、インスタンス内のすべてのデータベースからメトリックが取得されます。
- service_superclass_name
- この関数を呼び出すときに現在接続されているデータベースで有効なサービス・スーパークラス名を指定する、タイプ VARCHAR(128) の入力引数。 引数が NULL または空ストリングである場合、db_name パラメーターにより課される制約を満たすデータベース名を持つインスタンス内のすべてのスーパークラスについて、パフォーマンス・メトリックが取得されます。
- service_subclass_name
- この関数を呼び出すときに現在接続されているデータベースで有効なサービス・サブクラス名を指定する、タイプ VARCHAR(128) の入力引数。 引数が NULL または空ストリングである場合、db_name パラメーターと service_superclass_name パラメーターにより課される制約をそれぞれ満たすデータベース名とサービス・スーパークラス名を持つインスタンス内のすべてのサブクラスについて、パフォーマンス・メトリックが取得されます。
- sample_time (sample_time)
- データに対して結果を計算する前に、関数がそのデータを収集する時間。 この値の尺度は秒単位であり、1 以上でなければなりません。
- member
- この関数を呼び出すときに現在接続されているデータベースと同じインスタンス内の有効なメンバーを指定する、タイプ INTEGER の入力引数。 現行のデータベース・メンバーには -1、すべてのデータベース・メンバーには -2 を指定します。 NULL 値を指定すると、-1 が暗黙的に設定されます。
戻される情報
使用上の注意
MON_SAMPLE_SERVICE_CLASS_METRICS 表関数は、各アクティブ・データベースの各サービス・クラスのデータを、メンバーごとに 1 行戻します。
MON_SAMPLE_SERVICE_CLASS_METRICS 表関数は、各アクティブ・データベースの出力を、メンバーごとにさらに 1 行戻します。 その追加の行に、各データベース全体の CPU 割り当て率と使用状況が表示されます。 データベースの行では、サービス・クラス ID 列以外のすべての列にデータが取り込まれます。サービス・クラス ID 列には NULL 値が入ります。
- SERVICE_SUPERCLASS_NAME
- SERVICE_SUBCLASS_NAME
- SERVICE_CLASS_ID
この表関数は、(1 つのメンバー上の) 複数のサービス・クラスにわたる集約や、(1 つ以上のサービス・クラスの) 複数メンバーにわたる集約を行いません。 しかし、SQL 照会を使用して集約を実行できます。 入力パラメーターには、ANDed
という効果があります。 したがって、矛盾する複数の入力パラメーター (例えば SUPA というスーパークラスと、SUPA のサブクラスではない SUBB というサブクラス) を指定すると、行は戻されません。
例 1
すべてのパーティションにおける各サービス・サブクラスの 30 秒間のアクティビティー・スループットと CPU 速度を示します。
SELECT varchar(service_superclass_name,30) AS service_superclass,
varchar(service_subclass_name,30) AS service_subclass,
decimal(sum(act_throughput),10,2) AS act_throughput,
decimal(sum(total_cpu_time) /
(sum(total_cpu_time) +
sum(total_disp_run_queue_time)),3,2) AS cpu_velocity
FROM TABLE(MON_SAMPLE_SERVICE_CLASS_METRICS
(null, current server, '', '', 30, -2)) AS t
WHERE service_subclass_name IS NOT NULL
GROUP BY service_superclass_name, service_subclass_name
ORDER BY service_superclass_name, service_subclass_name以下はこの照会の出力例です。
SERVICE_SUPERCLASS SERVICE_SUBCLASS ...
--------------------------- ----------------------- ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS ...
SYSDEFAULTMAINTENANCECLASS SYSDEFAULTSUBCLASS ...
SYSDEFAULTSYSTEMCLASS SYSDEFAULTSUBCLASS ...
3 record(s) selected.... ACT_THROUGHPUT CPU_VELOCITY
... --------------- -----------------
... 214.76 0.72
... 0 0
... 0 0例 2
システム上のすべてのデータベースとパーティションにおける各サービス・クラスの 5 分間の構成済み共有、見積 CPU 割り当て率、および実際の CPU 使用率を示します。
SELECT varchar(db_name,18) AS db_name,
varchar(service_superclass_name,30) AS service_superclass,
varchar(service_subclass_name,30) AS service_subclass,
cpu_shares,
cpu_limit,
decimal(estimated_cpu_entitlement, 9, 2) AS estimated_cpu_entitlement,
decimal( cpu_utilization, 3, 2) AS cpu_utilization
FROM TABLE(MON_SAMPLE_SERVICE_CLASS_METRICS
(null, null, '', '', 300, -2)) AS t
ORDER BY db_name, service_superclass_name, service_subclass_name, member以下はこの照会の出力例です。
DB_NAME SERVICE_SUPERCLASS SERVICE_SUBCLASS ...
------------------ --------------------------- ----------------------- ...
SAMPLE SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS ...
SAMPLE SYSDEFAULTUSERCLASS - ...
SAMPLE SYSDEFAULTMAINTENANCECLASS SYSDEFAULTSUBCLASS ...
SAMPLE SYSDEFAULTMAINTENANCECLASS - ...
SAMPLE SYSDEFAULTSYSTEMCLASS SYSDEFAULTSUBCLASS ...
SAMPLE SYSDEFAULTSYSTEMCLASS - ...
OTHER SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS ...
OTHER SYSDEFAULTUSERCLASS - ...
OTHER SYSDEFAULTMAINTENANCECLASS SYSDEFAULTSUBCLASS ...
OTHER SYSDEFAULTMAINTENANCECLASS - ...
OTHER SYSDEFAULTSYSTEMCLASS SYSDEFAULTSUBCLASS ...
OTHER SYSDEFAULTSYSTEMCLASS - ...
12 record(s) selected....CPU_SHARES CPU_LIMIT ESTIMATED_CPU_ENTITLEMENT CPU_UTILIZATION
...---------- --------- ------------------------- ---------------
... 1000 - 0.20 0.16
... 2000 70 0.20 0.16
... 1000 - 0.10 0.09
... 1000 - 0.10 0.09
... - - - 0.10
... - - - 0.10
... 1000 - 0.50 0.45
... 5000 70 0.50 0.45
... 1000 - 0.20 0.11
... 2000 - 0.20 0.11
... - - - 0.09
... - - - 0.09