RUNSTATS 制御ステートメントのサンプル

以下の制御ステートメントのサンプルを、独自の RUNSTATS 制御ステートメントを作成するためのモデルとして使用できます。

例 1: 表スペースのカタログ統計を更新し、その間の変更を許可 する

次の制御ステートメントは、RUNSTATS ユーティリティーが、表スペース DSN8D81A.DSN8S11E と関連する すべての表および索引についての統計でカタログを更新する指定を行っています。 表の統計を更新する際、RUNSTATS は行の 25% をサンプリングし ます。SHRLEVEL CHANGE は指定されていませんが、 Db2® では、デフォルトで、RUNSTATS ユーティリティーの実行中に 他のプロセスがこの表スペースに変更を加えることを 許可します。
//STEP1    EXEC DSNUPROC,UID='IUJQU225.RUNSTA',TIME=1440,
//         UTPROC='',
//         SYSTEM='DSN'
//UTPRINT  DD  SYSOUT=*
//SYSIN    DD *
RUNSTATS TABLESPACE DSN8D11A.DSN8S11E
   TABLE(ALL) SAMPLE 25
    INDEX(ALL)

例 2: 索引統計を更新する

次の制御ステートメントは、RUNSTATS が索引 DSN8810.XEMPL1 のカタログ統計を更新する 指定を行っています。

RUNSTATS INDEX (DSN8B10.XEMPL1)

例 3: 索引統計を更新し、その間は更新を禁止する

次の制御ステートメントは、RUNSTATS が索引 XEMPL1 および XEMPL2 のカタログ統計を更新する 指定を行っています。Db2 は、このユーティリティーの実行中は、XEMPL1 および XEMPL2 (表スペース DSN8S11E) と関連する表スペースを他のプロセスが変更することを許可しません。この制限されたアクセスがデフォルトの動作です。

RUNSTATS INDEX (DSN8B10.XEMPL1,DSN8B10.XEMPL2)

例 4: いくつかの表の列に関する統計を更新する

次の制御ステートメントは、RUNSTATS が表スペース DSN8D11P.DSN8S11C の次の列について、 カタログ統計を更新する指定を行っています。

  • TCONA および TOPTVAL 表のすべての列
  • TDSPTXT 表の LINENO および DSPLINE 列
RUNSTATS TABLESPACE(DSN8D11P.DSN8S11C) 
         TABLE (TCONA)
         TABLE (TOPTVAL) COLUMN(ALL)
         TABLE (TDSPTXT) COLUMN(LINENO,DSPLINE)

例 5: 1 つの表スペースのすべての統計を更新する

次の制御ステートメントは、RUNSTATS が表スペース DSN8D81P.DSN8S81C のすべての カタログ統計 (表スペース、表、列、および索引) を更新する指定を行っています。

RUNSTATS TABLESPACE(DSN8D11P.DSN8S11C) TABLE INDEX

例 6: アクセス・パス選択に使用される統計を更新し、 報告書を生成する

次の制御ステートメントは、アクセス・パス選択用に収集された 統計 のみ を用いて、RUNSTATS がカタログ統計を更新する指定を行っています。 ユーティリティーは、表スペースについての すべての 統計を報告し、 レポートを SYSPRINT に送ります。

RUNSTATS TABLESPACE DSN8D11A.DSN8S11E
  REPORT YES
  UPDATE ACCESSPATH

例 7: すべての統計を更新し、報告書を生成する

次の 制御ステートメントは、RUNSTATS が表スペース DSN8D81A.DSN8S81E のすべての統計 (アクセス・パスおよびスペース) で カタログを更新する指定を行っています。また、ユーティリティーは、収集された統計の報告も行い、レポートを SYSPRINT に送ります。

RUNSTATS TABLESPACE DSN8D11A.DSN8S11E
  REPORT YES
  UPDATE ALL

例 8: カタログを更新せずに統計を報告する

次の制御ステートメントは、RUNSTATS が表スペース DSN8D81A.DSN8S81E の統計を収集して、 レポートを SYSPRINT に送る指定を行っています。 ユーティリティーは、収集された統計によるカタログの更新は行いません。

RUNSTATS TABLESPACE DSN8D11A.DSN8S11E
  REPORT YES
  UPDATE NONE

例 9: 1 つのパーティションの統計を更新する

次の制御ステートメントは、表スペース DSN8D81A.DSN8S81E の先頭パーティション と DSN8810.XEMP1 索引の先頭パーティションについての統計を、RUNSTATS が更新する指定を行っています。

RUNSTATS TABLESPACE DSN8D11A.DSN8S11E PART 1 INDEX(DSN8B10.XEMP1 PART 1)

例 10: カタログ表および履歴表を更新し、すべての 統計を報告する

次の制御ステートメントは、表スペース DB0E0101.TL0E0101 (関連する索引および列を含む) に ついてのすべての統計を用いて、RUNSTATS がカタログ表および履歴表を更新する指定を行っています。 ユーティリティーは、収集された統計を報告し、報告書を SYSPRINT に送ります。

RUNSTATS TABLESPACE DBOE0101.TLOE0101 
   INDEX                        
   TABLE                      
   REPORT YES                   
   UPDATE ALL                   
   HISTORY ALL                   

例 11: 頻繁に発生する値についての統計を更新する

SYSADM.IXNP1 索引が 4 つの列 NP1、NP2、NP3、および NP4 で定義されていると想定します。 次の制御ステートメントは、RUNSTATS が索引 SYSADM.IXNPI の統計を更新する 指定を行っています。

