RUNSTATS TABLESPACE の構文およびオプション
RUNSTATS TABLESPACE ユーティリティー制御ステートメントは、RUNSTATS ユーティリティー・ジョブによって実行される操作を定義します。
制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。
INDEX キーワードの使用法を含め、以下の構文と説明は、RUSNTATS TABLESPACE 制御ステートメントに適用されます。RUNSTATS INDEX 制御ステートメントの構文とオプションについては、RUNSTATS INDEX の構文とオプションを参照してください。
RUNSTATS TABLESPACE 構文図
>>-RUNSTATS--TABLESPACE--+-| listdef-spec |-----+---------------> '-| table-space-spec |-' .-| statistics-spec |-. >--+---------------------+------------------------------------->< '-| reset-spec |------'
listdef-spec
>>-LIST--listdef-name------------------------------------------><
table-space-spec
>>-+----------------+-table-space-name--------------------------> '-database-name.-' >--+-------------------------------------+--------------------->< | .-FORCEROLLUP--NO--. | '-PART--integer--+------------------+-' '-FORCEROLLUP--YES-'
statistics-spec
>>-+--------------------------------------------------+---------> | (1) .-(ALL)-. | +-TABLE------+-------+--| all-tables-spec |--------+ | .-,--------------------------------------------. | | V (1) | | '---TABLE------table-name--| named-tables-spec |-+-' >--+-------------------------------------------------------------+--> | (2) | '-+-INDEX------(--ALL--)--| correlation-stats-spec |--------+-' | (3) | +-INDEX--(--*------)--| correlation-stats-spec |----------+ | .-,--------------------------------------. | | V | | '-INDEX--(----index-name--| correlation-stats-spec |-+--)-' .-SHRLEVEL--CHANGE----. .-REPORT--NO--. >--+---------------------+--+-------------+---------------------> '-SHRLEVEL--REFERENCE-' '-REPORT--YES-' .-UPDATE--ALL----------------. >--+----------------------------+----| history-spec |-----------> '---UPDATE--+-ACCESSPATH-+---' +-SPACE------+ '-NONE-------' >--+-----------------------+----------------------------------->< '-SORTDEVT--device-type-'
- LOB 表スペースには TABLE キーワードは無効です。
- USE PROFILE または DELETE PROFILE オプションも指定されている場合、INDEX は指定できません。
- INDEX(*) は、Db2® が RUNSTATS プロファイルのコンテキストでのみ使用する INDEX(ALL) の内部表記であり、いずれかの RUNSTATS 制御ステートメントにおいて指定された場合は無効です。プロファイルを作成する RUNSTATS 制御ステートメントで INDEX(ALL) オプション を指定した場合、Db2 では、SYSIBM.SYSTABLES_PROFILES カタログ表の PROFILE_TEXT 列 で INDEX(*) を使用します。一方、PROFILE_TEXT 列の値を直接更新することによりプロファイルを変更する場合は、INDEX(ALL) ではなく INDEX(*) を指定する 必要があります。
all-tables-spec
>>---+-| sample-spec |--+----------------------+-+------------->< | '-| use-profile-spec |-' | '-DELETE PROFILE----------------------------'
named-tables-spec
(1) (2) >>-+---| sample-spec |----------+-| column-spec |--+-------------------+-+---+->< | | '-| colgroup-spec |-' | | | | (3) | | | '---| use-profile-spec |-----------------' | +-| column-spec |--+-------------------+--+--------------------------+----+ | '-| colgroup-spec |-' | (3) | | | '-| set-profile-spec |-----' | | (3) | '-DELETE PROFILE----------------------------------------------------------'
- TABLESAMPLE キーワードは、単一表の表スペースでのみ有効です。 REORG、COPY、および MODIFY RECOVERY が実行されるまで、ドロップされた表がこのカウントに含まれます。
- TABLESAMPLE を使用して、複数表の表スペースや、セグメント化されている一方でパーティション化されていない表スペースをサンプリングする場合、ページ・サンプリングは行われず、実行は続行されます。 LOB 表スペースには TABLESAMPLE キーワードは無効です。
- あるタイプの PROFILE 関数が、ある TABLE 節で指定されている場合、同じタイプの PROFILE 関数がすべての TABLE 節で指定されている必要があります。
sample-spec
>>-+-----------------------------------------------------------------+->< | .-25------. | +-SAMPLE--+---------+---------------------------------------------+ | '-integer-' | | .-AUTO------------. | '-TABLESAMPLE SYSTEM--+-numeric-literal-+--+--------------------+-' '-REPEATABLE-integer-'
use-profile-spec
(1) (2) >>-USE PROFILE----------+--------------------+----------------->< '-INCLUDE--+-(NPI)-+-' '-NPI---'
- USE PROFILE が TABLE (ALL) キーワードとともに指定されているのに、ターゲット表のプロファイルが存在しない場合、 TABLE ALL INDEX ALL がプロファイル指定に使用されます。
- USE PROFILE が指定されているのに、ターゲット表のプロファイルが存在しない場合、 COLUMN ALL INDEX ALL がプロファイル指定に使用されます。
column-spec:
.-COLUMN--(--ALL--)-----------------. >>-+-----------------------------------+------------------------> | .-,---------------. | | V (1) | | '-COLUMN--(----column-name-----+--)-' >--+------------------+---------------------------------------->< '-SORTNUM--integer-'
- 同じ列名を複数回指定することはできません。 すべての列が COLUMN オプションでリストされている場合、RUNSTAT はそれらをそのまま処理し、COLUMN(ALL) オプションで置き換えることはしません。 COLUMN(ALL) オプションが必要な場合、明示的に記述する必要があります。
colgroup-spec:
.----------------------------------------------------------. | .-,-----------. | V V | | >>---COLGROUP--(----column-name-+--)--| colgroup-stats-spec |-+-><
colgroup-stats-spec:
>>-+----------------------------------------+-------------------> | .-COUNT 10 MOST-------------. | '-FREQVAL--+---------------------------+-' | .-MOST--. | '-COUNT--integer--+-------+-' +-BOTH--+ '-LEAST-' >--+--------------------------------------+-------------------->< | .-NUMQUANTILES--100-----. | '-HISTOGRAM--+-----------------------+-' '-NUMQUANTILES--integer-'
correlation-stats-spec:
>>-+-------------+----------------------------------------------> | (1) | '-KEYCARD-----' .--------------------------------------------------------------. V .-FREQVAL -NUMCOLS--1--COUNT--10--MOST---------------------. | >----+----------------------------------------------------------+-+--> | .-COUNT 10 MOST-------------. | '-FREQVAL -NUMCOLS--integer--+---------------------------+-' | .-MOST--. | '-COUNT--integer--+-------+-' +-BOTH--+ '-LEAST-' .----------------------------------------------------------------. V | >----+------------------------------------------------------------+-+->< | .-NUMCOLS--1--NUMQUANTILES--100---------------. | '-HISTOGRAM--+---------------------------------------------+-' | .-NUMQUANTILES--100-----. | '-NUMCOLS--integer--+-----------------------+-' '-NUMQUANTILES--integer-'
- KEYCARD オプションは推奨されません。KEYCARD の機能は、RUNSTATS INDEX ユーティリティーの通常実行に組み込まれるようになっているため、無効にはできません。
set-profile-spec
>>-+-SET--PROFILE--+-------------------------+-+--------------->< | | (1) | | | '-FROM EXISTING STATS-----' | '-UPDATE--PROFILE---------------------------'
- column-spec、colgroup-spec、または INDEX キーワードが指定されている場合、FROM EXISTING STATS 節は無効です。
history-spec
(1).-HISTORY--NONE-----------. >>-----+-------------------------+----------------------------->< '-HISTORY--+-ALL--------+-' +-ACCESSPATH-+ '-SPACE------'
- STATISTICS HISTORY サブシステム・パラメーターを変更すること によって、デフォルトの HISTORY 値を変更することができます。 デフォルトでは、この値は NONE です。
>>-+-------------------------------------------+--------------->< '-RESET ACCESSPATH--+---------------------+-' '-HISTORY ACCESSPATH-'
RUNSTATS TABLESPACE オプションの説明
- TABLESPACE database-name.table-space-name
- 表スペース統計および表統計の収集が行われる表スペース (および
オプションで、それが属しているデータベース) を指定します。
このキーワードで、DSNDB01 内の表スペースや、DSNDB07 オブジェクトとユーザー定義の作業ファイル・オブジェクトから構成される作業ファイル・データベースを指定してはなりません。
- LIST listdef-name
- 前に定義された LISTDEF リスト名の名前を指定し
ます。それぞれの RUNSTATS 制御ステートメントごとに、1 つの LIST キーワードを指定することができます。
このキーワードを RUNSTATS TABLESPACE と一緒に指定する場合は、リストに含まれるのは表スペース
のみです。LIST を TABLE…(table-name) 仕様のキーワードと一緒に
指定しないでください。代わりに、LIST を TABLE (ALL) と共に指定してください。同様に、
LIST を INDEX…(index-name) 仕様のキーワードと一緒に指定しないでください。
リストと一緒に索引名を指定することはできません。
代わりに INDEX(ALL) を使用してください。
LIST を指定した場合は、PART オプションは指定できません。 代わりに、LISTDEF ステートメントで、PARTLEVEL オプションを使用してください。リストの内容の妥当性を検査するためには、TABLESPACE キーワードが必要です。 RUNSTATS TABLESPACE は、リストのそれぞれの項目ごとに 1 回、呼び出されます。
パーティションまたは パーティション範囲をリストに指定できます。
- database-name
- 表スペースが属しているデータベースの名前を示します。
デフォルト値は、DSNDB04 です。
- table-space-name
- 統計の収集が行われる表スペースの名前を示します。
TABLESPACE キーワードで指定される 表スペースが LOB 表スペースの場合、追加指定できるキーワードは、 SHRLEVEL REFERENCE または CHANGE、 REPORT YES または NO、および UPDATE ALL または NONE のみです。
- PART integer
- 統計の収集が行われる表スペースのパーティションを示します。
integer は物理パーティション番号です。1 から、表スペースに定義されたパーティション数までの範囲でなければなりません。
最大は 4096 です。
PART は LIST と一緒には指定できま せん。
- TABLE
- 列統計が収集される表を指定します。
すべての表は、TABLESPACE オプションで指定された表スペースに属している必要があります。
LOB 表スペースに TABLE オプションを指定することはできません。ただし、指定したリストに LOB 表スペースが含まれていても、LIST オプションと一緒に指定するのであれば TABLE オプションを指定できます。
この場合、TABLE キーワードは非 LOB 表スペースのみに適用され、LOB 表スペースでは無視されます。
- (ALL)
- 表スペース内のすべての表のすべての列について列統計を収集することを
指定します。ALL を囲む括弧はオプションです。
TABLE オプション値では、LOB 表を指定できません。 ただし、TABLE(ALL) が指定されていて、表スペース内の 1 つ以上の表に LOB 列がある場合、LOB 表についてのエラーは出されません。 RUNSTATS は、非 LOB 表についてのみ、表と列の統計を収集します。
- (table-name)
- 列統計が収集される表を指定します。
修飾子を省略すると、RUNSTATS は、ユーティリティー・ジョブのユーザー ID を使用します。
名前にブランクが含まれている場合は、表名を引用符で囲みます。
指定する表が複数の場合は、TABLE オプションを繰り返す必要があります。 複数の TABLE オプションを指定する場合、指定する INDEX キーワードの前または後にすべてを指定する必要があります。 例えば、2 つの TABLE キーワードの間に INDEX キーワードを指定することはできません。
- SAMPLE integer
- 索引の非先行索引列または非索引列で統計を収集する際に、RUNSTATS がサンプリングする行数のパーセントを示します。
1 から 100 までの任意の値を指定することができます。
デフォルト値は 25 です。
SAMPLE 値を低く指定した場合、不正確なサンプリングによって統計が不正確になり、結果として不良なアクセス・パスが生じることもあります。サンプルが小さいほど不正確になる可能性は高くなり、アクセス・パスに影響が及ぶ可能性があります。
LOB 表スペースに SAMPLE を指定することはできません。
- USE PROFILE
- 表の統計を収集するために使用する保管済みの統計プロファイルを指定します。統計プロファイルは SET PROFILE オプションを使用して作成され、UPDATE PROFILE オプションを使用して更新されます。
列、列グループ、および索引の仕様は、 制御ステートメントの一部としては許可されませんが、統計プロファイルに 保管されて使用されます。
指定された表に対するプロファイルが存在しない場合、デフォルトの統計が収集されます。
- 表名を指定しないときは、TABLE ALL INDEX ALL がプロファイル指定に使用されます。
- 表名を指定したときは、COLUMN ALL INDEX ALL がプロファイル指定に使用されます。

