14 DBMS_DEFER_SYS

DBMS_DEFER_SYSプロシージャは、デフォルト・レプリケーション・ノード・リストを管理します。このパッケージは、レプリケート・トランザクション遅延リモート・プロシージャ・コール機能のシステム管理者インタフェースです。管理者およびレプリケーション・デーモンは、この機能を使用して、リモート・ノードへのキューに入れられているトランザクションを実行できます。また管理者は、リモート・コールの接続先のノードを制御できます。

この章では、次の項目を説明します。

DBMS_DEFER_SYSサブプログラムの概要

DBMS_DEFER_SYSサブプログラムの概要

表14-1 DBMS_DEFER_SYSパッケージのサブプログラム

サブプログラム	説明
「ADD_DEFAULT_DESTプロシージャ」	接続先データベースを`DEFDEFAULTDEST`ビューに追加します。
「CLEAR_PROP_STATISTICSプロシージャ」	`DEFSCHEDULE`データ・ディクショナリ・ビューの伝播統計を消去します。
「DELETE_DEFAULT_DESTプロシージャ」	接続先データベースを`DEFDEFAULTDEST`ビューから削除します。
「DELETE_DEF_DESTINATIONプロシージャ」	接続先データベースを`DEFSCHEDULE`ビューから削除します。
「DELETE_ERRORプロシージャ」	トランザクションを`DEFERROR`ビューから削除します。
「DELETE_TRANプロシージャ」	トランザクションを`DEFTRANDEST`ビューから削除します。
「DISABLEDファンクション」	カレント・サイトから指定されたサイトへの、遅延トランザクション・キューの伝播が有効になっているかどうかを判定します。
「EXCLUDE_PUSHファンクション」	遅延トランザクション`PUSH`を防ぐ排他ロックを取得します。
「EXECUTE_ERRORプロシージャ」	正常に終了しなかった遅延トランザクションを、トランザクションの元の受信者のセキュリティ・コンテキストで再実行します。
「EXECUTE_ERROR_AS_USERプロシージャ」	正常に終了しなかった遅延トランザクションを、このプロシージャを実行するユーザーのセキュリティ・コンテキストで再実行します。
「PURGEファンクション」	カレント・マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延トランザクション・キューから、プッシュされたトランザクションをパージします。
「PUSHファンクション」	カレント・マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延リモート・プロシージャ・コール・キューを、強制的にリモート・サイトへプッシュします。
「REGISTER_PROPAGATORプロシージャ」	指定されたユーザーを、ローカル・データベースのプロパゲータとして登録します。
「SCHEDULE_PURGEプロシージャ」	カレント・マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延トランザクション・キューから、プッシュされたトランザクションをパージするジョブをスケジュールします。
「SCHEDULE_PUSHプロシージャ」	遅延トランザクション・キューをリモート・サイトにプッシュするジョブをスケジュールします。
「SET_DISABLEDプロシージャ」	カレント・サイトから、指定された接続先サイトへの遅延トランザクション・キューの伝播を、使用禁止または使用可能にします。
「UNREGISTER_PROPAGATORプロシージャ」	プロパゲータとしてのユーザーの登録を、ローカル・データベースから削除します。
「UNSCHEDULE_PURGEプロシージャ」	マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延トランザクション・キューからの、プッシュされたトランザクションの自動パージを中止します。
「UNSCHEDULE_PUSHプロシージャ」	マスター・サイトまたはマテリアライズド・ビュー・サイトからリモート・サイトへの、遅延トランザクション・キューの自動プッシュを中止します。

ADD_DEFAULT_DEST プロシージャ

このプロシージャは、接続先データベースをDEFDEFAULTDESTデータ・ディクショナリ・ビューに追加します。

構文

DBMS_DEFER_SYS.ADD_DEFAULT_DEST (
   dblink   IN   VARCHAR2);

パラメータ

表14-2 ADD_DEFAULT_DESTプロシージャのパラメータ

パラメータ	説明
dblink	`DEFDEFAULTDEST`ビューに追加するノードの、完全修飾されたデータベース名です。

例外

表14-3 ADD_DEFAULT_DESTプロシージャの例外

例外	説明
ORA-23352	指定された`dblink`は、デフォルトのリストにすでに存在しています。

CLEAR_PROP_STATISTICS プロシージャ

このプロシージャは、DEFSCHEDULEデータ・ディクショナリ・ビューの伝播統計を消去します。このプロシージャが正常に実行されると、このビューのすべての統計は0（ゼロ）に戻され、新たに統計収集が開始されます。

特に、このプロシージャはDEFSCHEDULEデータ・ディクショナリ・ビューの次の列からの統計を消去します。

