ヘッダーをスキップ
Oracle® Databaseアドバンスト・レプリケーション・マネージメントAPIリファレンス
12cリリース1 (12.1)
E52979-02
  目次へ移動
目次		 索引へ移動
索引
前
前 		 次
次		  

15 DBMS_OFFLINE_OG

DBMS_OFFLINE_OGパッケージには、マスター・グループのオフライン・インスタンシエーションのためのパブリックAPIが含まれます。

この章には、次の項が含まれます。


注意:

このプロシージャは、マルチマスター・レプリケーション環境での、マスター表のオフライン・インスタンシエーションに使用します。

このプロシージャをDBMS_REPCAT_INSTANTIATEパッケージのプロシージャ(デプロイメント・テンプレートのインスタンス化に使用)と混同しないでください。これらのプロシージャの使用方法の詳細は、このパッケージのドキュメントを参照してください。

DBMS_OFFLINE_OGサブプログラムの概要

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

サブプログラム 説明

「BEGIN_INSTANTIATIONプロシージャ」

マスター・グループのオフライン・インスタンシエーションを開始します。

「BEGIN_LOADプロシージャ」

オフライン・インスタンシエーションの一環として行われる新しいマスター・サイトへのデータのインポート中、トリガーを使用禁止にします。

「END_INSTANTIATIONプロシージャ」

マスター・グループのオフライン・インスタンシエーションを終了します。

「END_LOADプロシージャ」

オフライン・インスタンシエーションの一環として行われる新しいマスター・サイトへのデータのインポート後、トリガーを再び有効にします。

「RESUME_SUBSET_OF_MASTERSプロシージャ」

マスター・グループのオフライン・インスタンシエーションが行われている間、新しいサイトを除くすべての既存のサイトで、レプリケーション・アクティビティを再開します。

BEGIN_INSTANTIATIONプロシージャ

このプロシージャは、マスター・グループのオフライン・インスタンシエーションを開始します。このプロシージャは、マスター定義サイトからコールする必要があります。


注意:

このプロシージャは、マルチマスター・レプリケーション環境での、マスター表のオフライン・インスタンシエーションに使用します。

このプロシージャをDBMS_REPCAT_INSTANTIATEパッケージのプロシージャ(デプロイメント・テンプレートのインスタンス化に使用)と混同しないでください。これらのプロシージャの使用方法の詳細は、このパッケージのドキュメントを参照してください。


関連項目:

マスター・サイトのオフライン・インスタンシエーションによる、マスター・グループへの新しいマスター・サイトの追加の詳細は、「エクスポート/インポートを使用するオフライン・インスタンシエーションで新しいマスター・サイトを追加」を参照してください。

構文

DBMS_OFFLINE_OG.BEGIN_INSTANTIATION (
   gname     IN   VARCHAR2,
   new_site  IN   VARCHAR2
   fname     IN   VARCHAR2);

パラメータ

表15-2 BEGIN_INSTANTIATIONプロシージャのパラメータ

パラメータ 説明 
gname

新しいサイトにレプリケートするレプリケーション・グループの名前です。

 
new_site

レプリケーション・グループをレプリケートする新しいサイトの、完全修飾されたデータベース名です。

 
fname

このパラメータは内部で使用します。

注意: Oracleサポート・サービスから指示された場合を除き、このパラメータを設定しないでください。

例外

表15-3 BEGIN_INSTANTIATIONプロシージャの例外

例外 説明 
badargument

レプリケーション・グループまたは新しいマスター・サイトの名前が、NULLまたは空の文字列です。

 
dbms_repcat.nonmasterdef

このプロシージャは、マスター定義サイトからコールする必要があります。

 
sitealreadyexists

指定されたサイトは、すでにこのレプリケーション・グループのマスター・サイトになっています。

 
wrongstate

マスター定義サイトのステータスは、静止中である必要があります。

 
dbms_repcat.missingrepgroup

gnameは、マスター・グループとしては存在していません。

 
dbms_repcat.missing_flavor

この例外が発生した場合は、Oracleサポート・サービスまでお問い合せください。

BEGIN_LOADプロシージャ

このプロシージャは、オフライン・インスタンシエーションの一環として行われる新しいマスター・サイトへのデータのインポート中、トリガーを使用禁止にします。このプロシージャは、新しいマスター・サイトからコールする必要があります。


注意:

