MON_GET_INDEX_USAGE_LIST 表関数 - 索引用使用量リストからの情報を戻す

構文

スキーマは SYSPROC です。

表関数パラメーター

USAGELISTSCHEMA

この関数を呼び出すときに現在接続されているデータベース内の有効なスキーマ名を指定する、タイプ VARCHAR(128) の入力引数。 引数が NULL または空ストリングである場合、データベース内のすべてのスキーマの使用量リストが取得されます。 引数を指定した場合は、指定したスキーマの使用量リストのみが戻されます。 デフォルトは NULL です。

USAGELISTNAME

この関数を呼び出すときに現在接続されているデータベース内の索引に対して定義された使用量リストを指定する、タイプ VARCHAR(128) の入力引数。 usagelistname が NULL または空ストリングである場合、usagelistschema で識別されるスキーマにある索引に対して定義された、存在するすべての使用量リストが取得されます。 これを指定した場合は、usagelistschema で識別されるスキーマの、指定した使用量リストのみが戻されます。 デフォルトは NULL です。

member

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

許可

デフォルトの PUBLIC 特権

なし

例

すべてのデータベース・メンバーから使用量リスト USL_MON_IND1 を戻します。

SELECT * FROM TABLE(
MON_GET_INDEX_USAGE_LIST(NULL, 'USL_MON_IND1', -2))

USAGELISTSCHEMA    USAGELISTNAME    INDSCHEMA      INDNAME         MEMBER
------------------ ---------------- -------------- --------------- ------
ISAYYID            USL_MON_IND1     ISAYYID        I1              0
ISAYYID            USL_MON_IND1     ISAYYID        I1              0


DATA_PARTITION_ID
-----------------
                -
                -


EXECUTABLE_ID
-------------------------------------------------------------------
x'0100000000000000490000000000000000000000020020110706093802577065'
x'01000000000000004B0000000000000000000000020020110706093825981548'


MON_INTERVAL_ID     LAST_UPDATED               NUM_REFERENCES
---------------------------------------------- --------------------
                   02011-07-06-09.38.15.881668                    1
                   02011-07-06-09.38.25.984147                    1  
            
                   
NUM_REF_WITH_METRICS OBJECT_INDEX_L_READSOBJECT_INDEX_P_READS 
-------------------- ---------------------------------------- 
                   1                    1                   0 
                   1                    1                   0 

       
 OBJECT_INDEX_GBP_L_READS OBJECT_INDEX_GBP_P_READS 
 ------------------------ ------------------------ 
                        0                        0 
                        0                        0 
                        
OBJECT_INDEX_GBP_INVALID_PAGES OBJECT_INDEX_LBP_PAGES_FOUND                        
------------------------------ ----------------------------
                             0                            0                           
                             0                            0
                             

2 record(s) selected.

使用上の注意

この関数によって戻される各行は、リストに追加されて以降、特定の時間間隔 (モニター・インターバル ID) 中に固有のセクション (DML ステートメントのみ、実行可能 ID) が特定のオブジェクトを参照した合計回数 (num_references) を表します。 この行に関して収集された統計は、その時間間隔中のこれらの実行にわたる総計値を表します。

平均を計算するときには、num_references 列ではなく num_ref_with_metrics 列を使用してください。報告されるメトリックにセクション実行が寄与したかどうかにかかわらず、num_references 列ではセクションのすべての実行がカウントされるためです。

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

戻される情報