TOTAL_TXN_COUNT
AVG_THROUGHPUT
AVG_LATENCY
TOTAL_BYTES_SENT
TOTAL_BYTES_RECEIVED
TOTAL_ROUND_TRIPS
TOTAL_ADMIN_COUNT
TOTAL_ERROR_COUNT
TOTAL_SLEEP_TIME

構文

DBMS_DEFER_SYS.CLEAR_PROP_STATISTICS (
   dblink   IN   VARCHAR2);

パラメータ

表14-4 CLEAR_PROP_STATISTICSプロシージャのパラメータ

パラメータ	説明
dblink	統計を消去するノードの、完全修飾されたデータベース名です。消去される統計は、現在のノードから`dblink`に指定されたノードへの遅延トランザクションの伝播に関する統計です。

DELETE_DEFAULT_DEST プロシージャ

このプロシージャは、接続先データベースをDEFDEFAULTDESTビューから削除します。

構文

DBMS_DEFER_SYS.DELETE_DEFAULT_DEST (
   dblink   IN   VARCHAR2);

パラメータ

表14-5 DELETE_DEFAULT_DESTプロシージャのパラメータ

パラメータ	説明
dblink	`DEFDEFAULTDEST`ビューから削除するノードの、完全修飾されたデータベース名です。ビューでこのdblinkが見つからない場合、削除作業は実行されません。

DELETE_DEF_DESTINATION プロシージャ

このプロシージャは、接続先データベースをDEFSCHEDULEビューから削除します。

構文

DBMS_DEFER_SYS.DELETE_DEF_DESTINATION (
   destination   IN   VARCHAR2,
   force         IN   BOOLEAN := FALSE);

パラメータ

表14-6 DELETE_DEF_DESTINATIONプロシージャのパラメータ

パラメータ	説明
destination	`DEFSCHEDULE`ビューから削除する接続先の完全修飾されたデータベース名です。ビューでこの接続先が見つからない場合、削除作業は実行されません。
force	値が`TRUE`に設定されていると、すべての安全チェックが無視され、接続先が削除されます。

DELETE_ERRORプロシージャ

このプロシージャは、DEFERRORビューからトランザクションを削除します。

構文

DBMS_DEFER_SYS.DELETE_ERROR(
   deferred_tran_id     IN   VARCHAR2,
   destination          IN   VARCHAR2);

パラメータ

表14-7 DELETE_ERRORプロシージャのパラメータ

パラメータ	説明
deferred_tran_id	`DEFERROR`ビューから削除する遅延トランザクションの、`DEFERROR`ビューから渡される識別番号です。このパラメータが`NULL`の場合、他のパラメータの要件に一致するすべてのトランザクションが削除されます。
destination	トランザクションが初めにキューに入れられたデータベースの`DEFERROR`ビューから渡される、完全修飾されたデータベース名です。このパラメータが`NULL`の場合、他のパラメータの要件に一致するすべてのトランザクションが、`DEFERROR`ビューから削除されます。

DELETE_TRAN プロシージャ

このプロシージャは、DEFTRANDESTビューからトランザクションを削除します。他のDEFTRANDESTまたはDEFERRORエントリがない場合、トランザクションはDEFTRANビューとDEFCALLビューからも削除されます。

構文

DBMS_DEFER_SYS.DELETE_TRAN (
   deferred_tran_id     IN   VARCHAR2,
   destination          IN   VARCHAR2);

パラメータ

表14-8 DELETE_TRANプロシージャのパラメータ

パラメータ	説明
deferred_tran_id	削除する遅延トランザクションの`DEFTRAN`ビューから渡される識別番号です。値が`NULL`の場合、他のパラメータの要件に一致するすべてのトランザクションが削除されます。
destination	トランザクションが初めにキューに入れられたデータベースの`DEFTRANDEST`ビューから渡される、完全修飾されたデータベース名です。値が`NULL`の場合、他のパラメータの要件に一致するすべてのトランザクションが削除されます。

DISABLED ファンクション

このファンクションは、カレント・サイトから指定されたサイトへの、遅延トランザクション・キューの伝播が有効になっているかどうかを判定します。指定された接続先に対して遅延リモート・プロシージャ・コール（Remote Procedure Call: RPC）のキューが使用禁止になっている場合、DISABLEDファンクションによってTRUEが戻されます。

構文

DBMS_DEFER_SYS.DISABLED (
   destination  IN   VARCHAR2)
  RETURN BOOLEAN;

パラメータ

表14-9 DISABLEDファンクションのパラメータ

パラメータ	説明
destination	伝播ステータスをチェックするノードの、完全修飾されたデータベース名です。

例外

表14-10 DISABLEDファンクションの例外

例外	説明
NO_DATA_FOUND	指定された`destination`が`DEFSCHEDULE`ビューにありません。

戻り値

表14-11 DISABLEDファンクションの戻り値