- INCLUDE NPI または INCLUDE (NPI)
- 表のプロファイルにリストされている非パーティション化索引について、統計が収集されることを指定します。 RUNSTATS TABLESPACE レベルで PART キーワードが指定されていない場合、INCLUDE NPI 文節は無効です。 INCLUDE キーワードと NPI キーワードは、一緒に指定する必要があります。NPI を囲む括弧はオプションです。
- DELETE PROFILE
- SYSIBM.SYSTABLES_PROFILES カタログ表から削除する既存の RUNSTATS プロファイルを指定します。
DELETE PROFILE オプションを使用する 場合、列、列グループ、および索引の仕様は、制御ステートメントの一部としては 許可されません。RUNSTATS 制御ステートメントでこのオプションを指定した場合、統計は収集されません。
- TABLESAMPLE SYSTEM
- RUNSTATS でデータ・ページのサンプルの統計を表から収集できます。
システムのサンプリングでは、それぞれのページが別個であるとみなされ、確率が P/100 (P は、数値リテラルの値) のページは含められ、確率が 1-P/100 のページは除外されます。オプションの REPEATABLE 節を指定しないと、RUNSTATS を実行するたびに得られるそのような表のサンプルは、通常は異なるものになります。
サンプルのサイズは、戻される表の概算比率 (P) を表す、括弧で囲んだ整数パラメーターで制御されます。数値リテラル・パラメーターによって指定されたデータ・ページのパーセンテージのみが取得されて、統計収集に使用されます。
このキーワードは、単一表の表スペースに対してのみ有効です。
RUNSTATS を TABLESAMPLE SYSTEM AUTO キーワードと一緒にパーティション表スペース全体に対して実行した場合、しかも各パーティションの行数が大きく異なる場合は、行を含むページが非常に少ないパーティションがスキップされることがあります。そのような場合は、DSNU1375I メッセージによって、サンプリングされていない各パーティションが示されます。そのような各パーティションに対し、パーティション・レベルで SAMPLE キーワードを指定して、RUNSTATS を再実行するのが最良の方法です。
LOB 表スペースには TABLESAMPLE キーワードは無効です。
複数の表が存在する表スペース、またはセグメント化されている非パーティション化表スペースで RUNSTATS TABLESPACE TABLE を実行するとき、TABLESAMPLE キーワードは使用されません。
代わりに、すべてのページがスキャンされて統計が収集されます。
- numeric-literal
- 取得するサンプルのサイズを、パーセンテージ (P) で指定します。この値は、100 以下かつ 0 より大きい正数である必要があります。例えば、値 0.01 は、平均して 10,000 行のうち 1 行がサンプリングされるような、100 分の 1 パーセントを表します。100 より大きい値と 0 以下の値は、Db2 ではエラーとして扱われます。
このオプションに使用できる最小の正数は 0.01% です。
使用される表スペース・サイズおよびサンプリング率に基づき、パーティションがサンプルに含まれない場合もあります。 この場合、RUNSTATS により、このパーティションの統計は収集されず、集約された統計に関する警告またはエラーが報告される場合があります。
numeric-literal が指定され、リアルタイム統計を使用できない場合、Db2 はメッセージ DSNU3343I を発行します。
関連情報: - AUTO
- 「AUTO」を指定すると、RUNSTATS は、RUNSTATS の実行時の表のサイズに基づいてサンプリング率を決定します。
表が大きいほど、サンプリング率は小さくなります。サンプリングのしきい値は表に 500,000 を超える行がある場合です。それ以外の場合は、すべてのページが読み取られます。
PART オプションが指定された TABLESPACE サンプリングでは、同じしきい値が適用されます。行数は、リアルタイム統計レポートから取得されます。
AUTO が指定されて、リアルタイム統計が使用可能でない場合、RUNSTATS はサンプリング・レートを 100 に設定します。
- REPEATABLE integer
- REPEATABLE 文節を TABLESAMPLE 文節に追加すると、RUNSTATS を繰り返し実行した場合に同じサンプルが戻されるようになります。整数パラメーターは、サンプリングに使用されるシードを表す、負でない整数です。負のシードを渡すと、エラー (DSNU048I) になります。REPEATABLE を使用しても、反復可能な RUNSTATS 呼び出しで返される各サンプル・セットに違いが生じることがあります。 このような違いが発生する可能性があるのは、前回 TABLESAMPLE REPEATABLE が実行された後、表または統計ビューに対するアクティビティーによって表または統計ビューのデータが変更された場合です。
- SET PROFILE
RUNSTATS が、指定された表の RUNSTATS プロファイルを、現行の RUNSTATS 呼び出しで指定されたオプションから生成することを指定します。
RUNSTATS は、そのプロファイルを SYSIBM.SYSTABLES_PROFILES カタログ表に保管します。
RUNSTATS 制御ステートメントでこのオプションを指定した場合、統計は収集されません。
プロファイルで指定できるオプションおよびそれらのオプションを
指定する構文の詳細については、統計プロファイル構文を参照してください。
- FROM EXISTING STATS
- RUNSTATS が、指定された表に現在存在する統計の分析に基づいたオプションを含めて、統計プロファイルを生成することを指定します。 このオプションは、SET PROFILE オプションと合わせてのみ 指定できます。生成されたプロファイルで使用されるキーワードは、前に統計を収集するために使用されたキーワードと必ずしも一致するとは限りません。
- UPDATE PROFILE
- RUNSTATS が、SYSIBM.SYSTABLES_PROFILES カタログ表の既存の統計プロファイルを、現在の RUNSTATS 制御ステートメントに指定されたオプションによって更新することを指定します。 RUNSTATS 制御ステートメントでこのオプションを指定した場合、統計は収集されません。プロファイルに列または COLGROUP の仕様が既に存在する場合、既存の仕様が新しい仕様に置換されます。
- COLUMN
- 列統計が収集される列を指定します。
このオプションを指定できるのは、統計の収集が行われる特定の表 を指定する場合のみに限られます。(特定の表を指定するには、TABLE (table-name) オプションを使用します。) 特定の表を指定し、しかも、COLUMN オプションを指定しなかった場合は、RUNSTATS はデフォルト COLUMN(ALL) を使用します。TABLE オプションと共に特定の表を指定しなかった場合、COLUMN オプションは指定できません。ただしこの場合、COLUMN(ALL) が指定されていると見なされます。
- (ALL)
- 表のすべての列について、統計が収集されることを
指定します。
COLUMN (ALL) オプション を LOB 表スペースに対して指定することはできません。
- (column-name, …)
- 統計の収集が行われる列を指定します。列名のリストを 指定することができます。指定する列が複数の場合は、それぞれの名前をコンマで区切ります。
多くの列を指定すればするほど、ジョブの完了までに時間がかかります。
- COLGROUP (column-name, …)
- 指定された列セットを 1 つのグループとして扱うことを示します。
このオプションによって、RUNSTATS は、指定された列グループでカーディナリティー値を
収集することができます。
RUNSTATS TABLESPACE は、XML 表スペースおよび索引を処理しているときには COLGROUP を
無視します。
COLGROUP キーワードを指定した場合は、RUNSTATS は指定された列グループの相関統計を収集し ます。RUNSTATS に分散統計も収集させる場合は、COLGROUP とともに FREQVAL オプションを指定します。
(column-name, …) は、列グループの一部である列の名前を指定します。
単一列で COLGROUP を定義する場合、STATCLGSRT サブシステム・パラメーターの値を変更することによって RUNSTATS のパフォーマンスを向上できる可能性があります。STATCLGSRT サブシステム・パラメーターを使用すると、単一列の COLGROUP でのデータのソートを回避できます。
詳しくは、STATISTICS COLGROUP DATA SORT STG LIMIT フィールド (STATCLGSRT サブシステム・パラメーター)を参照してください。
複数の列グループを指定する場合は、COLGROUP オプションを繰り返します。
制約事項:- COLGROUP 値の長さ は、SYSIBM.SYSCOLDIST カタログ表内の COLVALUE 列の最大長 を超えてはなりません。
- RUNSTATS 制御ステートメントに含めることができる COLGROUP 指定は最大で 255 個です。
- FREQVAL
- COLGROUP オプションと一緒に指定した場合、頻度統計も指定した列のグループで
収集されることを示します。(COLGROUP は、カーディナリティー統計が収集されることを示し
ます。) 1 つの統計のグループが、それぞれの列ごとに収集されます。
RUNSTATS TABLESPACE は、XML 表スペースおよび索引を処理する際に、FREQVAL MOST、FREQVAL LEAST、FREQVAL BOTH を無視します。
- COUNT integer
- 指定した列グループから収集する、出現頻度の高い値の数を指定します。
integer に値を指定する必要があります。
COUNT キーワードが指定されていない場合、デフォルトは COUNT 10 MOST です。
列グループには、COLCARDF の値から 1 を減算した値以下の COUNT 値を指定するのが最適です。 ほとんどの状況では、10 が一般に妥当な値です。 それより大きな COUNT 値は、(特に高いカーディナリティーの場合には) スキュー・データの検出に必要とされることがあります。 しかし、ほとんどの場合は、100 より大きな値を指定しないでください。 1000 またはそれ以上の値を指定すると、一部の SQL ステートメントでは準備時間が増加する可能性があります。
- MOST
- COLGROUP が指定された場合に、指定された列セットについて、最も出現頻度の高い値をユーティリティーが収集することを指示します。 例えば、FREQVAL COUNT 10 MOST は、出現頻度の高い上位 10 個の値を収集することを意味します。
- BOTH
- COLGROUP が指定された場合に、指定された列セットで最も出現頻度の高い値と低い値をユーティリティーが収集することを示しています。 COUNT が n の場合、 ユーティリティーは n 個の最も出現頻度の低い値と n 個の最も出現頻度の高い値とを収集します。
- LEAST
- COLGROUP が指定された場合に、指定された列セットで最も出現頻度の低い値をユーティリティーが収集することを示しています。
- HISTOGRAM
- RUNSTATS TABLESPACE の COLGROUP オプション (colgroup-stats-spec を参照) と
ともに指定された場合に、指定された列のグループについて、
ヒストグラム統計を収集することを指示します。RUNSTATS TABLESPACE は、XML 表スペースおよび索引を処理する際に、HISTOGRAM を無視します。
- NUMQUANTILES integer
このユーティリティーが収集する変位値の数を示します。integer 値は、1 以上である必要があります。 指定する変位値の数は、列または列グループの値として異なる値がいくつあるのかを示す数の合計 を決して超えないような値にするべきです。許容される変位値の最大数は 100 です。
NUMQUANTILES キーワードが省略された場合、 NUMQUANTILES の値はデフォルトの 100 になります。表内のレコード数に 基づいて、変位値の数は最適な数に減らされます。
- INDEX
- 統計が収集される索引を指定します。RUNSTATS は、索引の最初の列について列統計を収集します。さらに指定したオプションによっては、追加の索引列についても収集する可能性があります。
すべての索引は同じ表スペースに関連している必要があり、その表スペースは TABLESPACE オプション
で指定された表スペースでなければなりません。
INDEX を補助表で使用すると、索引についての統計を収集することができます。
- (ALL)
- 表スペースに含まれる表で定義されたすべての索引について、列統計を収集することを指定します。
- (*)
- 指定した表に対し定義されているすべての索引について統計を収集することを指定します。
- (index-name, …)
- 統計の収集が行われる索引を指定します。索引名のリストを指定することができます。指定する索引が複数の場合は、それぞれの名前をコンマで 区切ります。 名前にブランクが含まれている場合は、索引名を引用符で囲みます。
- PART integer
- 統計の収集が行われる索引パーティションを示します。
integer はパーティションの番号です。
- KEYCARD
- RUNSTATS TABLESPACE 制御ステートメントの KEYCARD オプション
は非推奨であり、INDEX が指定されている場合に、索引のキー列に含まれる値のカーディナリティー統計を収集する
場合に指定する必要はなくなりました。
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 キーワードを続ける必要があります。
- 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 です。
- HISTOGRAM
- RUNSTATS TABLE SPACE の INDEX オプション (correlation-stats-spec) とともに指定された場合に、指定されたキー列のグループについて、
ヒストグラム統計を収集することを指示します。ヒストグラム統計は、順序が同じ接頭部列についてのみ収集できます。
ヒストグラム統計には、
順序が混合しているキー列は許可されません。
RUNSTATS は、パーティション表スペースについてヒストグラム統計を 収集する際、それらを集約して SYSCOLDIST に入れます。
- 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 は、統計の収集、カタログ表の更新、レポートの生成を行わずに動的ステートメント・キャッシュ内のステートメントを無効にします。
- HISTORY
- 収集されたどの統計をカタログ履歴表に記録するかを示します。
HISTORY に指定する値は、UPDATE に指定する値には依存しません。
デフォルトは、DSNTIPO インストール・パネルの STATISTICS HISTORY サブシステム・パラメーターの値です。 デフォルトでは、このパラメーター値は NONE です。
- ALL
- すべての収集された統計をカタログ履歴表内で更新することを示します。
- ACCESSPATH
- アクセス・パス選択に使用する統計のみで Db2 がカタログ履歴表を更新することを 示します。
- SPACE
- スペース関連の統計のみで Db2 がカタログ履歴表を 更新することを示します。
- NONE
- カタログ履歴表は、収集された統計を用いて更新しないことを示します。
- 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 にまで減らすこともあります。
重要: SORTNUM キーワードは、UTSORTAL サブシステム・パラメーターが YES に設定されており、かつ IGNSORTN サブシステム・パラメーターが YES に設定されている場合は無視されます。 - FORCEROLLUP
- 一部のパーティションで統計が収集されなかった場合でも統計の集約またはロールアップを行うかどうかを指定します。
このオプションによって、オプティマイザーは最適アクセス・パスを選択することができます。
- YES
- 一部のパーティションにデータが存在しない場合であっても、 集約またはロールアップ処理を強制的に行うことを示します。
- NO
- すべてのパーティションでデータが使用可能な場合に限り、 集約またはロールアップを行うことを示します。
RESET ACCESSPATH
指定の表スペース内および関連した索引内のすべての表のアクセス・パス統計をリセットします。
ターゲット・オブジェクトのカタログ内の、リアルタイム統計とスペース統計はリセットされません。
このオプションを指定するときにリセットまたは削除される統計の完全なリストについては、
アクセス・パス統計のリセットを参照してください。
重要: 統計履歴が維持されていない限り、RUNSTATS ユーティリティーに RESET ACCESSPATH オプションを指定して呼び出した後は、以前の値にリカバリーすることができません。 HISTORY_ACCESSPATH オプションを指定すると、アクセス・パス統計がいつリセットされたかが記録されるのみで、前の値をリカバリーする方法は提供されません。 統計履歴を保守する方法について詳しくは、統計履歴の収集を参照してください。統計がリセットされているオブジェクトを参照するステートメントは、動的ステートメント・キャッシュで無効化されます。
LOB 表スペースに対してこのオプションを指定することはできません。
この RESET ACCESSPATH を使用すると、表スペース内で特定の統計を収集することを指定するその他のキーワードは指定できません。

HISTORY ACCESSPATH
RESET ACCESSPATH オプションが指定されたとき、アクセス・パス統計がリセットされる各オブジェクトについて、以下の表に行を挿入します。
- 表については SYSIBM.SYSTABLES_HIST
- 索引については SYSIBM.SYSINDEXES_HIST

