ALTER DATABASE 文

この文は、データベースをアップグレードするとき、データベースの jConnect サポートのオン／オフを切り替えるとき、データベースを調整するとき、トランザクション・ログ・ファイル名とトランザクション・ログ・ミラー・ファイル名を変更するとき、またはミラー・サーバにデータベースの所有権の取得を強制するときに使用します。

ALTER DATABASE UPGRADE 文を現在ミラーされているデータベース・サーバで実行すると、エラー・メッセージが返されます。

構文 1 - コンポーネントのアップグレードまたはオブジェクトのリストア

ALTER DATABASE UPGRADE 
[ PROCEDURE ON ]
[ JCONNECT { ON | OFF } ]

構文 2 - 調整の実行

ALTER DATABASE {
 CALIBRATE [ SERVER ]
 | CALIBRATE DBSPACE dbspace-name
 | CALIBRATE DBSPACE TEMPORARY
 | CALIBRATE GROUP READ
 | CALIBRATE PARALLEL READ
 | RESTORE DEFAULT CALIBRATION
}

構文 3 - トランザクション・ログ名とトランザクション・ログ・ミラー名の変更

ALTER DATABASE dbfile
ALTER [ TRANSACTION ] LOG {
{ ON [ log-name ] [ MIRROR mirror-name ] | OFF }
[ KEY key ]

構文 4 - データベースの所有権の変更

ALTER DATABASE 
{ dbname FORCE START
| SET PARTNER FAILOVER }

パラメータ

PROCEDURE 句 データベースに含まれるすべての dbo 所有プロシージャと sys 所有プロシージャを削除して再作成します。
JCONNECT 句 jConnect JDBC ドライバからシステム・カタログ情報にアクセスできるようにするには、JCONNECT ON を指定します。jConnect をサポートするシステム・オブジェクトがインストールされます。jConnect システム・オブジェクトを含まない場合、JCONNECT OFF を指定します。その場合でも、システム情報にアクセスしないかぎり、JDBC を使用できます。JCONNECT はデフォルトで ON です。
Windows Mobile で使用するデータベースを変更する場合は、Windows Mobile での jConnect の使用を参照してください。
CALIBRATE [ SERVER ] 句 テンポラリ DB 領域以外のすべての DB 領域を調整します。この句は、CALIBRATE PARALLEL READ によって実行される処理も実行します。
CALIBRATE DBSPACE 句 指定した DB 領域を調整します。
CALIBRATE DBSPACE TEMPORARY 句 テンポラリ DB 領域を調整します。
CALIBRATE GROUP READ 句 テンポラリ DB 領域でグループ読み込みの調整を実行します。テンポラリ DB 領域に大きなワーク・テーブルを書き込み、さまざまなグループ読み込みサイズを使用してファイルの読み込み時間を設定します。テンポラリ・テーブルに追加する領域が接続の制限を超えた場合、またはキャッシュのサイズが足りず、最大メモリ・サイズで調整できない場合、調整が失敗してエラー・メッセージが返されます。
CALIBRATE PARALLEL READ 句 すべての DB 領域ファイルについてデバイスの並列 I/O 機能を調整します。CALIBRATE [ SERVER ] 句もこの調整を実行します。
RESTORE DEFAULT CALIBRATION 句 一般的なハードウェアと構成設定に基づく組み込みのデフォルト値に、ディスク転送時間 (DTT: Disk Transfer Time) をリストアします。
ALTER [TRANSACTION] LOG 句 トランザクション・ログ・ファイルまたはトランザクション・ログ・ミラー・ファイルの名前を変更します。MIRROR mirror-name を指定しないと、新しいトランザクション・ログのファイル名が設定されます。データベースがトランザクション・ログを現在使っていない場合、データベースは設定されたファイル名を使って起動します。すでにトランザクション・ログを使っている場合、データベースはトランザクション・ログとして新しいファイル名を使うように変更します。
MIRROR mirror-name を指定する、新しいトランザクション・ログ・ミラーのファイル名として設定されます。データベースがトランザクション・ログ・ミラーを現在使っていない場合、データベースはこの設定された名前を使って起動します。すでにトランザクション・ログ・ミラーを使っている場合、データベースはトランザクション・ログ・ミラーとして新しいファイル名を使うように変更します。

この句を使用して、トランザクション・ログまたはトランザクション・ログ・ミラーをオフにすることもできます。たとえば、ALTER DATABASE LOG OFF のように指定します。
KEY 句 トランザクション・ログまたはトランザクション・ログ・ミラーに使用する暗号化キーを指定します。強力に暗号化されたデータベースで ALTER [TRANSACTION] 句を使用するときは、暗号化キーを指定する必要があります。
dbname FORCE START 句 現在ミラー・サーバとして動作しているデータベース・サーバに、データベースの所有権の取得を強制します。この句は、プロシージャまたはイベントから実行できます。また、ミラー・サーバ上のユーティリティ・データベースに接続しているときに実行する必要があります。データベース・サーバの強制プライマリ・サーバ化を参照してください。
SET PARTNER FAILOVER 句 プライマリ・サーバからミラー・サーバへのデータベース・ミラーリングのフェールオーバを起動します。この文は、プライマリ・サーバ上のデータベースに接続しているときに実行する必要があります。プロシージャまたはイベントから実行できます。この文を実行すると、データベースに対する既存の接続は、文を実行した接続も含めて、閉じられます。この文がプロシージャまたはイベントに含まれている場合、後続する他の文は実行されない可能性があります。プライマリ・サーバのフェールオーバの起動を参照してください。

備考

構文 1 ALTER DATABASE UPGRADE 文は、データベースをアップグレードまたは更新するためのアップグレード・ユーティリティの代わりとして使用できます。リリースを維持するときにも適用されます。この文を実行した後は、データベースを再起動してください。一般に、マイナー・バージョンでのデータベースの変更はデータベース・オプションの追加やシステム・テーブルとプロシージャの細かい変更にかぎられます。ALTER DATABASE UPGRADE 文は、システム・テーブルを最新バージョンにアップグレードし、新規データベース・オプションを追加します。必要に応じて、すべてのシステム・プロシージャを削除し、再作成します。PROCEDURE ON 句を指定すると、システム・プロシージャを強制的に再構築できます。

ALTER DATABASE UPGRADE 文を使用して、設定やシステム・オブジェクトを元のインストール状態にリストアすることもできます。

データベース・ファイルの物理的な再編成を必要とする機能は、ALTER DATABASE UPGRADE 文を実行して使用可能にすることはできません。そのような機能には、インデックスの拡張やデータの格納に関する変更が含まれています。これらの拡張機能を利用するには、データベースのアンロードと再ロードを行ってください。データベースの再構築を参照してください。

警告

必ずデータベース・ファイルをバックアップしてからアップグレードしてください。既存のファイルにアップグレードを適用した場合、アップグレードに失敗すると、これらのファイルは使用できなくなります。データベースのバックアップの詳細については、バックアップとデータ・リカバリを参照してください。

jConnect JDBC ドライバを使用してシステム・カタログ情報にアクセスするには、JCONNECT ON (デフォルト値) を指定します。jConnect システム・オブジェクトを含まない場合、JCONNECT OFF を指定します。JCONNECT OFF を設定しても、データベースから jConnect サポートが削除されることはありません。その場合でも、システム・カタログ情報にアクセスしないかぎり、JDBC を使用できます。続けて jConnect の新しいバージョンをダウンロードする場合、ALTER DATABASE UPGRADE JCONNECT ON 文を (再) 実行して、データベースのバージョンをアップグレードできます。jConnect システム・オブジェクトのデータベースへのインストールを参照してください。

構文 2 構文 2 を使用すると、オプティマイザが使用する I/O コスト・モデルを再調整することもできます。この場合、ディスク転送時間 (DTT: Disk Transfer Time) モデルが更新されます。DTT は、コスト・モデルで使用されるディスク I/O の数学的モデルです。I/O コスト・モデルを再調整するときは、データベース・サーバを他の用途に使用できません。また、コンピュータ上の他のすべてのアクティビティがアイドル状態になっている必要があります。データベース・サーバの再調整は高負荷のオペレーションであり、完了までに長時間かかることがあります。通常はデフォルトのままにすることをおすすめします。

CALIBRATE PARALLEL READ 句を使用する場合、10000 ページ未満の DB 領域ファイルでは並列の調整は実行されません。調整操作中にデータベース・サーバが自動的にすべてのアクティビティを中断した場合でも、同じコンピュータに大量のリソースを消費するプロセスがなければ、並列の調整は実行されます。調整後、IOParallelism 拡張データベース・プロパティを使用して、DB 領域ファイルに使用できる並列 I/O 操作の最大推定数を取得できます。DB_EXTENDED_PROPERTY 関数 [システム]を参照してください。

同じようなハードウェア・インストールが大量にある場合に、繰り返し行われる時間のかかる再調整作業を省くには、sa_unload_cost_model システム・プロシージャを使用してアンロードしてから、sa_load_cost_model システム・プロシージャを使用して別のデータベースに適用 (ロード) して調整を再使用できます。sa_unload_cost_model システム・プロシージャとsa_load_cost_model システム・プロシージャを参照してください。

構文 3 ALTER DATABASE 文を使用して、データベース・ファイルに関連付けられているトランザクション・ログとトランザクション・ログ・ミラーの名前を変更できます。これらの変更は、トランザクション・ログ (dblog) ユーティリティで行う変更と同じです。この文は、-gu オプションの設定に応じて、ユーティリティ・データベースまたは別のデータベースと接続しているときに実行できます。暗号化されたデータベースのトランザクション・ログまたはトランザクション・ログ・ミラーを変更する場合は、キーを指定してください。データベースが監査を実行中にトランザクション・ログの使用を停止することはできません。監査をオフにすると、トランザクション・ログの使用を停止できます。この構文は、プロシージャ、トリガ、イベント、またはバッチではサポートされていません。

構文 4 ALTER DATABASE ... FORCE START は、プライマリ・サーバからではなく、ミラー・サーバから実行する必要があります。ALTER DATABASE ... FORCE START 文を、現在ミラーされていないデータベースに対して実行しようとしたり、現在アクティブでこのサーバによって所有されているデータベースに対して実行しようとしたりすると、エラーになります。また、プライマリ・サーバがまだミラー・サーバに接続されている場合も、エラーになります。データベース・ミラーリングの概要を参照してください。

パーミッション

構文 1 と 2 の場合、DBA 権限が必要です。また、このデータベースに他の接続がないことが必要です。ALTER DATABASE UPGRADE 文は、Windows Mobile ではサポートされません。

構文 3 の場合、トランザクション・ログが保存されているディレクトリへのファイル・パーミッションが必要です。また、データベースが実行中ではない必要があります。

構文 4 の場合、実行するユーザには、-gk サーバ・オプションで指定されているパーミッションが必要です。

参照

標準と互換性

SQL/2003 ベンダ拡張。

例

次の例では、jConnect サポートを無効にします。

ALTER DATABASE UPGRADE JCONNECT OFF;

次の例は、demo.db に関連するトランザクション・ログ・ファイル名を newdemo.log に設定します。

ALTER DATABASE 'demo.db'
   ALTER LOG ON 'newdemo.log';