値	説明
TRUE	カレント・サイトからこのサイトへの伝播は使用禁止になっています。
FALSE	カレント・サイトからこのサイトへの伝播は有効になっています。

EXCLUDE_PUSHファンクション

このファンクションは、遅延トランザクションPUSHを防ぐ排他ロックを取得します（シリアルまたはパラレル）。このファンクションは、ロックの取得時にコミットを実行します。ロックはRELEASE_ON_COMMIT => TRUEで取得されるため、次のコミット後に、遅延トランザクション・キューのプッシュを再開できます。

構文

DBMS_DEFER_SYS.EXCLUDE_PUSH (
   timeout   IN   INTEGER)
  RETURN INTEGER;

パラメータ

表14-12 EXCLUDE_PUSHファンクションのパラメータ

パラメータ	説明
timeout	タイムアウトを秒で設定します。エラーが発生したか、または`PUSH`が行われているために、設定された期間内にロックが取得されない場合は、値1が戻されます。タイムアウトの値を`DBMS_LOCK`.`MAXWAIT`に設定すると、無期限に待機します。

戻り値

表14-13 EXCLUDE_PUSHファンクションの戻り値

値	説明
0	ロックは正常に取得されました。
1	タイムアウトにより、ロックは取得されませんでした。
2	デッドロックにより、ロックは取得されませんでした。
4	ロックはすでに取得されています。

EXECUTE_ERROR プロシージャ

このプロシージャは、正常に終了しなかった遅延トランザクションを、トランザクションの元の受信者のセキュリティ・コンテキストで再実行します。

構文

DBMS_DEFER_SYS.EXECUTE_ERROR (
   deferred_tran_id IN   VARCHAR2,
   destination      IN   VARCHAR2);

パラメータ

表14-14 EXECUTE_ERRORプロシージャのパラメータ

パラメータ	説明
deferred_tran_id	再実行する遅延トランザクションの`DEFERROR`ビューから渡される識別番号です。これが`NULL`の場合、`destination`へのキューに入れられているすべてのトランザクションが再実行されます。
destination	トランザクションが初めにキューに入れられたデータベースの`DEFERROR`ビューから渡される、完全修飾されたデータベース名です。`NULL`は指定できません。指定したデータベース名が完全修飾されていない場合や無効の場合、エラーは発生しません。

例外

表14-15 EXECUTE_ERRORプロシージャの例外

例外	説明
ORA-24275 error	`NULL`パラメータと`NULL`以外のパラメータの無効な組合せが使用されています。
badparam	パラメータ値が欠落しているか、または無効です（たとえば、`destination`が`NULL`）。
missinguser	無効なユーザーです。

EXECUTE_ERROR_AS_USER プロシージャ

このプロシージャは、正常に終了しなかった遅延トランザクションを再実行します。各トランザクションは、接続しているユーザーのセキュリティ・コンテキストで実行されます。

構文

DBMS_DEFER_SYS.EXECUTE_ERROR_AS_USER (
   deferred_tran_id IN   VARCHAR2,
   destination      IN   VARCHAR2);

パラメータ

表14-16 EXECUTE_ERROR_AS_USERプロシージャのパラメータ

パラメータ	説明
deferred_tran_id	再実行する遅延トランザクションの`DEFERROR`ビューから渡される識別番号です。これが`NULL`の場合、`destination`へのキューに入れられているすべてのトランザクションが再実行されます。
destination	トランザクションが初めにキューに入れられたデータベースの`DEFERROR`ビューから渡される、完全修飾されたデータベース名です。`NULL`は指定できません。

例外

表14-17 EXECUTE_ERROR_AS_USERプロシージャの例外

例外	説明
ORA-24275 error	`NULL`パラメータと`NULL`以外のパラメータの無効な組合せが使用されています。
badparam	パラメータ値が欠落しているか、または無効です（たとえば、`destination`が`NULL`）。
missinguser	無効なユーザーです。

PURGEファンクション

このファンクションは、カレント・マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延トランザクション・キューから、プッシュされたトランザクションをパージします。

構文

DBMS_DEFER_SYS.PURGE (
   purge_method         IN  BINARY_INTEGER := purge_method_quick,
   rollback_segment     IN  VARCHAR2       := NULL,
   startup_seconds      IN  BINARY_INTEGER := 0,
   execution_seconds    IN  BINARY_INTEGER := seconds_infinity,
   delay_seconds        IN  BINARY_INTEGER := 0,
   transaction_count    IN  BINARY_INTEGER := transactions_infinity,
   write_trace          IN  BOOLEAN        := NULL);
  RETURN BINARY_INTEGER;

パラメータ

表14-18 PURGEファンクションのパラメータ

