AUTOCONFIGURE コマンド (ADMIN_CMD プロシージャーを使用)

AUTOCONFIGURE コマンドは、バッファー・プール・サイズ、データベース構成パラメーター、およびデータベース・マネージャー構成パラメーターの初期値を計算して表示します。オプションで、これらの報告値を適用するように指定できます。

許可

SYSADM

必要な接続

データベース

コマンド構文

構文図を読む構文図をスキップする AUTOCONFIGURE autoconfigure-clause

autoconfigure-clause:

構文図を読む構文図をスキップするUSINGinput-keywordparam-value apply-clauseREPORT EXISTING SUMMARY

apply-clause:

構文図を読む構文図をスキップする APPLYDB ONLYON CURRENT MEMBERDB AND DBMON CURRENT MEMBERNONE report-clause

report-clause

構文図を読む構文図をスキップする REPORT FOR MEMBER -1 REPORT FOR MEMBER-2MEMBER member-number1 MEMBERS,(member-number2) INCLUDE SUMMARYEXCLUDE SUMMARY

コマンド・パラメーター

USING input-keyword param-value
表 1. 有効な入力キーワードおよびパラメーター値
キーワード 有効値 デフォルト値 説明
mem_percent 1 から 100
  • 分析が有効になっていない場合、デフォルト値は 25 です。
  • 分析が有効になっている場合、mem_percent はデフォルトで次の値の大きいほうになります。
    • 25
    • 80% をデータベース・インスタンス数で割った値
データベースに割り当てられているインスタンス・メモリーのパーセンテージ。ただし、CREATE DATABASE コマンドによって構成アドバイザーが呼び出され、mem_percent の値を指定しない場合、インスタンスとシステムのメモリー使用量に基づいてパーセンテージが計算され、最大でインスタンス・メモリーの 25% になります。
workload_type simplemixedcomplex mixed 単純 (simple) ワークロードは入出力集中の傾向があり大部分がトランザクションであるのに対し、 複雑 (complex) ワークロードは CPU 集中の傾向があり大部分が照会です。
num_stmts 1-1 000 000 10 作業単位ごとのステートメント数
tpm 1-200 000 60 1 分ごとのトランザクション
admin_priority performancerecoveryboth both より良いパフォーマンス (分あたりのより多いトランザクション数) またはより良いリカバリー時間のための最適化
is_populated yesno yes データベースにデータを移植するかどうか
num_local_apps 0-5 000 0 接続されたローカル・アプリケーションの数
num_remote_apps 0-5 000 10 接続されたリモート・アプリケーションの数
isolation RRRSCSUR RR このデータベースに接続するアプリケーションの最大分離レベル (反復可能読み取り (RR)、読み取り固定 (RS)、カーソル固定 (CS)、非コミット読み取り (UR))。 これは、他の構成パラメーターの値を決定するためにのみ使用されます。 アプリケーションを特定の分離レベルに制限するよう設定されるものはなく、デフォルト値を使用するのが安全です。
bp_resizeable yesno yes バッファー・プールのサイズが変更可能かどうか。
grp_tolerance_percent 1-100 5 メンバーが属するグループを決定するために構成変数値を比較するときにサマリー・レポートに使用する正または負の許容度のパーセンテージ。
analytics_env automaticyesno automatic 分析環境についての推奨値を生成するかどうか
Yes
構成アドバイザーは、Db2_WORKLOAD レジストリー変数を無視し、このヒントを使用して分析環境についての推奨値を決定します。
No
構成アドバイザーは、推奨値を生成しません。
Automatic
Db2® 構成アドバイザーは、DB2_WORKLOAD レジストリー変数に指定された値を使用して、分析環境についての推奨値を決定します。
APPLY
DB ONLY
現行のデータベース・マネージャーの構成に基づいて、 データベース構成およびバッファー・プール設定の推奨値を表示します。 データベース構成およびバッファー・プール設定に対して推奨される変更を適用します。
DB AND DBM
データベース・マネージャー構成、データベース構成、 およびバッファー・プール設定に対して推奨される変更を、表示および適用します。
NONE
推奨される変更を表示しますが、適用はしません。
EXCLUDE SUMMARY