このプロシージャは、マルチマスター・レプリケーション環境での、マスター表のオフライン・インスタンシエーションに使用します。

このプロシージャをDBMS_REPCAT_INSTANTIATEパッケージのプロシージャ(デプロイメント・テンプレートのインスタンス化に使用)と混同しないでください。これらのプロシージャの使用方法の詳細は、このパッケージのドキュメントを参照してください。


関連項目:

マスター・サイトのオフライン・インスタンシエーションによる、マスター・グループへの新しいマスター・サイトの追加の詳細は、「エクスポート/インポートを使用するオフライン・インスタンシエーションで新しいマスター・サイトを追加」を参照してください。

構文

DBMS_OFFLINE_OG.BEGIN_LOAD (
   gname     IN   VARCHAR2,
   new_site  IN   VARCHAR2);

パラメータ

表15-4 BEGIN_LOADプロシージャのパラメータ

パラメータ 説明 
gname

メンバーをインポートするレプリケーション・グループの名前です。

 
new_site

レプリケーション・グループ・メンバーをインポートする新しいサイトの、完全修飾されたデータベース名です。

例外

表15-5 BEGIN_LOADプロシージャの例外

例外 説明 
badargument

レプリケーション・グループまたは新しいマスター・サイトの名前が、NULLまたは空の文字列です。

 
wrongsite

このプロシージャは、新しいマスター・サイトからコールする必要があります。

 
unknownsite

指定されたサイトは、レプリケーション・グループで認識されません。

 
wrongstate

新しいマスター・サイトのステータスは、静止中である必要があります。

 
dbms_repcat.missingrepgroup

gnameは、マスター・グループとしては存在していません。

END_INSTANTIATIONプロシージャ

このプロシージャは、マスター・グループのオフライン・インスタンシエーションを終了します。このプロシージャは、マスター定義サイトからコールする必要があります。


注意:

このプロシージャは、マルチマスター・レプリケーション環境での、マスター表のオフライン・インスタンシエーションに使用します。

このプロシージャをDBMS_REPCAT_INSTANTIATEパッケージのプロシージャ(デプロイメント・テンプレートのインスタンス化に使用)と混同しないでください。これらのプロシージャの使用方法の詳細は、このパッケージのドキュメントを参照してください。


関連項目:

マスター・サイトのオフライン・インスタンシエーションによる、マスター・グループへの新しいマスター・サイトの追加の詳細は、「エクスポート/インポートを使用するオフライン・インスタンシエーションで新しいマスター・サイトを追加」を参照してください。

構文

DBMS_OFFLINE_OG.END_INSTANTIATION (
  gname     IN  VARCHAR2,
  new_site  IN  VARCHAR2);

パラメータ

表15-6 END_INSTANTIATIONプロシージャのパラメータ

パラメータ 説明 
gname

新しいサイトにレプリケートするレプリケーション・グループの名前です。

 
new_site

レプリケーション・グループをレプリケートする新しいサイトの、完全修飾されたデータベース名です。

例外

表15-7 END_INSTANTIATIONプロシージャの例外

例外 説明 
badargument

レプリケーション・グループまたは新しいマスター・サイトの名前が、NULLまたは空の文字列です。

 
dbms_repcat.nonmasterdef

このプロシージャは、マスター定義サイトからコールする必要があります。

 
unknownsite

指定されたサイトは、レプリケーション・グループで認識されません。

 
wrongstate

マスター定義サイトのステータスは、静止中である必要があります。

 
dbms_repcat.missingrepgroup

gnameは、マスター・グループとしては存在していません。

END_LOADプロシージャ

このプロシージャは、オフライン・インスタンシエーションの一環として行われる新しいマスター・サイトへのデータのインポート後、トリガーを再び有効にします。このプロシージャは、新しいマスター・サイトからコールする必要があります。


注意:

このプロシージャは、マルチマスター・レプリケーション環境での、マスター表のオフライン・インスタンシエーションに使用します。

このプロシージャをDBMS_REPCAT_INSTANTIATEパッケージのプロシージャ(デプロイメント・テンプレートのインスタンス化に使用)と混同しないでください。これらのプロシージャの使用方法の詳細は、このパッケージのドキュメントを参照してください。


関連項目:

マスター・サイトのオフライン・インスタンシエーションによる、マスター・グループへの新しいマスター・サイトの追加の詳細は、「エクスポート/インポートを使用するオフライン・インスタンシエーションで新しいマスター・サイトを追加」を参照してください。

