AUTOCONFIGURE コマンド (ADMIN_CMD プロシージャーを使用)
AUTOCONFIGURE コマンドは、バッファー・プール・サイズ、データベース構成パラメーター、およびデータベース・マネージャー構成パラメーターの初期値を計算して表示します。オプションで、これらの報告値を適用するように指定できます。
許可
SYSADM
必要な接続
データベース
コマンド構文
autoconfigure-clause:
apply-clause:
コマンド・パラメーター
- USING input-keyword param-value
-
表 1. 有効な入力キーワードおよびパラメーター値 キーワード 有効値 デフォルト値 説明 mem_percent 1 から 100 - 分析が有効になっていない場合、デフォルト値は 25 です。
- 分析が有効になっている場合、mem_percent はデフォルトで次の値の大きいほうになります。
- 25
- 80% をデータベース・インスタンス数で割った値
データベースに割り当てられているインスタンス・メモリーのパーセンテージ。ただし、CREATE DATABASE コマンドによって構成アドバイザーが呼び出され、mem_percent の値を指定しない場合、インスタンスとシステムのメモリー使用量に基づいてパーセンテージが計算され、最大でインスタンス・メモリーの 25% になります。 workload_type simple、 mixed、 complex mixed 単純 (simple) ワークロードは入出力集中の傾向があり大部分がトランザクションであるのに対し、 複雑 (complex) ワークロードは CPU 集中の傾向があり大部分が照会です。 num_stmts 1-1 000 000 10 作業単位ごとのステートメント数 tpm 1-200 000 60 1 分ごとのトランザクション admin_priority performance、 recovery、 both both より良いパフォーマンス (分あたりのより多いトランザクション数) またはより良いリカバリー時間のための最適化 is_populated yes、no yes データベースにデータを移植するかどうか num_local_apps 0-5 000 0 接続されたローカル・アプリケーションの数 num_remote_apps 0-5 000 10 接続されたリモート・アプリケーションの数 isolation RR、RS、 CS、UR RR このデータベースに接続するアプリケーションの最大分離レベル (反復可能読み取り (RR)、読み取り固定 (RS)、カーソル固定 (CS)、非コミット読み取り (UR))。 これは、他の構成パラメーターの値を決定するためにのみ使用されます。 アプリケーションを特定の分離レベルに制限するよう設定されるものはなく、デフォルト値を使用するのが安全です。 bp_resizeable yes、no yes バッファー・プールのサイズが変更可能かどうか。 grp_tolerance_percent 1-100 5 メンバーが属するグループを決定するために構成変数値を比較するときにサマリー・レポートに使用する正または負の許容度のパーセンテージ。 analytics_env automatic、yes、no 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 環境で使用する場合に、レポートに含めるメンバーを指定します。
- 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 および DBPARTITIONNUM を MEMBER の代わりに指定できます。
結果セット情報
コマンドの実行状況は、CALL ステートメントからの結果である SQLCA で戻されます。
実行が成功したなら、以下の結果セットによりコマンドから追加情報が戻されます。
| 列名 | データ・タイプ | 説明 |
|---|---|---|
| LEVEL | VARCHAR(3) | パラメーターのレベル。以下のいずれか 1 つ。
|
| NAME | VARCHAR(128) |
|
| VALUE | VARCHAR(256) |
|
| RECOMMENDED_VALUE | VARCHAR(256) |
|
| DATATYPE | VARCHAR(128) | パラメーターのデータ・タイプ。 |
| MEMBER | INTEGER | メンバー番号 |