パラメータ	説明
purge_method	遅延トランザクション・キューのパージ方法を制御します。`purge_method_quick`はコストを低く抑えられますが、`purge_method_precise`の方が精度が高くなります。 `purge_method_quick`を使用するには、次のように指定します。 `dbms_defer_sys.purge_method_quick` `purge_method_precise`を使用するには、次のように指定します。 `dbms_defer_sys.purge_method_precise` `purge_method_quick`を使用する場合は、正常にプッシュされた遅延トランザクションおよび遅延プロシージャ・コールが、パージされるまで、それぞれ`DEFTRAN`および`DEFCALL`データ・ディクショナリ・ビューに予想以上に長時間保持されることがあります。詳細は、「使用上の注意」を参照してください。
rollback_segment	パージに使用するロールバック・セグメントの名前、またはデフォルトの`NULL`です。
startup_seconds	同じ遅延トランザクション・キューの前のパージを待つ最大秒数です。
execution_seconds	値が0（ゼロ）より大きい場合、指定された実秒数後に、パージが完全に停止します。
delay_seconds	`delay_seconds`の間、遅延トランザクション・キューにパージするトランザクションがなくなると、パージが完全に停止します。
transaction_count	値が0（ゼロ）より大きい場合、`transaction_count`の数だけトランザクションがパージされると、完全に停止します。
write_trace	値が`TRUE`に設定されている場合、`PURGE`ファンクションから戻された結果値が、サーバーのトレース・ファイルに記録されます。値が`FALSE`に設定されている場合は、結果値が記録されません。

戻り値

表14-19 PURGEファンクションの戻り値

値	説明
result_ok	OKです。`delay_seconds`の経過後に終了しました。
result_startup_seconds	スタート時にロック・タイムアウトにより終了しました。
result_execution_seconds	`execution_seconds`の超過により終了しました。
result_transaction_count	`transaction_count`の超過により終了しました。
result_errors	エラー発生後に終了しました。
result_split_del_order_limit	排他モードでエンキューの取得の失敗後に終了しました。このリターン・コードが戻された場合は、パージを再試行してください。問題が解決しない場合は、Oracleサポート・サービスまでお問い合せください。
result_purge_disabled	静止せずに新しいマスター・サイトを追加するときの同期のため、キューのパージが内部で使用禁止になっています。

例外

表14-20 PURGEファンクションの例外

例外	説明
argoutofrange	パラメータ値が有効範囲外です。
executiondisabled	パージの実行が使用禁止になっています。
defererror	内部エラーが発生しました。

使用上の注意

DBMS_DEFER_SYS.PURGEファンクションのpurge_methodパラメータにpurge_method_quickを指定すると、遅延トランザクションおよび遅延プロシージャ・コールが正常にプッシュされた後、それぞれDEFTRANおよびDEFCALLデータ・ディクショナリ・ビューに保持されることがあります。これは、複数のデータベース・リンクがあるレプリケーション環境で、1つのデータベース・リンクのみに対してプッシュが実行された場合に発生します。

遅延トランザクションおよび遅延プロシージャ・コールをパージするには、次のいずれかを実行します。

purge_method_quickではなく、purge_methodパラメータのpurge_method_preciseを使用します。purge_method_preciseを使用するとコストは増大しますが、遅延トランザクションおよびプロシージャ・コールは、正常にプッシュされた後で確実にパージされます。
purge_methodパラメータにpurge_method_quickを指定して、遅延トランザクションをすべてのデータベース・リンクにプッシュします。遅延トランザクションおよび遅延プロシージャ・コールは、最後のデータベース・リンクに正常にプッシュされた時点でパージされます。

PUSHファンクション

このファンクションは、カレント・マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延リモート・プロシージャ・コール（RPC）・キューを、強制的にリモート・サイトへプッシュ（伝播）します。シリアル伝播またはパラレル伝播のいずれかが使用されます。

構文

DBMS_DEFER_SYS.PUSH (
   destination          IN  VARCHAR2,
   parallelism          IN  BINARY_INTEGER := 0,
   heap_size            IN  BINARY_INTEGER := 0,
   stop_on_error        IN  BOOLEAN        := FALSE,
   write_trace          IN  BOOLEAN        := FALSE,
   startup_seconds      IN  BINARY_INTEGER := 0,
   execution_seconds    IN  BINARY_INTEGER := seconds_infinity,
   delay_seconds        IN  BINARY_INTEGER := 0,
   transaction_count    IN  BINARY_INTEGER := transactions_infinity,
   delivery_order_limit IN  NUMBER         := delivery_order_infinity)
  RETURN BINARY_INTEGER;

パラメータ

表14-21 PUSHファンクションのパラメータ

