ADMIN_GET_INDEX_INFO 表関数 - 索引情報を戻す

構文

スキーマは SYSPROC です。

表関数パラメーター

objecttype

オブジェクト・タイプを示す、タイプ VARCHAR(1) の入力引数。値は以下のいずれかでなければならず、大/小文字を区別します。

• 'T'、NULL、または空ストリング (") (表を示す場合)
• 'I' (索引の場合)

objectschema

オブジェクト・スキーマを指定する、タイプ VARCHAR (128) の大/小文字を区別する入力パラメーター。

objecttype が 'T'、NULL、または空ストリング ('') である場合、objectschema は表スキーマを示します。

• objectschema が指定され、objectname が NULL または空ストリング ('') の場合、指定されたスキーマのすべての表に関する情報が戻されます。
• objectschema と objectname の両方が指定される場合、指定された表のすべての索引に関する情報が戻されます。

objecttype が 'I' である場合、objectschema は索引スキーマを示します。

• objectschema が指定され、objectname が NULL または空ストリング (") の場合、指定されたスキーマのすべての索引に関する情報が戻されます。
• objectschema と objectname の両方が指定される場合、指定された索引に関する情報が戻されます。
• objectschema と objectname のどちらも指定されない場合、すべてのスキーマのすべての索引に関する情報が戻されます。

objectname が指定され、objectschema が指定されない場合、関数が SQL エラー を戻します。 値が NULL または空ストリング (") である場合、パラメーター値は未指定であるといいます。

objectname

オブジェクト名を指定する、タイプ VARCHAR (128) の大/小文字を区別する入力パラメーター。 objectschema パラメーターの説明を参照してください。

許可

デフォルトの PUBLIC 特権

制限のないデータベースでは、この関数が自動的に作成されると、EXECUTE 特権が PUBLIC に付与されます。

例

表のいくつかの索引に対して索引圧縮を有効にした後で、どの索引が圧縮されるのか、および圧縮するためにはどの索引を再作成する必要があるかを知りたいとします。 この例では、S はスキーマ名、T1 は表名です。

db2 SELECT iid, compress_attr, index_compressed
    FROM TABLE(sysproc.admin_get_index_info('','S','T1')) AS t

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

IID       COMPRESS_ATTR INDEX_COMPRESSED 
--------- ------------- ---------------- 
        1 Y             Y                
        2 Y             Y                
        3 Y             N                
        4 N             N                

さらに、スキーマ S2 のすべての索引の他の索引情報を参照するとします。この例では、それぞれ次の意味を持つとします。

• T2 = 2 つのデータ・パーティションを持つパーティション表
• T3 = 非パーティション表
• IND_1 = T2 上の非パーティション索引
• IND_2 = T2 上のパーティション索引
• IND_3 = T2 上のパーティション索引
• IND_4 = T3 上の索引
• IND_5 = T3 上の索引

db2 SELECT tabname, indname, iid,index_partitioning, datapartitionid,
   index_object_l_size, index_object_p_size, index_requires_rebuild,
   large_rids FROM TABLE(sysproc.admin_get_index_info('I','S2','')) AS t

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

TABNAME INDNAME IID       INDEX_PARTITIONING DATAPARTITIONID
------- ------- --------- ------------------ ---------------
T2      IND_1           1 N                                0
T2      IND_2           2 P                                1
T2      IND_2           2 P                                2
T2      IND_3           3 P                                1
T2      IND_3           3 P                                2
T3      IND_4           4                                  0
T3      IND_5           5                                  0

この手順からの出力 (続き):

INDEX_OBJECT_L_SIZE INDEX_OBJECT_P_SIZE INDEX_REQUIRES_REBUILD LARGE_RIDS
------------------- ------------------- ---------------------- ----------
                 50                  51                      N          Y
                 40                  40                      N          Y
                 45                  45                      N          Y
                 40                  40                      N          Y
                 45                  45                      N          Y
                 20                  20                      N          Y
                 20                  20                      N          Y

戻される情報