RUNSTATS INDEX の構文およびオプション

RUNSTATS INDEX ユーティリティー制御ステートメントは、RUNSTATS ユーティリティー・ジョブによって実行される操作を定義します。

制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。

以下の構文と説明は RUSNTATS INDEX 制御ステートメントに適用されます。INDEX キーワードの使用法を含め、RUNSTATS TABLESPACE 制御ステートメントの構文とオプションについては、RUNSTATS TABLESPACE の構文とオプションを参照してください。

RUNSTATS INDEX 構文図

>>-RUNSTATS--INDEX---------------------------------------------->

>--+-LIST--listdef-name--| correlation-stats-spec |----------------------------------------+-->
   |   .-,---------------------------------------------------------.                       |   
   |   V                                                           |                       |   
   +-(---index-name--+---------------+--| correlation-stats-spec |-+-)---------------------+   
   |                 '-PART--integer-'                                                     |   
   '-(--ALL--)--TABLESPACE--+----------------+-tablespace-name--| correlation-stats-spec |-'   
                            '-database-name.-'                                                 

   .-SHRLEVEL--CHANGE----.  .-REPORT--NO--.   
>--+---------------------+--+-------------+--------------------->
   '-SHRLEVEL--REFERENCE-'  '-REPORT--YES-'   

   .-UPDATE--ALL------------.                              
>--+------------------------+--+-----------------------+-------->
   '-UPDATE--+-ACCESSPATH-+-'  '-SORTDEVT--device-type-'   
             +-SPACE------+                                
             '-NONE-------'                                

                                         (1)           
                         .-HISTORY--NONE-----------.   
>--+------------------+--+-------------------------+------------>
   '-SORTNUM--integer-'  '-HISTORY--+-ALL--------+-'   
                                    +-ACCESSPATH-+     
                                    '-SPACE------'     

   .-FORCEROLLUP--NO--.   
>--+------------------+----------------------------------------><
   '-FORCEROLLUP--YES-'   

注:
  1. STATISTICS HISTORY サブシステム・パラメーターを変更すること によって、デフォルトの HISTORY 値を変更することができます。 デフォルトでは、この値は NONE です。

correlation-stats-spec:

             (1)     
   .-KEYCARD-----.   
>>-+-------------+---------------------------------------------->

   .----------------------------------------------------------------.   
   V .-FREQVAL -NUMCOLS--1--COUNT--10--MOST-----------------------. |   
>----+------------------------------------------------------------+-+-><
     |                                            .-MOST--.       |     
     +-FREQVAL -NUMCOLS--integer--COUNT--integer--+-------+-------+     
     |                                            +-BOTH--+       |     
     |                                            '-LEAST-'       |     
     |            .-NUMCOLS--1--NUMQUANTILES--100---------------. |     
     '-HISTOGRAM--+---------------------------------------------+-'     
                  |                   .-NUMQUANTILES--100-----. |       
                  '-NUMCOLS--integer--+-----------------------+-'       
                                      '-NUMQUANTILES--integer-'         

注:
  1. KEYCARD オプションは推奨されません。KEYCARD の機能は、RUNSTATS INDEX ユーティリティーの通常実行に組み込まれるようになっているため、無効にはできません。

RUNSTATS INDEX オプションの説明

INDEX
統計が収集される索引を指定します。 列統計の収集は、索引の最初の列について行われます。すべての索引は、同じ表スペースに関連付けられている必要があります。
LIST listdef-name
前に定義された LISTDEF リスト名の名前を指定し ます。それぞれの RUNSTATS 制御ステートメントごとに、1 つの LIST キーワードを指定することができます。 LIST を RUNSTATS INDEX と一緒に指定する場合は、リストに含まれるのは索引スペースのみ です。correlation-stats-spec を除き、LIST を INDEX…(index-name) 仕様のキーワードと一緒に指定しないでください。

RUNSTATS は、関連した表スペース別に索引をグループ化し ます。RUNSTATS INDEX は、1 つの表スペースにつき 1 回呼び出されます。 LIST の内容を妥当性検査するためには、INDEX キーワードが必要です。

(index-name, …)
統計が収集される索引を指定します。 索引名のリストを指定することができます。指定する索引が複数の場合は、それぞれの名前をコンマで 区切ります。 名前にブランクが含まれている場合は、索引名を引用符で囲みます。
PART integer
統計の収集が行われる索引パーティションを示します。

integer はパーティションの番号です。

(ALL)
指定した表スペースのすべての表に定義されているすべての索引について、 統計を収集することを指定します。
TABLESPACE
索引の統計の収集が行われる表スペース (およびオプションで、それが属するデータベース) を示します。
database-name
表スペースが属するデータベースの名前。

