統計プロファイルの構文

統計プロファイルのオプションは、SYSTABLES_PROFILES カタログ表 の PROFILE_TEXT 列に格納されます。

統計プロファイルでは、以下の統計収集オプションを指定できます。
  • COLUMN
  • COLGROUP
  • FREQVAL
  • COUNT
  • MOST
  • BOTH
  • LEAST
  • INDEX
  • KEYCARD
  • NUMCOLS
  • COUNT
  • MOST
  • BOTH
  • LEAST
  • HISTOGRAM
  • NUMQUANTILES

プロファイルは、指定されないすべてのオプションに対するデフォルト値を含みます。

パーティション化された索引を含む既存のプロファイルを更新する場合は、その索引のすべての索引の仕様で PART キーワードを指定するか、その索引の索引の使用で省略する必要があります。統計プロファイル処理によって、この要件が実施されます。SQL ステートメントを使用して行われるプロファイルの変更は、同じ制約事項に従う必要があります。そうしないと、プロファイルの使用時にエラー・メッセージが出されます。

所定のパーティション化された索引では、以下のようになります。

  • PART キーワードのない新規索引の仕様の場合、PART キーワードの仕様に関係なく、 プロファイル内のすべての索引の仕様が置換されます。
  • PART キーワードのある新規索引の仕様の場合は、同じ PART が指定された索引の仕様のみまたは PART キーワードのない仕様が置換されます。

PROFILE 関数は、統計プロファイルに構文エラーがある場合は実行できません。構文エラーは、RUNSTATS UPDATE PROFILE または SQL UPDATE を使用するか、または RUNSTATS DELETE PROFILE または SQL DELETE でプロファイルを削除することによって訂正できます。

>>-| column-spec |--+----------------------------------+-------><
                    '-| colgroup-spec |-| index-spec |-'   

column-spec:

   .-COLUMN--(--ALL--)-----------------.   
>>-+-----------------------------------+-----------------------><
   |            .-,---------------.    |   
   |            V             (1) |    |   
   '-COLUMN--(----column-name-----+--)-'   

注:
  1. 同じ列名を複数回指定することはできません。 COLUMN オプションにすべての列がリストされている場合、RUNSTATS はそのリストを COLUMN(ALL) オプションで置換せずにそのまま処理します。COLUMN(ALL) オプションは、明示的に指定する必要があります。

colgroup-spec:

                .-,-----------.                               
                V             |                               
>>-COLGROUP--(----column-name-+--)--| colgroup-stats-spec |----><

index-spec:

>>-+-------------------------------------------------------------+-><
   '-+-INDEX--(--ALL--)--| correlation-stats-spec |------------+-'   
     |             (1)                                         |     
     +-INDEX--(--*------)--| correlation-stats-spec |----------+     
     |           .-,--------------------------------------.    |     
     |           V                                        |    |     
     '-INDEX--(----index-name--| correlation-stats-spec |-+--)-'     

注:
  1. INDEX(*) は、Db2® が RUNSTATS プロファイルのコンテキストでのみ使用する INDEX(ALL) の内部表記であり、いずれかの RUNSTATS 制御ステートメントにおいて指定された場合は無効です。プロファイルを作成する RUNSTATS 制御ステートメントで INDEX(ALL) オプション を指定した場合、Db2 では、SYSIBM.SYSTABLES_PROFILES カタログ表の PROFILE_TEXT 列 で INDEX(*) を使用します。一方、PROFILE_TEXT 列の値を直接更新することによりプロファイルを変更する場合は、INDEX(ALL) ではなく INDEX(*) を指定する 必要があります。

colgroup-stats-spec:

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

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 ユーティリティーの通常実行に組み込まれるようになっているため、無効にはできません。

統計プロファイルのオプション

統計プロファイル・オプションには、RUNSTATS ユーティリティー制御ステートメントで直接指定された場合と同じ意義があります。 詳しくは、RUNSTATS TABLESPACE の構文とオプションを参照してください。