構成アドバイザーのレポートにサマリーを含めないことを指定します。

INCLUDE SUMMARY
構成アドバイザーのレポートに、計算された推奨値に基づくすべてのメンバー・グループのサマリーを含めることを指定します。 これはデフォルト・オプションです。
ON CURRENT MEMBER
デフォルトでは、パーティション・データベース環境または Db2 pureScale® 環境において、構成アドバイザーによりすべてのメンバー上のデータベース構成が更新されます。ON CURRENT MEMBER オプションを指定すると、構成アドバイザーは接続から判別した現在のメンバーに対してメンバー・レベルの構成パラメーターを設定します。一方、グローバル・レベルの構成パラメーターはグローバル・レベルでのみ機能するように構成することができ、設定するとすべてのメンバーに影響を与えます。

バッファー・プールの変更事項は常にシステム・カタログに適用されます。 したがってすべてのメンバーが影響を受けます。 ON CURRENT MEMBER オプションは、バッファー・プールの推奨事項では無視されます。

REPORT FOR
パーティション・データベース環境または Db2 pureScale 環境で使用する場合に、レポートに含めるメンバーを指定します。
MEMBER -1

パーティション・データベース環境または Db2 pureScale 環境において、接続を介して指定された現行メンバーについて、構成アドバイザーが計算して推奨あるいは実行したメンバー・レベルの構成パラメーターの変更を報告します。REPORT FOR 節を指定しない場合は、これがデフォルトです。

MEMBER -2

すべてのメンバーについて、構成アドバイザーが計算した推奨値または実行した変更を報告することを指定します。

MEMBER member-number1

構成アドバイザーが計算した推奨値または実行した変更を報告するメンバーの番号を指定します。

MEMBERS (member-number2…)

構成アドバイザーが計算した推奨値または実行した変更を報告する全メンバーの番号を指定します。

REPORT EXISTING SUMMARY

構成アドバイザーが既存の構成値に基づいたすべてのメンバー・グループのサマリーを示すことを指定します。

pureScale では、このオプションを使用する前に、すべてのメンバーでデータベースをアクティブにすることをお勧めします。そうしないと、アクティブでないメンバーについて報告されるグループが正確でない場合があります。

ADMIN_CMD ストアード・プロシージャーにより、データベースに対して AUTOCONFIGURE を呼び出します。
CALL SYSPROC.ADMIN_CMD( 'AUTOCONFIGURE APPLY NONE' ) 
以下は、コマンドによって戻される結果セットの例です。
LEVEL     NAME                 VALUE       RECOMMENDED_VALUE  DATATYPE    
-----...- ----------------...- -------...- ------------------ --------...-
DBM       ASLHEAPSZ            15          15                 BIGINT      
DBM       FCM_NUM_BUFFERS      512         512                BIGINT      
...                                                                       
DB        APP_CTL_HEAP_SZ      128         144                INTEGER     
DB        APPGROUP_MEM_SZ      20000       14559              BIGINT      
...                                                                       
BP        IBMDEFAULTBP         1000        164182             BIGINT      