デフォルト値は、DSNDB04 です。

tablespace-name
索引の統計の収集が行われる表スペースの名前を示します。
KEYCARD
RUNSTATS INDEX 制御ステートメントの KEYCARD オプション は非推奨であり、索引のキー列に含まれる値の統計を収集する場合に指定する 必要はなくなりました。

XML NODEID 索引または XML 値索引を処理する場合を除き、RUNSTATS ユーティリティーでは、指定された索引の 1 から n 個までのキー列の全組み合わせの中で、異なる値をすべて自動的に収集します。ここで、n は、索引内の列の数です。 例えば、3 つの列 A、B、および C に定義された 1 つの索引があると します。RUNSTATS は列 A、列セット A と B、および列セット A、B、C に ついてカーディナリティー統計を収集します。KEYCARD が非推奨になったことにともない、 この機能を使用不可にすることはできなくなりました。

RUNSTATS ユーティリティー では、KEYCARD オプションの指定が容認されます。このユーティリティーでは、 INDEX を指定するときに制御ステートメントに KEYCARD オプションが含まれて いても、除外されていても、メッセージを出しません。

FREQVAL
INDEX オプションとともに指定した場合、頻度統計の収集を制御します。変更の始まりFREQVAL を INDEX と一緒に指定する場合は、このキーワードの後に NUMCOLS キーワードを続ける必要があります。変更の終わり RUNSTATS INDEX は、XML NODEID 索引または XML 値索引を処理しているときには FREQVAL MOST/LEAST/BOTH を無視します。
NUMCOLS integer
頻繁に発生する値を RUNSTATS が収集する、索引の列の数を示し ます。integer は、1 から索引の列数までの数値です。 索引のある列数よりも大きい数を指定すると、RUNSTATS は索引の列数を使用します。

例えば、3 つの列 A、B、および C で索引が定義されているとします。NUMCOLS 1 を指定すると、Db2® は、列 A について、頻繁に発生する値を収集します。NUMCOLS 2 を指定すると、Db2 は、列セット A と B について、頻繁に発生する値を収集します。NUMCOLS 3 を指定すると、Db2 は、列セット A、B、および C について、頻繁に発生する値を収集します。

デフォルト値は 1 です。 これは、RUNSTATS が、索引の最初のキー列で頻繁に発生する値を収集することを 意味します。

COUNT integer
指定したキー列から収集する、頻繁に発生する値の個数を指示します。 例えば、15 と指定すると、RUNSTATS は、指定されたキー列から 15 個の頻度を収集することを意味します。

デフォルト は 10 です。

MOST
FREQVAL NUMCOLS COUNT MOST キーワードが指定された場合に、指定されたキー列セットについて、最も頻繁に発生する値 をユーティリティーが収集することを指示します。
LEAST
FREQVAL NUMCOLS COUNT LEAST キーワードが指定された場合に、指定されたキー列セットについて、発生頻度が最も低い値 をユーティリティーが収集することを指示します。
BOTH
FREQVAL NUMCOLS COUNT BOTH キーワードが指定された場合に、指定されたキー列セットについて、発生頻度が最高の値と最低の値を ユーティリティーが収集することを指示します。
HISTOGRAM
RUNSTATS INDEX の INDEX オプション (correlation-stats-spec を参照) とともに指定された場合に、指定されたキー列のグループについて、 ヒストグラム統計を収集することを指示します。ヒストグラム統計は、順序が同じ接頭部列についてのみ収集できます。 ヒストグラム統計には、 順序が混合しているキー列は許可されません。

RUNSTATS は、パーティション化索引についてヒストグラム統計を 収集する際、それらを集約して SYSCOLDIST に入れます。RUNSTATS INDEX は、XML NODEID 索引または XML 値索引を処理しているときには HISTOGRAM キーワードを無視します。

NUMQUANTILES integer
ユーティリティーが収集する変位値の数を指定します。 integer 値は、1 以上である必要があります。 指定する変位値の数は、指定されたキー列の値として異なる数がいくつあるのかを示す数の合計 を決して超えないような値にするべきです。変位値の数の最大数は 100 です。

NUMQUANTILES キーワードが省略された場合、 NUMQUANTILES の値はデフォルトの 100 になります。索引のキー数に 基づいて、変位値の数は最適な数に減らされます。