パラメータ	説明
destination	変更を転送するマスター・サイトまたはマテリアライズド・ビュー・サイトの、完全修飾されたデータベース名です。
parallelism	0（ゼロ）はシリアル伝播を指定します。 n > 1は、n個のパラレル処理のパラレル伝播を指定します。 1は、パラレル処理を1つのみ使用するパラレル伝播を指定します。
heap_size	パラレル伝播スケジュールのために同時に検査されるトランザクションの最大数です。最適なパフォーマンスを実現するデフォルト値が、自動的に計算されます。注意: Oracleサポート・サービスから指示された場合を除き、パラメータを設定しないでください。
stop_on_error	値が`FALSE`の場合（デフォルト）、競合などのエラーが発生しても処理が続行されます。値が`TRUE`の場合、接続先サイトでのエラーの発生が最初に指摘されたときに伝播を中止します。注意: `stop_on_error`が`TRUE`に設定され、`parallelism`パラメータが`0`（ゼロ）より大きい場合、トランザクションは、エラーの発生後も一定期間伝播および適用されます。
write_trace	値が`TRUE`の場合、ファンクションから戻された結果値が、サーバーのトレース・ファイルに記録されます。値が`FALSE`に設定されている場合は、結果値が記録されません。
startup_seconds	同じ接続先への前のプッシュを待つ最大秒数です。
execution_seconds	値が0（ゼロ）より大きい場合、指定された実秒数後に、プッシュが完全に停止します。`transaction_count`および`execution_seconds`が0（ゼロ）の場合（デフォルト）、キューにトランザクションがなくなるまで、トランザクションが実行されます。 `execution_seconds`パラメータは、操作が開始可能な期間のみを制御します。リモート・サイトのトランザクションに必要な時間は含まれません。したがって、`execution_seconds`パラメータは、リモート・サイトへのトランザクションの伝播を正確に制御して停止するためのものではありません。正確に制御する必要がある場合は、`transaction_count`または`delivery_order`パラメータを使用します。
delay_seconds	キューが空でも、指定された秒数が経過するまでプッシュは終了しません。タイトなループから`PUSH`がコールされるとき、実行オーバーヘッドを縮小するのに便利です。
transaction_count	値が0（ゼロ）より大きい場合、トランザクションの最大数のプッシュ後に停止します。`transaction_count`および`execution_seconds`が0（ゼロ）の場合（デフォルト）、キューにプッシュの必要なトランザクションがなくなるまで、トランザクションが実行されます。
delivery_order_limit	`delivery_order`が`delivery_order_limit`以上であるトランザクションのプッシュ前に、実行が完全に停止します。

戻り値

表14-22 PUSHファンクションの戻り値

値	説明
result_ok	OKです。`delay_seconds`の経過後に終了しました。
result_startup_seconds	スタート時にロック・タイムアウトにより終了しました。
result_execution_seconds	`execution_seconds`の超過により終了しました。
result_transaction_count	`transaction_count`の超過により終了しました。
result_delivery_order_limit	`delivery_order_limit`の超過により終了しました。
result_errors	エラー発生後に終了しました。
result_push_disabled	PUSHが内部で使用禁止になりました。通常はこの戻り値は、マスター・グループを静止せずにマスター・グループに新しいマスター・サイトを追加するとき、伝播同期のため、接続先への伝播が内部で使用禁止に設定されたことを意味します。伝播はのちに自動的に使用可能になります。
result_split_del_order_limit	排他モードでエンキューの取得の失敗後に終了しました。このリターン・コードが戻された場合は、プッシュを再試行してください。問題が解決しない場合は、Oracleサポート・サービスまでお問い合せください。

例外

表14-23 PUSHファンクションの例外

例外	説明
incompleteparallelpush	シリアル伝播を実行するには、パラレル伝播を完全に停止する必要があります。
executiondisabled	遅延リモート・プロシージャ・コール（RPC）の実行が、接続先で使用禁止になっています。
crt_err_err	`DEFERROR`にエントリを作成中、エラーが発生しました。
deferred_rpc_quiesce	レプリケーション・グループのレプリケーション・アクティビティが中断されました。
commfailure	遅延リモート・プロシージャ・コール（RPC）中に通信障害が発生しました。
missingpropagator	プロパゲータが存在しません。

REGI STER_PROPAGATORプロシージャ

このプロシージャは、指定されたユーザーをローカル・データベースのプロパゲータとして登録します。また、指定されたユーザーに（ユーザーがラッパーを作成できるように）次の権限を付与します。

CREATE SESSION
CREATE PROCEDURE
CREATE DATABASE LINK
EXECUTE ANY PROCEDURE

構文

DBMS_DEFER_SYS.REGISTER_PROPAGATOR (
   username  IN  VARCHAR2);

パラメータ

表14-24 REGISTER_PROPAGATORプロシージャのパラメータ

パラメータ	説明
username	ユーザー名です。

例外

