7 Oracle Data Guardコマンドライン・インタフェース・リファレンス
コマンド・リファレンスを使用して、Data Guard Brokerコマンドライン・インタフェース(DGMGRL)でブローカ構成を管理する方法を確認します。
DGMGRLを使用すると、Data Guard Broker構成とその様々なメンバーを、コマンドラインから直接、あるいはバッチ・プログラムやスクリプトから管理できます。Data Guard Brokerコマンドライン・インタフェースは、Data Guard構成を管理するためのOracle Enterprise Manager Cloud Control (Cloud Control)の代替手段として使用できます。
7.1 Data Guardコマンドライン・インタフェースの起動
Data Guardコマンドライン・インタフェース(DGMGRL)を起動するには、Oracleがインストールされているシステム上で、コマンドライン・プロンプトから「dgmgrl
」と入力します。
7.1.1 DGMGRLのオプション・パラメータ
コマンドラインからオプション・パラメータを入力して、Data Guardコマンドライン・インタフェースでの出力の表示方法を指定できます。
出力には、コマンド・プロンプト、バナーおよびメッセージなどの項目が含まれます。
また、単一コマンド・モードも使用可能です。このモードのDGMGRLでは、1つのコマンドが実行され、そのコマンドの終了時にDGMGRLも終了します。終了コードとしてコマンドの結果が戻されます。終了コードが0であれば、コマンドは正常終了しています。それ以外の場合は、エラーがあります。
DGMGRLのコマンドラインは次のとおりです。
% dgmgrl [<options>] [<logon> [<command>] ]
DGMGRLコマンドライン・インタフェースの起動時に、次の任意のキーワードを指定します。
-
<options>
には、次のいずれか1つを選択できます。-
-echo
コマンドの入力と出力をデフォルトの表示デバイスに表示します。このパラメータを使用しない場合、コマンドからの出力のみが表示されます。
-
-logfile
<file-spec> "<dgmgrl-command>"DGMGRLコマンドライン・インタフェースの処理情報を取得するファイルを指定します。これは特に、ファスト・スタート・フェイルオーバーのオブザーバとして機能させるためにDGMGRLを起動する場合に役立ちます。詳細は、「START OBSERVER」コマンドを参照してください。
注意:
DGMGRLの-logfile
オプションは、Oracle Database 12cリリース2 (12.2.0.1)では非推奨です。下位互換性のためにのみサポートされています。かわりに、START OBSERVER
コマンドでLOGFILE IS
句を使用してログ・ファイルが指定されるようになりました。
関連項目:
-
-
-
-silent
DGMGRLのコマンド・プロンプト(
DGMGRL>
)をデフォルトの表示デバイスに表示しません。このオプションは、コマンド出力をファイルまたは他の表示ツールに送る場合に役立ちます。
-
-
<logon>
は次のとおりです。-
username [@connect-identifier]
データベースに接続するには、
username
と、オプションでconnect-identifier
を入力します。次に、パスワードの入力を求められます。connect-identifier
は、完全指定の接続記述子またはOracleネーミング・メソッド(TNSなど)により解決される名前です。完全指定の接続記述子が使用されている場合は、引用符を含める必要があります。引用符がないと、invalid option
エラーで接続が失敗します。次に、引用符を使用して接続する例を示します。dgmgrl sys@'(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=sales.us.example.com)))'
Enter password: password
完全指定の接続記述子を使用するか、簡易接続ネーミング・メソッドを使用するかに関係なく、接続識別子の指定には次のすべての構文が有効です(パスワードの入力を要求されます)。
-
dgmgrl username@'connect_identifier'
-
dgmgrl username@"connect_identifier"
-
dgmgrl username@"'connect_identifier'"
警告:
DGMGRLの起動時にコマンドラインでパスワードを指定することには、安全上のリスクがあります。このリスクは、DGMGRLの起動時はパスワードを省略し、後で求められたときに入力するか、外部の認証方式を使用することで回避できます。
-
-
オペレーティング・システム認証(リモート・データベースの再起動を除く)、Secure Sockets Layer(SSL)プロトコルまたはウォレットに格納されたデータベース資格証明を使用する場合は、'/'として接続できます。
-
-
<command>
は1つのコマンドです。次に例を示します。
dgmgrl sys "show database 'North_Sales'"
Password
: パスワード
次の各項で、DGMGRL>
コマンド・プロンプトから入力するコマンドの書式について説明します。
7.1.2 DGMGRLコマンドの書式とパラメータ
DGMGRLコマンドを使用すると、一度に1つのブローカ構成を作成およびメンテナンスできます。
表7-1 DGMGRLコマンドの要約
コマンド | 効果 |
---|---|
@ (アットマーク)コマンド | DGMGRLスクリプトを実行します。 |
/ (スラッシュ)コマンド |
DGMGRLコマンド・プロンプトで最後に入力したコマンドを繰り返します。 |
既存のブローカ構成に新しいスタンバイ・データベースを追加します。 |
|
既存の遠隔同期インスタンスをOracle Data Guard Broker構成に追加します。 |
|
ADD RECOVERY_APPLIANCE | Zero Data Loss Recovery Appliance (リカバリ・アプライアンス)を既存のブローカ構成に追加します。 |
指定のユーザー名を使用して指定のデータベースに接続します。 |
|
指定されたデータベースをスナップショット・スタンバイ・データベースまたはフィジカル・スタンバイ・データベースに変換します。 |
|
ブローカ構成を作成し、プライマリ・データベースをその構成に追加します。 |
|
構成とそのすべてのデータベースがブローカによる管理対象から外れるように、構成のブローカ管理を無効化します。 |
|
指定したスタンバイ・データベースのブローカ管理を無効化します。 |
|
遠隔同期インスタンスのブローカ管理を無効にします。 |
|
ファスト・スタート・フェイルオーバーを無効化します。 |
|
ユーザーによるファスト・スタート・フェイルオーバーの実行条件の削除を可能にします。 |
|
DISABLE RECOVERY_APPLIANCE | 指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)のブローカ管理を無効にします。 |
ブローカ構成のプロパティ値を変更します。 |
|
ブローカ構成の現在の保護モード設定を変更します。 |
|
構成名を変更します。 |
|
指定された構成プロパティをそのデフォルト値にリセットします。 |
|
指定したデータベースのプロパティ値を変更します。 |
|
ブローカにより指定したデータベースの参照に使用される名前を変更します。 |
|
指定したデータベースの状態を変更します。 |
|
指定されたデータベースの指定されたプロパティをそのデフォルト値にリセットします。 |
|
遠隔同期インスタンスの名前、状態またはプロパティを変更します。 |
|
指定された遠隔同期インスタンスの指定されたプロパティをそのデフォルト値にリセットします。 |
|
指定したインスタンスの初期化パラメータ・ファイル名を設定します。 |
|
指定したインスタンスのプロパティ値を変更します。 |
|
指定されたインスタンスのインスタンス固有のプロパティを、そのデフォルト値にリセットします。 |
|
EDIT RECOVERY_APPLIANCE (プロパティ) | 指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)のプロパティ値を変更します。 |
EDIT RECOVERY_APPLIANCE (名前の変更) | ブローカ構成内の該当するリカバリ・アプライアンスのプロファイルに記録されているように、指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)を参照するためにブローカで使用する名前を変更します。 |
EDIT RECOVERY_APPLIANCE RESET (プロパティ) | 指定されたZero Data Loss Recovery Appliance (リカバリ・アプライアンス)の指定されたプロパティを、そのデフォルト値にリセットします。 |
ブローカ構成とそのすべてのデータベースのブローカ管理を有効化します。 |
|
指定したデータベースのブローカ管理を有効化します。 |
|
指定した遠隔同期インスタンスのブローカ管理を有効化します。 |
|
ブローカによるプライマリ・データベースからターゲット・スタンバイ・データベースへの自動的なフェイルオーバーを可能にします。 |
|
ユーザーによるファスト・スタート・フェイルオーバーの実行条件の追加を可能にします。 |
|
ENABLE RECOVERY_APPLIANCE | 指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)のブローカ管理を有効化します。 |
Data Guardコマンドライン・インタフェースを終了します。 |
|
データベース・フェイルオーバー操作を実行します。この操作では、現在DGMGRLが接続しているスタンバイ・データベースが、プライマリ・データベースのロールにフェイルオーバーされます。 |
|
Data Guardコマンドライン・インタフェースのオンライン・ヘルプを表示します。 |
|
HOSTまたは! (感嘆符) |
DGMGRLを離れることなく、DGMGRLコンソールから直接オペレーティング・システム・コマンドを実行します。 |
MIGRATE PLUGGABLE DATABASE | 同じホスト上のCDB間でPDBを移行します。 |
Data Guardコマンドライン・インタフェースを終了します。 |
|
フェイルオーバー後、データベースを回復します。 |
|
ブローカ構成を削除し、そのメンバーのブローカ管理を終了します。 |
|
指定したスタンバイ・データベースをブローカ構成から削除します。 |
|
既存の遠隔同期インスタンスをOracle Data Guard Broker構成から削除します。 |
|
ブローカ構成からインスタンスを削除します。 |
|
REMOVE RECOVERY_APPLIANCE | 指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)をブローカ構成から削除し、そのリカバリ・アプライアンスのブローカ管理を終了します。 |
SET MASTEROBSERVER TO |
どのオブザーバをマスター・オブザーバとして認識するか、手動で変更できます。 |
SET MASTEROBSERVERHOSTS |
ブローカ構成のマスター・オブザーバをターゲット・ホスト上のオブザーバに設定します。 |
SET ObserverConfigFile |
オブザーバ構成ファイルのフルパスとファイル名を設定します。 |
SET TIME | タイムスタンプ出力のオン/オフを切り替えます。 |
ブローカ構成に関する情報を表示します。 |
|
指定したデータベースがプライマリ・データベースであった場合に有効になるREDO転送構成を表示します。 |
|
指定したデータベースに関する情報を表示します。 |
|
遠隔同期インスタンスに関する情報を表示します。 |
|
すべてのファスト・スタート・フェイルオーバー関連情報を表示します。 |
|
指定したインスタンスに関する情報を表示します。 |
|
SHOW OBSERVER |
Data Guard Broker構成内のすべての登録済オブザーバに関する情報を表示します。 |
SHOW ObserverConfigFile |
|
SHOW OBSERVERS |
特定の構成グループのすべてのブローカ構成の、すべてのオブザーバに関する情報を表示します。 |
SHOW RECOVERY_APPLIANCE | 指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)の情報またはプロパティ値を表示します。 |
現在実行中のOracleデータベースを停止します。 |
|
SPOOL | DGMGRLの入出力をファイルに記録します。 |
Data Guardコマンドライン・インタフェース(DGMGRL)からのSQL文の入力を許可します。 |
|
オブザーバを起動します。 |
|
START OBSERVER IN BACKGROUND |
DGMGRLセッションを実行中のホスト上で、ファスト・スタート・フェイルオーバー・オブザーバをバックグラウンド・プロセスとして開始します。 |
START OBSERVING |
指定したグループの各ブローカ構成に対応する新規オブザーバを起動します。 |
データベースのマウントやオープンなど、SQL*Plusと同じオプションを指定してOracleインスタンスを起動します。 |
|
オブザーバを停止します。 |
|
STOP OBSERVING |
このDGMGRLセッションを実行中のホスト上で動作している、特定のグループのすべてのブローカ構成のローカル・オブザーバをすべて停止します。 |
スイッチオーバー操作を実行します。現行のプライマリ・データベースがスタンバイ・データベースになり、指定したスタンバイ・データベースがプライマリ・データベースになります。 |
|
ロール変更に先立って包括的なデータベース・チェックを実行します。 |
|
VALIDATE DATABASE DATAFILE | プライマリ・データベースとスタンバイ・データベース全体のデータ・ファイルの検証を実行します。 |
遠隔同期インスタンスに対する一連の包括的なチェックを実行します。 |
7.1.3 DGMGRLコマンドの使用上の注意
このリストの項目では、DGMGRLに固有の使用上の注意について説明します。
-
手動操作なしでインスタンスを再起動する必要のあるブローカ操作を有効化するには、プライマリとスタンバイのデータベース・インスタンスを含む各ホスト上でOracle Net Servicesを構成する必要があります。特に、listener.oraファイルにインスタンスの静的構成情報が含まれていることが必要です。
GLOBAL_DBNAME
属性を、db_unique_name
_DGMGRL.
db_domain
に設定する必要があります。詳細は、「前提条件」を参照してください。 -
構成の作成時またはデータベースの追加時に使用する接続識別子は、構成内のすべてのホストから解決可能である必要があります。
-
Oracle Data Guardコマンドライン・インタフェースを使用するには、
SYSDG
またはSYSDBA
権限が必要です。CONNECT
コマンド上に、AS SYSDG
またはAS SYSDBA
を含めないでください。DGMGRLは先にAS SYSDG
接続を試み、それが失敗したら、AS SYSDBA
接続を試みます。 -
コマンドで複数のオプションを指定する場合、指定する順序は問われません。
-
各DGMGRLコマンドの末尾にセミコロンを付ける必要があります。
-
DGMGRLコマンド文字列の値で指定する文字は、二重引用符(")または一重引用符(')で囲まれていない場合、小文字として解釈されます。たとえば、databaseとDatAbaSeは同じですが、"database"と"DatAbaSe"は異なります。
-
一重引用符(')、二重引用符(")およびバックスラッシュ(\)が文字列に含まれている場合は、これらの文字のエスケープ文字としてバックスラッシュ(\)を使用できます。
-
ブローカ構成では、1つ以上のデータベースのシャットダウンと再起動が必要となる操作がいくつかあります。次の条件を満たす場合はほとんど、特定のデータベースのシャットダウンと再起動がDGMGRLによって自動的に行われます。
-
instance-name
はSIDです(Cloud ControlとDGMGRLに適用されます)。 -
ブローカは、最後の
CONNECT
コマンドが別のデータベースへの接続に使用された場合でも、最後のCONNECT
コマンドに指定された資格証明を使用してデータベースに接続できる必要があります。
-
コマンドの例
例7-1 ローカル・システム上のDGMGRLへの接続
この例は、デフォルトのローカル・システム上でDGMGRLコマンドライン・インタフェースに接続する方法を示しています。
% dgmgrl
.
.
.
Welcome to DGMGRL, type "help" for information.
DGMGRL> CONNECT sysdg;
Password: password
Connected to "North_Sales"
Connected as SYSDG.
例7-2 リモート・システム上のDGMGRLへの接続
この例は、リモート・システム上でOracle Data Guard (DGMGRL)コマンドライン・インタフェースに接続する方法を示しています。
DGMGRL> CONNECT sysdg@remote-stby;
Password: password
Connected to "remote-stdby"
Connected as SYSDG.
例7-3 ASオプションを使用した接続
この例は、CONNECT AS
オプションを使用してOracle Data Guard (DGMGRL)コマンドライン・インタフェースに接続する方法を示しています。
DGMGRL> CONNECT sys@remote-stby AS SYSDBA;
Password: password
Connected to "remote-stdby"
Connect as SYSDBA.
7.2 Data Guardコマンドライン・インタフェースの終了
DGMGRLインタフェースでの作業を完了し、オペレーティング・システムに戻るには、EXIT
またはQUIT
コマンドを入力します。
次に例を示します。
DGMGRL> EXIT;
7.3 @ (アットマーク)コマンド
@コマンドを使用すると、スクリプト・ファイルに保存されているDGMGRLコマンドを実行できます。
一連のコマンドをスクリプト・ファイルに入力してから、@コマンドを使用してそのファイルを実行できます。スクリプト内に含まれているコマンドが順に実行されます。
書式
DGMGRL内での書式は次のとおりです。
DGMGRL> @script_file_name
コマンド・パラメータ
フラグ | 説明 |
---|---|
-echo | スクリプト内のすべてのコマンドと、その実行結果を表示します。 |
使用上の注意
このコマンドを使用して実行するスクリプトは、次の条件を満たしている必要があります。
-
DGMGRLがスクリプトにアクセスできる必要があります。できない場合、DGMGRLではファイルを開けないため、コマンドは失敗します。
-
スクリプト内のすべてのDGMGRLコマンドがセミコロンで終了している必要があります。
-
@コマンドの再帰実行は可能ですが、再帰レベルの上限は20です。再帰レベルが20に達すると、実行は中断され、未実行のコマンドは実行されません。そのため、@コマンドの自己再帰的な実行(たとえば、abc.scriptスクリプト自体に@abc.scriptコマンドを入力する)を使用する場合には注意が必要です。
-
スクリプト内に
START OBSERVER
コマンドがある場合、START OBSERVER
コマンドによってDGMGRLセッションがオブザーバに移行されるため、このコマンド以降に出現するコマンドはすべて無視されます。START OBSERVER IN BACKGROUND
コマンドは、通常のコマンドとして処理されます。つまり、このコマンド以降に出現するコマンドはすべて実行されます。 -
コメント行はスクリプト内で使用できますが、セミコロンで終了している必要があります。たとえば、次のコメントはスクリプト内で使用できます。
REM Hello World; -- Hello Again!;
二重ダッシュの後に空白文字を入れてから、コメント・テキストを続ける必要があります。
7.4 / (スラッシュ)コマンド
DGMGRLの/ (スラッシュ)コマンドは、コマンド・プロンプトで最後に入力したコマンドを繰り返す場合に使用します。
書式
DGMGRL> /
使用上の注意
-
次のコマンドは、/ (スラッシュ)コマンドを使用して繰り返すことはできません。
-
RETURN
-
認識できないコマンド
-
CONNECT
コマンド(資格証明が含まれている可能性があるため) -
/ (スラッシュ)コマンド自体
-
コマンドの例
次の例では、/ (スラッシュ)コマンドを使用して、簡単にSHOW CONFIGURATION
コマンドを繰り返します。
DGMGRL> SHOW CONFIGURATION;
Configuration - Sales_Configuration
Protection Mode: MaxAvailability
Members:
North_Sales - Primary database
Local_Sales - Physical standby database
Remote_Sales - Physical standby database (receiving current redo)
Fast-Start Failover: DISABLED
Configuration Status:
SUCCESS
DGMGRL> /
Configuration - Sales_Configuration
Protection Mode: MaxAvailability
Members:
North_Sales - Primary database
Local_Sales - Physical standby database
Remote_Sales - Physical standby database (receiving current redo)
Fast-Start Failover: DISABLED
Configuration Status:
SUCCESS
DGMGRL>
7.5 ADD DATABASE
DGMGRLのADD DATABASE
コマンドは、既存のブローカ構成にスタンバイ・データベースを追加します。
書式
ADD DATABASE database-name AS CONNECT IDENTIFIER IS connect-identifier;
コマンド・パラメータ
使用上の注意
-
このコマンドを発行するには、プライマリ・データベースまたは構成内にすでに存在する有効化されたスタンバイ・データベースに接続する必要があります。
-
ブローカでは、指定した
connect-identifier
が、他のデータベースから指定したデータベースへの通信に使用されます。したがって、構成内のすべてのデータベースから指定のデータベースへのアドレス指定に、connect-identifier
を使用できることを確認する必要があります。たとえば、TNSをネーミング・メソッドとして使用する場合、構成内のすべてのデータベースとインスタンスのtnsnames.oraファイルにconnect-identifier
のエントリが含まれることを確認する必要があります。接続識別子は同じ接続記述子に解決される必要があります。追加するデータベースがOracle RACデータベースである場合、Oracle RACのすべてのインスタンスにアクセスできる接続識別子
を指定する必要があります。FAILOVER
属性を設定することをお薦めします。 -
接続できない場合、ブローカでは新しいデータベースが構成に追加されません。
-
リモートREDO転送先は、スタンバイ・データベース上ですべてクリアしてからでないと、構成に追加できません。
コマンドの例
次の例に、データベースSouth_Sales
を追加する方法を示します。
DGMGRL> ADD DATABASE South_Sales AS CONNECT IDENTIFIER IS South_Sales.example.com; Database "South_Sales" added
7.6 ADD FAR_SYNC
ADD FAR_SYNC
コマンドは、既存の遠隔同期インスタンスをOracle Data Guard Broker構成に追加します。
作成された遠隔同期インスタンスは無効化されています。ブローカがそれとの間でREDOをやりとりするには、それを明示的に有効にする必要があります。
書式
ADD FAR SYNC far_sync_instance_name AS CONNECT IDENTIFIER IS connect-identifier;
コマンド・パラメータ
使用上の注意
-
ブローカ構成に遠隔同期インスタンスを追加するには、先にそれが存在する必要があります。
-
リモートREDO転送先は、遠隔同期インスタンス上ですべてクリアしてからでないと、構成に追加できません。
コマンドの例
次の例は、chicago
という名前の遠隔同期インスタンスを構成に追加します。
DGMGRL> ADD FAR_SYNC chicago AS CONNECT IDENTIFIER IS chicago.example.com;
7.7 ADD RECOVERY_APPLIANCE
ADD RECOVERY_APPLIANCE
コマンドは、Zero Data Loss Recovery Appliance (リカバリ・アプライアンス)を既存のブローカ構成に追加します。
AS CONNECT IDENTIFIER
句は、オプションです。この句を指定しない場合、ブローカはプライマリ・データベースと有効化されたすべてのスタンバイ・データベース上でLOG_ARCHIVE_DEST_n
初期化パラメータを検索し、追加されるリカバリ・アプライアンスに対応するエントリを探します。
書式
ADD RECOVERY APPLIANCE object-name AS CONNECT IDENTIFIER IS connect-identifier;
コマンド・パラメータ
使用上の注意
-
このコマンドを発行するには、プライマリ・データベースまたは構成内にすでに存在する有効化されたスタンバイ・データベースに接続する必要があります。
-
ブローカでは、指定した接続識別子を使用して、構成内の任意のデータベースから指定のリカバリ・アプライアンスに通信します。したがって、構成内の任意のデータベースから指定のリカバリ・アプライアンスへのアドレス指定に、接続識別子を使用できることを確認する必要があります。たとえば、TNSをネーミング・メソッドとして使用する場合、構成内のすべてのデータベースとインスタンスの
tnsnames.ora
ファイルに接続識別子のエントリが含まれることを確認する必要があります。接続識別子は同じ接続記述子に解決される必要があります。 -
接続を確立できない場合、新しいリカバリ・アプライアンスは構成に追加されません。
-
構成内に複数のリカバリ・アプライアンスを含むことが可能です。
コマンドの例
次の例は、EnterpriseRecoveryAppliance
という名前のリカバリ・アプライアンスを追加する方法を示しています。
DGMGRL> ADD RECOVERY_APPLIANCE EnterpriseRecoveryAppliance AS CONNECT IDENTIFIER IS EnterpriseRecoveryAppliance.example.com;Oracle Backup Appliance "EnterpriseRecoveryAppliance" added
7.8 CONNECT
DGMGRLのCONNECT
コマンドを使用すると、Data Guard Broker構成のメンバーであるデータベースまたは遠隔同期インスタンスに接続できます。
書式
CONNECT username@connect-identifer [AS {SYSDBA | SYSDG} ];
コマンド・パラメータ
使用上の注意
-
接続を試みる構成メンバーに対してユーザー名とパスワードが有効である必要があります。
指定するユーザー名には、
SYSDG
またはSYSDBA
権限が必要です。 -
AS
句はオプションです。指定されている場合、DGMGRLは、その指定されたSYSDGまたはSYSDBAのいずれかで接続を試みます。AS
句が指定されていない場合、DGMGRLは最初にAS SYSDG
接続を試み、それが失敗した場合は、AS SYSDBA
接続を試みます。 -
CONNECT
コマンドでエラーが戻される場合は、有効なconnect-identifier
を指定したことを確認してください。 -
CONNECT
コマンドが正常に実行されると、接続が確立された構成メンバーの名前が表示されます。
コマンドの例
例1: ローカルの構成メンバーへの接続
この例は、ローカル・システム上のデフォルトのデータベースまたは遠隔同期インスタンスに接続します。
DGMGRL> CONNECT sysdg;
Password: password
Connected to "North_Sales"
Connected as SYSDG.
例2: リモートの構成メンバーへの接続
この例では、リモート・システム上のデータベースに接続します(かわりに遠隔同期を指定してもかまいません)。
DGMGRL> CONNECT sysdg@South_Sales;
Password: password
Connected to "South_Sales"
Connected as SYSDG.
例3: 接続資格証明を表示しない接続
この例では、コマンドラインで接続資格証明を表示できないように、CONNECT '/'
を使用して構成メンバーに接続しています。
DGMGRL> CONNECT /@North_Sales.example.com; Connected to "North_Sales"
CONNECT '/'
を使用するには、OracleウォレットまたはSSLを設定する必要があります。OracleウォレットまたはSSLを設定することで、スクリプトでデータベース資格証明を指定せずに、オブザーバをバックグラウンド・ジョブとして安全に起動および実行するためのスクリプトを記述できます。
7.9 CONVERT DATABASE
CONVERT DATABASE
コマンドは、フィジカル・スタンバイ・データベースをスナップショット・スタンバイ・データベースに変換するか、スナップショット・スタンバイ・データベースをフィジカル・スタンバイ・データベースに戻します。
スナップショット・スタンバイ・データベースは完全に更新可能なスタンバイ・データベースです。フィジカルまたはロジカル・スタンバイ・データベースと同様に、スナップショット・スタンバイ・データベースは、プライマリ・データベースからREDOデータを受信し、アーカイブします。フィジカルまたはロジカル・スタンバイ・データベースとは異なり、スナップショット・スタンバイ・データベースは、受信したREDOデータを適用しません。スナップショット・スタンバイ・データベースが受信したREDOデータは、スナップショット・スタンバイが元のフィジカル・スタンバイ・データベースに変換され、スナップショット・スタンバイ・データベースに対するすべてのローカルな更新が破棄された後に適用されます。
スナップショット・スタンバイ・データベースは、フィジカル・スタンバイ・データベースの一時的かつ更新可能なスナップショットが必要な場合に最もよく使用されます。スナップショット・スタンバイ・データベースでは、フィジカル・スタンバイに戻るまで受信したREDOデータが適用されないため、ロール遷移の実行に要する時間は、適用する必要があるREDOデータの量に正比例します。
スナップショット・スタンバイ・データベースの詳細は、『Oracle Data Guard概要および管理』を参照してください。
書式
CONVERT DATABASE db_unique_name TO {SNAPSHOT | PHYSICAL} STANDBY;
使用上の注意
-
ファスト・スタート・フェイルオーバーのターゲットである場合、フィジカル・スタンバイ・データベースをスナップショット・スタンバイ・データベースに変換できません。「
ORA-16668: ファスト・スタート・フェイルオーバー・ターゲットのスタンバイ・データベースでは操作を実行できません
」というエラーが表示されます。 -
構成可能なプロパティ
RedoRoutes
がNullでない値に設定されている場合、フィジカル・スタンバイ・データベースをスナップショット・スタンバイ・データベースに変換できません。 -
DGMGRL ADD DATABASEコマンドを使用して、既存のスナップショット・スタンバイ・データベースをOracle Data Guard Broker構成にインポートしてください。
-
スナップショット・スタンバイ・データベースを、スイッチオーバーまたはファスト・スタート・フェイルオーバーのターゲットにすることはできません。
-
ファスト・スタート・フェイルオーバーが無効化されている場合、スナップショット・スタンバイ・データベースは、手動フェイルオーバーのターゲットにすることができます。
-
SHOW CONFIGURATION
またはSHOW DATABASE
コマンドを使用して、変換の結果を確認できます。次に例を示します。DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxPerformance Members: North_Sales - Primary database South_Sales - Snapshot standby database Fast-Start Failover: DISABLED Configuration Status: SUCCESS
-
スナップショット・スタンバイ・データベースをフィジカル・スタンバイ・データベースに戻すと、フィジカル・スタンバイ・データベースのデフォルトの
APPLY-ON
の状態になります。
コマンドの例
例1: フィジカル・スタンバイからスナップショット・スタンバイへの変換
次のコマンドを発行して、フィジカル・スタンバイ・データベースをスナップショット・スタンバイ・データベースに変換します。
DGMGRL> CONVERT DATABASE 'South_Sales' to SNAPSHOT STANDBY; Converting database "South_Sales" to a Snapshot Standby database, please wait... Database "South_Sales" converted successfully
例2: スナップショット・スタンバイからフィジカル・スタンバイへの再変換
次のコマンドを発行して、スナップショット・スタンバイ・データベースをフィジカル・スタンバイ・データベースに戻します。
DGMGRL> CONVERT DATABASE 'South_Sales' to PHYSICAL STANDBY; Converting database "South_Sales" to a Physical Standby database, please wait... Operation requires shutdown of instance "south_sales1" on database "South_Sales" Shutting down instance "south_sales1"... Database closed. Database dismounted. ORACLE instance shut down. Operation requires startup of instance "south_sales1" on database "South_Sales" Starting instance "south_sales1"... ORACLE instance started. Database mounted. Continuing to convert database "South_Sales" ... Database "South_Sales" converted successfully
7.10 CREATE CONFIGURATION
CREATE CONFIGURATION
コマンドは、指定されたプライマリ・データベースを含む新しいブローカ構成を作成します。
書式
CREATE CONFIGURATION configuration_name AS PRIMARY DATABASE IS database-name CONNECT IDENTIFIER IS connect-identifier;
コマンド・パラメータ
- configuration-name
-
作成する構成のわかりやすい名前。有効な名前には英数字が含まれます。名前に空白を含める場合は、その名前を二重引用符または一重引用符で囲む必要があります。名前は30バイト以内で指定してください。
- database-name
-
ブローカでプライマリ・データベースを参照するために使用される名前。この名前は、プライマリ・データベースの
DB_UNIQUE_NAME
初期化パラメータの値と一致する(大/小文字は区別されません)必要があります。 - connect-identifier
-
完全指定の接続記述子またはOracle Net Servicesのネーミング・メソッド(TNSなど)により解決される名前です。指定した値は、データベース・プロパティ
DGConnectIdentifier
の初期値としても使用されます。
使用上の注意
-
ブローカ構成は、グループとして管理する必要のある1つ以上のデータベースの名前付きコレクションです。各コマンド・パラメータの値を指定する必要があります。デフォルト値はありません。
-
このコマンドを発行するには、プライマリ・データベースに接続する必要があります。
-
ブローカでは、指定した
connect-identifier
が、他のデータベースから指定したデータベースへの通信に使用されます。したがって、構成内のすべてのデータベースから指定のデータベースへのアドレス指定に、connect-identifier
を使用できることを確認する必要があります。たとえば、TNSをネーミング・メソッドとして使用する場合、構成内のすべてのデータベースとインスタンスのtnsnames.oraファイルにconnect-identifier
のエントリが含まれることを確認する必要があります。接続識別子は同じ接続記述子に解決される必要があります。追加するデータベースがOracle RACデータベースである場合、Oracle RACのすべてのインスタンスにアクセスできる接続識別子
を指定する必要があります。FAILOVER
属性を設定することをお薦めします。 -
ブローカ構成の作成後にスタンバイ・データベースを追加するには、ADD DATABASEコマンドを使用します。
-
NOREGISTER
属性のないプライマリ・データベース上ですべてのリモートREDO転送先をクリアしてからでないと、構成を作成できません。
コマンドの例
次の例では、プライマリ・データベースNorth_Sales
を含む新しいブローカ構成DRSolution
を作成しています。
DGMGRL> CREATE CONFIGURATION 'DRSolution' AS > PRIMARY DATABASE IS 'North_Sales' > CONNECT IDENTIFIER IS North_Sales.example.com; Configuration "DRSolution" created with primary database "North_Sales"
7.11 DISABLE CONFIGURATION
DISABLE CONFIGURATION
コマンドは、構成とそのすべてのデータベースがブローカによる管理対象から外れるように、構成のブローカ管理を無効化します。
書式
DISABLE CONFIGURATION;
コマンド・パラメータ
なし。
使用上の注意
-
無効化された構成およびそこに含まれるすべてのデータベースが、ブローカで管理されなくなります。
-
プライマリ・データベースのブローカ管理を無効にするには、
DISABLE CONFIGURATION
コマンドを使用する必要があります。 -
このコマンドは、構成ファイルからブローカ構成を削除しません。構成を削除する方法の詳細は、REMOVE CONFIGURATIONコマンドを参照してください。
-
構成が無効になっている間、データベース・プロパティを編集したり構成の保護モードを変更できます。ただし、プロパティや保護モードの変更結果は、構成が有効化されるまで有効になりません。
-
このコマンドは、ファスト・スタート・フェイルオーバーが有効になっている場合は実行できません。
コマンドの例
次の例では、ブローカ構成およびそのすべてのデータベースの管理を無効化しています。
DGMGRL> DISABLE CONFIGURATION; Disabled.
7.12 DISABLE DATABASE
DISABLE DATABASE
コマンドは、指定したスタンバイ・データベースのブローカ管理を無効化します。
つまり、ブローカではこのデータベースの状態を変更できなくなり、ブローカはデータベースの健全性ステータスや監視可能なプロパティを監視しません。
書式
DISABLE DATABASE database-name;
使用上の注意
-
プライマリ・データベース名は指定できません。
-
プライマリ・データベースとすべてのスタンバイ・データベースを無効化するには、
DISABLE CONFIGURATION
コマンドを使用します。 -
スタンバイ・データベースを1つのみ無効化する場合、フェイルオーバー・オプションを使用できません。このスタンバイ・データベースは、再び有効化するまでは実行できなくなります。
-
ファスト・スタート・フェイルオーバーが有効化されているとき、このコマンドを使用してファスト・スタート・フェイルオーバーのターゲット・データベースを無効にすることはできません。
コマンドの例
次の例に、データベースSouth_Sales
を無効化する方法を示します。
DGMGRL> DISABLE DATABASE 'South_Sales'; Disabled.
7.14 DISABLE FAST_START FAILOVER
DISABLE FAST_START FAILOVER
コマンドは、オブザーバによりターゲット・スタンバイ・データベースへのフェイルオーバーが開始されないようにします。
詳細は、「ファスト・スタート・フェイルオーバーの無効化」を参照してください。
書式
DISABLE FAST_START FAILOVER [ FORCE ];
コマンド・パラメータ
なし。
使用上の注意
-
プライマリ・データベースとターゲット・スタンバイ・データベースにネットワーク接続がある場合、ブローカ構成内のすべてのデータベースでファスト・スタート・フェイルオーバーを無効化するには、
FORCE
オプションを指定せずにDISABLE FAST_START FAILOVER
を使用します。無効化操作中にエラーが発生した場合、ブローカによりエラー・メッセージが戻され、無効化操作が停止されます。エラー状態をオーバーライドし、接続先データベースのファスト・スタート・フェイルオーバーを無効化するには、FORCE
オプションを指定してDISABLE FAST_START FAILOVER
コマンドを再発行する必要があります。詳細は、「ファスト・スタート・フェイルオーバーの無効化」を参照してください。 -
プライマリ・データベースとターゲット・スタンバイ・データベース間のネットワークが切断されている場合、またはコマンドを受信するデータベースに、プライマリ・データベースとの接続がない場合には、
FORCE
オプションを指定してDISABLE FAST_START FAILOVER
を使用します。FORCE
オプションは、エラー発生時でも、接続先データベースのファスト・スタート・フェイルオーバーを無効化します。 -
オブザーバおよびターゲットのスタンバイ・データベースから切断されたプライマリ・データベース上で
FORCE
オプションを指定してファスト・スタート・フェイルオーバーを無効化しても、オブザーバによる、ターゲットのスタンバイ・データベースへのファスト・スタート・フェイルオーバーの開始を無効にはできません。 -
ブローカ構成のいずれかのデータベースに接続している場合、そのデータベースとプライマリ間が接続されていれば、ファスト・スタート・フェイルオーバーを無効化できます。
-
ターゲットのスタンバイ・データベース上で強制オプション付きで無効化され、その後プライマリ・データベースとの接続が再開された場合、ファスト・スタート・フェイルオーバーは、構成内のすべてのデータベースで無効化されています。
-
プライマリ・データベースとターゲット・スタンバイ・データベースがネットワークで接続されている場合、プライマリに接続しているときに
FORCE
オプションを指定してファスト・スタート・フェイルオーバーを無効化すると、ターゲット・スタンバイ・データベースのファスト・スタート・フェイルオーバーが無効になります。
コマンドの例
例1: ファスト・スタート・フェイルオーバーの無効化
次の例に、ファスト・スタート・フェイルオーバーを無効化する方法を示します。
DGMGRL> DISABLE FAST_START FAILOVER; Disabled.
例2: FORCEを使用したファスト・スタート・フェイルオーバーの無効化
次の例では、接続先のデータベースでファスト・スタート・フェイルオーバーを無効化するFORCE
オプションを使用しています。
DGMGRL> DISABLE FAST_START FAILOVER FORCE; Disabled.
7.15 DISABLE FAST_START FAILOVER CONDITION
DISABLE FAST_START FAILOVER CONDITION
コマンドは、ユーザーによるファスト・スタート・フェイルオーバーの実行条件の削除を可能にします。
書式
DISABLE FAST_START FAILOVER CONDITION value;
使用上の注意
条件が設定されていない場合、認識されていない条件の場合、エラーは発生しません。
コマンドの例
この例では、破損した制御ファイルが検出されても自動的に即時ファスト・スタート・フェイルオーバーが開始されないように指定します。
DGMGRL> DISABLE FAST_START FAILOVER CONDITION "Corrupted Controlfile";
7.16 DISABLE RECOVERY_APPLIANCE
DISABLE RECOVERY_APPLIANCEコマンドは、指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)のブローカ管理を無効にします。
リカバリ・アプライアンスのブローカ管理を無効化すると、ブローカによりリカバリ・アプライアンスへの転送の健全性が監視されなくなります。ただし、リカバリ・アプライアンスへのREDO転送は停止されません。
書式
DISABLE RECOVERY_APPLIANCE object_name;
コマンドの例
次の例は、EnterpriseRecoveryAppliance
という名前のリカバリ・アプライアンスを無効化する方法を示しています。
DGMGRL> DISABLE RECOVERY_APPLIANCE 'EnterpriseRecoveryAppliance'; Disabled.
7.17 EDIT CONFIGURATION (Property)
EDIT CONFIGURATION SET PROPERTY
コマンドは、ブローカ構成のプロパティ値を変更します。
書式
EDIT CONFIGURATION SET PROPERTY property-name=value;
関連項目:
構成プロパティの詳細は、「ブローカ構成のメンバーの管理」および「Oracle Data Guard Brokerのプロパティ」を参照
使用上の注意
-
プライマリ・データベースに、またはそのプライマリ・データベースと接続された構成内の任意のスタンバイ・データベースに接続されている場合に、このコマンドを発行します。
-
構成の現在のプロパティ情報を表示するには、
SHOW CONFIGURATION
コマンドを使用します。
コマンドの例
次の例に、FastStartFailoverThreshold
構成プロパティを90秒に設定する方法を示します。
DGMGRL> EDIT CONFIGURATION SET PROPERTY FastStartFailoverThreshold=90;
7.18 EDIT CONFIGURATION(保護モード)
EDIT CONFIGURATION SET PROTECTION MODE AS
コマンドは、ブローカ構成の現在の保護モード設定を編集します。
書式
EDIT CONFIGURATION SET PROTECTION MODE AS protection-mode;
コマンド・パラメータ
使用上の注意
-
EDIT
CONFIGURATION
コマンドを使用して保護モードを設定する前に、少なくとも1つのスタンバイが、プライマリから直接REDOを受け取る場合にSYNC
またはFASTSYNC
モードでREDOを受け取るように構成されていることを確認してください。スタンバイが遠隔同期インスタンスを介してREDOを受け取る場合、遠隔同期インスタンスはSYNC
またはFASTSYNC
モードでREDOを受け取るように構成され、スタンバイはASYNC
モードでREDOを受け取るように構成される必要があります。 -
次の表は、構成の保護モードと、REDO転送サービスの対応する最低限の設定を示しています。
保護モード REDO転送 スタンバイREDOログ・ファイルの要否 ファスト・スタート・フェイルオーバーとの併用 MAXPROTECTION
SYNC
はい
はい
MAXAVAILABILITY
SYNC
またはFASTSYNC
はい
はい
MAXPERFORMANCE
ASYNC
はい
はい
構成のデフォルトの保護モードは
MAXPERFORMANCE
です。関連項目:
保護モードとREDO転送サービスの詳細は、「ブローカ構成のメンバーの管理」を参照
-
このコマンドは、ファスト・スタート・フェイルオーバーが有効になっている場合は実行できません。
-
MAXPERFORMANCE
からMAXPROTECTION
へのアップグレードは許可されません。まずMAXAVAILABILITY
に変更してから、MAXPROTECTION
にする必要があります。 -
SHOW CONFIGURATION
コマンドを使用して構成の現在の保護モードを表示します。DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxPerformance Members: North_Sales - Primary database South_Sales - Physical standby database Fast-Start Failover: DISABLED Configuration Status: SUCCESS
EDIT CONFIGURATION
コマンドの入力時に構成のブローカ管理が無効になっている場合、構成の保護モードは、次回ENABLE CONFIGURATIONコマンドを使用して構成を有効化するまで有効にはなりません。
コマンドの例
次の例は、ブローカ構成をMAXAVAILABILITY
保護モードにアップグレードする方法を示しています。
次のように、スタンバイ・データベースでスタンバイREDOログ・ファイルが構成されていること、REDO転送サービスがSYNC
に設定されていることを確認します。
DGMGRL> EDIT DATABASE 'South_Sales' SET PROPERTY 'LogXptMode'='SYNC'; Property "LogXptMode" updated DGMGRL> EDIT CONFIGURATION SET PROTECTION MODE AS MAXAVAILABILITY; Succeeded.
7.19 EDIT CONFIGURATION (RENAME)
EDIT CONFIGURATION RENAME TO
コマンドは、構成名を変更します。
書式
EDIT CONFIGURATION RENAME TO new-configuration-name;
コマンドの例
次の例は、DR_Sales
という名前の構成の名前をHA_Sales
に変更する方法を示しています。
DGMGRL> SHOW CONFIGURATION Configuration - DR_Sales Protection Mode: MaxPerformance Members: North_Sales - Primary database South_Sales - Physical standby database Fast-Start Failover: DISABLED Configuration Status: DISABLED DGMGRL> EDIT CONFIGURATION RENAME TO "HA_Sales"; Succeeded. DGMGRL> ENABLE CONFIGURATION Enabled. DGMGRL> SHOW CONFIGURATION Configuration - HA_Sales Protection Mode: MaxPerformance Members: North_Sales - Primary database South_Sales - Physical standby database Fast-Start Failover: DISABLED Configuration Status: SUCCESS
7.20 EDIT CONFIGURATION RESET (プロパティ)
EDIT CONFIGURATION RESET PROPERTY
コマンドは、指定された構成プロパティをそのデフォルト値にリセットします。
書式
EDIT CONFIGURATION RESET PROPERTY property-name;
使用上の注意
-
プライマリ・データベースに、またはそのプライマリ・データベースと接続された構成内の任意のスタンバイ・データベースに接続されている場合に、このコマンドを発行します。
-
構成の現在のプロパティ情報を表示するには、
SHOW CONFIGURATION
コマンドを使用します。
コマンドの例
次の例では、BystandersFollowChange
プロパティをリセットする方法を示します。
DGMGRL> EDIT CONFIGURATION RESET PROPERTY BystandersFollowChange; Succeeded.
7.21 EDIT DATABASE (Property)
EDIT DATABASE
コマンドは、ブローカにより指定したデータベースに対して使用される名前を変更します。
書式
EDIT DATABASE database-name SET PROPERTY property-name=value;
コマンド・パラメータ
- database-name
-
プロパティ値を変更するデータベースの名前。
- property-name
-
データベース固有の既存のプロパティの名前。これがOracle RACデータベースの場合、このプロパティを変更するとデータベースのインスタンスすべてに影響します。
関連項目:
プロパティの詳細は、「ブローカ構成のメンバーの管理」および「Oracle Data Guard Brokerのプロパティ」を参照。
- value
-
新しいプロパティ値。
注意:
このコマンドを使用してインスタンス固有のプロパティの値を変更できるのは、指定したデータベースに関してブローカでインスタンスが1つしか認識されていない場合のみです。ブローカでデータベースのインスタンスが複数認識されている場合は、このコマンドを使用してインスタンス固有のプロパティを変更しようとしても拒否されます。インスタンス固有のプロパティの値の変更には、
EDIT INSTANCE(プロパティ)
のみを使用することをお薦めします。
コマンドの例
例1: データベース・レベルの構成可能なプロパティの編集
次の例では、データベース・レベルの構成可能なプロパティを編集します。
DGMGRL> EDIT DATABASE 'North_Sales' SET PROPERTY 'ArchiveLagTarget'=1200; Property "ArchiveLagTarget" updated
例2: 非Oracle RACデータベースの構成可能なインスタンス固有のプロパティの編集
次の例では、非Oracle RACデータベースの構成可能なインスタンス固有のプロパティを編集します。
DGMGRL> EDIT DATABASE 'South_Sales' SET PROPERTY > 'StandbyArchiveLocation'='/archfs/arch/'; Property "StandbyArchiveLocation" updated
例3: Oracle RACデータベースの構成可能なインスタンス固有のプロパティの編集
次の例では、Oracle RACデータベースの構成可能なインスタンス固有のプロパティを編集します。プロパティの変更が適用されるインスタンスが明らかでないため、このコマンドは失敗します。
DGMGRL> EDIT DATABASE 'North_Sales' SET PROPERTY > 'StandbyArchiveLocation'='/archfs/arch/'; Error: ORA-16587: ambiguous object specified to Data Guard broker Failed.
例4: ファスト・スタート・フェイルオーバー・ターゲットのリストの編集
次の例では、ファスト・スタート・フェイルオーバー・ターゲットのリストを指定する方法を示します。
DGMGRL> EDIT DATBASE db1 SET PROPERTY FastStartFailoverTarget='db2, db3';
DGMGRL> EDIT DATABASE db2 SET PROPERTY FastStartFailoverTarget='db1,db3';
DGMGRL> EDIT DATABASE db3 SET PROPERTY FastStartFailoverTarget='db1';
7.22 EDIT DATABASE (名前の変更)
EDIT DATABASE
(名前の変更)コマンドは、ブローカにより指定したデータベースの参照に使用される名前を変更します。
書式
EDIT DATABASE database-name RENAME TO new-database-name;
使用上の注意
-
このコマンドを使用して、このデータベースの
DB_UNIQUE_NAME
初期化パラメータの変更を追跡します。注意:
database-name
は、そのデータベースのDB_UNIQUE_NAME
初期化パラメータの値と常に一致する必要があります。 -
このコマンドを実行できるのは、名前を変更するデータベースのブローカ管理が無効化されている場合のみです。
コマンドの例
次の例に、データベースを編集して名前を変更する方法を示します。
DGMGRL> DISABLE DATABASE 'South_Sales_typo'; Disabled. DGMGRL> EDIT DATABASE 'South_Sales_typo' RENAME TO 'South_Sales'; Succeeded. DGMGRL> ENABLE DATABASE 'South_Sales'; Enabled.
7.23 EDIT DATABASE (状態)
EDIT DATABASE
(状態)コマンドは、指定したデータベースの状態を変更します。
書式
EDIT DATABASE database-name SET STATE=state [WITH APPLY INSTANCE=instance-name];
コマンド・パラメータ
使用上の注意
-
ターゲットの状態が
APPLY-ON
で、このデータベースが現在フィジカルまたはロジカル・スタンバイ・データベースである場合は、オプションのWITH APPLY INSTANCE
句で適用インスタンスを指定します。 -
ターゲットの状態が
APPLY-ON
ではない場合、またはデータベースが現在プライマリ・ロールになっている場合は、WITH APPLY INSTANCE
句を指定しても無視されます。 -
スナップショット・スタンバイ・データベースの状態は変更できません。
-
このデータベースの状態変更は、Oracle RACデータベースのすべてのインスタンスに影響します。
コマンドの例
次の各例に、データベースの状態を変更する方法を示します。
DGMGRL> EDIT DATABASE 'South_Sales' SET STATE='APPLY-ON'; Succeeded.
7.24 EDIT DATABASE RESET (プロパティ)
EDIT DATABASE RESET
(プロパティ)コマンドは、指定されたデータベースの指定されたプロパティをそのデフォルト値にリセットしなおします。
書式
EDIT DATABASE database-name RESET PROPERTY property-name;
コマンドの例
次の例は、South_Sales
という名前のデータベースのNetTimeout
プロパティをリセットする方法を示しています。
DGMGRL> EDIT DATABASE 'South_Sales' RESET PROPERTY NetTimeout; Succeeded.
7.25 EDIT FAR_SYNC
EDIT FAR_SYNC
プロパティは、遠隔同期インスタンスの名前またはプロパティを変更します。
書式
EDIT FAR_SYNC far_sync_instance_name RENAME TO new_far_sync_instance_name;
EDIT FAR_SYNC far_sync_instance_name SET PROPERTY property_name = value;
コマンド・パラメータ
コマンドの例
次の例は、chicago
という名前の遠隔同期インスタンスの名前をdallas
に変更します。
DGMGRL> DISABLE FAR_SYNC 'chicago_typo';EDIT FAR_SYNC 'chicago_typo' RENAME TO 'chicago';ENABLE FAR_SYNC 'chicago;
7.26 EDIT FAR_SYNC RESET (プロパティ)
EDIT FAR_SYNC RESET
(プロパティ)コマンドは、指定された遠隔同期インスタンスの指定されたプロパティをそのデフォルト値にリセットします。
書式
EDIT FAR_SYNC far_sync_instance_name RESET PROPERTY property-name;
コマンド・パラメータ
コマンドの例
次の例は、dallas
という名前の遠隔同期インスタンスのReopenSecs
プロパティをデフォルト値にリセットする方法を示しています。
DGMGRL> EDIT FAR_SYNC 'dallas' RESET PROPERTY ReopenSecs;
7.27 EDIT INSTANCE(AUTO PFILE)
EDIT INSTANCE
(AUTO PFILE)コマンドは、指定したインスタンスの初期化パラメータ・ファイル名を設定します。
書式
EDIT INSTANCE instance-name
[ON DATABASE database-name] SET AUTO PFILE [= { initialization-file | OFF } ];
コマンド・パラメータ
- instance-name
-
初期化パラメータ・ファイルを指定するインスタンスの名前(SID)。
- database-name
-
instance-name
が関連付けられているデータベースの名前。 - initialization-file
-
後続のブローカ操作でインスタンスを自動的に起動する必要がある場合は、そのインスタンスの起動操作を実行します。
SET AUTO PFILE
をOFF
に設定すると、そのインスタンスの自動再起動は無効化されます。そのインスタンスを後続の操作で起動する必要がある場合は、手動で起動する必要があります。インスタンスに対してSET AUTO PFILE
を指定しない場合、自動起動操作では初期化パラメータ・ファイルがデフォルト位置で検索されます。
使用上の注意
-
instance-name
には、構成全体で一意の名前を指定できます。instance-name
が一意ではない場合、database-name
およびinstance-name
の両方を指定してインスタンスを完全に識別する必要があります。 -
SET AUTO PFILE
は、現行のDGMGRLセッションの存続期間中にのみ有効です。DGMGRLを終了して再起動した場合は、SET AUTO PFILE
を再指定する必要があります。
コマンドの例
次の例に、データベースのインスタンスの起動に使用するパラメータ・ファイルを変更する方法を示します。
DGMGRL> EDIT INSTANCE 'south_sales1' ON DATABASE 'South_Sales' > SET AUTO PFILE='initsales1.ora'; Instance 'south_sales1' updated
7.28 EDIT INSTANCE (プロパティ)
EDIT INSTANCE
(プロパティ)コマンドは、指定したインスタンスのインスタンス固有のプロパティ値を変更します。
書式
EDIT INSTANCE { {instance-name [ON {DATABASE database-name | FAR_SYNC far-sync-name}] } | {* ON {DATABASE database-name | FAR_SYNC far-sync-name} } }
SET PROPERTY property-name=value;
コマンド・パラメータ
- instance-name
-
インスタンス固有のプロパティ値を変更するインスタンスの名前(SID)。インスタンス名にアスタリスクが指定されている場合、
ON DATABASE
句またはON
FAR_SYNC
句も指定し、この変更をそのデータベースまたは遠隔同期に関連する各インスタンスの指定プロパティに適用する必要があります。このコマンドを使用して変更できるインスタンス固有プロパティについては、「Oracle Data Guard Brokerのプロパティ」を参照してください。 - database-name
-
instance-name
が関連付けられているデータベースの名前。instance-name
にアスタリスクが付けられている場合、または構成内でinstance-name
が一意でない場合は、このパラメータを指定する必要があります - far-sync-name
-
instance-name
が関連付けられている遠隔同期の名前。 - property-name
-
新しい値を設定するインスタンス固有のプロパティの名前。
関連項目:
プロパティの詳細は、「ブローカ構成のメンバーの管理」および「Oracle Data Guard Brokerのプロパティ」を参照。
- value
-
新しいプロパティ値。
使用上の注意
-
instance-name
には、構成全体で一意の名前を指定できます。instance-name
が一意ではない場合、database-name
(またはfar-sync-name
)とinstance-name
の両方を指定してインスタンスを完全に識別する必要があります。 -
このコマンドは、データベース固有のプロパティの変更には使用できません。
コマンドの例
例1: インスタンス固有のプロパティの編集
インスタンス固有のプロパティを編集します。
DGMGRL> EDIT INSTANCE 'north_sales1' ON DATABASE 'North_Sales' > SET PROPERTY 'StandbyArchiveLocation'='/archfs/arch/'; Property "StandbyArchiveLocation" updated.
例2: データベース固有のプロパティの編集
データベース固有のプロパティを編集します。この操作は許可されません。
DGMGRL> EDIT INSTANCE 'north_sales1' ON DATABASE 'North_Sales' > SET PROPERTY 'LogXptMode'='SYNC'; Error: ORA-16586: cannot change database property with EDIT INSTANCE command Failed.
例3: Oracle RACデータベースのすべてのインスタンスのインスタンス固有のプロパティの変更
Oracle RACデータベースのすべてのインスタンスのインスタンス固有のプロパティを変更します。
DGMGRL> EDIT INSTANCE * ON DATABASE 'North_Sales' > SET PROPERTY LogArchiveTrace=4095;
例4: Oracle RAC遠隔同期のすべてのインスタンスのインスタンス固有プロパティの変更
Oracle RAC遠隔同期インスタンスのすべてのインスタンスのインスタンス固有プロパティの値を変更します。
DGMGRL> EDIT INSTANCE * ON FAR_SYNC 'dallas' SET PROPERTY LogArchiveTrace=4095;
7.29 EDIT INSTANCE RESET (プロパティ)
EDIT INSTANCE RESET
(プロパティ)コマンドは、指定されたインスタンスのインスタンス固有のプロパティを、そのデフォルト値にリセットします。
書式
EDIT INSTANCE { {instance-name [ON {DATABASE database-name | FAR_SYNC far-sync-name}] } | {* ON {DATABASE database-name | FAR_SYNC far-sync-name} } } RESET PROPERTY property-name;
コマンド・パラメータ
- instance-name
-
インスタンス固有のプロパティ値をデフォルトにリセットするインスタンスの名前(SID)。インスタンス名にアスタリスクが付いている場合、
ON DATABASE
句も指定する必要があります。このプロパティはそのデータベースに関連する各インスタンスのデフォルトにリセットされます。 - database-name
-
instance-name
が関連付けられているデータベースの名前。instance-name
にアスタリスクが付けられている場合、または構成内でinstance-name
が一意でない場合は、このパラメータを指定する必要があります。 - property-name
-
デフォルト値にリセットするインスタンス固有のプロパティの名前。
関連項目:
プロパティの詳細は、「ブローカ構成のメンバーの管理」および「Oracle Data Guard Brokerのプロパティ」を参照。
- value
-
新しいプロパティ値。
使用上の注意
-
instance-name
には、構成全体で一意の名前を指定できます。instance-name
が一意ではない場合、database-name
およびinstance-name
の両方を指定してインスタンスを完全に識別する必要があります。 -
このコマンドは、データベース固有のプロパティの変更には使用できません。
コマンドの例
例1: 特定のインスタンスのプロパティのリセット
次のコマンドは、South_Sales
という名前のデータベース上の、固有のインスタンスsouth1
について、LogArchiveTrace
プロパティをリセットする方法を表示します。
DGMGRL> EDIT INSTANCE 'south1' ON DATABASE 'South_Sales' > RESET PROPERTY LogArchiveTrace; Succeeded.
例2: データベースのすべてのインスタンスのプロパティのリセット
次の例は、South_Salesという名前のデータベースのすべてのインスタンスについてLogArchiveTraceプロパティをリセットする方法を、示しています。
DGMGRL> EDIT INSTANCE * ON DATABASE 'South_Sales' RESET PROPERTY LogArchiveTrace; Succeeded.
7.30 EDIT RECOVERY_APPLIANCE (プロパティ)
EDIT RECOVERY_APPLIANCE
(プロパティ)コマンドは、指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)のプロパティ値を変更します。
書式
EDIT object name SET PROPERTY property-name = value;
コマンド・パラメータ
- object name
-
プロパティ値を変更するリカバリ・アプライアンスの名前。
- property-name
-
既存のリカバリ・アプライアンス固有プロパティの名前。有効なプロパティは次のとおりです。
-
DGConnectIdentifier
-
LogXptMode
-
DelayMins
-
Binding
-
MaxFailure
-
MaxConnections
-
ReopenSecs
-
NetTimeout
-
RedoCompression
-
LogShipping
-
ArchiveLagTarget
-
LogArchiveMaxProcesses
-
LogArchiveMinSucceedDest
-
InconsistentProperties
-
InconsistentLogXptProps
-
AlternateLocation
-
- value
-
新しいプロパティ値。
コマンドの例
次の例は、構成可能なプロパティを編集する例を示しています。
DGMGRL> EDIT RECOVERY_APPLIANCE 'EnterpriseRecoveryAppliance' SET PROPERTY 'ReopenSecs'=300; Property "ReopenSecs" updated
7.31 EDIT RECOVERY_APPLIANCE (名前の変更)
EDIT RECOVERY_APPLIANCE
(名前の変更)コマンドは、ブローカ構成内の該当するリカバリ・アプライアンスのプロファイルに記録されているように、指定したリカバリ・アプライアンスを参照するためにブローカで使用する名前を変更します。
書式
EDIT RECOVERY_APPLIANCE object name RENAME TO new object name ;
使用上の注意
-
このコマンドを使用して、このリカバリ・アプライアンスの
DB_UNIQUE_NAME
初期化パラメータへの変更を追跡します。注意:
リカバリ・アプライアンスの名前は、そのリカバリ・アプライアンスの
DB_UNIQUE_NAME
初期化パラメータの値と常に一致する必要があります。
コマンドの例
次の例は、リカバリ・アプライアンスの編集および名前を変更する方法を示しています。
DGMGRL> EDIT RECOVERY_APPLIANCE 'EnterpriseRecoveryAppliance_typo' RENAME TO 'EnterpriseRecoveryAppliance'; Succeeded.
7.32 EDIT RECOVERY_APPLIANCE RESET (プロパティ)
EDIT RECOVERY_APPLIANCE RESET
(プロパティ)コマンドは、指定されたリカバリ・アプライアンスの指定されたプロパティを、そのデフォルト値にリセットします。
書式
EDIT RECOVERY_APPLIANCE object name RESET PROPERTY property-name ;
コマンド・パラメータ
コマンドの例
次の例は、South_Sales
という名前のリカバリ・アプライアンスのReopenSecs
プロパティをデフォルト値にリセットする方法を示しています。
DGMGRL> EDIT DATABASE 'South_Sales' RESET PROPERTY ReopenSecs; Succeeded.
7.33 ENABLE CONFIGURATION
ENABLE CONFIGURATION
コマンドは、すべてのデータベースを含むブローカ構成をブローカで管理できるようにします。
書式
ENABLE CONFIGURATION;
コマンド・パラメータ
なし。
使用上の注意
-
このコマンドを使用して、プライマリ・データベースのブローカ管理と構成のすべてのメンバーを有効にします(これらのメンバーが明示的に無効にされていない場合)。
-
このコマンドを発行するには、制御ファイルのロールがプライマリであるデータベースに接続する必要があります。
-
デフォルトでは、構成のデータベースのブローカ管理は、プライマリ・データベースでは
TRANSPORT-ON
状態で有効化され、REDO転送サービスがオンになり、スタンバイ・データベースではAPPLY-ON
状態で有効化され、ログ適用サービスが起動します。遠隔同期インスタンスは、REDOデータを受け取り、REDOデータを送信するように有効化されます。EDIT DATABASE(状態)コマンドを使用して任意のデータベースの状態を変更できますが、対象のデータベースまたは構成全体が無効になっている場合は変更できません。遠隔同期インスタンスの状態は変更できません。 -
構成に関する情報を表示するには、SHOW CONFIGURATIONコマンドを使用します。
-
フェイルオーバーまたはスイッチオーバーがDGMGRLやCloud ControlでなくSQL*Plusを使用して実行された場合、このコマンドを使用して、ブローカ構成に格納されているロールを更新します。
コマンドの例
次の例では、ブローカ構成の管理を有効化しています。
DGMGRL> ENABLE CONFIGURATION; Enabled.
7.34 ENABLE DATABASE
ENABLE DATABASE
コマンドは、指定したスタンバイ・データベースのブローカ管理を有効化します。
注意:
回復する必要があるスタンバイ・データベースでENABLE DATABASE
コマンドを発行しないでください。詳細は、「ロール変更後の無効化されたデータベースの再有効化」を参照してください。
書式
ENABLE DATABASE database-name;
使用上の注意
-
このコマンドを発行するには、プライマリ・データベースまたはすでに有効化されたスタンバイ・データベースに接続する必要があります。
-
前のフェイルオーバー操作またはスイッチオーバー操作の結果、ブローカによりスタンバイ・データベースが無効化されている場合があります。データベースを回復または再作成する方法を理解するには、「ロール変更後の無効化されたデータベースの再有効化」を参照してください。
-
デフォルトでは、フィジカルまたはロジカル・スタンバイ・データベースのブローカ管理は
APPLY-ON
状態で有効化され、ログ適用サービスが有効化されます。データベースが有効になっている場合にのみ、EDIT DATABASE(状態)コマンドを使用してスタンバイ・データベースの状態を変更できます。 -
構成に関する情報を表示するには、SHOW DATABASEコマンドを使用します。
-
Oracle RACデータベースの場合は、インスタンスを1つ起動してマウントすれば、このコマンドが正常に実行されます。
コマンドの例
次の例に、データベースSouth_Sales
を有効化する方法を示します。
DGMGRL> ENABLE DATABASE 'South_Sales'; Enabled.
7.36 ENABLE FAST_START FAILOVER
ENABLE FAST_START FAILOVER
コマンドは、プライマリ・データベースが消失した場合、手動による手順を必要とせずに、ブローカが具体的に選択されたスタンバイ・データベースにフェイルオーバーできるようにします。
詳細は、「ファスト・スタート・フェイルオーバーの有効化」を参照してください。
書式
ENABLE FAST_START FAILOVER;
コマンド・パラメータ
なし。
使用上の注意
-
このコマンドを発行してファスト・スタート・フェイルオーバーを有効化する前に、「ファスト・スタート・フェイルオーバーを有効化するための前提条件」で説明する前提条件を満たす必要があります。
-
ENABLE FAST_START FAILOVER
コマンドの発行により、フェイルオーバーが起動されることはありません。構成を監視しているオブザーバが、フェイルオーバーの条件が満たされた場合に、ファスト・スタート・フェイルオーバーを開始できるようにするだけです。 -
ブローカ構成のデータベースに接続されている間は、ファスト・スタート・フェイルオーバーを有効化できます。
-
ファスト・スタート・フェイルオーバーを有効化した後にオブザーバを開始しない場合、プライマリ・データベースとターゲットのスタンバイ・データベースに
ORA-16819
の警告が表示されます。次に例を示します。DGMGRL> SHOW DATABASE 'South_Sales'; Database - South_Sales Role: PRIMARY Intended State: TRANSPORT-ON Instance(s): south_sales1 Database Warning(s): ORA-16819: fast-start failover observer not started Database Status: WARNING
-
複数のスタンバイ・データベースを含むブローカ構成でファスト・スタート・フェイルオーバーを有効化する場合は、プライマリ・データベース上の
FastStartFailoverTarget
構成プロパティで1つ以上の実行可能なターゲット・スタンバイ・データベースを指定する必要があります。プライマリ・データベースおよびターゲット・スタンバイ・データベースの両方が次の条件を満たしている必要があります。-
スタンバイREDOログが構成されていること
-
REDO転送が、両方のデータベース上で、構成された保護モードに正しく構成されていること
また、プライマリ・データベースとスタンバイ・データベースの両方でフラッシュバック・データベースを有効化し、フェイルオーバー後に元のプライマリ・データベースの回復を許可することをお薦めします。有効化されていない場合、ファスト・スタート・フェイルオーバーを有効化すると警告が表示されます。
DGMGRL> enable fast_start failover; Warning: ORA-16827: Flashback Database is disabled
FastStartFailoverTarget
構成プロパティの詳細は、「ファスト・スタート・フェイルオーバーの有効化」のタスク2および「FastStartFailoverTarget」を参照してください。 -
-
ファスト・スタート・フェイルオーバーを有効化した後は、「ファスト・スタート・フェイルオーバーが有効化されている場合の制限事項」の説明にある制約に従う必要があります。
コマンドの例
例1: ファスト・スタート・フェイルオーバーの有効化
次の例では、ファスト・スタート・フェイルオーバーを有効化しています。
DGMGRL> ENABLE FAST_START FAILOVER; Enabled.
例2: ファスト・スタート・フェイルオーバーの有効化の成功例
次の例では、最大パフォーマンス・モードで動作している構成で、ファスト・スタート・フェイルオーバーが正常に有効化されました。
DGMGRL> SHOW FAST_START FAILOVER; Fast-Start Failover: ENABLED Threshold: 30 seconds Target: South_Sales Observer: (none) Lag Limit: 30 seconds Shutdown Primary: TRUE Auto-reinstate: TRUE Observer Reconnect: (none) Observer Override: FALSE Configurable Failover Conditions Health Conditions: Corrupted Controlfile YES Corrupted Dictionary YES Inaccessible Logfile NO Stuck Archiver NO Datafile Write Errors YES Oracle Error Conditions: (none)
7.37 ENABLE FAST_START FAILOVER CONDITION
ENABLE FAST_START FAILOVER CONDITION
コマンドは、ファスト・スタート・フェイルオーバーを実行する追加条件を指定します。
書式
ENABLE FAST_START FAILOVER CONDITION value;
コマンド・パラメータ
使用上の注意
-
表7-2に、データベース健全性チェック機能によって管理される健全性条件の例を示します。
-
指定された値が認識されていないか、条件がすでに設定されている場合、エラーは発生しません。
-
表7-2 健全性条件の例
健全性条件 説明 データファイル・オフライン
書込みエラーによってデータファイルがオフラインになりました。
Oracle Database 12cリリース2 (12.2.0.1)では、データファイル・オフライン健全性条件は、データファイル書込みエラー条件にかわりました。下位互換性の理由から、データファイル・オフライン条件は引き続き指定できます。
データファイル書込みエラー ファスト・スタート・フェイルオーバーが有効化され、データファイル書込みエラー条件が指定されている場合、任意のデータ・ファイル(一時ファイル、システム・データ・ファイル、UNDOファイルなど)で書込みエラーが発生すると、ファスト・スタート・フェイルオーバーが開始されます。 "破損した制御ファイル"
制御ファイルが破損しました。この条件はデフォルトで有効になっています。
"破損したディクショナリ"
重要なデータベース・オブジェクトのディクショナリが破損しました。この条件はデフォルトで有効になっています。
"アクセス不可能なログ・ファイル"
I/Oエラーにより、LGWRがログ・グループのどのメンバーにも書き込むことができません。
"スタック・アーカイバ"
デバイスに空き容量がないかデバイスを使用できないためにアーカイバがREDOログをアーカイブできません。
-
SHOW FAST_START FAILOVER
コマンドでこれらの構成可能な条件を表示できます。
コマンドの例
例1
次の例では、破損した制御ファイルが検出された場合、ファスト・スタート・フェイルオーバーを実行するように指定します。
ENABLE FAST_START FAILOVER CONDITION "Corrupted Controlfile";
例2
次の例では、ORA-00240エラーが発生した場合、ファスト・スタート・フェイルオーバーを実行するように指定します。
ENABLE FAST_START FAILOVER CONDITION 240;
例3
次の例では、データファイル書込みエラー条件を示す出力を表示します。
DGMGRL> ENABLE FAST_START FAILOVER CONDITION "Datafile Write Errors" Succeeded. DGMGRL> SHOW FAST_START FAILOVER Fast-Start Failover: DISABLED Threshold: 180 seconds Target: (none) Observer: (none) Lag Limit: 300 seconds Shutdown Primary: TRUE Auto-reinstate: TRUE Observer Reconnect: (none) Observer Override: FALSE Configurable Failover Conditions Health Conditions: Corrupted Controlfile YES Corrupted Dictionary YES Inaccessible Logfile NO Stuck Archiver NO Datafile Write Errors YES Oracle Error Conditions: (none)
7.38 ENABLE RECOVERY_APPLIANCE
ENABLE RECOVERY_APPLIANCE
コマンドは、指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)のブローカ管理を有効化します。
書式
ENABLE RECOVERY_APPLIANCE object name ;
使用上の注意
-
このコマンドを発行するには、プライマリ・データベースまたはすでに有効化されたスタンバイ・データベースに接続する必要があります。
-
SHOW RECOVERY_APPLIANCE
コマンドを使用すると、リカバリ・アプライアンスの情報が表示されます。
コマンドの例
次の例は、EnterpriseRecoveryAppliance
という名前のリカバリ・アプライアンスを有効にする方法を示しています。
DGMGRL> ENABLE RECOVERY_APPLIANCE 'EnterpriseRecoveryAppliance';Enabled.
7.39 EXIT
EXIT
コマンドは、ブローカのコマンドライン・インタフェースを終了します。
書式
EXIT;
コマンド・パラメータ
なし。
使用上の注意
-
このコマンドの効果は、QUITコマンドと同じです。
-
このコマンドの実行には、データベース接続は不要です。ただし、接続されている場合は、このコマンドにより接続が解除されます。
コマンドの例
次の例に、コマンドライン・インタフェースを終了する方法を示します。
DGMGRL> EXIT;
7.40 FAILOVER
FAILOVER
コマンドは、指定したターゲットのスタンバイ・データベースをプライマリ・データベースのロールに遷移するフェイルオーバーを開始します。
このタイプのフェイルオーバーは、手動フェイルオーバーと呼びます。詳細は、「手動フェイルオーバー」を参照してください。
注意:
フェイルオーバーを実行すると、スタンバイ・データベースがプライマリ・データベースのロールに遷移するため、フェイルオーバーは、プライマリ・データベースに障害が発生するか使用不可になり、適時にリカバリできない場合に実行してください。フェイルオーバーの結果、実行時に有効になっている保護モード、およびターゲット・スタンバイ・データベースがプライマリ・データベースと同期化されていたかどうかによっては、データが消失する場合があります。
プライマリ・データベースに障害がなく、データの消失なしに現在のプライマリ・データベースとスタンバイ・データベースのロールを切り替えるには、SWITCHOVER
コマンドを使用します。
書式
FAILOVER TO database-name [IMMEDIATE];
使用上の注意
-
ORA-752
またはORA-600
[3020]
エラーにより、フェイルオーバー・ターゲットでREDO Applyが停止されていないかぎり、常に完全フェイルオーバーを最初に実行するようにします。これらのエラーのいずれかが発生した場合は、先に進む前に、My Oracle Supportノート1265884.1 (http://support.oracle.com
)のスタンバイ・リカバリ時のORA-752またはORA-600 [3020]の解決のガイドラインに従います。即時フェイルオーバーは、完全フェイルオーバーが失敗するか、前述のエラーの場合にのみ実行してください。 -
指定したスタンバイ・データベースは、プライマリ・データベースに障害が発生する前に有効化されている必要があります。ただし、有効化されているスタンバイ・データベースが停止している場合は、フェイルオーバー操作の候補とみなすことができます。この場合は、DGMGRLの
STARTUP
コマンドを使用してスタンバイ・データベースを再起動してからFAILOVER
コマンドを発行します。 -
フェイルオーバーは、指定したスタンバイ・データベースに対して動作し、スタンバイ・データベースのロールがプライマリ・データベースのロールに変更されます。フェイルオーバーに関係しないその他のスタンバイ・データベースは、スタンバイ・ロールのままです。
-
FAILOVER
コマンドを発行する前に、新しいプライマリ・データベースになるスタンバイ・データベースに接続していることを確認します。必要な場合は、CONNECTコマンドを発行してフェイルオーバーするスタンバイ・データベースに接続します。 -
オプションを指定せずに
FAILOVER
コマンドを発行すると、フェイルオーバー・ターゲットとして選択したスタンバイ・データベースにより、プライマリ・ロールへの変更前に受信した未適用のREDOがすべて適用されます。これを完全フェイルオーバーと呼びます。 -
ブローカ構成が最大保護モードで動作している場合、手動フェイルオーバー操作を実行すると、保護モードが強制的に最大パフォーマンスに設定されます。REDO転送サービスの設定は影響を受けません。フェイルオーバー操作後に、構成に必要な保護モードをリストアする必要があります。
注意:
ファスト・スタート・フェイルオーバーの場合は、ブローカにより、フェイルオーバー前に有効になっていた保護モードが維持されます。
-
IMMEDIATE
オプションを指定してFAILOVER
コマンドを発行すると、受け取った未適用のREDOの適用は試行されません。このオプションを指定すると、スタンバイ・データベースでスタンバイREDOログ・ファイルが構成されている場合でも、アプリケーション・データが消失する可能性があります。また、構成内の他のスタンバイ・データベースは、回復または再作成されるまで機能しません。詳細は、「ロール変更後の無効化されたデータベースの再有効化」を参照してください。 -
手動フェイルオーバーを実行するか、ブローカをファスト・スタート・フェイルオーバーを実行するように設定できます。フェイルオーバーの条件が満たされた場合に、ブローカにより自動的にフェイルオーバーを起動させる方法については、ENABLE FAST_START FAILOVERコマンドを参照してください。
-
ファスト・スタート・フェイルオーバーが有効になっている場合は、完全手動フェイルオーバーを、ファスト・スタート・フェイルオーバーのターゲット・スタンバイ・データベースに対してのみ、そのスタンバイ・データベースがプライマリ・データベースと同期化されているかプライマリ・データベースのラグ制限内である場合にのみ、およびオブザーバーが開始されている場合にのみ実行できます。ファスト・スタート・フェイルオーバーが有効になっている場合に、即時手動フェイルオーバーは実行できません。
-
障害が発生した元のプライマリ・データベース上で、フェイルオーバーの前に「データベースをフラッシュバック」が有効化されていた場合は、ブローカの
REINSTATE
コマンド(REINSTATE DATABASEコマンドを参照)を使用して、そのプライマリ・データベースを回復できます。フィジカル・スタンバイ・データベースに対してフェイルオーバーが実行された場合は、そのスタンバイ・データベースで「データベースをフラッシュバック」が有効化されていて、使用可能なフラッシュバック・ログ情報が不足なくある場合にのみ、そのフェイルオーバーにより無効化されたその他のフィジカル・スタンバイ・データベースも回復できます。手順については、「ロール変更後の無効化されたデータベースの再有効化」を参照してください。
-
元のプライマリ・データベースは、回復または再作成後、スタンバイ・データベースとしてのみ構成に関係できます。
注意:
フェイルオーバー前にまだアクティブなインスタンスが実行されている場合は、元のプライマリ・データベースを停止してください。
関連項目:
プライマリ・データベースのスタンバイ・データベースとして機能するように、元のプライマリ・データベースを再有効化する方法については、「ロール変更後の無効化されたデータベースの再有効化」を参照してください
コマンドの例
次の例では、スタンバイ・データベースSouth_Sales
がプライマリ・ロールに遷移するフェイルオーバーを実行しています。
DGMGRL> FAILOVER TO 'South_Sales'; Performing failover NOW, please wait... Failover succeeded, new primary is "South_Sales" DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxPerformance Members: South_Sales - Primary database North_Sales - Physical standby database (disabled) ORA-16661: the standby database needs to be reinstated Fast-Start Failover: DISABLED Configuration Status: WARNING
7.41 HELP
DISPLAY
コマンドは、Data Guardコマンドライン・インタフェースのオンライン・ヘルプを表示します。
書式
HELP [command_name];
コマンド・パラメータ
- command_name
-
ヘルプ情報を表示するコマンド。コマンドを指定しない場合は、すべてのコマンドがリストされます。次のコマンドを使用できます。
@ Execute DGMGRL script file ! Host operating system command / Repeat the last command -- Comment to be ignored by DGMGRL add Adds a member to the broker configuration connect Connects to an Oracle database instance convert Converts a database from one type to another create Creates a broker configuration disable Disables a configuration, a member, or fast-start failover edit Edits a configuration or a member enable Enables a configuration, a member, or fast-start failover exit Exits the program failover Changes a standby database to be the primary database help Displays description and syntax for a command host Host operating system command migrate Migrate a pluggable database from one configuration to another. quit Exits the program reinstate Changes a database marked for reinstatement into a viable standby rem Comment to be ignored by DGMGRL remove Removes a configuration or a member set Set a property to a specified value show Displays information about a configuration or a member shutdown Shuts down a currently running Oracle database instance spool store input and output of DGMGRL CLI in a file sql Executes a SQL statement start Starts the fast-start failover observer startup Starts an Oracle database instance stop Stops the fast-start failover observer switchover Switches roles between a primary and standby database validate Performs an exhaustive set of validations for a database
個々のコマンドの構文を参照するには、
help
command_name
と入力します。
使用上の注意
-
このコマンドの実行には、データベース接続は不要です。
コマンドの例
次の例では、EDIT
コマンドのヘルプを取得しています。
DGMGRL> HELP EDIT
7.42 HOSTまたは! (感嘆符)
DGMGRLのHOST
コマンドおよび!コマンドでは、DGMGRLを離れることなく、DGMGRLコンソールから直接オペレーティング・システム・コマンドを実行できます。
HOST
コマンドと!コマンドには同じ機能があります。これにより、DGMGRLにログインしたままオペレーティング・システム・コマンドを発行できます。DGMGRLプロンプトがオペレーティング・システム・コマンドを受け入れるシェル・プロンプトになります。また、個別のオペレーティング・システム・コマンドをHOSTコマンドまたは!コマンド経由でDGMGRLに直接送信することもできます。
書式
HOST [command]
または
! [command]
使用上の注意
-
コマンドを指定せずに
HOST
とだけ入力すると、EXIT
コマンドを発行してDGMGRLコンソールに戻るまで、DGMGRLコンソールはオペレーティング・システムのシェル・プロンプトになります。 -
HOSTコマンドおよび!コマンドは、コマンドラインから入力された後続の内容すべてを、オペレーティング・システムのシェル・プロンプトへの入力として解釈します。次に示すコマンドの例2を参照してください。
コマンドの例
例1
次の例は、HOST
コマンドおよび!コマンドを使用し、DGMGRLコンソールで個別のオペレーティング・システム・コマンドを実行する方法を示しています。
DGMGRL> host date
Executing operating system command(s):" date"
Fri Oct 23 14:08:42 EDT 2015
DGMGRL>
DGMGRL> ! date
Executing operating system command(s):" date"
Fri Oct 23 14:09:20 EDT 2015
DGMGRL>
例2
次の例では、両方のDATE
コマンドをオペレーティング・システム・シェルで実行した後、制御がDGMGRLに戻ります。
DGMGRL> ! DATE;DATE;
Executing operating system command(s):" date;date;"
Fri Oct 23 14:11:40 EDT 2015
Fri Oct 23 14:11:40 EDT 2015
DGMGRL>
7.43 MIGRATE PLUGGABLE DATABASE
MIGRATE PLUGGABLE DATABASE
コマンドを使用すると、プラガブル・データベース(PDB)を1つのマルチテナント・コンテナ・データベース(CDB)から同じホスト上の別のCDBに移行できます。
あるプライマリCDBから別のプライマリCDBにPDB移行するか、スタンバイCDBからプライマリCDBにPDBをフェイルオーバーできます。MIGRATE PLUGGABLE DATABASE
コマンドには次の前提条件があります。
-
ソースCDBと同じファイル・パスでPDBデータ・ファイルにアクセスできるようにして、宛先CDBが作成および起動されている必要があります。
-
ソースCDBと宛先CDBは、それぞれ別々のData Guard Broker構成に含まれている必要があります。
-
ソースCDBはプライマリ・データベースまたはフィジカル・スタンバイ・データベースのどちらでもかまいません。
-
ソースCDBがフィジカル・スタンバイ・データベースの場合
-
ソースCDBと宛先CDBでOracleの同じバージョンおよびパッチが実行されている必要があります。
-
ソースCDBと宛先CDBの
COMPATIBLE
初期化パラメータに同じ設定が使用されている必要があります。 -
移行対象のPDBがそのプライマリCDB上でクローズされている必要があります。
-
PDBフェイルオーバーによってデータが消失する可能性がある場合は、
IMMEDIATE
オプションを使用して、フェイルオーバーの実行を明示的に選択する必要があります。
-
-
ソースCDBがプライマリ・データベースの場合
-
宛先CDBで古いバージョンのOracleは実行できません。
-
宛先CDBでは、
COMPATIBLE
初期化パラメータの設定をソースCDBよりも低い値に設定できません。
-
-
PDBのサービスを停止して、移行対象のソース・データベースのOracle Clusterwareリポジトリから削除する必要があります。これは、ソース・データベースのData Guard Broker構成内のすべてのデータベースに対して実行する必要があります。
-
宛先CDBがオープンしている必要があります。
-
ユーザーには、ソースCDBと宛先CDBの両方の
SYSDBA
権限が必要です。
書式
MIGRATE PLUGGABLE DATABASE [IMMEDIATE] pdb-name
TO CONTAINER dest-cdb-name
USING XML-description-file
[CONNECT AS { /@dest-cdb-connect-identifer | dest-cdb-user/dest-cdb-pass@dest-cdb-connect-identifer} ];
コマンド・パラメータ
- pdb-name
- 移行対象のPDBの名前。
- dest-cdb-name
- 移行対象のPDBを受け入れるCDBの一意のデータベース名。
- XML-description-file
- 移行対象のPDBの説明が含まれているXMLファイル。このファイルは、
MIGRATE PLUGGABLE DATABASE
コマンドで実行するSQL文によって自動的に作成されます。 - dest-cdb-user
- 宛先CDBへの
SYSDBA
アクセス権を持つユーザーのユーザー名。 - dest-cdb-pass
dest-cdb-user
に指定されているユーザー名に関連付けられたパスワード。- dest-cdb-connect-identifier
- 宛先CDBへの接続に使用するOracle Net接続識別子。
使用上の注意
-
デフォルトで、このコマンドをPDBフェイルオーバーで使用する場合、データを消失する可能性があると、フェイルオーバーの試行は拒否されます。
IMMEDIATE
オプションを使用して、このデフォルトの動作を上書きできます。 -
ソース・データベースがプライマリ・データベースの場合、
IMMEDIATE
オプションは無視されます。 -
接続識別子が指定されている場合、宛先CDBでのユーザー認証にはデータベース資格証明が使用されます。
-
オペレーティング・システム資格証明は、宛先CDBでのユーザー認証には使用できません。接続識別子を指定する必要があります。スラッシュ(/)はサポートされません。
-
スラッシュ(/)を使用して接続識別子が指定されている場合(例:
/@boston
)、資格証明はウォレットから取得されます。 -
接続文字列を指定する場合は、次のオプションを使用できます。
-
/@dest-cdb-connect-identifier
(資格証明はウォレットから取得されます) -
dest-cdb-user/dest-cdb-pass@dest-cdb-connect-identifier
(データベース資格証明を使用します)
-
-
パスワードがコマンドライン上に表示されないようにするには、接続識別子とユーザー名のみを指定します。次に、パスワードの入力を求められます。ユーザー名と接続識別子のみを入力する場合は、次のオプションがサポートされています。
-
dest-cdb-user@dest-cdb-connect-identifier
(データベース資格証明を使用) -
dest-cdb-user/@dest-cdb-connect-identifier
(データベース資格証明を使用)
-
-
コマンドラインから接続文字列をすべて省略すると、ユーザー名とパスワードを入力するように要求されます。次のオプションがサポートされています。
-
/@dest-cdb-connect-identifier
(パスワードは要求されず、資格証明はウォレットから取得されます) -
dest-cdb-user@dest-cdb-connect-identifier
(データベース資格証明を使用) -
dest-cdb-user/@dest-cdb-connect-identifier
(データベース資格証明を使用)
-
コマンドの例
例1: プライマリCDBからのPDBの移行
DGMGRL> MIGRATE PLUGGABLE DATABASE REGION1 TO CONTAINER NORTH_SALES_NEW USING REGION1.xml
CONNECT AS sys/mypassword@NORTH_SALES_NEW;
Connected to "NORTH_SALES_NEW"
Connected.
Beginning migration of pluggable database REGION1.
Source multitenant container database is NORTH_SALES.
Destination multitenant container database is NORTH_SALES_NEW.
Closing pluggable database REGION1 on all instances of multitenant container database NORTH_SALES.
Unplugging pluggable database REGION1 from multitenant container database NORTH_SALES.
Pluggable database description will be written to REGION1.xml.
Dropping pluggable database REGION1 from multitenant container database NORTH_SALES.
Creating pluggable database REGION1 on multitenant container database NORTH_SALES_NEW.
Opening pluggable database REGION1 on all instances of multitenant container database NORTH_SALES_NEW.
Succeeded.
例2: フィジカル・スタンバイからのPDBのフェイルオーバー
DGMGRL> MIGRATE PLUGGABLE DATABASE REGION1 TO CONTAINER SOUTH_SALES_NEW
USING REGION1.xml CONNECT AS sys/mypassword@SOUTH_SALES_NEW;
Connected to "SOUTH_SALES_NEW"
Connected.
Beginning migration of pluggable database REGION1.
Source multitenant container database is SOUTH_SALES.
Destination multitenant container database is SOUTH_SALES_NEW.
Continuing with migration of pluggable database REGION1 to multitenant container database SOUTH_SALES_NEW.
Stopping Redo Apply services on source multitenant container database SOUTH_SALES.
Succeeded.
Opening database SOUTH_SALES.
Opening pluggable database REGION1 on source multitenant container database SOUTH_SALES to prepare for migration.
Pluggable database description will be written to REGION1.xml.
Closing pluggable database REGION1 on all instances of multitenant container database SOUTH_SALES.
Disabling media recovery for pluggable database REGION1.
Closing database SOUTH_SALES.
Restarting redo apply services on source multitenant container database SOUTH_SALES.
Succeeded.
Creating pluggable database REGION1 on multitenant container database SOUTH_SALES_NEW.
Opening pluggable database REGION1 on all instances of multitenant container database SOUTH_SALES_NEW.
Unplugging pluggable database REGION1 from multitenant container database NORTH_SALES.
Dropping pluggable database REGION1 from multitenant container database NORTH_SALES.
Succeeded.
7.44 QUIT
QUIT
コマンドは、Data Guardコマンドライン・インタフェースを終了します。
書式
QUIT;
コマンド・パラメータ
なし。
使用上の注意
-
このコマンドの効果は、EXITコマンドと同じです。
-
このコマンドの実行には、データベース接続は不要です。ただし、接続されている場合は、このコマンドにより接続が解除されます。
コマンドの例
次の例に、コマンドライン・インタフェースを終了する方法を示します。
DGMGRL> QUIT;
7.45 REINSTATE DATABASE
REINSTATE DATABASE
コマンドは、ブローカ構成内で、データベースを現在のプライマリ・データベースの新規スタンバイ・データベースとして回復します。
書式
REINSTATE DATABASE database-name;
使用上の注意
-
「ブローカ構成に含まれる元のプライマリ・データベースの回復」で説明する回復の条件が満たされていない場合、回復処理は失敗し、対応するエラー・ステータスが表示され、指定されたデータベースは無効なままになります。
-
database-name
に、元のプライマリの名前が指定され、ファスト・スタート・フェイルオーバーが有効化されている場合、元のプライマリ・データベースは、新規プライマリ・データベースのスタンバイとして回復し、ファスト・スタート・フェイルオーバー環境は、新規スタンバイ・データベースの可用性を反映して更新されます。新規スタンバイ・データベースは、新規プライマリ・データベースに障害が発生した場合、新規プライマリ・データベースからREDOデータを受け取り、ファスト・スタート・フェイルオーバーのターゲットとなります。FastStartFailoverAutoReinstate
構成プロパティがFALSE
に設定されている場合を除き、オブザーバが実行中であれば自動的に回復が実行されます。 -
このコマンドでは、ファスト・スタート・フェイルオーバーが有効化されている必要はありません。このコマンドは、完全手動フェイルオーバーが実行された後、元のプライマリ・データベースを回復する場合に使用できます。完全または即時フェイルオーバー後に無効化されたその他のスタンバイ・データベースを回復するために使用することもできます。
-
このコマンドは、ブローカ構成内で回復させるデータベース以外のデータベースに接続されている場合に発行します。
コマンドの例
次の例に、North_Sales
データベースを、ブローカ構成のスタンバイ・データベースとして回復させる方法を示します。
DGMGRL> REINSTATE DATABASE 'North_Sales'; Reinstating database "North_Sales", please wait... Reinstatement of database "North_Sales" succeeded
7.46 REMOVE CONFIGURATION
REMOVE CONFIGURATION
コマンドは、Oracle Data Guard Broker構成を削除し、構成内のすべてのメンバーのブローカ管理を終了します。
書式
REMOVE CONFIGURATION [ PRESERVE DESTINATIONS ];
コマンド・パラメータ
なし。
使用上の注意
-
デフォルトでは、このコマンドを実行すると、プライマリ・データベースの
LOG_ARCHIVE_DEST_
n
初期化パラメータと構成内の全メンバーのLOG_ARCHIVE_CONFIG
初期化パラメータから、対応するブローカ設定が削除されます。これらの設定を保持するには、PRESERVE DESTINATIONS
オプションを使用します。 -
このコマンドでは、基礎となるOracle Data Guard構成の実際のプライマリまたはスタンバイ・データベース・インスタンス、データベース、遠隔同期インスタンス、データ・ファイル、制御ファイル、初期化パラメータ・ファイル、サーバー・パラメータ・ファイルまたはログ・ファイルは削除されず、影響を受けません。
-
ファスト・スタート・フェイルオーバーが有効化されている場合は、その構成を削除できません。
コマンドの例
次の例では、REMOVE CONFIGURATION
コマンドの成功例と失敗例を示します。
例1
次のコマンドは、構成ファイルから構成情報を削除する方法を示します。
DGMGRL> REMOVE CONFIGURATION; Removed configuration DGMGRL> SHOW CONFIGURATION; Error: ORA-16532: Data Guard broker configuration does not exist Configuration details cannot be determined by DGMGRL
例2
次のコマンドは、ファスト・スタート・フェイルオーバーが有効になっているために失敗しています。
DGMGRL> REMOVE CONFIGURATION; Error: ORA-16654: fast-start failover is enabled Failed. DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxAvailability Members: North_Sales - Primary database South_Sales - (*) Physical standby database Fast-Start Failover: ENABLED Configuration status: SUCCESS
7.47 REMOVE DATABASE
REMOVE DATABASE
コマンドは、指定したスタンバイ・データベースをブローカ構成から削除し、そのスタンバイ・データベースのブローカ管理を終了します。
書式
REMOVE DATABASE database-name [ PRESERVE DESTINATIONS ];
使用上の注意
-
ブローカ構成に含まれるプライマリ・データベースの名前を指定すると、エラーが戻されます。
-
デフォルトで、このコマンドは、構成の各メンバーにおける、すべてのREDO転送初期化パラメータから、指定されたデータベースへのすべての参照を削除します。これらの設定を保持するには、
PRESERVE DESTINATIONS
オプションを使用します。 -
このコマンドは、ファスト・スタート・フェイルオーバーが有効になっている場合は実行できません。また、database-nameには、ターゲットのスタンバイ・データベースの名前を指定します。
コマンドの例
次の例に、Oracle Data Guard Broker構成からデータベースを削除する方法を示します。
DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxPerformance Members: North_Sales - Primary database South_Sales - Physical standby database Fast-Start Failover: DISABLED Configuration status: SUCCESS DGMGRL> REMOVE DATABASE 'South_Sales'; Removed database "South_Sales" from the configuration. Configuration - DRSolution Protection Mode: MaxPerformance Members: North_Sales - Primary database Fast-Start Failover: DISABLED Configuration status: SUCCESS
7.48 REMOVE FAR_SYNC
REMOVE FAR SYNC
コマンドは、遠隔同期インスタンスをOracle Data Guard Broker構成から削除します。
書式
REMOVE FAR_SYNC far_sync_instance_name;
コマンド・パラメータ
使用上の注意
-
RedoRoutes
プロパティが設定されている遠隔同期インスタンスは、削除できません。
コマンドの例
次の例は、dallas
という名前の遠隔同期インスタンスをブローカ構成から削除します。
DGMGRL> REMOVE FAR_SYNC 'dallas';
7.49 REMOVE INSTANCE
REMOVE INSTANCE
コマンドは、指定したインスタンスをブローカ構成から削除します。
書式
REMOVE INSTANCE instance-name [ON { DATABASE | FAR_SYNC } object-name];
コマンド・パラメータ
使用上の注意
-
開始されたインスタンスは、ブローカにより自動的にブローカ構成に追加されます。ただし、インスタンスはデータベース・プロファイルから自動的に削除されません。
REMOVE
INSTANCE
コマンドを使用すると、存在しなくなったインスタンスを構成から手動で削除できます。 -
instance-name
が構成内で一意ではない場合、database-nameまたはfar sync-nameとinstance-nameの両方を指定してインスタンスを完全に識別する必要があります。 -
ブローカ構成内で現在アクティブなインスタンスの場合は、このコマンドが拒否されます。
-
現在そのインスタンスのみがデータベースまたは遠隔同期に関連付けられている場合、このコマンドは拒否されます。
コマンドの例
次の例に、データベースのインスタンスを削除する方法を示します。
DGMGRL> REMOVE INSTANCE 'south_sales3' ON DATABASE 'South_Sales'; Removed instance "south_sales3" from the database "South_Sales"
7.50 REMOVE RECOVERY_APPLIANCE
REMOVE RECOVERY_APPLIANCE
コマンドは、指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)をブローカ構成から削除し、そのリカバリ・アプライアンスのブローカ管理を終了します。
注意:
REMOVE RECOVERY_APPLIANCE
コマンドを使用すると、リカバリ・アプライアンスのプロファイル情報がブローカ構成ファイルから削除され、リカバリできません。
書式
REMOVE RECOVERY_APPLIANCE object-name [ PRESERVE DESTINATIONS ];
使用上の注意
-
デフォルトでは、このコマンドを実行すると、リカバリ・アプライアンスにREDOデータを送信していたデータベースの
LOG_ARCHIVE_DEST_n
初期化パラメータと構成内の全データベースのLOG_ARCHIVE_CONFIG
初期化パラメータから、対応するブローカ設定が削除されます。これらの設定を保持するには、PRESERVE DESTINATIONS
オプションを使用します。
コマンドの例
次の例は、Data Guard Broker構成からリカバリ・アプライアンスを削除する方法を示しています。
DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxPerformance Members: North_Sales - Primary database South_Sales - Physical standby database EnterpriseRecoveryAppliance - Oracle Backup Appliance Fast-Start Failover: DISABLED Configuration status: SUCCESS DGMGRL> REMOVE RECOVERY_APPLIANCE 'EnterpriseRecoveryAppliance'; Removed Oracle Backup Appliance "EnterpriseRecoveryAppliance" from the configuration. DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxPerformance Members: North_Sales - Primary database South_Sales - Physical standby database Fast-Start Failover: DISABLED Configuration status: SUCCESS
7.51 SET MASTEROBSERVER TO
SET MASTEROBSERVER TO
コマンドを使用すると、どのオブザーバをマスター・オブザーバとして認識するか、手動で変更できます。
SET MASTEROBSERVER TO
コマンドを使用して、どのオブザーバをマスターとして使用するか、手動で指定します。
書式
SET MASTEROBSERVER TO observer_name
使用上の注意
-
指定されたオブザーバ名が存在しない場合は、エラー・メッセージが返され、マスター・オブザーバは変更されません
-
このコマンドが発行された場合、実際に切替えが発生するのは、プライマリがターゲット・スタンバイと次回通信したとき(ファスト・スタート・フェイルオーバーが有効化されている場合、通常は3秒以内)です。
SHOW OBSERVER
コマンドを使用して、切替えが実行されたことを確認してください。 -
手動設定を正常に行うには、ファスト・スタート・フェイルオーバーの次回ping時に、次の条件を満たしている必要があります。
-
ターゲット・スタンバイが有効化されていて、回復の必要がないこと。
-
ロール変更、回復またはファスト・スタート・フェイルオーバー・ターゲットの切替えが進行中でないこと
-
コマンドの例
次に、新しいオブザーバをマスターに指定する例を示します。
DGMGRL> SET MASTEROBSERVER TO boston-obsever;
Succeeded.
7.52 SET MASTEROBSERVERHOSTS
SET MASTEROBSERVERHOSTS
コマンドは、ブローカ構成のマスター・オブザーバをターゲット・ホスト上のオブザーバに設定します。
指定したグループ内の各ブローカ構成に、ターゲット・ホスト上で動作しているバックアップ・オブザーバがある場合、このブローカ構成のマスター・オブザーバをターゲット・ホスト上のオブザーバに設定します。
書式
SET MASTEROBSERVERHOSTS {FOR cfg_group_name} TO host-name;
コマンド・パラメータ
使用上の注意
-
cfg_group_nameが指定されていない場合、このコマンドを実行すると、オブザーバ構成ファイルに定義されているすべてのブローカ構成について、指定されたホストへのマスター・オブザーバの切替えが試行されます。
-
cfg_group_nameにキーワード
ALL
は使用できません。 -
実際の切替えは、各ブローカ構成内でプライマリがターゲット・スタンバイと次回通信するまで実行されません(ファスト・スタート・フェイルオーバーが有効化されている場合、通常は3秒以内です)。
SHOW OBSERVERS
コマンドを使用して、切替えが実行されたことを確認してください。
コマンドの例
DGMGRL > SET MASTEROBSERVERHOSTS FOR GRP_A TO dgnet0;
7.53 SET ObserverConfigFile
SET ObserverConfigFile
コマンドは、オブザーバ構成ファイルのフルパスとファイル名を設定します。
オブザーバ構成ファイルには、管理対象の構成に関する情報が格納されています。コマンドSTART OBSERVING
、STOP OBSERVING
およびSHOW OBSERVERS
は、このコマンドで指定されたファイルから、ブローカ構成グループに関する情報を読み取ります。
書式
SET ObserverConfigFile = filename
使用上の注意
-
ObserverConfigFile
はDGMGRLのランタイム・プロパティです。ブローカ構成メタデータには存在せず、ディスクにも保持されません。オブザーバ構成ファイルの名前がobserver.oraでないか、現在の作業ディレクトリ内に存在しない場合は、新しいDGMGRLクライアントを起動するたびに名前を指定する必要があります。 -
プロパティ
ObserverConfigFile
のデフォルト値はobserver.ora
で、デフォルトの場所は作業ディレクトリ内です。 -
このコマンドの発行時、指定のファイルが存在しないか、そのファイルの内容が無効である場合でも、構成ファイルの名前は変更されます。
コマンドの例
DGMGRL> SET ObserverConfigFile = /usr/oracle/observer.ora
7.54 SET TIME
DGMGRLのSET TIME
コマンドは、タイムスタンプ出力のオン/オフを切り替えます。
タイムスタンプ出力機能は、ユーザーがDGMGRLプロンプトで各コマンドを入力したときのタイムスタンプを記録します。この情報は、DGMGRLコンソールの入出力の分析に役立つ場合があります。
書式
SET TIME [ON | OFF];
使用上の注意
-
なし
コマンドの例
DGMGRL> SET TIME ON;
07/11/2016 09:28:21 DGMGRL> SHOW CONFIGURATION;
Configuration - DRSolution
Protection Mode: MaxPerformance
Members:
North_Sales - Primary database
South_Sales - Physical standby database
Fast-Start Failover: DISABLED
Configuration Status:
SUCCESS
07/11/2016 09:28:24 DGMGRL> SET TIME OFF;
DGMGRL>
7.55 SHOW CONFIGURATION
SHOW CONFIGURATION
コマンドは、ブローカ構成のサマリーおよびステータスを表示します。
サマリーには、ブローカ構成に含まれるすべてのメンバーと、ファスト・スタート・フェイルオーバーのステータスなど、ブローカ構成自体に関するその他の情報が表示されます。
書式
SHOW CONFIGURATION [VERBOSE | property-name];
コマンド・パラメータ
- property-name
-
サマリー情報を表示するプロパティの名前。
プロパティの詳細は、「Oracle Data Guard Brokerのプロパティ」を参照してください。
使用上の注意
-
ファスト・スタート・フェイルオーバーに関連するプロパティを表示するには、
SHOW CONFIGURATION VERBOSE
コマンド(またはSHOW FAST_START FAILOVER
コマンド)を使用します。 -
VERBOSE
またはproperty-name
のどちらかをオプションで指定できますが、両方指定することはできません。 -
SHOW
CONFIGURATION
コマンドを使用すると、最後に健全性が評価された時点での構成およびそのメンバーのステータスが表示されます。(構成およびそのメンバーの健全性は毎秒1回評価されます。)VERBOSE
キーワードを指定すると、健全性情報が表示される前に、構成およびそのメンバーの健全性評価が即時に実行されます。 -
PL/SQLパッケージ
DBMS_ROLLING
を使用したローリング・アップグレードの実行時に、SHOW CONFIGURATION
コマンドは、アップグレード・ターゲットのロールとしてTransient logical standby database
、構成ステータスとしてROLLING DATABASE MAINTENANCE IN PROGRESS
を示します。例3を参照してください。 -
ファスト・スタート・フェイルオーバーが有効化されている場合、現在のファスト・スタート・フェイルオーバー・ターゲットはアスタリスク(*)で強調表示されます
コマンドの例
例1: DRSolution構成のサマリーの表示
次の例では、ファスト・スタート・フェイルオーバーが無効化されているDRSolution
構成のサマリーを表示しています。出力に、ブローカ構成内のFS
という名前の遠隔同期インスタンスが示されています。North_Sales
データベースはFS
に、FS
はSouth_Sales
にデータを送信しています。
DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxAvailability Members: North_Sales - Primary database FS- Far sync instance South_Sales- Physical standby database Fast-Start Failover: DISABLED Configuration Status: SUCCESS (status updated 20 seconds ago)
例2: DRSolution構成の詳細な説明の表示
次の例では、DRSolution構成の詳細な情報を、構成プロパティ、ファスト・スタート・フェイルオーバー関連の情報を含めて表示しています。
DGMGRL> SHOW CONFIGURATION VERBOSE; Configuration - DRSolution Protection Mode: MaxAvailability Members: North_Sales - Primary database FS- Far sync instance South_Sales- (*) Physical standby database (*) Fast-Start Failover target Properties: FastStartFailoverThreshold = '30' OperationTimeout = '30' TraceLevel = 'USER' FastStartFailoverLagLimit = '30' CommunicationTimeout = '180' ObserverReconnect = '0' FastStartFailoverAutoReinstate = 'TRUE' FastStartFailoverPmyShutdown = 'TRUE' BystandersFollowRoleChange = 'ALL' ObserverOverride = 'FALSE' ExternalDestination1 = '' ExternalDestination2 = '' PrimaryLostWriteAction = 'CONTINUE' ConfigurationWideServiceName = 'North_Sales_CFG' Fast-Start Failover: ENABLED Threshold: 30 seconds Target: South_Sales Observer: observer.example.com Lag Limit: 30 seconds (not in use) Shutdown Primary: TRUE Auto-reinstate: TRUE Observer Reconnect: (none) Observer Override: FALSE Configuration Status: WARNING
例3: DBMS_ROLLINGパッケージを使用したローリング・アップグレード実行時の出力例
Configuration - DRSolution
Protection Mode: MaxPerformance
Members:
North_Sales - Primary database
South_Sales - Transient logical standby database
Fast-Start Failover: DISABLED
Configuration Status:
ROLLING DATABASE MAINTENANCE IN PROGRESS
7.56 SHOW CONFIGURATION WHEN PRIMARY IS
SHOW CONFIGURATION WHEN PRIMARY IS
コマンドは、指定したデータベースがプライマリ・データベースであった場合に有効になるREDO転送構成を表示します。
すべてのメンバーが表示されますが、SHOW
CONFIGURATION
とは異なり、ステータス情報やその他の構成情報は表示されません。
書式
SHOW CONFIGURATION WHEN PRIMARY IS database-name;
使用上の注意
-
SHOW
CONFIGURATION
WHEN
PRIMARY
IS
コマンドを使用すると、指定したデータベースがプライマリ・データベースであった場合に有効になるREDO転送構成が表示されます。この情報を使用して、ロール変更の後に不適切になるREDO転送構成があれば事前に特定できます。
コマンドの例
次の例に、South_Sales
データベースに対するロール変更の前後のDRSolution
構成のサマリーを示します。
DGMGRL> SHOW CONFIGURATION; Configuration - DRSolution Protection Mode: MaxAvailability Members: North_Sales - Primary database North_FS - Far Sync South_Sales - Physical standby database Members Not Receiving Redo: South_FS - Far Sync Fast-Start Failover: DISABLED Configuration Status: SUCCESS DGMGRL> SHOW CONFIGURATION WHEN PRIMARY IS 'South_Sales'; Configuration when South_Sales is primary - DRSolution Members: South_Sales - Primary database South_FS - Far Sync North_Sales - Physical standby database Members Not Receiving Redo: North_FS - Far Sync
これらの表示は、各メンバーに対して次のように設定されているRedoRoutes
プロパティに基づいています。
DGMGRL> SHOW DATABASE 'North_Sales' RedoRoutes; RedoRoutes = '(LOCAL : North_FS)' DGMGRL> SHOW FAR_SYNC 'North_FS' RedoRoutes; RedoRoutes = '(North_Sales : South_Sales)' DGMGRL> SHOW DATABASE 'South_Sales' RedoRoutes; RedoRoutes = '(LOCAL : South_FS)' DGMGRL> SHOW FAR_SYNC 'South_FS' RedoRoutes; RedoRoutes = '(South_Sales : North_Sales)'
7.57 SHOW DATABASE
SHOW DATABASE
コマンドは、指定したデータベースとそのインスタンスに関する情報またはプロパティ値を表示します。
書式
SHOW DATABASE [VERBOSE]database-name [property-name];
コマンド・パラメータ
- database-name
-
情報を表示するデータベースの名前。
VERBOSE
キーワードを使用する場合は、database-name
の前に指定する必要があります。そうしないとエラーが戻ります。 - property-name
-
値を表示するプロパティの名前。プロパティ名を指定すると、
VERBOSE
キーワードを指定したかどうかにかかわらず、出力には指定したプロパティのみ(データベースのすべてのプロパティではなく)が表示されます。関連項目:
プロパティの詳細は、「ブローカ構成のメンバーの管理」および「Oracle Data Guard Brokerのプロパティ」を参照。
使用上の注意
-
SHOW DATABASE
コマンドを使用すると、データベースの簡潔なサマリーが表示されます。SHOW DATABASE VERBOSE
コマンドを使用すると、簡潔なサマリーに加えてデータベースのプロパティが表示されます。データベースのステータスは、どちらのコマンドでも表示されます。 -
SHOW DATABASE VERBOSE
コマンドは、Oracleアラート・ログ・ファイルとブローカ・ログ・ファイルの場所を表示します。ブローカ・ログ・ファイルは、アラート・ログと同じディレクトリに作成され、drc<$ORACLE_SID>.log
という名前が付けられます。 -
SHOW DATABASE VERBOSE
コマンドを使用すると、データベース固有のプロパティとインスタンス固有のプロパティが表示されます。非Oracle RACデータベースの場合、インスタンス固有のプロパティの値は、データベースの唯一のインスタンスの値です。Oracle RACデータベースの場合、プロパティ名は表示されますが、インスタンス固有のプロパティの値は表示されません。これらのプロパティについてインスタンス固有の値を表示するには、SHOW INSTANCE
コマンドを使用します。 -
SHOW DATABASE VERBOSE
コマンドで表示されるプロパティは、データベース・ロールと構成の内容によって異なります。-
プライマリ・データベースの場合は、構成に少なくとも1つのフィジカルまたはスナップショット・スタンバイ・データベースが含まれている場合にのみ、フィジカルまたはスナップショット・スタンバイ・データベース固有のプロパティが表示されます。ロジカル・スタンバイ・データベース固有のプロパティは、構成に少なくとも1つロジカル・スタンバイ・データベースが含まれている場合にのみ表示されます。
-
フィジカルおよびスナップショット・スタンバイ・データベースの場合、ロジカル・スタンバイ・データベース固有のプロパティは表示されません。
-
ロジカル・スタンバイ・データベースの場合、フィジカルおよびスナップショット・スタンバイ・データベース固有のプロパティは表示されません。
-
-
Oracle RACデータベースのインスタンス固有のプロパティを表示するために
SHOW DATABASE
database-name property-name
コマンドを使用すると、このコマンドは拒否されます。 -
PL/SQLパッケージ
DBMS_ROLLING
を使用したローリング・アップグレードの実行時に、SHOW DATABASE
コマンドは、アップグレード・ターゲットおよび後続または先行スタンバイに対して、現在のローリング・アップグレードの進行に応じてWARNING
を該当するORA
エラーとともに示します。例3を参照してください。
コマンドの例
例1: 簡略形式でのデータベース情報の表示
この例では、データベース情報を簡略形式で表示します。
DGMGRL> SHOW DATABASE South_Sales;
Database - South_Sales
Role: PHYSICAL STANDBY
Intended State: APPLY-ON
Transport Lag: (unknown)
Apply Lag: 0 seconds (computed 0 seconds ago)
Apply Rate: 1.73 MByte/s
Real Time Query: OFF
Instance(s):
south_sales1
Database Status:
SUCCESS
例2: 拡張形式でのデータベース情報の表示
この例では、データベース情報を拡張形式で表示します。
DGMGRL> SHOW DATABASE VERBOSE 'North_Sales';
Database - North_Sales
Role: PRIMARY
Intended State: TRANSPORT-ON
Instance(s):
c0
Properties:
DGConnectIdentifier = 'North_Sales.example.com'
ObserverConnectIdentifier = ''
LogXptMode = 'ASYNC'
RedoRoutes = ''
DelayMins = '0'
Binding = 'optional'
MaxFailure = '0'
MaxConnections = '1'
ReopenSecs = '300'
NetTimeout = '30'
RedoCompression = 'DISABLE'
LogShipping = 'ON'
PreferredApplyInstance = ''
ApplyInstanceTimeout = '0'
ApplyLagThreshold = '0'
TransportLagThreshold = '0'
TransportDisconnectedThreshold = '0'
ApplyParallel = 'AUTO'
ApplyInstances = '0'
StandbyFileManagement = 'AUTO'
ArchiveLagTarget = '0'
LogArchiveMaxProcesses = '5'
LogArchiveMinSucceedDest = '1'
DataGuardSyncLatency = '0'
DbFileNameConvert = 'dbs/cdb2_, dbs/cdb1_, dbs/bt, dbs/t, dbs/cdb4_, dbs/cdb1_, dbs/dt, dbs/t'
LogFileNameConvert = 'dbs/cdb2_, dbs/cdb1_, dbs/bt, dbs/t, dbs/cdb4_, dbs/cdb1_, dbs/dt, dbs/t'
FastStartFailoverTarget = ''
InconsistentProperties = '(monitor)'
InconsistentLogXptProps = '(monitor)'
SendQEntries = '(monitor)'
LogXptStatus = '(monitor)'
RecvQEntries = '(monitor)'
PreferredObserverHosts = ''
StaticConnectIdentifier = '(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)
(HOST=North_Sales.example.com)(PORT=2840))
(CONNECT_DATA=(SERVICE_NAME=North_Sales_DGMGRL.example.com)
(INSTANCE_NAME=north_sales1)(SERVER=DEDICATED)))'
StandbyArchiveLocation = 'USE_DB_RECOVERY_FILE_DEST'
AlternateLocation = ''
LogArchiveTrace = 255
LogArchiveFormat = 'db1r_%d_%t_%s_%R.arc'
TopWaitEvents = '(monitor)'
Log file locations:
Alert log : /dev/oracle/log/diag/rdbms/North_Sales/north1/trace/alert_north1.log
Data Guard Broker log : /dev/oracle/log/diag/rdbms/North_Sales/north1/trace/drcnorth1.log
Database Status:
SUCCESS
例3: DBMS_ROLLINGパッケージを使用したローリング・アップグレード実行時のターゲット・データベースの出力例
DGMGRL> SHOW DATABASE South_Sales;
Database - South_Sales
Role: Physical standby database
Intended State: APPLY-ON
Transport Lag: ***
Apply Lag: ***
Average Apply Rate: ***
Real Time Query: OFF
Instance(s):
South
Database Warning(s):
ORA-16866: database converted to transient logical standby database for rolling database maintenance
Database Status:
WARNING
例4: DBMS_ROLLINGパッケージを使用したローリング・アップグレード実行時の先行スタンバイの出力例
DGMGRL> SHOW DATABASE South_Sales;
Database - South_Sales
Role: Physical standby database
Intended State: APPLY-ON
Transport Lag: 0 seconds (computed 0 seconds ago)
Apply Lag: 0 seconds (computed 0 seconds ago)
Average Apply Rate: 510.00 KByte/s
Real Time Query: OFF
Instance(s):
South
Database Warning(s):
ORA-16881: standby database is not protecting the current primary database during rolling database maintenance
Database Status:
WARNING
7.58 SHOW FAR_SYNC
SHOW FAR_SYNC
コマンドは、遠隔同期インスタンスに関する情報を表示します。
書式
SHOW FAR_SYNC [VERBOSE] far_sync_instance_name [property-name];
コマンド・パラメータ
- far_sync_instance_name
-
ブローカが情報を表示する遠隔同期インスタンスの名前。この名前は、対応するデータベースの
DB_UNIQUE_NAME
初期化パラメータの値と一致する(大/小文字は区別されません)必要があります。 - property-name
-
値を表示するプロパティの名前。プロパティ名を指定すると、
VERBOSE
キーワードを指定したかどうかにかかわらず、出力には(遠隔同期のすべてのプロパティではなく)指定したプロパティのみが表示されます。関連項目:
プロパティの詳細は、「ブローカ構成のメンバーの管理」および「Oracle Data Guard Brokerのプロパティ」を参照。
コマンドの例
例1: SHOW FAR_SYNCの出力例(VERBOSEの指定なし)
次の例は、このコマンドからのサンプル出力を示しています。
DGMGRL> SHOW FAR_SYNC FS; Far Sync - FS Transport Lag: 0 seconds (computed 1 second ago) Instance(s): fs1 Far Sync Status: SUCCESS
例2: SHOW FAR SYNCの出力例(VERBOSEの指定あり)
次の例は、VERBOSE
オプションが使用された場合の、このコマンドからのサンプル出力を示しています。
DGMGRL> SHOW FAR_SYNC VERBOSE FS; Far Sync - FS Transport Lag: 0 seconds (computed 0 seconds ago) Instance(s): b02 Properties: DGConnectIdentifier = 'fs.example.com' LogXptMode = 'sync' RedoRoutes = '(North_Sales : South_Sales) (South_Sales : North_Sales)' Binding = 'optional' MaxFailure = '0' MaxConnections = '1' ReopenSecs = '300' NetTimeout = '30' RedoCompression = 'DISABLE' LogShipping = 'ON' TransportLagThreshold = '0' TransportDisconnectedThreshold = '0' ArchiveLagTarget = '0' LogArchiveMaxProcesses = '5' LogArchiveMinSucceedDest = '1' InconsistentProperties = '(monitor)' InconsistentLogXptProps = '(monitor)' LogXptStatus = '(monitor)' StaticConnectIdentifier = '(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp) (HOST=fs.example.com)(PORT=2202)) (CONNECT_DATA=(SERVICE_NAME=FS_DGMGRL.example.com) (INSTANCE_NAME=fs1)(SERVER=DEDICATED)))' StandbyArchiveLocation = 'USE_DB_RECOVERY_FILE_DEST' AlternateLocation = '' LogArchiveTrace = '255' LogArchiveFormat = 'db2r_%d_%t_%s_%R.arc' TopWaitEvents = '(monitor)' Far Sync Status: SUCCESS
7.59 SHOW FAST_START FAILOVER
SHOW FAST_START FAILOVER
コマンドは、すべてのファスト・スタート・フェイルオーバー関連情報を表示します。
複数の登録済オブザーバが動作している場合、このコマンドの出力にはすべての登録済オブザーバが表示され、マスター・オブザーバがアスタリスクで示されます。オブザーバのホスト名以外の情報も表示するには、SHOW OBSERVER
コマンドを使用します。
書式
SHOW FAST_START FAILOVER;
コマンド・パラメータ
なし。
使用上の注意
-
SHOW FAST_START FAILOVER
コマンドは、ファスト・スタート・フェイルオーバー構成のサマリーを表示します。 -
ファスト・スタート・フェイルオーバーの現行ターゲットとターゲット候補が表示されます。プライマリ・データベースの
FastStartFailoverTarget
プロパティがANY
に設定されている場合、ターゲット候補には、有効な保護モードに対して適切に構成されているスタンバイ・データベースが含まれます。
コマンドの例
例1: この例は、動作中の登録済オブザーバが1つのみで、ターゲット候補が複数ある場合の出力を示しています。
DGMGRL> SHOW FAST_START FAILOVER; Fast-Start Failover: ENABLED Threshold: 30 seconds Target: South_Sales Candidate Targets: East_Sales, West_Sales Observer: observer.example.com Lag Limit: 30 seconds (not in use) Shutdown Primary: TRUE Auto-reinstate: TRUE Observer Reconnect: (none) Observer Override: FALSE Configurable Failover Conditions Health Conditions: Corrupted Controlfile YES Corrupted Dictionary YES Inaccessible Logfile NO Stuck Archiver NO Datafile Write Errors YES Oracle Error Conditions: (none)
例2: この例は、動作中の登録済オブザーバが複数ある場合の出力を示しています。アスタリスク記号(*)は、どのオブザーバがマスターであるかを示します。
DGMGRL> SHOW FAST_START FAILOVER
Fast-Start Failover: ENABLED
Threshold: 30 seconds
Target: South_Sales
Observers: (*)observer1.example.com
observer2.example.com
observer3.example.com
Lag Limit: 30 seconds (not in use)
Shutdown Primary: TRUE
Auto-reinstate: TRUE
Observer Reconnect: (none)
Observer Override: FALSE
Configurable Failover Conditions
Health Conditions:
Corrupted Controlfile YES
Corrupted Dictionary YES
Inaccessible Logfile NO
Stuck Archiver NO
Datafile Write Errors YES
Oracle Error Conditions:
(none)
7.60 SHOW INSTANCE
SHOW INSTANCE
コマンドは、指定したインスタンスの情報またはプロパティ値を表示します。
書式
SHOW INSTANCE [VERBOSE] instance-name [property-name] [ON {DATABASE database-name | FAR_SYNC far-sync-name} ];
コマンド・パラメータ
- instance-name
-
情報を表示するインスタンスの名前。
VERBOSE
キーワードを使用する場合は、インスタンス名の前に指定する必要があります。 - property-name
-
値を表示するプロパティの名前。プロパティ名を指定すると、
VERBOSE
キーワードを指定したかどうかにかかわらず、出力には指定したプロパティのみ(すべてのプロパティではなく)が表示されます。関連項目:
プロパティの詳細は、「ブローカ構成のメンバーの管理」および「Oracle Data Guard Brokerのプロパティ」を参照。
- database-name | far-sync-name
-
情報を表示するインスタンスに関連付けられているデータベースまたは遠隔同期の名前。
使用上の注意
-
SHOW INSTANCE
コマンドを使用すると、インスタンスの簡潔なサマリーが表示されます。SHOW INSTANCE VERBOSE
コマンドを使用すると、簡潔なサマリーに加えてインスタンスのプロパティが表示されます。インスタンスのステータスは、どちらのコマンドでも表示されます。 -
SHOW INSTANCE VERBOSE
コマンドは、Oracleアラート・ログ・ファイルとブローカ・ログ・ファイルの場所を表示します。ブローカ・ログ・ファイルは、アラート・ログと同じディレクトリに作成され、drc<$ORACLE_SID>.log
という名前が付けられます。 -
SHOW INSTANCE VERBOSE
コマンドでは、インスタンス固有のプロパティのみが表示されます。 -
SHOW INSTANCE VERBOSE
コマンドで表示されるプロパティは、データベース・ロールと構成の内容によって異なります。-
プライマリ・データベースのインスタンスの場合は、構成に少なくとも1つのフィジカルまたはスナップショット・スタンバイ・データベースが含まれている場合にのみ、フィジカルまたはスナップショット・スタンバイ・インスタンス固有のプロパティが表示されます。ロジカル・スタンバイ・インスタンス固有のプロパティは、構成に少なくとも1つロジカル・スタンバイ・データベースが含まれている場合にのみ表示されます。
-
フィジカルまたはスナップショット・スタンバイ・データベースのインスタンスの場合、ロジカル・スタンバイ・インスタンス固有のプロパティは表示されません。
-
ロジカル・スタンバイ・データベースのインスタンスの場合、フィジカルおよびスナップショット・スタンバイ・インスタンス固有のプロパティは表示されません。
-
-
instance-name
には、構成全体で一意の名前を指定できます。instance-name
が一意ではない場合、database-name
およびinstance-name
の両方を指定してインスタンスを完全に識別する必要があります。
コマンドの例
例1: 簡略形式でのインスタンス情報の表示
次の例では、データベースの特定のインスタンスに関する情報を表示します。
DGMGRL> SHOW INSTANCE 'north_sales1'; Instance 'north_sales1' of database 'North_Sales' Instance Status: SUCCESS
例2: 拡張形式でのインスタンス情報の表示
次の例では、インスタンス情報を拡張形式で表示します。
DGMGRL> SHOW INSTANCE VERBOSE 'north_sales1'; Instance 'north_sales1' of database 'North_Sales' Host Name: north.example.com PFILE: Properties: SidName = 'north_sales1' StaticConnectIdentifier = '(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp) (HOST=north.example.com)(PORT=2094)) (CONNECT_DATA=(SERVICE_NAME=North_Sales_DGMGRL.example.com) (INSTANCE_NAME=north_sales1)(SERVER=DEDICATED)))' StandbyArchiveLocation = 'USE_DB_RECOVERY_FILE_DEST' AlternateLocation = '' LogArchiveTrace = '255' LogArchiveFormat = 'r_%d_%t_%s_%R.arc' LatestLog = '(monitor)' TopWaitEvents = '(monitor)' Log file locations: Alert log : /u01/oracle/diag/rdbms/orclbi/orclbi/trace/alert_South_Sales.log Data Guard Broker log : /u01/oracle/diag/rdbms/orclbi/orclbi/trace/drc_South_Sales.log Instance Status: SUCCESS
7.61 SHOW OBSERVER
SHOW OBSERVER
コマンドは、Data Guard Broker構成内のすべての登録済オブザーバに関する情報を表示します。
SHOW OBSERVER
コマンドは、オブザーバ名、オブザーバが動作中のホスト名、オブザーバがマスター・オブザーバかどうか、およびオブザーバが最後にプライマリとスタンバイにping送信した時間を表示します。この情報は、この1つの構成内にあるすべてのオブザーバ(最大3つ)について表示されます。
FORMAT
SHOW OBSERVER;
コマンド・パラメータ
なし
使用上の注意
-
このコマンドを実行するには、このコマンドを発行するDGMGRLセッションが1つの構成に接続されている必要があります。
コマンドの例
次の例のSHOW OBSERVER
コマンドは、DRSolution
ブローカ構成内のすべての登録済オブザーバに関する情報を表示します。
DGMGRL> SHOW OBSERVER; Configuration - DRSolution Primary: North_Sales Active Target Standby: South_Sales Observer "ob2" - Master Host Name: observer2.example.com Last Ping to Primary: 1 second ago Last Ping to Target: 2 seconds ago Observer "ob1" - Backup Host Name: observer1.example.com Last Ping to Primary: 1 second ago Last Ping to Target: 3 seconds ago Observer "ob3" - Backup Host Name: observer3.example.com Last Ping to Primary: 4 seconds ago Last Ping to Target: 5 seconds ago
7.62 SHOW ObserverConfigFile
SHOW ObserverConfigFile
コマンドは、ObserverConfigFile
プロパティの値を表示します。
書式
SHOW ObserverConfigFile;
コマンド・パラメータ
なし。
使用上の注意
-
ObserverConfigFile
プロパティの値が空文字列の場合、current_working_directory/observer.ora
と出力されます。 -
SHOW ObserverConfigFile
コマンドは、ObserverConfigFile
プロパティで指定されているファイルの解析を試みます。ファイルが存在しない、または解析に失敗した場合、ファイルは使用できませんというメッセージが戻ります。
コマンドの例
DGMGRL> SHOW ObserverConfigFile;
ObserverConfigFile=/usr/oracle/observer
observer configuration file parsing succeeded
7.63 SHOW OBSERVERS
SHOW OBSERVERS
コマンドは、特定の構成グループのすべてのブローカ構成の、すべてのオブザーバに関する情報を表示します。
SHOW OBSERVERS
コマンドは、オブザーバ名、オブザーバが動作中のホスト名、オブザーバがマスター・オブザーバかどうか、およびオブザーバが最後にプライマリとスタンバイにping送信した時間を表示します。
書式
SHOW OBSERVERS [FOR cfg_group_name ];
コマンド・パラメータ
使用上の注意
-
このコマンドを使用して、新しいマスター・オブザーバへの手動による切替えが正常に実行されたことを確認できます。
コマンドの例
DGMGRL> SHOW OBSERVERS;
ObserverConfigFile=observer.ora
observer configuration file parsing succeeded
Submit command SHOW OBSERVER using the connect identifier 'North_Sales'.
Connected to "North_Sales"
Configuration - DrSolution1
Primary: North_Sales
Target: South_Sales
Observer DRSolution1_Observer - Master
Host Name: observer1.example.com
Last Ping to Primary: 3 seconds ago
Last Ping to Target: 3 seconds ago
Submit command SHOW OBSERVER using the connect identifier 'East_Sales'.
Connected to "East_Sales"
Configuration - DRSolution2
Primary: East_Sales
Target: West_Sales
Observer DRSolution2_Observer - Master
Host Name: observer2.example.com
Last Ping to Primary: 3 seconds ago
Last Ping to Target: 3 seconds ago
7.64 SHOW RECOVERY_APPLIANCE
SHOW RECOVERY_APPLIANCE
コマンドは、指定したZero Data Loss Recovery Appliance (リカバリ・アプライアンス)の情報またはプロパティ値を表示します。
書式
SHOW RECOVERY_APPLIANCE [VERBOSE] object name [property name];
コマンド・パラメータ
使用上の注意
-
SHOW RECOVERY_APPLIANCE
コマンドを使用すると、リカバリ・アプライアンスの簡潔なサマリーが表示されます。SHOW RECOVERY_APPLIANCE VERBOSE
コマンドは、簡潔なサマリーに加え、リカバリ・アプライアンスのプロパティを表示します。データベースのステータスは、どちらのコマンドでも表示されます。 -
SHOW RECOVERY_APPLIANCE VERBOSE
コマンドは、リカバリ・アプライアンス固有のプロパティを表示します。
コマンドの例
例1: 簡略形式でのリカバリ・アプライアンス情報
次の例では、リカバリ・アプライアンス情報を簡略形式で表示します。
DGMGRL> SHOW RECOVERY_APPLIANCE 'EnterpriseRecoveryAppliance'; Oracle Recovery Server - EnterpriseRecoveryAppliance Transport Lag: 0 seconds Redo Source: South_Sales Oracle Backup Appliance Status: SUCCESS
例2: 拡張形式でのリカバリ・アプライアンス情報
次の例では、VERBOSE
パラメータを使用して、リカバリ・アプライアンス情報を拡張形式で表示します。
DGMGRL> SHOW RECOVERY_APPLIANCE VERBOSE 'EnterpriseRecoveryAppliance'; Oracle Backup Appliance - EnterpriseRecoveryAppliance Transport Lag: 0 Redo Source: South_Sales Properties: DGConnectIdentifier = 'South_Sales.example.com' LogXptMode = 'ASYNC' DelayMins = '0' Binding = 'optional' MaxFailure = '0' MaxConnections = '1' ReopenSecs = '300' NetTimeout = '30' RedoCompression = 'DISABLE' LogShipping = 'ON' ArchiveLagTarget = '0' LogArchiveMaxProcesses = '5' LogArchiveMinSucceedDest = '1' InconsistentProperties = '(monitor)' InconsistentLogXptProps = '(monitor)' AlternateLocation = '' RedoSource = 'South_Sales' Database Status: SUCCESS
7.65 SHUTDOWN
現在実行中のOracleインスタンスを停止します。
書式
SHUTDOWN [ ABORT | IMMEDIATE | NORMAL ];
コマンド・パラメータ
なし。
使用上の注意
-
引数を指定せずに
SHUTDOWN
コマンドを使用すると、SHUTDOWN NORMAL
コマンドを使用した場合と同じ結果になります。 -
SHUTDOWN
コマンドのオプションを次に示します。-
ABORT
コールの完了やデータベースからのユーザーの切断を待たずに、データベースを可能なかぎり高速でシャットダウンします。コミットされていないトランザクションはロールバックされません。処理中のクライアントのSQL文は終了します。データベースに接続されているユーザー全員が暗黙的に切断され、次回のデータベース起動時にはインスタンスのリカバリが必要になります。バックグラウンド・プロセスが異常終了した場合は、このオプションを使用する必要があります。
注意:
ファスト・スタート・フェイルオーバーが有効化され、オブザーバが実行されている場合に、プライマリ・データベースに
ABORT
オプションを使用すると、ファスト・スタート・フェイルオーバーが実行される場合があります。意図しないファスト・スタート・フェイルオーバーの実行を防ぐには、IMMEDIATE
またはNORMAL
オプションを使用します。 -
IMMEDIATE
現在のコールが完了したり、ユーザーがデータベースから切断するまで待機しません。それ以降の接続は禁止されます。データベースはクローズされ、ディスマウントされます。インスタンスはシャットダウンされ、次回のデータベース起動時にインスタンスのリカバリは不要です。
-
NORMAL
このオプションがデフォルトです。プロセスは、ユーザーがデータベースから切断するまで待機します。それ以降の接続は禁止されます。データベースはクローズされ、ディスマウントされます。インスタンスはシャットダウンされ、次回のデータベース起動時にインスタンスのリカバリは不要です。
-
コマンドの例
次のコマンドにより、プライマリ・データベースをNORMALモードでシャットダウンします。
DGMGRL> SHUTDOWN; Database closed. Database dismounted. Oracle instance shut down.
7.66 SPOOL
SPOOL
コマンドは、DGMGRLの入出力をファイルに記録します。
書式
SPOOL
コマンドには、3通りの使用可能な書式があります。
SPOOL;
SPOOL spool-file-name [CREATE | REPLACE | APPEND];
SPOOL OFF;
DGMGRLコマンド・プロンプトでSPOOL
とだけ入力すると、現在のスプール・ファイル名が表示されます。
それ以外の場合に、使用可能なスプール・オプションは次のよう定義されています。
-
CREATE
- 新しいログ・ファイルを作成します。指定した名前のスプール・ファイルがすでに存在する場合、SPOOLコマンドは失敗します。 -
REPLACE
- 指定した名前の既存のスプール・ファイルを置換します。これは、オプションを指定しない場合のデフォルト動作です。 -
APPEND
- 指定したログ・ファイルが存在する場合は、そのファイルに新しいログを追加します。それ以外の場合は、新規作成します。 -
OFF
- スプールをオフにします。
使用上の注意
-
なし
コマンドの例
次に、スプールを開始する前と開始した後のSPOOL
コマンドの出力例を示します。
DGMGRL> SPOOL; not spooling currently DGMGRL> SPOOL mysession; DGMGRL> SPOOL; currently spooling to "mysession" DGMGRL>
7.67 SQL
SQLコマンドは、SQL文またはPL/SQLストアド・プロシージャを実行します。
書式
SQL "sql_statmement"
使用上の注意
-
実行するSQL文またはPL/SQLストアド・プロシージャは、二重引用符に入れる必要があります。
-
実行するSQL文の後にはセミコロン(;)を付けません。
-
DGMGRLがPL/SQLに渡す文字列にファイル名が含まれる場合、ファイル名を一重引用符で囲み、SQLコマンドに続く文字列全体を二重引用符で囲む必要があります。たとえば、次の構文を使用します。
SQL "CREATE TABLESPACE temp1 DATAFILE '?/oradata/trgt/temp1.dbf' SIZE 10M TEMPORARY"
-
SELECT
文は実行できません。
コマンドの例
データベースをオープンするには、次のコマンドを入力します。
DGMGRL> SQL "alter database open"
7.68 START OBSERVER
START OBSERVER
コマンドは、DGMGRLセッションを実行中のこのホスト上で、この構成に対応する登録済オブザーバが動作していない場合に、ファスト・スタート・フェイルオーバー・オブザーバを起動します。
このコマンドを使用するには、まずCONNECT
コマンドを発行して特定のブローカ構成にログインする必要があります。そうしないと、ログオンしていませんというエラー・メッセージが戻ります。
書式
START OBSERVER [observer-name] [FILE IS observer-file] [LOGFILE IS logfile] [TRACE LEVEL IS USER | SUPPORT];
コマンド・パラメータ
- observer-name
- 同一のData Guard Broker構成内でオブザーバを識別する名前。
-
同一のData Guard Broker構成上で2つのオブザーバに同じ名前を付けることはできません。
-
オブザーバの名前を指定しない場合は、デフォルトのオブザーバ名(START OBSERVERコマンドが発行されたマシンのホスト名)が使用されます。
-
オブザーバ名の大/小文字は区別されません。
-
文字列"NONAME"はオブザーバ名として使用できません。
-
- observer-file
- ランタイム・データ・ファイルのパスと名前を指定します。指定しない場合、ファイル名はデフォルトで
fsfo.dat
、パスは現在の作業ディレクトリになります。 - log-file
- オブザーバ・ログ・ファイルのフルパス名。各オブザーバには独自のログ・ファイルがあります。
使用上の注意
-
1つのData Guard Broker構成を監視するには、最大で3つのオブザーバを登録できます。各オブザーバは、
START OBSERVER
コマンドの発行時に指定する名前で識別されます。「オブザーバのインストールおよび起動」を参照してください。 -
オプションの
TRACE_LEVEL IS
句を使用すると、実行してオブザーバ・ログ・ファイルに書き込むトレースの量を制御できます。デフォルト値のUSER
の場合、オブザーバ・ログの内容は、ファスト・スタート・フェイルオーバー、プライマリ・データベースとターゲット・スタンバイ・データベースのステータス変更、およびエラーまたは警告メッセージに関するトレース情報に制限されます。TRACE_LEVEL
をSUPPORT
に設定すると、Oracleサポート・サービスが必要とするより低レベルの情報が含まれ、トレース情報の量が増大します。 -
ファスト・スタート・フェイルオーバーを有効化する予定のブローカ構成を監視するには、Oracle Client Administratorキット、Oracle Database Enterprise EditionまたはOracle Database Personal Editionのフルキットを、オブザーバ・コンピュータ上にインストールする必要があります。詳細は、「ファスト・スタート・フェイルオーバーを有効化するための前提条件」を参照してください。
-
START OBSERVER
コマンドは、オブザーバ・コンピュータ上で発行する必要があります。オブザーバが正常に開始されると、制御は、(別のクライアント接続からのSTOP OBSERVERのコマンドの発行などにより)オブザーバが停止されるまでユーザーには戻されません。そのブローカ構成とさらに交信する場合は、他のクライアントを介して接続する必要があります。オブザーバをバックグラウンドで起動する方法の詳細は、「START OBSERVER IN BACKGROUND」を参照してください。
-
LOGFILE IS
句を使用すると、オブザーバの出力はすべて指定したファイルに記録されます。指定したログ・ファイルにアクセスできないか、LOGFILE IS
句を使用していない場合、オブザーバの出力は標準出力に送信されます。オブザーバの出力は、オブザーバの問題とファスト・スタート・フェイルオーバー全般の問題のトラブルシューティングに役立ちます。 -
ディレクトリ・パスが
FILE IS
パラメータを使用して指定されていない場合、オブザーバは、現在の作業ディレクトリでfsfo.dat
ファイルを検索します。fsfo.dat
ファイルが検出されない場合で、START OBSERVER
コマンドを初めて発行する場合には、オブザーバにより、fsfo.dat
ファイルが作成されます。 -
プライマリ・データベースおよびターゲット・スタンバイ・データベースの
DB_UNIQUE_NAME
初期化パラメータおよび接続識別子は、fsfo.dat
構成ファイルに格納されています。このファイルの不正アクセスを確実に防止することをお薦めします。 -
このコマンドを発行する前に、ファスト・スタート・フェイルオーバーを有効化しておく必要はありません。
-
ファスト・スタート・フェイルオーバーが有効化されている場合、オブザーバは、プライマリおよびターゲット・スタンバイの接続識別子をブローカ構成から取得し、構成の監視を開始します。
-
ファスト・スタート・フェイルオーバーが有効化されていない場合、オブザーバは、継続的にファスト・スタート・フェイルオーバーの有効化の時期を監視します。
-
-
このコマンドの発行時、実行されている必要があるのはプライマリ・データベースのみです。コマンドを正常に実行するために、ファスト・スタート・フェイルオーバーのターゲットとなるスタンバイ・データベースが実行されている必要はありません。
-
オブザーバおよびそのホスト・コンピュータのステータスを表示するには、
SHOW OBSERVER
コマンドまたはSHOW CONFIGURATION VERBOSE
コマンドを使用するか、プライマリ・データベースのV$FS_FAILOVER_OBSERVERS
ビューを問い合せます。 -
プライマリ・データベースとターゲットのスタンバイ・データベースの間の接続が維持されている状態でオブザーバとの接続が失われた場合、プライマリ・データベースは監視されない状態になります。この状態は、ブローカの健全性チェック機能により報告されます。
-
SHOW OBSERVER
コマンドは、1つ以上のオブザーバが起動済であるかどうかを示します。SHOW OBSERVER
コマンドで1つ以上の登録済オブザーバが表示されたが、その一部がなんらかの理由で実行されていない場合、次のいずれかの操作を実行できます。-
オブザーバを最初に起動したときに使用したオブザーバ構成ファイルを指定して、
START OBSERVER
コマンドを、最初にオブザーバを起動したオブザーバ・コンピュータ上で発行します。 -
任意のコンピュータ上で、
STOP OBSERVER
コマンドを発行してからSTART OBSERVER
コマンドを発行してオブザーバを起動します。
SHOW OBSERVER
コマンドで1つ以上のオブザーバが表示され、1つのオブザーバが1つの場所ですでに実行されている場合、同じ場所で再度オブザーバを起動しようとすると、次のエラーが表示されて失敗します。Unable to open the observer file
SHOW OBSERVER
コマンドで3つの登録済オブザーバが表示された場合、別の場所でオブザーバを起動しようとすると、次のエラーが表示されてコマンドは失敗します。ORA-16647: could not start more than three observers
-
コマンドの例
例1: オブザーバの起動
次の例では、オブザーバの起動方法を示しています。
DGMGRL> CONNECT sysdg@North_Sales.example.com;
Password: password
Connected to "North_Sales"
Connected as SYSDG.
DGMGRL> START OBSERVER;
Observer started
例2: オブザーバの起動(資格証明の表示なし)
次の例は、コマンドラインで接続資格証明を表示できないように、CONNECT '/'
を使用してオブザーバを起動する方法を示しています。
DGMGRL> CONNECT /@North_Sales.example.com; Connected to "North_Sales" DGMGRL> START OBSERVER; Observer started.
CONNECT '/'
を使用するには、OracleウォレットまたはSSLを設定する必要があります。OracleウォレットまたはSSLを設定することで、スクリプトでデータベース資格証明を指定せずに、オブザーバをバックグラウンド・ジョブとして安全に起動および実行するためのスクリプトを記述できます。Oracleウォレットをセキュアな外部パスワード・ストアとして使用する場合は、プライマリ・データベースおよびファスト・スタート・フェイルオーバーのターゲット・スタンバイ・データベースの資格証明を追加する必要があります。各データベースの資格証明を追加するとき、指定するデータベース接続文字列は、データベース・プロパティObserverConnectIdentifer
またはDGConnectIdentifier
と一致している必要があります。
7.69 START OBSERVER IN BACKGROUND
START OBSERVER IN BACKGROUND
コマンドは、このDGMGRLセッションを実行中のこのホスト上で、ファスト・スタート・フェイルオーバー・オブザーバをバックグラウンド・プロセスとして起動します。
このコマンドが発行された後、DGMGRLによって、START OBSERVER IN BACKGROUND
コマンドが正常に発行されたかどうか報告されます。「Yes」の場合、ユーザーに制御が戻ります。(これは、オブザーバの起動後にユーザーに制御が戻らないSTART OBSERVER
コマンドの動作とは異なります。)
このコマンドではOracleウォレットを使用して資格証明を取得し、データベース・サーバーにログインして、オブザーバを登録します。CONNECT
コマンドを使用してブローカ構成内のデータベース・サーバーに正常に接続している場合でも、このコマンドでは既存の接続が無視され、Oracleウォレットに格納されている資格証明が使用されます。ウォレットが構成されていない場合、このコマンドによるオブザーバの起動は失敗します。
書式
START OBSERVER [observer-name] IN BACKGROUND [FILE IS observer-file] [LOGFILE IS log-file]
CONNECT IDENTIFIER IS connect-identifier [TRACE_LEVEL IS USER | SUPPORT];
コマンド・パラメータ
- observer-name
- 同一のData Guard Broker構成内でオブザーバを識別する名前。
-
同一のData Guard Broker構成上で2つのオブザーバに同じ名前を付けることはできません。
-
オブザーバの名前を指定しない場合は、デフォルトのオブザーバ名(
START OBSERVER
コマンドが発行されたマシンのホスト名)が使用されます。 -
オブザーバ名の大/小文字は区別されません。
-
文字列"NONAME"はオブザーバ名として使用できません。
-
- observer-file
- ランタイム・データ・ファイルのパスと名前を指定します。指定しない場合、ファイル名はデフォルトで
fsfo.dat
、パスは現在の作業ディレクトリになります。 - log-file
- オブザーバ・ログ・ファイルのフルパス。各オブザーバには独自のログ・ファイルがあります。
- connect-identifier
- ファスト・スタート・フェイルオーバー・オブザーバが監視するブローカ構成内のデータベースの接続識別子。Oracleウォレットでは、この識別子をOracleウォレットの検索キーとして使用します。
使用上の注意
-
START OBSERVER
コマンドが正常に発行されても、資格証明の問題、断続的なネットワーク接続またはオブザーバ登録の失敗が原因で、オブザーバを起動できない場合があります。オブザーバが正常に起動されたことを確認するには、SHOW OBSERVERS
コマンドを使用するか、オブザーバ・ログ・ファイルを確認します。 -
このコマンドでは、
CONNECT
コマンドを使用して確立された特定の構成メンバーへの接続がすべて無視されます。つまり、ブローカ構成内の特定のメンバーに接続していない場合でも、START OBSERVER IN BACKGROUND
コマンドを使用することでオブザーバを起動できます。 -
START OBSERVER IN BACKGROUND
コマンドを発行する前に特定の構成メンバーに接続している場合は、制御が戻った後、その接続を引き続き使用できます。 -
observer-fileパラメータが
FILE IS
パラメータを使用して指定されていない場合、オブザーバは、現在の作業ディレクトリでfsfo.dat
ファイルを検索します。見つからない場合は、オブザーバによってfsfo.dat
ファイルが作成されます。 -
log-fileパラメータが指定されていない場合は、現在の作業ディレクトリ内の
observer.log
という名前のファイルがオブザーバ・ログ・ファイルとして使用されます。このファイルが存在しない場合は作成されます。 -
オプションの
TRACE_LEVEL IS
句を使用すると、実行してオブザーバ・ログ・ファイルに書き込むトレースの量を制御できます。デフォルト値のUSER
の場合、オブザーバ・ログの内容は、ファスト・スタート・フェイルオーバー、プライマリ・データベースとターゲット・スタンバイ・データベースのステータス変更、およびエラーまたは警告メッセージに関するトレース情報に制限されます。TRACE_LEVEL
をSUPPORT
に設定すると、Oracleサポート・サービスが必要とするより低レベルの情報が含まれ、トレース情報の量が増大します。
コマンドの例
DGMGRL> START OBSERVER observer1 IN BACKGROUND
FILE IS /net/sales/dat/oracle/broker/fsfo.dat
LOGFILE IS /net/sales/dat/oracle/broker/observer.log
CONNECT IDENTIFIER IS sales_p;
Submitted command "START OBSERVER" using connect identifier "sales_p"
7.70 START OBSERVING
START OBSERVING
コマンドは、指定したグループの各ブローカ構成に対応する新規オブザーバを起動します。
START OBSERVING
コマンドの結果は、個々の構成に対してSTART OBSERVER
コマンドを発行した場合と同じ結果になります。
書式
START OBSERVING [cfg_group_name];
使用上の注意
-
cfg_group_name
が指定されていない場合は、このコマンドによって、オブザーバ構成ファイルに定義されている構成ごとに1つの新規オブザーバが起動されます。 -
cfg_group_name
にキーワードALL
は使用できません。
コマンドの例
DGMGRL> START OBSERVING;
ObserverConfigFile=/net/oracle/dataguard/observer.ora
observer configuration file parsing succeeded
Submitted command 'START OBSERVER' using connect identifier "cfg1_cid".
Submitted command 'START OBSERVER' using connect identifier "cfg2_cid".
Submitted command 'START OBSERVER' using connect identifier "cfg3_cid".
Check superobserver.log and individual observer logs for execution details.
DGMGRL> START OBSERVING GRP_A;
ObserverConfigFile=/net/oracle/dataguard/observer.ora
observer configuration file parsing succeeded
Submitted command 'START OBSERVER' using connect identifier "cfg1_cid".
Submitted command 'START OBSERVER' using connect identifier "cfg2_cid".
Check superobserver.log and individual observer logs for execution details.
7.71 STARTUP
STARTUP
コマンドは、Oracleデータベース・インスタンスを起動しますが、ユーザーは様々なオプションを指定できます。
-
FORCE
: 現行のOracleインスタンスをSHUTDOWN
ABORT
モードでシャットダウンしてから、再起動します。 -
RESTRICT
:RESTRICTED SESSION
システム権限を持つOracleユーザーにのみインスタンスへの接続を許可します。 -
PFILE
: データベース・インスタンスの起動時に使用するPFILE
初期化パラメータ・ファイルを指定します。 -
MOUNT
: 指定したデータベースをオープンせずにマウントします。 -
OPEN
: 指定したデータベースをマウントしてオープンします。 -
NOMOUNT
: 指定したデータベース・インスタンスを、データベースをマウントせずに起動します。
書式
STARTUP [FORCE] [RESTRICT] [PFILE=filename] [MOUNT | OPEN [open_options] | NOMOUNT];
コマンド・パラメータ
使用上の注意
-
引数を指定せずに
STARTUP
コマンドを使用すると、STARTUP OPEN
コマンドを使用した場合と同じ結果になります。 -
STARTUP
コマンドの使用時にFORCE
句を指定せず、現行のデータベース・インスタンスが実行中の場合は、エラーになります。FORCE
句は、デバッグ時やエラー条件の発生時に役立ちます。それ以外の場合は、使用しないでください。 -
RESTRICT
句を使用すると、RESTRICTED SESSION
システム権限を持つOracleユーザーにのみインスタンスへの接続が許可されます。後でSQL*Plusを介しALTER SYSTEM
コマンドを使用して、制限付きセッション機能を無効化できます。 -
初期化パラメータ・ファイルの指定に
PFILE
句を使用しない場合、STARTUP
コマンドではデフォルトのサーバー・パラメータ・ファイル(存在する場合)が使用されます。それ以外の場合、STARTUP
コマンドではデフォルトの初期化パラメータ・ファイルが使用されます。デフォルトのファイルはプラットフォーム固有です。デフォルトのパラメータ・ファイルの詳細は、オペレーティング・システム固有のマニュアルを参照してください。
-
指定したデータベースをマウントしてオープンするには、
OPEN
句を使用します。 -
NOMOUNT
句を指定すると、データベースをマウントせずにデータベース・インスタンスを起動できます。NOMOUNT
句は、MOUNT
またはOPEN
オプションと併用できません。
コマンドの例
例1: データベース・インスタンスの2つの起動方法
次の例では、データベース・インスタンスの2つの起動方法を示します。各コマンドでは、標準パラメータ・ファイルを使用してデータベース・インスタンスを起動し、デフォルト・データベースを排他モードでマウントしてオープンしています。
DGMGRL> STARTUP; DGMGRL> STARTUP OPEN;
例2: 現在のインスタンスの停止および再起動(マウント/オープンなし)
次のコマンドでは、現行のインスタンスをシャットダウンし、その直後にマウントもオープンもせずにデータベースを再起動し、制限付きセッション権限のあるユーザーにのみ接続を許可しています。
DGMGRL> STARTUP FORCE RESTRICT NOMOUNT;
例3: パラメータ・ファイルを使用したインスタンスの起動(ただし、マウントなし)
次のコマンドでは、パラメータ・ファイルtestparm
を使用して、データベースをマウントせずにインスタンスを起動しています。
DGMGRL> STARTUP PFILE=testparm NOMOUNT;
例4: インスタンスの起動およびマウント(オープンなし)
次の例では、データベース・インスタンスを起動してマウントしていますが、オープンはしていません。
DGMGRL> STARTUP MOUNT;
7.72 STOP OBSERVER
STOP OBSERVER
コマンドは、ファスト・スタート・フェイルオーバー・オブザーバを停止します。
書式
STOP OBSERVER [observer-name | ALL];
コマンド・パラメータ
- observer-name
- 停止するオブザーバの名前。名前を指定しない場合、構成に対して登録済オブザーバが1つしかないと、そのオブザーバが停止されます。構成内に複数の登録済オブザーバがある場合は、エラー・メッセージが戻ります。
ALL
キーワードを使用すると、このブローカ構成に登録されているすべてのオブザーバが停止します。
使用上の注意
-
このコマンドは、ブローカ構成内のいずれかのデータベースと接続されている場合に発行できます。
-
このコマンドではファスト・スタート・フェイルオーバーを無効化できませんが、ファスト・スタート・フェイルオーバーはオブザーバがないと開始できません。
-
このコマンドの発行時に、ファスト・スタート・フェイルオーバーが有効化されている必要はありません。
-
STOP OBSERVER
コマンドの発行時にファスト・スタート・フェイルオーバーが有効化されている場合は、プライマリ・データベースおよびスタンバイ・データベースが接続され、相互に交信している必要があります。そうでない場合は、次のエラーが戻されます。ORA-16636 fast-start failover target standby in error state, cannot stop observer
プライマリ・データベースとスタンバイ・データベースが接続されていない場合、プライマリ・データベースで
DISABLE FAST_START FAILOVER FORCE
コマンドを発行してからSTOP OBSERVER
コマンドを発行できます。オブザーバおよびターゲットのスタンバイ・データベースから切断されたプライマリ・データベース上でFORCE
オプションを指定してファスト・スタート・フェイルオーバーを無効化しても、オブザーバによる、ターゲットのスタンバイ・データベースへのファスト・スタート・フェイルオーバーの開始を無効にはできません。 -
STOP OBSERVER
コマンドの発行時にファスト・スタート・フェイルオーバーが有効化されていない場合は、オブザーバの停止時にプライマリ・データベースのみが実行されている必要があります。 -
オブザーバは、
STOP OBSERVER
コマンドの発行後すぐには停止されません。オブザーバは、次回オブザーバーがブローカと接続されるまで停止されたことを検出しません。STOP OBSERVER
コマンドの発行後ただちに、任意のコンピュータでSTART OBSERVER
コマンドを再度入力できます。旧オブザーバがまだ自身の停止を検出していない場合でも、新規オブザーバを即座に開始できます。ブローカ構成では新しいオブザーバがすでに開始されているため、元のオブザーバの開始を試行すると失敗します。 -
新しいファスト・スタート・フェイルオーバーまたは新しいマスター・オブザーバへの切替えが進行中の場合、
STOP OBSERVER
コマンドは失敗します。 -
登録済オブザーバが2つ以上ある場合、マスターのみを停止しようとすると、
STOP OBSERVER
コマンドは失敗します。
コマンドの例
次の例では、ブローカ構成内の動作しているすべてのオブザーバを停止します。
DGMGRL> STOP OBSERVER ALL;
7.73 STOP OBSERVING
STOP OBSERVING
コマンドは、このDGMGRLセッションを実行中のこのホスト上で動作している、特定のグループのすべてのブローカ構成のローカル・オブザーバをすべて停止します。
書式
STOP OBSERVING [cfg_group_name] [TRACE_LEVEL= USER | SUPPORT];
コマンド・パラメータ
- cfg_group_name
- DGMGRLを実行中のこのホスト上で動作しているローカル・オブザーバを停止するブローカ構成グループの名前。
- TRACE_LEVEL
- オプションの
TRACE_LEVEL IS
句を使用すると、実行してオブザーバ・ログ・ファイルに書き込むトレースの量を制御できます。デフォルト値のUSER
の場合、オブザーバ・ログの内容は、ファスト・スタート・フェイルオーバー、プライマリ・データベースとターゲット・スタンバイ・データベースのステータス変更、およびエラーまたは警告メッセージに関するトレース情報に制限されます。TRACE_LEVEL
をSUPPORT
に設定すると、Oracleサポート・サービスが必要とするより低レベルの情報が含まれ、トレース情報の量が増大します。
使用上の注意
-
cfg_group_nameが指定されていない場合、このコマンドを実行すると、このDGMGRLセッションを実行中のこのホスト上で動作している、オブザーバ構成ファイルに定義されたすべてのブローカ構成のローカル・オブザーバをすべて停止します。
-
cfg_group_name
にキーワードALL
は使用できません。
コマンドの例
DGMGRL> STOP OBSERVING;
ObserverConfigFile=/net/oracle/dataguard/observer.ora
observer configuration file parsing succeeded
Submitted command "STOP OBSERVER HOST IS OBM1" using connect identifier cfg1_cid.
Submitted command "STOP OBSERVER HOST IS OBM1" using connect identifier cfg2_cid.
Submitted command "STOP OBSERVER HOST IS OBM1" using connect identifier cfg3_cid.
Check superobserver.log and individual observer logs for execution details.
DGMGRL> STOP OBSERVING GRP_A;
ObserverConfigFile=/net/oracle/dataguard/observer.ora
observer configuration file parsing succeeded
Submitted command "STOP OBSERVER HOST IS OBM1" using connect identifier cfg1_cid.
Submitted command "STOP OBSERVER HOST IS OBM1" using connect identifier cfg2_cid.
Check superobserver.log and individual observer logs for execution details.
7.74 SWITCHOVER
SWITCHOVER
コマンドを発行すると、現行のプライマリ・データベースがスタンバイ・データベースになり、指定したスタンバイ・データベースがプライマリ・データベースになります。
これはスイッチオーバー操作と呼ばれています。
書式
SWITCHOVER TO database_name [WAIT [timeout_in_seconds]];
WAIT
オプションでは、スイッチオーバーを続行する前にセッションが排出されるまで待機することを指定します。ブローカは、現在のアクティブなサービスすべてについてdrain_timeout
の最大値を判断し、最大でその期間、現在のすべてのクライアント要求が処理されるのを待機してから、スイッチオーバーを続行します。drain-timeout
値は、SRVCTLユーティリティのadd service
コマンドで指定するオプションです。WAIT
オプションは、単一のインスタンス・データベースには無効です。Oracle Clusterwareのアプリケーション・コンティニュイティ関連の属性を使用してサービスが構成されている場合にのみ有効です。
必要に応じて、セッションが排出されるまでの待機時間(秒)を指定することもできます。指定する値でdrain_timeout
値が上書きされます。
コマンド・パラメータ
使用上の注意
-
ファスト・スタート・フェイルオーバーが有効な場合は、ファスト・スタート・フェイルオーバーのターゲット・スタンバイ・データベースへのスイッチオーバーのみ実行できます。
-
スイッチオーバーの起動前に、ブローカによって、プライマリ・データベースおよびスタンバイ・データベースが次の状態であることが検証されます。
-
REDO転送サービスが起動するように、プライマリ・データベースが有効化され、
TRANSPORT-ON
状態になっている必要があります。 -
スタンバイ・データベースが有効化され、
TRANSPORT-ON
状態になっており、ログ適用サービスが起動している必要があります。
-
-
ブローカは、スイッチオーバーに関係するように選択したスタンバイ・データベースにREDO転送サービスのエラーがないかぎり、スイッチオーバーを続行します。その他のスタンバイ・データベースにエラーが発生しても、スイッチオーバーの続行には影響しません。
-
ロジカル・スタンバイ・データベースへのスイッチオーバーは、構成が最大保護モードで動作している場合には許可されません。
-
ブローカ構成が最大保護モードまたは最大可用性モードで動作している場合、スイッチオーバーの操作後も同じ保護モードが維持されます(「スイッチオーバー操作実行前の考慮事項」を参照)。スイッチオーバーのターゲットとなるスタンバイ・データベースが保護モード要件を満たす唯一のスタンバイであったためにモードを維持できない場合、スイッチオーバーは許可されません。
-
プライマリ・ロールを引き継ぐスタンバイ・データベースがフィジカル・スタンバイ・データベースの場合は、スイッチオーバーの完了後に、元のプライマリ・データベースが再起動されます。スタンバイ・データベースがロジカル・スタンバイ・データベースの場合は、プライマリ・データベースもロジカル・スタンバイ・データベースも再起動されません。
-
プライマリ・ロールを引き継ぐスタンバイ・データベースがフィジカル・スタンバイ・データベースの場合、元のプライマリ・データベースはフィジカル・スタンバイ・データベースとなります。
-
プライマリ・ロールを引き継ぐスタンバイ・データベースがロジカル・スタンバイ・データベースの場合、元のプライマリ・データベースはロジカル・スタンバイ・データベースとなります。
-
Oracle RACプライマリ・データベースがフィジカル・スタンバイ・データベースになる場合、スイッチオーバーを実行する前に、プライマリ・データベース上のインスタンスのうち1つを残してそれ以外はすべては停止されます。詳細は、「スイッチオーバー」を参照してください。
-
スナップショット・スタンバイ・データベースにスイッチオーバーすることはできません。
-
プライマリ・ロールを引き継ぐスタンバイ・データベースがロジカル・スタンバイ・データベースで、構成にフィジカル・スタンバイ・データベースが含まれている場合、スイッチオーバー後、フィジカル・スタンバイ・データベースは無効化されます。
注意:
このため、通常、スイッチオーバーには、ロジカル・スタンバイ・データベースのかわりにフィジカル・スタンバイ・データベースを指定することをお薦めします。ロジカル・スタンバイ・データベースへのスイッチオーバーが必要な場合、フィジカル・スタンバイ・データベースを再作成する方法については、「ロール変更後の無効化されたデータベースの再有効化」を参照してください。
比較的すぐに元のプライマリ・データベースにスイッチバックする場合は、フィジカルおよびスナップショット・スタンバイ・データベースを無効なままにしておくことができます。フィジカルおよびスナップショット・スタンバイ・データベースはまだ元のプライマリ・データベースの実行可能なスタンバイ・データベースであるため、元のプライマリ・データベースへのスイッチバックの完了後、これらを再有効化できます。
コマンドの例
例1: フィジカルからプライマリへのスイッチオーバーの成功例
次の例では、フィジカル・スタンバイ・データベースSouth_Sales
がプライマリ・ロールに遷移する正常なスイッチオーバーを示しています。
DGMGRL> SWITCHOVER TO 'South_Sales'; Performing switchover NOW, please wait... New primary database "South_Sales" is opening... Operation requires shutdown of instance "north_sales1" on database "North_Sales" Shutting down instance "north_sales1"... ORA-01109: database not open Database dismounted. ORACLE instance shut down. Operation requires startup of instance "north_sales1" on database "North_Sales" Starting instance "north_sales1"... ORACLE instance started. Database mounted. Switchover succeeded, new primary is "South_Sales"
例2: O/S認証を使用したことによるスイッチオーバーの失敗例
オペレーティング・システム認証を使用してデータベースに接続する場合は、任意のユーザー名およびパスワードを使用して接続できます。ただし、DGMGRLはリモートでは自己認証できないため、プライマリ・データベースとスタンバイ・データベースを自動的にシャットダウンして起動することができません。
次に、スイッチオーバーには成功したが、DGMGRLでプライマリ・データベースとスタンバイ・データベースのシャットダウンおよび起動ができなかったためにエラーが戻された例を示します。
DGMGRL> SWITCHOVER TO 'South_Sales'; Performing switchover NOW, please wait... New primary database "South_Sales" is opening... Operation requires shutdown of instance "north_sales1" on database "North_Sales" Shutting down instance "north_sales1"... ORA-01031: insufficient privileges Warning: You are no longer connected to ORACLE. Please complete the following steps to finish switchover: shut down instance "north_sales1" of database "North_Sales" start up and mount instance "north_sales1" of database "North_Sales"
注意:
DGMGRLでインスタンスを自動的に再起動するには、最後のCONNECT
コマンドが別のデータベースへの接続に使用された場合でも、最後のCONNECT
コマンドに指定された資格証明を使用してデータベースに接続する必要があります。
SHUTDOWNおよびSTARTUPコマンドを手動で発行して、新しいプライマリおよび停止されたスタンバイ・インスタンスを再起動する必要があります。
7.75 VALIDATE DATABASE
VALIDATE DATABASE
コマンドは、ロール変更に先立って包括的なデータベース・チェックを実行します。
チェックでは、様々なOracle Data Guardビューや自動診断リポジトリで入手できる情報を使用します。
書式
VALIDATE DATABASE [VERBOSE] database-name;
コマンド・パラメータ
使用上の注意
VALIDATE
DATABASE
コマンドは、データベースのサマリーを表示し、エラーまたは警告が検出されたらレポートします。VALIDATE
DATABASE
VERBOSE
は、簡潔なサマリーの全内容に加え、検証されたすべての項目を表示します。
コマンドの例
この項の例は、プライマリおよびスタンバイ・データベースでのVALIDATE
DATABASE
コマンドの出力の、簡潔表示と詳細表示の例を示します。
この項の例は、プライマリおよびスタンバイ・データベースでのVALIDATE
DATABASE
コマンドの出力の、簡潔表示と詳細表示の例を示します。
例1: プライマリに対するVALIDATE DATABASEの簡潔出力
次の例は、プライマリ・データベースの簡潔出力を示します。
DGMGRL> VALIDATE DATABASE 'South_Sales'; Database Role: Primary database Ready for Switchover: Yes
例2: ロジカル・スタンバイに対するVALIDATE DATABASEの簡潔出力
次の例は、ロジカル・スタンバイ・データベースの簡潔出力を示します。
DGMGRL> VALIDATE DATABASE 'West_Sales'; Database Role: Logical standby database Primary Database: South_Sales Ready for Switchover: Yes Ready for Failover: Yes (Primary Running) Warning: Physical and snapshot standby databases will be disabled if a role change is performed to this database
例3: フィジカル・スタンバイに対するVALIDATE DATABASEの簡潔出力
次の例は、フィジカル・スタンバイ・データベースの簡潔出力を示します。
DGMGRL> VALIDATE DATABASE 'North_Sales'; Database Role: Physical standby database Primary Database: South_Sales Ready for Switchover: Yes Ready for Failover: Yes (Primary Running)
例4: プライマリに対するVALIDATE DATABASEの詳細出力
次の例は、プライマリ・データベースの詳細出力を示します。
DGMGRL> VALIDATE DATABASE VERBOSE 'South_Sales'; Database Role: Primary database Ready for Switchover: Yes Capacity Information: Database Instances Threads South_Sales 2 2 Temporary Tablespace File Information: South_Sales TEMP Files: 2 Flashback Database Status: South_Sales: On Data file Online Move in Progress: South_Sales: No Transport-Related Information: Transport On: Yes Log Files Cleared: South_Sales Standby Redo Log Files: Cleared Automatic Diagnostic Repository Errors: Error South_Sales No logging operation NO Control file corruptions NO System data file missing NO System data file corrupted NO System data file offline NO User data file missing NO User data file corrupted NO User data file offline NO Block Corruptions found NO
例5: ロジカル・スタンバイに対するVALIDATE DATABASEの詳細出力
次のコマンドは、ロジカル・スタンバイ・データベースの詳細出力を示します。
DGMGRL> VALIDATE DATABASE VERBOSE 'West_Sales'; Database Role: Logical standby database Primary Database: South_Sales Ready for Switchover: Yes Ready for Failover: Yes (Primary Running) Warning: Logical and snapshot standby databases will be disabled if a role change is performed to this database Capacity Information: Database Instances Threads South_Sales 2 2 West_Sales 2 2 Temporary Tablespace File Information: South_Sales TEMP Files: 2 West_Sales TEMP Files: 2 Flashback Database Status: South_Sales: On West_Sales: On Data file Online Move in Progress: South_Sales: No West_Sales: No Standby Apply-Related Information: Apply State: Running Apply Lag: 0 seconds Apply Delay: 0 minutes Transport-Related Information: Transport On: Yes Gap Status: No Gap Transport Lag: 0 seconds Transport Status: Success Log Files Cleared: South_Sales Standby Redo Log Files: Cleared West_Sales Online Redo Log Files: Not applicable for this database West_Sales Standby Redo Log Files: Available Current Log File Groups Configuration: Thread # Online Redo Log Groups Standby Redo Log Groups Status (South_Sales) (West_Sales) 1 4 5 Sufficient SRLs 2 4 5 Sufficient SRLs Future Log File Groups Configuration: Thread # Online Redo Log Groups Standby Redo Log Groups Status (West_Sales) (South_Sales) 1 4 5 Sufficient SRLs 2 4 5 Sufficient SRLs Current Configuration Log File Sizes: Thread # Smallest Online Redo Smallest Standby Redo Log File Size Log File Size (South_Sales) (West_Sales) 1 25 MBytes 25 MBytes 2 25 MBytes 25 MBytes Future Configuration Log File Sizes: Thread # Smallest Online Redo Smallest Standby Redo Log File Size Log File Size (West_Sales) (South_Sales) 1 25 MBytes 25 MBytes 2 25 MBytes 25 MBytes Apply-Related Property Settings: Property South_Sales Value West_Sales Value DelayMins 0 0 LsbyMaxEventsRecorded 0 0 LsbyPreserveCommitOrder <empty> <empty> LsbyRecordSkipErrors <empty> <empty> LsbyRecordSkipDdl <empty> <empty> LsbyRecordAppliedDdl <empty> <empty> Transport-Related Property Settings: Property South_Sales Value West_Sales Value LogXptMode SYNC SYNC Dependency <empty> <empty> DelayMins 0 0 Binding optional optional MaxFailure 0 0 MaxConnections 1 1 ReopenSecs 30 30 NetTimeout 300 300 RedoCompression DISABLE DISABLE LogShipping ON ON Automatic Diagnostic Repository Errors: Error South_Sales West_Sales No logging operation NO NO Control file corruptions NO NO SRL Group Unavailable NO NO System data file missing NO NO System data file corrupted NO NO System data file offline NO NO User data file missing NO NO User data file corrupted NO NO User data file offline NO NO Block Corruptions found NO NO
例6: フィジカル・スタンバイに対するVALIDATE DATABASEの詳細出力
次のコマンドは、フィジカル・スタンバイ・データベースの詳細出力を示します。
DGMGRL> VALIDATE DATABASE VERBOSE North_Sales'; Database Role: Physical standby database Primary Database: South_Sales Ready for Switchover: Yes Ready for Failover: Yes (Primary Running) Capacity Information: Database Instances Threads South_Sales 2 2 North_Sales 2 2 Temporary Tablespace File Information: South_Sales TEMP Files: 2 North_Sales TEMP Files: 2 Flashback Database Status: South_Sales: On North_Sales: On Data file Online Move in Progress: South_Sales: No North_Sales: No Standby Apply-Related Information: Apply State: Running Apply Lag: 0 seconds Apply Delay: 0 minutes Transport-Related Information: Transport On: Yes Gap Status: No Gap Transport Lag: 0 seconds Transport Status: Success Log Files Cleared: South_Sales Standby Redo Log Files: Cleared North_Sales Online Redo Log Files: Cleared North_Sales Standby Redo Log Files: Available Current Log File Groups Configuration: Thread # Online Redo Log Groups Standby Redo Log Groups Status (South_Sales) (North_Sales) 1 4 5 Sufficient SRLs 2 4 5 Sufficient SRLs Future Log File Groups Configuration: Thread # Online Redo Log Groups Standby Redo Log Groups (North_Sales) (South_Sales) 1 4 5 Sufficient SRLs 2 4 5 Sufficient SRLs Current Configuration Log File Sizes: Thread # Smallest Online Redo Smallest Standby Redo Log File Size Log File Size (South_Sales) (North_Sales) 1 25 MBytes 25 MBytes 2 25 MBytes 25 MBytes Future Configuration Log File Sizes: Thread # Smallest Online Redo Smallest Standby Redo Log File Size Log File Size (North_Sales) (South_Sales) 1 25 MBytes 25 MBytes 2 25 MBytes 25 MBytes Apply-Related Property Settings: Property South_Sales Value North_Sales Value DelayMins 0 0 ApplyParallel AUTO AUTO Transport-Related Property Settings: Property South_Sales Value North_Sales Value LogXptMode SYNC SYNC Dependency <empty> <empty> DelayMins 0 0 Binding optional optional MaxFailure 0 0 MaxConnections 1 1 ReopenSecs 30 30 NetTimeout 300 300 RedoCompression DISABLE DISABLE LogShipping ON ON Automatic Diagnostic Repository Errors: Error South_Sales North_Sales No logging operation NO NO Control file corruptions NO NO SRL Group Unavailable NO NO System data file missing NO NO System data file corrupted NO NO System data file offline NO NO User data file missing NO NO User data file corrupted NO NO User data file offline NO NO Block Corruptions found NO NO
7.76 VALIDATE DATABASE DATAFILE
VALIDATE DATABASE DATAFILE
コマンドは、プライマリ・データベースとスタンバイ・データベース全体のデータ・ファイルの検証を実行します。
データ・ファイルの検証では、いずれかのデータベースでの書込み欠落を検出します。
書式
VALIDATE DATABASE [database-name | ALL] DATAFILE [datafile-name | datafile-number | ALL] OUTPUT="output-file-name";
コマンド・パラメータ
- database-name
-
情報を表示するデータベースの名前。
VERBOSE
キーワードを使用する場合は、database-name
の前に指定する必要があります。そうしないとエラーが戻ります。検証対象のデータベースがプライマリまたは
ALL
の場合、すべてのスタンバイ・データベースのデータ・ファイルがプライマリのデータ・ファイルと比較されます。検証対象のデータベースがスタンバイ・データベースの場合、そのデータ・ファイルがプライマリのデータ・ファイルと比較されます。
- datafile-name | datafile-number
- 比較対象のデータ・ファイルを名前(datafile-name)または番号(datafile-number)で指定できます。
datafile-nameは、検証される特定のデータ・ファイルの名前です。
datafile-numberは、データ・ファイルのファイル識別番号です(
V$DATAFILE
ビューのFILE#
列に表示)。 - output-file-name
- ブロック比較が完了しているかどうか、および書込み欠落があったかどうかを判断するためにチェックする必要がある、サーバー上に生成されるファイル。出力ファイルは、比較しているデータベースの診断の
trace
ディレクトリに作成されます。
使用上の注意
-
VALIDATE
DATABASE
コマンドは、データベースのサマリーを表示し、エラーまたは警告が検出されたらレポートします。 -
VALIDATE
DATABASE
コマンドが発行されると、データベースでデータ・ファイルの比較が開始されたことを示すメッセージが即時に戻りますが、これはデータ・ファイルの比較が完了したこと、またはデータ・ファイル間で書込み欠落がなかったことを意味するわけではありません。データ・ファイルの比較が完了したかどうか、または書込み欠落があったかどうかを判断するには、生成される出力ファイルをチェックする必要があります。
コマンドの例
例: VALIDATE DATABASE DATAFILEを使用したデータ・ファイルの比較
次のコマンドでは、スタンバイのデータ・ファイルをプライマリのデータ・ファイルと比較します。出力は、dbcomp1.out
という名前のファイルに送信されます。
DGMGRL> VALIDATE DATABASE boston DATAFILE ALL OUTPUT=dbcomp1.out;
Operation requires a connection to database "boston"
Connecting ...
Output files are created in /path/to/trace on host "standby-host"
次に、コマンドの出力例を示します。
Client is connected to database: boston. Role: physical standby.
******************************
Remote database chicago.
remote db role: primary database
Slave Id 0
Summary:
Different data block pairs: 66617
Details:
***************************************************
ID: Block Type Id
TOTAL: Total number of blocks found
DIFFV: Number of block pairs with different version
LWLOC: Lost Writes at Local
LWRMT: Lost Writes at Remote
SAMEV: Number of block pairs with same version
SAMEV&C: Number of block pairs with same version and checksum
DIFFPAIR: Number of block pairs with same version but different contents
ENCERR: Undecided blocks related to encryption/decrytion error.
e.g. Wallet is not open.
SKIPPED: Skipped blocks due to data corruption, direct load, etc
ID TOTAL DIFFV LWLOC LWRMT SAMEV SAMEV&C DIFFPAIR ENCERR SKIPPED
02 0067698 0001032 0000000 0000000 0066666 0000049 0066617 0000000 0000000
29 0000001 0000001 0000000 0000000 0000000 0000000 0000000 0000000 0000000
30 0000125 0000001 0000000 0000000 0000124 0000124 0000000 0000000 0000000
38 0000014 0000014 0000000 0000000 0000000 0000000 0000000 0000000 0000000
7.77 VALIDATE FAR_SYNC
VALIDATE FAR_SYNC
コマンドは、遠隔同期インスタンスに対する一連の包括的なチェックを実行します。
チェックでは、Oracle Data Guardの様々なビューで使用可能な情報が使用されます。
書式
VALIDATE FAR_SYNC [VERBOSE] far_sync_instance_name [WHEN PRIMARY IS database-name];
コマンド・パラメータ
使用上の注意
VALIDATE
FAR_SYNC
コマンドは、遠隔同期インスタンスの簡潔なサマリーを表示し、エラーまたは警告が検出された場合は報告します。VALIDATE
FAR_SYNC
VERBOSE
コマンドは、簡潔なサマリーの全内容に加え、REDO転送関連情報を表示します。
コマンドの例
この項では、様々なシナリオにおけるVALIDATE
FAR_SYNC
コマンドの出力例を示しています。
例1: VALIDATE FAR_SYNCの簡潔出力
次の例では、遠隔同期インスタンスの簡潔な出力を示しています。
DGMGRL> VALIDATE FAR_SYNC FS; Member Role: Far Sync Instance When Primary Is: North_Sales Active Redo Source: North_Sales Redo Destinations: South_Sales Thread # Online Redo Log Groups Standby Redo Log Groups Status North_Sales FS 1 4 5 Sufficient SRLs
例2: VALIDATE FAR_SYNCの詳細出力
次の例では、遠隔同期インスタンスの冗長な出力を示しています。
DGMGRL> VALIDATE FAR_SYNC VERBOSE FS; Member Role: Far Sync Instance When Primary Is: North_Sales Active Redo Source: North_Sales Redo Destinations: South_Sales Thread # Online Redo Log Groups Standby Redo Log Groups Status North_Sales FS 1 4 5 Sufficient SRLs Transport-Related Information: Transport On: Yes Gap Status: No Gap Transport Lag: 0 seconds (computed 0 seconds ago) Transport Status: Success
例3: South_Salesがプライマリの場合のVALIDATE FAR_SYNCの出力
次の例では、South_Sales
データベースをプライマリ・データベースとして指定したときの出力を示しています。
DGMGRL> VALIDATE FAR_SYNC FS WHEN PRIMARY IS 'South_Sales'; Member Role: Far Sync Instance When Primary Is: South_Sales Redo Destinations: North_Sales Thread # Online Redo Log Groups Standby Redo Log Groups Status South_Sales FS 1 4 5 Sufficient SRLs