使用上の注意

  • このコマンドは、現在接続されているデータベースのための推奨構成を作成し、このデータベースがインスタンス上で唯一のアクティブ・データベースであると仮定します。 セルフチューニング・メモリー・マネージャーを使用可能にしておらず、インスタンス上に複数のアクティブ・データベースがある場合、データベース・メモリー分散を反映する mem_percent 値を指定してください。 例えば、インスタンス・メモリーの 80% を使用しリソースを平等に共有する、2 つのアクティブ・データベースがインスタンスにある場合、40% (80% を 2 データベースで割る) を mem_percent 値に指定します。
  • 同じコンピューター上に複数のインスタンスがあり、セルフチューニング・メモリー・マネージャーが使用可能になっていない場合は、各インスタンスで instance_memory に固定値を設定するか、データベース・メモリーの配分を反映する mem_percent 値を指定してください。例えば、すべてのアクティブ・データベースがコンピューター・メモリーの 80% を使用し、それぞれ 1 つのデータベースを持つインスタンスが 4 つある場合は、20% (80% を 4 データベースで割る) を mem_percent 値に指定します。
  • AUTOCONFIGURE コマンドによって構成アドバイザーを明示的に呼び出す場合、Db2_ENABLE_AUTOCONFIG_DEFAULT レジストリー変数の設定値は無視されます。
  • データベースに対して AUTOCONFIGURE コマンドを実行すると、セルフチューニング・メモリー・マネージャーを有効にすることが推奨されます。 ただし、sheapthres がゼロではないインスタンス内で、あるデータベースに対して AUTOCONFIGURE コマンドを実行した場合、ソート・メモリー・チューニング (sortheap) は自動的には有効になりません。 ソート・メモリー・チューニング (sortheap) を有効にするには、UPDATE DATABASE MANAGER CONFIGURATION コマンドを使用して、sheapthres をゼロに設定する必要があります。 sheapthres の値を変更すると、これまでの既存データベース内のソート・メモリーの使用に影響を与える可能性があることに注意してください。
  • コマンドの実行状況は、CALL ステートメントからの結果である SQLCA で戻されます。
  • AUTOCONFIGURE コマンドの実行終了時には COMMIT ステートメントが発行されます。 タイプ 2 接続では、その結果として ADMIN_CMD プロシージャーから理由コード 2 の SQL30090N が戻されます。

互換性

以前のバージョンとの互換性:
  • Db2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、NODE および DBPARTITIONNUMMEMBER の代わりに指定できます。

結果セット情報

コマンドの実行状況は、CALL ステートメントからの結果である SQLCA で戻されます。 実行が成功したなら、以下の結果セットによりコマンドから追加情報が戻されます。
表 2. AUTOCONFIGURE コマンドから戻される結果セット
列名 データ・タイプ 説明
LEVEL VARCHAR(3) パラメーターのレベル。以下のいずれか 1 つ。
  • BP (バッファー・プール・レベル)
  • DBM (データベース・マネージャー・レベル)
  • DB (データベース・レベル)
NAME VARCHAR(128)
  • LEVEL が DB または DBM の場合、 これには構成パラメーター・キーワードが含まれています。
  • LEVEL が BP の場合、この値にはバッファー・プール名が含まれています。
VALUE VARCHAR(256)
  • LEVEL が DB または DBM で、推奨値が適用された場合、この列の内容は、推奨値適用前に NAME 列の中で示されていた構成パラメーターの値です (つまり古い値が含まれています)。 変更が適用されなかった場合、この列の内容は、示されている構成パラメーターについて現在ディスク上にある (据え置き) 値です。
  • LEVEL が BP で、推奨値が適用された場合、この列の内容は、推奨値適用前に NAME 列の中で示されていたバッファー・プールのサイズ (ページ数) です (つまり古いサイズが含まれています)。 変更が適用されなかった場合、この列の内容は、示されているバッファー・プールの現在のサイズ (ページ数) です。
RECOMMENDED_VALUE VARCHAR(256)
  • LEVEL が DB または DBM の場合、この列の内容は、パラメーター列で示されている構成パラメーターの推奨値 (または適用された値) です。
  • タイプが BP の場合、この列の内容は、パラメーター列で示されているバッファー・プールの推奨サイズ (または適用されたサイズ) です (ページ数)。
DATATYPE VARCHAR(128) パラメーターのデータ・タイプ。
MEMBER INTEGER メンバー番号