表14-25 REGISTER_PROPAGATORプロシージャの例外

例外	説明
missinguser	指定されたユーザーは存在しません。
alreadypropagator	指定されたユーザーはすでにプロパゲータとして登録されています。
duplicatepropagator	他のプロパゲータがすでに登録されています。

SCHEDULE_PURGEプロシージャ

このプロシージャは、カレント・マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延トランザクション・キューから、プッシュされたトランザクションのパージ・ジョブをスケジュールします。1つのパージ・ジョブをスケジュールする必要があります。

関連項目:

このプロシージャを使用した、遅延トランザクション・キューの連続的または定期的なパージのスケジュールの詳細は、『Oracle Databaseアドバンスト・レプリケーション』を参照してください。

構文

DBMS_DEFER_SYS.SCHEDULE_PURGE (
   interval             IN  VARCHAR2,
   next_date            IN  DATE,
   reset                IN  BOOLEAN        := NULL,
   purge_method         IN  BINARY_INTEGER := NULL,
   rollback_segment     IN  VARCHAR2       := NULL,
   startup_seconds      IN  BINARY_INTEGER := NULL,
   execution_seconds    IN  BINARY_INTEGER := NULL,
   delay_seconds        IN  BINARY_INTEGER := NULL,
   transaction_count    IN  BINARY_INTEGER := NULL,
   write_trace          IN  BOOLEAN        := NULL);

パラメータ

表14-26 SCHEDULE_PURGEプロシージャのパラメータ

パラメータ	説明
interval	次のパージの時間を計算するファンクションを指定できます。値は`DEFSCHEDULE`ビューの`interval`フィールドに格納され、このビューの`next_date`フィールドの計算に使用します。このパラメータのデフォルト値`NULL`を使用した場合、このフィールドの値は変更されません。このフィールドに既存の値が設定されていない場合は、`NULL`で作成されます。このフィールドに値を設定しない場合は、`next_date`に値を設定する必要があります。
next_date	サイトのキューから、プッシュされたトランザクションをパージする時間を指定できます。値は`DEFSCHEDULE`ビューの`next_date`フィールドに格納されます。このパラメータのデフォルト値`NULL`を使用した場合、このフィールドの値は変更されません。このフィールドに既存の値が入っていない場合は、`NULL`で作成されます。このフィールドに値を設定しない場合は、`interval`に値を設定する必要があります。
reset	`TRUE`に設定すると、`LAST_TXN_COUNT`、`LAST_ERROR`および`LAST_MSG`が`NULL`に設定されます。
purge_method	遅延トランザクション・キューのパージ方法を制御します。`purge_method_quick`はコストを低く抑えられますが、`purge_method_precise`の方が精度が高くなります。 `purge_method_quick`を使用するには、次のように指定します。 `dbms_defer_sys.purge_method_quick` `purge_method_precise`を使用するには、次のように指定します。 `dbms_defer_sys.purge_method_precise` `purge_method_quick`を使用する場合は、正常にプッシュされた遅延トランザクションおよび遅延プロシージャ・コールが、パージされるまで、それぞれ`DEFTRAN`および`DEFCALL`データ・ディクショナリ・ビューに予想以上に長時間保持されることがあります。詳細は、「使用上の注意」を参照してください。これらの使用方法は`DBMS_DEFER_SYS.PURGE`ファンクションに関するものですが、`DBMS_DEFER_SYS.SCHEDULE_PURGE`プロシージャにも適用可能です。
rollback_segment	パージに使用するロールバック・セグメントの名前、またはデフォルトの`NULL`です。
startup_seconds	同じ遅延トランザクション・キューの前のパージを待つ最大秒数です。
execution_seconds	値が0（ゼロ）より大きい場合、指定された実秒数後に、パージが完全に停止します。
delay_seconds	`delay_seconds`の間、遅延トランザクション・キューにパージするトランザクションがなくなると、パージが完全に停止します。
transaction_count	値が0（ゼロ）より大きい場合、`transaction_count`の数だけトランザクションがパージされると、完全に停止します。
write_trace	値が`TRUE`に設定されている場合、`PURGE`ファンクションから戻された結果値が、サーバーのトレース・ファイルに記録されます。

SCHEDULE_PUSHプロシージャ

このプロシージャは、遅延トランザクション・キューをリモート・サイトにプッシュするジョブをスケジュールします。このプロシージャではCOMMITが実行されます。

関連項目:

このプロシージャを使用した、遅延トランザクション・キューの連続的または定期的なプッシュのスケジュールの詳細は、『Oracle Databaseアドバンスト・レプリケーション』を参照してください。

構文