RUNSTATS ユーティリティーは、列 NP1、列セット NP1 および NP2、 列セット NP1、NP2、および NP3、列セット NP1、NP2、NP3、および NP4 についてのカーディナリティー統計 を収集します。FREQVAL オプションおよびその関連パラメーターは、RUNSTATS が、列 NP1 (索引の最初のキー列) での 5 個の 最多頻度値、さらに列セット NP1 および NP2 (索引の最初の 2 つのキー列) での 10 個の最多頻度値を 収集することも示しています。 ユーティリティーは、収集された統計を報告し、報告書を SYSPRINT に送ります。

RUNSTATS INDEX (SYSADM.IXNPI) 
           FREQVAL NUMCOLS 1 COUNT 5                        
           FREQVAL NUMCOLS 2 COUNT 10           
           REPORT YES          

例 12: 1 つの表内の指定された列のグループについての分散統計 を更新する

次の制御ステートメントは、表 DSN8810.DEPT (表スペース DSN8D81A.DSN8S81E 内) に おける列 EMPLEVEL、EMPGRADE、および EMPSALARY についての統計を、RUNSTATS が更新する 指定を行っています。 ステートメントでは COLGROUP キーワードを使用して、これらの列をグループ化してい ます。RUNSTATS は、この列グループのカーディナリティーを収集して、 カーディナリティーを SYSCOLDIST カタログ表に保管します。

RUNSTATS TABLESPACE DSN8D81A.DSN8S81E
TABLE(DSN8810.DEPT)
COLGROUP (EMPLEVEL,EMPGRADE,EMPSALARY)   

例 13: 特定の列の分散統計を更新し、 最も頻繁に発生する値を取得する

次の制御ステートメントは、表 DSN8810.DEPT の列 EMPLEVEL、EMPGRADE、および EMPSALARY に ついての統計を、RUNSTATS が更新する指定を行ってい ます。FREQVAL および COUNT オプションは、RUNSTATS がそれぞれの列ごとに 10 個の最多頻度値を収集 することを示しています。この値は、SYSCOLDIST および SYSCOLDISTSTATS のカタログ表に保管されます。

RUNSTATS TABLESPACE DSN8D81A.DSN8S81E
TABLE(DSN8810.DEPT)
COLGROUP(EMPLEVEL,EMPGRADE,EMPSALARY) FREQVAL COUNT 10

例 14: 1 つの表内の特定の列について分散統計を 更新し、発生頻度が最低の値を取得する

次の制御ステートメントは、表 DSN8810.DEPT の列 EMPLEVEL、EMPGRADE、および EMPSALARY に ついての統計を、RUNSTATS が更新する指定を行ってい ます。FREQVAL および COUNT オプションは、RUNSTATS がそれぞれの列ごとに 15 個の最少頻度値を収集 することを示しています。この値は、SYSCOLDIST および SYSCOLDISTSTATS のカタログ表に保管されます。

RUNSTATS TABLESPACE DSN8D81A.DSN8S81E
TABLE(DSN8810.DEPT)
COLGROUP(EMPLEVEL,EMPGRADE,EMPSALARY) FREQVAL COUNT 15 LEAST

例 15: 1 つの表スペース内の特定の列についての分散統計を更新し、 発生頻度が最高の値および最低の値を取得する

次の制御ステートメントは、表 DSN8810.DEPT の列 EMPLEVEL、EMPGRADE、および EMPSALARY に ついての統計を、RUNSTATS が更新する指定を行ってい ます。FREQVAL および COUNT オプションは、RUNSTATS がそれぞれの列ごとに 10 個の最多頻度値と それぞれの列ごとに 10 個の最少頻度値を収集することを示しています。この値は、SYSCOLDIST および SYSCOLDISTSTATS のカタログ表に保管されます。

RUNSTATS TABLESPACE DSN8D81A.DSN8S81E
TABLE(DSN8810.DEPT)
COLGROUP(EMPLEVEL,EMPGRADE,EMPSALARY) FREQVAL COUNT 10 BOTH

例 16: 1 つの索引の統計を更新し、 発生頻度が最高の値および最低の値を取得する

次の制御ステートメントは、索引 ADMF001.IXMA0101 の最初のキー列について、 それぞれの列ごとに 10 個の最多頻度値とそれぞれの列ごとに 10 個の最少頻度値を RUNSTATS が 収集することを示しています。デフォルトでは、このユーティリティーは、すべてのキー列の 組み合わせで、すべての異なる値を収集します。 メッセージのセットが SYSPRINT に送られ、すべての収集された統計はカタログで更新されます。
RUNSTATS INDEX(ADMF001.IXMA0101)
FREQVAL NUMCOLS 1 COUNT 10 BOTH
REPORT YES UPDATE ALL

例 17: 1 つの表スペースについて動的ステートメント・キャッシュ内のステートメントを無効化 し、統計の報告書を生成しない

次の 制御ステートメントは、RUNSTATS が、表スペース DSN8D81A.DSN8S81E について、 動的ステートメント・キャッシュ内のステートメントを無効化する指定を行っています。ただし、RUNSTATS は統計の収集も報告も行わず、カタログの更新も行いません。

RUNSTATS TABLESPACE DSN8D81A.DSN8S81E
REPORT NO
UPDATE NONE

例 18: RUNSTATS HISTOGRAM ジョブ・ステートメント

次の 制御ステートメントは、RUNSTATS が、 指定されたキー列のヒストグラム統計を収集する指定を行っています。ヒストグラム統計は、 順序が同じ接頭部列についてのみ収集できます。

RUNSTATS TABLESPACE RVTDB01.RVTTS01
INDEX ALL
HISTOGRAM NUMCOLS 2   NUMQUANTILES 5
SHRLEVEL(CHANGE)
UPDATE ALL
REPORT YES