MON_GET_CONTAINER 表関数 - 表スペース・コンテナー・メトリックの取得

構文

スキーマは SYSPROC です。

表関数パラメーター

tbsp_name

この関数を呼び出すときに現在接続されているデータベースと同じデータベース内の有効な表スペース名を指定する、タイプ VARCHAR(128) の入力引数。引数が NULL または空ストリングである場合、 データベース内のすべての表スペース内のすべてのコンテナーについてメトリックが戻されます。

member

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

許可

デフォルトの PUBLIC 特権

なし

例

例 1: 読み取り時間が最長のすべてのデータベース・メンバーのコンテナーをリストします。

SELECT varchar(container_name,70) as container_name, 
       varchar(tbsp_name,20) as tbsp_name, 
       pool_read_time 
FROM TABLE(MON_GET_CONTAINER('',-2)) AS t 
ORDER BY pool_read_time DESC

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

CONTAINER_NAME                                                         ... 
---------------------------------------------------------------------- ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000000/C0000000.CAT      ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000002/C0000000.LRG      ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000001/C0000000.TMP      ... 

  3 record(s) selected.

照会の出力 (続き)。

... TBSP_NAME            POOL_READ_TIME      
... -------------------- --------------------
... SYSCATSPACE                           597
... USERSPACE1                             42
... TEMPSPACE1                              0

例 2: アクセスできないすべてのコンテナーをリストします。

SELECT varchar(container_name, 70) as container_name 
FROM TABLE(MON_GET_CONTAINER('',-1)) AS t 
WHERE accessible = 0

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

CONTAINER_NAME                                                        
----------------------------------------------------------------------

  0 record(s) selected.

例 3: 使用率の高い順にコンテナー・ファイル・システムの使用率をリストします。

SELECT varchar(container_name, 65) as container_name, 
       fs_id, 
       fs_used_size, 
       fs_total_size, 
       CASE WHEN fs_total_size > 0 
            THEN DEC(100*(FLOAT(fs_used_size)/FLOAT(fs_total_size)),5,2) 
            ELSE DEC(-1,5,2) 
       END as utilization 
FROM TABLE(MON_GET_CONTAINER('',-1)) AS t 
ORDER BY utilization DESC

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

CONTAINER_NAME                                                    ... 
----------------------------------------------------------------- ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000000/C0000000.CAT ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000001/C0000000.TMP ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000002/C0000000.LRG ... 

  3 record(s) selected.

照会の出力 (続き)。

FS_ID                FS_USED_SIZE         FS_TOTAL_SIZE        UTILIZATION 
-------------------- -------------------- -------------------- ----------- 
               64768         106879311872         317068410880       33.70
               64768         106879311872         317068410880       33.70
               64768         106879311872         317068410880       33.70

使用上の注意

MON_GET_CONTAINER 表関数は、 コンテナーごとおよびデータベース・メンバーごとに 1 行のデータを戻します。 データは、指定の表スペース内のすべてのコンテナー、またはデータベース内のすべてのコンテナーについて戻すことができます。データベース・パーティション全体からの集約は実行されません。 しかし、集約は SQL 照会を使用して実行できます。

この関数によって収集されるメトリックは、mon_obj_metrics 構成パラメーターを使用してデータベース・レベルで制御されます。 デフォルトでは、メトリック収集は有効になります。

戻される情報