DBMS_DEFER_SYS.SCHEDULE_PUSH (
   destination          IN  VARCHAR2,
   interval             IN  VARCHAR2,
   next_date            IN  DATE,
   reset                IN  BOOLEAN        := FALSE,
   parallelism          IN  BINARY_INTEGER := NULL,
   heap_size            IN  BINARY_INTEGER := NULL,
   stop_on_error        IN  BOOLEAN        := NULL,
   write_trace          IN  BOOLEAN        := NULL,
   startup_seconds      IN  BINARY_INTEGER := NULL,
   execution_seconds    IN  BINARY_INTEGER := NULL,
   delay_seconds        IN  BINARY_INTEGER := NULL,
   transaction_count    IN  BINARY_INTEGER := NULL);

パラメータ

表14-27 SCHEDULE_PUSHプロシージャのパラメータ

パラメータ	説明
destination	変更を転送するマスター・サイトまたはマテリアライズド・ビュー・サイトの、完全修飾されたデータベース名です。
interval	次のプッシュの時間を計算するファンクションを指定できます。値は`DEFSCHEDULE`ビューの`interval`フィールドに格納され、このビューの`next_date`フィールドの計算に使用します。このパラメータのデフォルト値`NULL`を使用した場合、このフィールドの値は変更されません。このフィールドに既存の値が設定されていない場合は、`NULL`で作成されます。このフィールドに値を設定しない場合は、`next_date`に値を設定する必要があります。
next_date	遅延トランザクションをリモート・サイトにプッシュする時間を指定できます。値は`DEFSCHEDULE`ビューの`next_date`フィールドに格納されます。このパラメータのデフォルト値`NULL`を使用した場合、このフィールドの値は変更されません。このフィールドに既存の値が設定されていない場合は、`NULL`で作成されます。このフィールドに値を設定しない場合は、`interval`に値を設定する必要があります。
reset	`TRUE`に設定すると、`LAST_TXN_COUNT`、`LAST_ERROR`および`LAST_MSG`が`NULL`に設定されます。
parallelism	0（ゼロ）はシリアル伝播を指定します。 n > 1は、n個のパラレル処理のパラレル伝播を指定します。 1は、パラレル処理を1つのみ使用するパラレル伝播を指定します。
heap_size	パラレル伝播スケジュールのために同時に検査されるトランザクションの最大数です。最適なパフォーマンスを実現するデフォルト値が、自動的に計算されます。注意: Oracleサポート・サービスから指示された場合を除き、パラメータを設定しないでください。
stop_on_error	値が`FALSE`の場合（デフォルト）、競合などのエラーが発生しても処理が続行されます。値が`TRUE`の場合、接続先サイトでのエラーの発生が最初に指摘されたときに伝播を中止します。注意: `stop_on_error`が`TRUE`に設定され、`parallelism`パラメータが`0`（ゼロ）より大きい場合、トランザクションは、エラーの発生後も一定期間伝播および適用されます。
write_trace	値が`TRUE`の場合、ファンクションから戻された結果値が、サーバーのトレース・ファイルに記録されます。
startup_seconds	同じ接続先への前のプッシュを待つ最大秒数です。
execution_seconds	値が0（ゼロ）より大きい場合、指定された実秒数後に、実行が完全に停止します。`transaction_count`および`execution_seconds`が0（ゼロ）の場合（デフォルト）、キューにトランザクションがなくなるまで、トランザクションが実行されます。
delay_seconds	キューが空でも、指定された秒数が経過するまでプッシュは終了しません。タイトなループから`PUSH`がコールされるとき、実行オーバーヘッドを縮小するのに便利です。
transaction_count	値が0（ゼロ）より大きい場合、トランザクションの最大数のプッシュ後に停止します。`transaction_count`および`execution_seconds`が0（ゼロ）の場合（デフォルト）、キューにプッシュの必要なトランザクションがなくなるまで、トランザクションが実行されます。

SET_DISABLEDプロシージャ

カレント・サイトから指定された接続先サイトへの、遅延トランザクション・キューの伝播が使用禁止あるいは使用可能にされます。disabledパラメータがTRUEの場合、指定された接続先への伝播が使用禁止になり、PUSHが呼び出されても遅延リモート・プロシージャ・コール（RPC）キューがプッシュされなくなります。SET_DISABLEDは、指定された接続先へキューをすでにプッシュしているセッションには適用されますが、DBMS_DEFERでキューに追加されているセッションには適用されません。

disabledパラメータがFALSEの場合、指定された接続先への伝播が有効になり、キューはプッシュされませんが、PUSHの呼び出しによる指定された接続先へのキューのプッシュが可能になります。disabledパラメータがTRUEかFALSEかに関係なく、設定が他のセッションにも適用されるようにするには、COMMITが必要です。

構文

DBMS_DEFER_SYS.SET_DISABLED (
   destination   IN   VARCHAR2,
   disabled      IN   BOOLEAN := TRUE,
   catchup       IN   RAW := '00',
   override      IN   BOOLEAN := FALSE);