SHRLEVEL
他のプログラムが RUNSTATS の実行中に表スペースにアクセスする場合、 読み取り専用アクセスを使用する必要があるか、 あるいは表スペースを変更できるかどうかを示します。
CHANGE
他のプログラムは、表スペースまたは索引を変更することができ ます。SHRLEVEL CHANGE を用いると、RUNSTATS はコミットされていないデータで統計を収集することがあります。
REFERENCE
他のプログラムは、読み取り専用アクセスのみが可能です。
REPORT
RUNSTATS が、収集された統計を報告するメッセージのセットを生成することを指定します。
NO
RUNSTATS がメッセージのセットを生成しないことを示します。
YES
メッセージのセットが出力として SYSPRINT に送られることを示します。 RUNSTATS が生成するメッセージは、ユーティリティー制御ステートメントにおけるキーワードの組み合わせによって異なります。 ただし、これらのメッセージは UPDATE オプションの値によって左右されることはありません。 REPORT YES を用いると、スペース統計およびアクセス・パス 統計の報告書は必ず生成されます。
UPDATE
収集されたどの統計をカタログ表に挿入するかを示します。
ALL
すべての収集された統計をカタログ内で更新することを示します。
ACCESSPATH
アクセス・パス選択に使用する統計のみで Db2 がカタログを更新することを 示します。
SPACE
スペース関連の統計のみで Db2 がカタログを 更新することを示します。
NONE
収集された統計でカタログ表を更新しないことを示します。

RUNSTATS を実行すると常に動的キャッシュは無効になります。 ただし UPDATE NONE REPORT NO を指定した場合、RUNSTATS は、統計の収集、カタログ表の更新、レポートの生成を行わずに動的ステートメント・キャッシュ内のステートメントを無効にします。

SORTDEVT
必要なソート作業データ・セットを動的に割り振るために外部ソート・プログラムが使用する 装置タイプを指定します。
device-type
外部ソート・プログラムの SORT または OPTIONS オプションの DYNALLOC パラメーター で受け入れ可能な任意のディスク装置タイプを指定します。

以下のすべての条件に該当する場合、SORTDEVT のデフォルトは SYSALLDA に設定され、一時データ・セットは動的に割り振られます。

  • SORTDEVT を省略した。
  • ソートが必要である。
  • ソート・プログラムが一時データ・セット用に必要とする DD ステートメントを指定しなかった。

SORTDEVT を指定し、SORTNUM を省略した場合、ソート・プログラムに値は渡されません。ソート・プログラムはプログラム自身のデフォルトを使用します。

SORTNUM
ソート・プログラムが割り振る、必要な作業データ・セットの 数を指定します。

integer は一時データ・セット数で、可能な 範囲は 2 から 255 です。

各ソートごとに最低 2 つのソート用作業データ・セットが必要です。SORTNUM 値は、このユーティリティー内の各ソート呼び出しに適用されます。例えば、3 つの索引で RUNSTATS が実行されていて、SORTKEYS が指定されていて、並列処理を制限する制約が何もなく、SORTNUM が 8 と指定されているとします。この場合、合計で 24 個のソート作業データ・セットがジョブに割り振られます。

各ソート作業データ・セットは、16 MB 境界より上と下の両方の仮想ストレージを使用します。 そのため、SORTNUM に指定する値が高すぎると、このユーティリティーは仮想ストレージの制約のために並列処理の度合いを減らす可能性があり、場合によっては、並列処理が使用されないことを意味する 1 にまで減らすこともあります。

HISTORY
収集されたどの統計をカタログ履歴表に記録するかを示します。 HISTORY に指定する値は、UPDATE に指定する値には依存しません。

デフォルトは、DSNTIPO インストール・パネルの STATISTICS HISTORY サブシステム・パラメーターの値です。 デフォルトでは、このパラメーター値は NONE です。

ALL
すべての収集された統計をカタログ履歴表内で更新することを示します。
ACCESSPATH
アクセス・パス選択に使用する統計のみで Db2 がカタログ履歴表を更新することを 示します。
SPACE
スペース関連の統計のみで Db2 がカタログ履歴表を 更新することを示します。
NONE
カタログ履歴表は、収集された統計を用いて更新しないことを示します。
FORCEROLLUP
一部のパーティションで統計が収集されなかった場合でも統計の集約またはロールアップを行うかどうかを指定します。 このオプションによって、オプティマイザーは最適アクセス・パスを選択することができます。
YES
一部のパーティションにデータが存在しない場合であっても、 集約またはロールアップ処理を強制的に行うことを示します。
NO
すべてのパーティションでデータが使用可能な場合に限り、 集約またはロールアップを行うことを示します。
パネル DSNTIPO の STATISTICS ROLLUP の値が NO であり、 すべてのパーティションに対してデータが使用可能でない場合、Db2 はメッセージ DSNU623I を発行します。