構文

DBMS_OFFLINE_OG.END_LOAD (
   gname     IN   VARCHAR2,
   new_site  IN   VARCHAR2
   fname     IN   VARCHAR2);

パラメータ

表15-8 END_LOADプロシージャのパラメータ

パラメータ 説明 
gname

メンバーのインポートを終了したレプリケーション・グループの名前です。

 
new_site

レプリケーション・グループ・メンバーをインポートした新しいサイトの、完全修飾されたデータベース名です。

 
fname

このパラメータは内部で使用します。

注意: Oracleサポート・サービスから指示された場合を除き、このパラメータを設定しないでください。

例外

表15-9 END_LOADプロシージャの例外

例外 説明 
badargument

レプリケーション・グループまたは新しいマスター・サイトの名前が、NULLまたは空の文字列です。

 
wrongsite

このプロシージャは、新しいマスター・サイトからコールする必要があります。

 
unknownsite

指定されたサイトは、レプリケーション・グループで認識されません。

 
wrongstate

新しいマスター・サイトのステータスは、静止中である必要があります。

 
dbms_repcat.missingrepgroup

gnameは、マスター・グループとしては存在していません。

 
dbms_repcat.flavor_noobject

この例外が発生した場合は、Oracleサポート・サービスまでお問い合せください。

 
dbms_repcat.flavor_contains

この例外が発生した場合は、Oracleサポート・サービスまでお問い合せください。

RESUME_SUBSET_OF_MASTERSプロシージャ

マスター・サイトのオフライン・インスタンシエーションによりマスター・グループに新しいマスター・サイトを追加するとき、オフライン・インスタンシエーション・プロセスの完了に時間がかかる場合があります。このプロシージャは、マスター・グループのオフライン・インスタンシエーションの間、新しいサイトを除くすべての既存のサイトで、レプリケーション・アクティビティを再開します。このプロシージャは、通常DBMS_OFFLINE_OG.BEGIN_INSTANTIATIONプロシージャを実行した後に実行します。このプロシージャは、マスター定義サイトからコールする必要があります。


注意:

このプロシージャは、マルチマスター・レプリケーション環境での、マスター表のオフライン・インスタンシエーションに使用します。

このプロシージャをDBMS_REPCAT_INSTANTIATEパッケージのプロシージャ(デプロイメント・テンプレートのインスタンス化に使用)と混同しないでください。これらのプロシージャの使用方法の詳細は、このパッケージのドキュメントを参照してください。


関連項目:

マスター・サイトのオフライン・インスタンシエーションによる、マスター・グループへの新しいマスター・サイトの追加の詳細は、「エクスポート/インポートを使用するオフライン・インスタンシエーションで新しいマスター・サイトを追加」を参照してください。

構文

DBMS_OFFLINE_OG.RESUME_SUBSET_OF_MASTERS (
   gname     IN  VARCHAR2,
   new_site  IN  VARCHAR2
   override  IN  BOOLEAN := FALSE);

パラメータ

表15-10 RESUME_SUBSET_OF_MASTERSプロシージャのパラメータ

パラメータ 説明 
gname

新しいサイトにレプリケートするレプリケーション・グループの名前です。

 
new_site

レプリケーション・グループをレプリケートする新しいサイトの、完全修飾されたデータベース名です。

 
override

値がTRUEの場合は、保留になっている管理要求が無視され、各マスターで通常のレプリケーション・アクティビティがリストアされます。overrideパラメータは、緊急の場合のみTRUEに設定します。

値がFALSEの場合は、各マスターで通常のレプリケーション・アクティビティがリストアされます。ただし、そのマスターでgnameに対する管理要求が保留されていない場合にかぎられます。

例外

表15-11 RESUME_SUBSET_OF_MASTERSプロシージャの例外

例外 説明 
badargument

レプリケーション・グループまたは新しいマスター・サイトの名前が、NULLまたは空の文字列です。

 
dbms_repcat.nonmasterdef

このプロシージャは、マスター定義サイトからコールする必要があります。

 
unknownsite

指定されたサイトは、レプリケーション・グループで認識されません。

 
wrongstate

マスター定義サイトのステータスは、静止中である必要があります。

 
dbms_repcat.missingrepgroup

gnameは、マスター・グループとしては存在していません。

  前
前 		 次
次
  目次へ移動
目次		 索引へ移動
索引