パラメータ

表14-28 SET_DISABLEDプロシージャのパラメータ

パラメータ	説明
destination	伝播ステータスを変更するノードの、完全修飾されたデータベース名です。
disabled	デフォルトでは、このパラメータによって、カレント・サイトから指定された接続先への遅延トランザクション・キューの伝播が使用禁止になります。値を`FALSE`に設定すると、伝播が有効になります。
catchup	マスター・グループを静止せずに新しいマスター・サイトをマスター・グループに追加するための、拡張識別子です。新しいマスター・サイトが接続先です。`DEFSCHEDULE`データ・ディクショナリ・ビューの問合せを行い、既存の拡張識別子を検索します。
override	デフォルトの`FALSE`設定では、`disabled`パラメータが`FALSE`に設定されており、Oracle内部で伝播が使用禁止になった場合、`cantsetdisabled`例外が呼び出されます。 `TRUE`設定では、同期のために内部で伝播の使用禁止状態が設定されたかどうかは無視され、常に`disabled`パラメータの指定どおりの状態の設定が行われます。注意: Oracleサポート・サービスから指示された場合を除き、このパラメータを設定しないでください。

例外

表14-29 SET_DISABLEDプロシージャの例外

例外説明

例外	説明
NO_DATA_FOUND	指定された`destination`の`DEFSCHEDULE`ビューには、エントリが見つかりませんでした。
cantsetdisabled	マスター・グループを静止せずにマスター・グループに新しいマスター・サイトを追加している間に、このサイトの使用禁止ステータスは、同期をとるために内部で設定されます。このプロシージャを呼び出す前に、静止しないで新しいマスター・サイトの追加が完了したことを確認してください。

NO_DATA_FOUND

指定されたdestinationのDEFSCHEDULEビューには、エントリが見つかりませんでした。

cantsetdisabled

マスター・グループを静止せずにマスター・グループに新しいマスター・サイトを追加している間に、このサイトの使用禁止ステータスは、同期をとるために内部で設定されます。このプロシージャを呼び出す前に、静止しないで新しいマスター・サイトの追加が完了したことを確認してください。

UNREGISTER_PROPAGATORプロシージャ

プロパゲータとしてのユーザーの登録を、ローカル・データベースから削除します。このプロシージャでは、次の処理が行われます。

指定されたプロパゲータがDEFPROPAGATORから削除されます。
REGISTER_PROPAGATORによってユーザーに付与された権限が取り消されます。別個に付与された同一の権限も取り消されます。
指定されたプロパゲータのスキーマ内に生成されたラッパーが削除されます。削除されたラッパーには、レプリケーション・カタログで削除済のマークが付けられます。

構文

DBMS_DEFER_SYS.UNREGISTER_PROPAGATOR (
   username  IN  VARCHAR2
   timeout   IN  INTEGER DEFAULT DBMS_LOCK.MAXWAIT);

パラメータ

表14-30 UNREGISTER_PROPAGATORプロシージャのパラメータ

パラメータ	説明
username	プロパゲータ・ユーザーの名前です。
timeout	タイムアウトを秒で設定します。プロパゲータが稼働中の場合、プロシージャはタイムアウトで指定された時間が経過するまで待機します。デフォルトは`DBMS_LOCK`.`MAXWAIT`です。

例外

表14-31 UNREGISTER_PROPAGATORプロシージャの例外

パラメータ	説明
missingpropagator	指定されたユーザーはプロパゲータではありません。
propagator_inuse	プロパゲータが稼働中のため、登録を削除できません。後で再度実行してください。

UNSCHEDULE_PURGEプロシージャ

このプロシージャは、マスター・サイトまたはマテリアライズド・ビュー・サイトの遅延トランザクション・キューからの、プッシュされたトランザクションの自動パージを中止します。

構文

DBMS_DEFER_SYS.UNSCHEDULE_PURGE();

パラメータ

なし

UNSCHEDULE_PUSHプロシージャ

このプロシージャは、マスター・サイトまたはマテリアライズド・ビュー・サイトからリモート・サイトへの、遅延トランザクション・キューの自動プッシュを中止します。

構文

DBMS_DEFER_SYS.UNSCHEDULE_PUSH (
   dblink   IN   VARCHAR2);

パラメータ

表14-32 UNSCHEDULE_PUSHプロシージャのパラメータ

パラメータ	説明
dblink	遅延リモート・プロシージャ・コールの定期的な実行スケジュールを変更するデータベースの、完全修飾されたパス名です。

例外

表14-33 UNSCHEDULE_PUSHプロシージャの例外

例外	説明
NO_DATA_FOUND	指定された`dblink`の`DEFSCHEDULE`ビューには、エントリが見つかりませんでした。