UPDATE DATABASE CONFIGURATION コマンド
UPDATE DATABASE CONFIGURATION コマンドは、特定のデータベース構成ファイルの中の個々の項目を修正します。 データベース 構成ファイルは、 データベース が作成されたすべてのデータベース・パーティションに存在します。
範囲
- MEMBER は、 Db2® pureScale® 環境の 1 つのデータベース・メンバーのみを更新するか、パーティション・データベース環境の 1 つのデータベース・パーティションのみを更新します。
許可
- SYSADM
- SYSCTRL
- SYSMAINT
必要な接続
インスタンス。 明示的なアタッチは必要ありませんが、 データベースがアクティブになっているときは、データベース接続が勧められています。 データベースがリモートとして示されている場合、 リモート・ノードへのインスタンス・アタッチはコマンドの持続期間の間、 ずっと確立されたままになります。 パラメーターをオンラインにするには、データベースへの接続が必要です。
コマンド構文
コマンド・パラメーター
- FOR database-alias
- 構成を更新するデータベースの別名を指定します。 データベース接続が既に確立されている場合は、データベース別名を指定する必要はありません。 同じデータベース・インスタンスにある別のデータベースについては、その構成ファイルを更新できます。 例えば、データベース
db11
のみに接続している場合に、update db config for alias db22 using .... immediate
を発行すると、以下のようになります。db22
上にアクティブな接続がない場合、更新の必要なのは構成ファイルだけであるため、更新は成功します。 新しい接続 (それによりデータベースがアクティブになる) により、メモリー内で新しい変更が認識されるようになります。db22
上に他のアプリケーションからのアクティブな接続があるなら、更新はディスク上で動作しますが、メモリー内では動作しません。 データベースを再始動する必要があることを示す警告を受け取ることになります。
- MEMBER member-number
- MEMBER 節は、変更を適用するメンバーを指定します。 この節を省略すると、結果としてすべてのメンバーに対して変更が適用されることになります。
- USING config-keyword value
- config-keyword は、更新するデータベース構成パラメーターを指定します。 value は、パラメーターに割り当てる値を指定します。
- AUTOMATIC
- いくつかの構成パラメーターは AUTOMATIC に設定できます。それにより、Db2 データベース・システムが自動的にこれらのパラメーターを調整し、現行のリソース要件を反映します。 AUTOMATIC キーワードをサポートする構成パラメーターのリストは、構成パラメーターのサマリーを参照してください。 AUTOMATIC キーワードと一緒に値を指定すると、自動計算に影響する可能性があります。 この動作の具体的な詳細については、構成パラメーターの資料を参照してください。
- MANUAL
- 構成パラメーターの自動チューニングを使用不可にします。 パラメーターはその現行の内部値に設定され、自動的な更新は行われなくなります。
- IMMEDIATE
- データベースが稼働している場合に、即時に変更を行います。 IMMEDIATE はデフォルトのアクションですが、有効にするにはデータベース接続が必要です。
これは、CLPPlus インターフェースで操作する場合のデフォルトの節でもあります。 CLPPlus プロセッサーを使う場合、IMMEDIATE を呼び出す必要はありません。
- DEFERRED
- 構成ファイルでのみ変更を行います。 したがって、加えられた変更は、次にデータベースが再活動化されるときに有効になります。
例
マルチパーティション・インスタンス上でのデータベース構成の更新
SAMPLE という名前のデータベースで、データベース構成パラメーター MAXAPPLS を 10 から 50 に更新する例を以下に示します。
10 gilera 0
20 gilera 1
30 motobi 0
40 motobi 1
ユーザーはインスタンス上で SAMPLE データベースを作成しました。 SAMPLE のカタログ・パーティションはメンバー 10 にあります。 ユーザーがシステム motobi
にログオンしたと想定しましょう。
db2 update db cfg for sample using maxappls 50
db2 update db cfg for sample member 30 using maxappls 50
使用上の注意
データベース構成パラメーターのリストを表示または印刷するには、 GET DATABASE CONFIGURATION コマンドを使用します。
すべてのデータベース構成パラメーターを推奨されているデフォルトにリセットするには、 RESET DATABASE CONFIGURATION コマンドを使用してください。
データベース構成パラメーターを変更するには、 UPDATE
DATABASE CONFIGURATION コマンドを使用します。 例えば、ZELLMART という名前のデータベースを含む単一パーティション・データベース環境でロギング・モードを アーカイブ・ロギング
に変更するには、以下を使用します。
db2 update db cfg for zellmart using logarchmeth1 logretain
logarchmeth1 構成パラメーターが変更されたことをチェックするには、次を使用します。
db2 get db cfg for zellmart
例えば、すべてのパーティションでロギング・モードを アーカイブ・ロギング
に変更するには (レジストリー変数 DB2_UPDDBCFG_SINGLE_DBPARTITION がデフォルトで設定されている場合)、以下のようにします。 zellmart
という名前のデータベースを含む複数パーティション・データベース環境で NULL または FALSEに設定するには、以下を使用します。
db2 update db cfg for zellmart using logarchmeth1 logretain
logarchmeth1 構成パラメーターが、すべてのデータベース・パーティションで変更されたことをチェックするには、次を使用します。
db2_all ";db2 get db cfg for zellmart"
db2 update db cfg for zellmart member 30 using logarchmeth1 logretain
選択によっては、SYSIBMADM.DBCFG
ビューを活用すれば、db2_all を使用しなくても、すべてのパーティションからデータを取得することができます。
UNIX オペレーティング・システムで作業していて、 grep コマンドがある場合は、以下のコマンドを使用して logarchmeth1 値のみを表示できます。
db2_all ";db2 get db cfg for zellmart | grep -i logarchmeth1"
Db2 データベース構成パラメーターと、各種データベース・ノードに使用できる値についての詳細は、 個々の構成パラメーターの説明を参照してください。 これらのパラメーターの値は、構成するデータベース・ノードの各タイプ (サーバー、 クライアント、またはリモート・クライアントを持つサーバー) によって異なります。
すべてのパラメーターを更新できるわけではありません。
データベース構成ファイルへの変更の一部は、 ファイルがメモリーにロードされた後にのみ有効になります。 これを行う前にすべてのアプリケーションはデータベースから切断されている必要があります。 オンラインで構成できるパラメーターと構成できないパラメーターについては、 構成パラメーターの一覧をご覧ください。
db2 connect to sales
db2 update db cfg using sortheap 1000
db2 connect reset
エラーが発生した場合、データベース構成ファイルは変更されません。 チェックサムが無効な場合、データベース構成ファイルは更新できません。 適当なコマンドを使用しないでデータベース構成ファイルを変更するとこれが発生することがあります。 これが発生する場合、データベースをリストアしてデータベース構成ファイルをリセットする必要があります。
互換性
- DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数がONに設定された場合を除き、 MEMBERの代わりにDBPARTITIONNUMを使用できます。