データのレプリケート

Oracle Cloud Infrastructure GoldenGateデプロイメント・コンソールは、GoldenGateデプロイメントの作成、管理およびモニターに使用するインタフェースです。

GoldenGateデプロイメント・コンソールは、「デプロイメント」ページでデプロイメントの「アクション」(3つのドット)メニューから、またはデプロイメントの「詳細」ページから起動します。デプロイメントの作成時に指定したGoldenGateユーザー名およびパスワードを使用してログインします。

正常にログインすると、GoldenGateデプロイメント・コンソール管理サービスの概要が表示されます。

ogginstance_ui_labeled.pngの説明が続きます

管理サービス・コンソールの主な領域は次のとおりです。

  1. ナビゲーション・メニュー: ナビゲーション・アイコンをクリックして、ナビゲーション・メニューを表示または非表示にします。
  2. ナビゲーション・バーを使用すると、次のサービスを切り替えることができます。
    • Administration Service: (currently shown) Administers, manages, and monitors Extract and Replicat processes within an Oracle GoldenGate deployment.
    • Distribution Service: A networked data distribution agent that conveys and processes data and commands in a distributed deployment environment.
    • Performance Metrics Service: Collects and stores deployment performance results.
    • Receiver Service: Interoperates with the Distribution Server to handle all incoming trail files.
  3. Extract: 実行中、失敗またはその他のExtractの数が表示されます。「Extractの追加」(プラス・アイコン)をクリックして、新しいExtractを作成します。
  4. Replicat: 実行中、失敗またはその他のReplicatの数が表示されます。「Replicatの追加」(プラス・アイコン)をクリックして、新しいReplicatを作成します。
  5. クリティカル・イベント: クリティカル・イベントの重大度が表示されます。

開始する前に

すべてのOracle Databaseについて、必ず次を行ってください:

トランザクション情報の追加

TRANDATAを追加して、表レベルのサプリメンタルを有効にします。スキーマ・レベルのサプリメンタル・ロギングがすでに有効になっている場合は、このタスクをスキップできます。

詳細は、ロギング・プロパティの構成を参照してください。

TRANDATAを追加するには:
  1. GoldenGateデプロイメント・コンソールにまだログインしていない場合は、ログインします。
  2. ナビゲーション・メニューで「構成」をクリックします。
  3. 「管理サービス」タブで、「データベース」タブに移動し、ソースCDBデータベースの接続アイコンをクリックします。
  4. 「TRANDATA情報」の横にあるプラス(+)アイコンをクリックします。
  5. 「スキーマ名」にデータベース・スキーマ名を入力し、「送信」をクリックします。

Extractの作成

Extractを作成する前に、まだサプリメンタル・ロギングが有効になっていない場合は、最初にトランザクション情報を追加してください。
Extractを作成するには:
  1. From the Overview page of the Administration Service, click Add Extract (plus sign).
  2. 作成するExtractのタイプを選択して、Nextをクリックします。
  3. アスタリスク(*)の指定に必要な情報を指定します。「抽出の追加」画面の様々なセクションのオプションの説明を次に示します。
    オプション 説明 データベース
    「基本情報」セクション

    プロセス名

    抽出プロセスの名前。抽出プロセスの名前は最大8文字です。

    すべてのデータベース

    説明

    作成するExtractプロセスの説明。

    すべてのデータベース

    目的

    Extractを作成する目的を説明します。デフォルトのオプションは「単方向」です。その他のオプションは、「高可用性」、「ディザスタ・リカバリ」、「N方向」です。これらは情報提供のみです。

    すべてのデータベース

    開始

    抽出がデータの取得を開始するREDOログまたはトランザクション・ログの開始場所を設定するために使用します。使用可能なオプションは、サポートされているデータベースに応じて、「今すぐ」、「カスタム時間」、「CSN」または「ログ内の位置」および「EOF」です。

    すべてのデータベース

    トレイル名

    2文字のトレイル名。

    すべてのデータベース

    トレイルのサブディレクトリ、サイズ、シーケンスおよびオフセット

    トレイルの詳細をさらに詳細に構成できます。

    すべてのデータベース

    リモート

    抽出証跡がリモートの場合、このオプションを有効にします。

    Oracleデータベースの場合、Extract証跡をリモートのOracle GoldenGate Classicインストールに直接書き込む場合は、このオプションを有効にします。

    MySQLの場合、このオプションを設定すると、TRANLOGOPTIONS ALTLOGDEST REMOTEパラメータでリモートExtractをサポートできます。トレイルには関連していません。

    Oracle、MySQL

    「登録情報」セクション

    CSN

    コミット順序番号(CSN)値

    Oracle

    共有

    LogMinerデータ・ディクショナリを共有する方法を選択します。オプションは:
    • 自動: このオプションを使用すると、ディクショナリを共有する方法を選択できます。

    • なし: このオプションを選択すると、ディクショナリを共有できなくなります。

    • Extract: 特定のExtractのLogMinerディクショナリの共有を許可する場合は、このオプションを選択します。

    Oracle

    最適化済

    Extract登録を最適化するには、このオプションを有効にします。

    Oracle

    ダウンストリーム取得

    ログ・マイニング用にダウンストリームExtractを設定するには、このオプションを有効にします。

    Oracle

    登録のみ

    このオプションは、抽出を追加するだけでなく、抽出を登録するときに使用します。この登録は、Extractの登録時または「Register Only」オプションの使用時にレプリケーション・スロットを作成します。

    PostgreSQL

    ソース・データベース資格証明

    新規資格証明の作成 データベース・ログイン資格証明を設定していない場合は、ここからデータベース・ログイン資格証明を作成して保存できます。 すべて
    資格証明ドメイン データベースのドメインを作成します。 すべて
    資格証明別名 データベース・ログインの資格証明を指定します。 すべて
    ユーザーID データベースにログインするためのユーザー名を指定します。 すべて
    パスワード、パスワードの確認 データベースへのログインに使用するパスワードを入力し、確認のためにパスワードを再入力します。 すべて

    資格証明ドメイン

    指定したドメイン名に資格証明ユーザーを保存します。同じ資格証明ストアを使用する複数のOracle GoldenGateインストールで同じ別名を使用できます。デフォルト・ドメインはOracle GoldenGateです。

    すべてのデータベース

    資格証明別名

    ユーザー名の別名を指定します。ユーザー名をパラメータ・ファイルまたはコマンドに含めない場合、このオプションを使用します。ALIASを使用しない場合、別名はデフォルトでユーザー名になります。この別名は、ログインが必要な場合に、パラメータ・ファイルおよびコマンドで使用する必要があります。1人のユーザーに対してそれぞれ異なる別名を持つ複数のエントリを作成するには、ADD USERオプションをALIAS付きで使用します。

    すべてのデータベース

    ダウンストリーム・マイニング

    マイニング資格証明ドメイン ダウンストリーム・マイニング・データベースのドメイン名。 Oracle
    マイニング資格証明別名 マイニング・ダウンストリーム・データベースの別名。 Oracle
    ユーザーIDなし ソース・データベース接続がない場合、このオプションを有効にします。このオプションを選択すると、ADGフェッチ・オプションが有効になります。 Oracle
    ADGフェッチ資格証明ドメイン ADGフェッチ・データベースのドメイン名。 Oracle
    ADGフェッチ資格証明別名 ADGフェッチ・データベースのドメイン別名。 Oracle
  4. (オプション)暗号化プロファイルの説明を入力します。暗号化プロファイルを作成していない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
    1. リスト・ボックスからプロファイル名を選択します。ローカル・ウォレット・プロファイルまたはカスタム・プロファイルを選択できます。

    2. リスト・ボックスから暗号化プロファイル・タイプを選択します。

    3. 暗号化プロファイルのマスターキーを指定します。このオプションは、SQL Serverでは存在しません。

  5. (オプション)すべてのタイプのExtractプロセスの作成時に管理オプションを入力します。次の表に、これらのオプションを示します。
    オプション 説明

    プロファイル名

    自動開始および自動再起動プロファイルの名前を指定します。デフォルトまたはカスタムのオプションを選択できます。

    すでにプロファイルを作成している場合は、そのプロファイルも選択できます。「カスタム」オプションを選択した場合は、このセクション自体から新しいプロファイルを設定できます。

    デプロイメントのヘルスに不可欠

    OCIコンソールの「デプロイメント詳細」ページでメトリックを表示するには、このオプションを有効にします。

    自動開始

    プロセスの自動開始を有効にします。

    開始の遅延

    プロセスの開始まで待機する時間(秒単位)

    自動再起動

    プロセスが終了した場合にプロセスを再起動する方法を構成します

    最大再試行数

    プロセスの開始の再試行の最大数を指定します

    再試行遅延

    プロセスの開始を試行する際の遅延時間

    再試行期間 プロセスの開始を試行する間隔
    失敗時にのみ再起動 trueの場合、失敗したタスクのみが再開されます
    試行回数に達したらタスクを無効化 trueの場合、プロセスの再起動の最大試行回数に達すると、タスクが無効化されます。
  6. 「次」をクリックします。

  7. テキスト領域でパラメータ・ファイルを編集して、取得を検討している表詳細を指定できます。たとえば、table source.table1;とします

    ノート

    GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。SETENVを使用して、デフォルト設定をオーバーライドします。例:
    setenv (TZ="US/Eastern")
    setenv (TZ="GMT+5")

    SETENVの詳細を参照してください。

  8. 「バックグラウンドにExtractを登録しますか」を選択すると、Extractをバックグラウンドで非同期に登録できます。このオプションは、OracleおよびPostgreSQLデータベースに必須です。

  9. 「作成および実行」をクリックして、Extractを作成および起動します。「作成」を選択した場合、Extractは作成されますが、「概要」ページの「Extract」ドロップダウンを使用して起動する必要があります。

    Administration ServiceのOverviewページに戻ります。Extractの詳細(プロセス情報、チェックポイント、統計、パラメータ、レポートなど)を表示するには、「Action」リストを選択します。

分散パスの作成

分散パスは、データのトランザクションをExtractからReplicatに送信します。

ノート

オンプレミスのOracle GoldenGateからOCI GoldenGateへのディストリビューション・パスを作成する場合、データ転送プロトコルはWebSocket Secure (WSS)である必要があります。
分散パスを作成するには:
  1. 「デプロイメントの詳細」ページで、OCI GoldenGateデプロイメント・コンソールを起動してログインします。
  2. On the OCI GoldenGate Deployment Console dashboard, click Distribution Service.
  3. Click Add Path (+) on the Distribution Service home page.
  4. 「パスの追加」ページで、次のようにフィールドに入力します:
    オプション 説明

    パス名

    パスの名前を選択します。

    説明

    説明を入力します。たとえば、配布パスに関連付けられたExtractおよびReplicatプロセスの名前です。

    リバース・プロキシは有効ですか。

    リバース・プロキシを使用する場合に選択します。

    ソース: トレイル名

    ドロップダウン・リストからExtractの名前を選択します(トレイル名が自動的に入力されます)。入力されない場合は、Extractの追加時に指定したトレイル名を入力します。

    生成されたソースURI:

    指定したExtractの情報に基づいてトレイルのURIが自動的に生成されます。鉛筆をクリックしてソースを変更することで、このURIを編集できます。通常、リバース・プロキシを使用する場合は、このURIの編集が必要になります。

    ターゲット認証方式

    ターゲットURIの認証メソッドを選択します。

    認証オプションは次のとおりです。

    OAuth: Use the OAuth if the source and target deployments are IDCS-enabled. This option uses the client credentials for authentication from the Distribution Service to the Receiver Service.

    証明書: ドロップダウンから証明書を選択します。この証明書は、サービス・マネージャの「証明書管理」ページを使用して作成されます。How to Add and Manage Certificate for the Deploymentを参照してください。

    UserID Alias

    ターゲット

    パスのターゲット・エンドポイントを入力します。

    ドロップダウン・リストから、データ転送プロトコルを選択します。デフォルトのオプションは、wss (セキュアなWebソケット)です。このオプションを選択した場合は、次の詳細を指定します。

    • ターゲット・ホスト:ターゲット・ホストのURLを入力します。たとえば、ターゲットが同じシステム上にある場合はlocalhostです。

    • ポート番号: Receipt Serviceのポート番号や前に作成したReplicatの証跡名を入力することもできます。これは必須ではありません。ポートは、クラシック・アーキテクチャのManagerのポート番号です。

    • トレイル名:パスはソース証跡を受け取り、ここで指定されたターゲット証跡に日付を送信します。これは、後から作成されるどのReplicatでも使用できます。

    • ドメイン:ターゲット・ドメインの名前。

    • 別名:ターゲット・ドメインのユーザー別名。

    You can also choose ogg or ws (web socket) protocol.

    oggプロトコルの場合は、ターゲットホスト、ポート番号、およびトレールファイル名のみを指定する必要があります。

    wsプロトコルの場合、オプションは、wssプロトコルと同じです。

    生成されたターゲットURI

    指定したターゲット認証方法およびターゲットに基づいて、証跡のターゲットURIが自動的に生成されます。鉛筆をクリックしてターゲットを変更することで、このURIを編集できます。

    ターゲット暗号化アルゴリズム

    ターゲット・トレールの暗号化アルゴリズムを選択します。オプションには、NONE、AES128、AES192、AES256があります。

    ネットワーク圧縮の有効化

    このオプションを有効にした場合は、圧縮しきい値を設定します。

    圧縮しきい値

    このオプションは、ネットワーク圧縮を有効にしたときに表示されます。圧縮しきい値を指定します。

    順序の長さ

    トレイル順序番号の長さ。

    トレイル・サイズ(MB)

    トレイル内のファイルの最大サイズ。

    トレイル形式の構成

    トレイル・ファイル形式を有効にして構成するには、このスイッチを切り替えます。

    タイプ

    次のタイプのトレイル・ファイル形式のいずれかを選択します:
    • プレーン・テキスト

    • XML

    • SQL

    次と互換性がある

    トレイル・ファイルと互換性のあるユーティリティを選択します。オプションは:
    • BCP

    • SQLLOADER

    • COMCAST

    タイムスタンプ精度

    トレイル・ファイルのタイムスタンプ精度値を指定します。

    余分な列

    各レコードの末尾に追加列のためのプレースホルダを含めます。このオプションは、ターゲット表にソース表よりも多くの列がある場合に使用してください。

    1から9の間の値を指定します。

    SYSKEYを含める

    このオプションは、Replicat構成にSYSKEYのある表が含まれる場合に選択します。

    見積形式

    データベース要件に応じて見積形式を選択します。

    列名を含めますか。

    トレイル・ファイルに列名を含めるには、このオプションを有効にします。

    Nullは空白ですか。

    トレイル・ファイルのnull値が空白であることを示す場合は、このオプションを選択します。

    プレース・ホルダを含めますか。

    欠落した列に対してプレースホルダを出力します。

    ヘッダー・フィールドを含めますか。

    トレイル・ファイルにヘッダー・フィールドを含める場合に選択します。

    デリミタ

    代替デリミタ文字。

    修飾名を使用しますか。

    パラメータ・ファイルの完全修飾名を使用する場合に選択します。

    トランザクション情報を含めますか。

    トランザクション情報を含めることができるようにします。

    暗号化プロファイル

    セクション

    開始

    データのロギングを開始する時点を選択します。ドロップダウン・リストから次のオプションを選択できます:

    • 今すぐ

    • カスタム時間

    • ログでの位置(デフォルト)

    ソース順序番号

    ソース・デプロイメントのExtractからのトレイルの順序番号を選択します。

    ソースRBAオフセット

    この設定は相対バイト・アドレス(RBA)オフセット値を提供します。これは、トレイル・ファイル内のプロセスを開始する地点(バイト単位)です。

    クリティカル

    デフォルト値はfalseです。trueに設定した場合、分散パスがデプロイメントにとってクリティカルであることを示します。

    自動再起動

    デフォルト値はFALSEです。trueに設定すると、配布パスが終了すると自動的に再起動されます。

    自動再起動オプション

    セクション

    再試行

    タスク(パス・プロセス)の再開の試行回数。

    遅延

    再試行の間隔。

    ルール構成 説明
    フィルタの有効化

    トグル・ボタンから選択してフィルタリングを有効にし、「ルールの追加」ボタンをクリックすると、「ルール定義」ダイアログ・ボックスが表示されます。

    • ルール名

    • ルール・アクション: 「除外」または「含める」のいずれかを選択します

    • フィルタ・タイプ: 次のオプションのリストから選択します:

      • オブジェクト・タイプ: 3つのオブジェクト・タイプDMLDDLProcedureから選択します

      • オブジェクト名: 既存のオブジェクト名を指定するにはこのオプションを選択します。3部構成の命名規則は、CDBを使用するかどうかに依存します。CDBでは、3部構成の命名規則を使用する必要があります。それ以外の場合、2部構成の規則が必須です。3部構成の規則にはコンテナ、スキーマオブジェクトが含まれます。2部構成の規則にはスキーマオブジェクト名が含まれます。

      • プロシージャ機能名: 既存のプロシージャ機能名に基づいてフィルタするにはこのオプションを選択します。

      • 列ベース: このオプションを選択すると、ルールが適用される表と列の名前を入力するオプションが表示されます。LTGTEQLEGENEの各条件を列の値と一緒に使用してフィルタ処理できます。フィルタされたデータに前イメージまたは後イメージを含めるかどうかも指定できます。

      • タグ: タグに基づいたフィルタを設定するにはこのオプションを選択します。

      • チャンクID: データベース・シャードの構成の詳細が表示されますが、この詳細は編集できません。

    • 否定: 既存のルールを否定する必要がある場合はこのチェック・ボックスを選択します。

    「JSON」タブをクリックして、ルールのJSONスクリプトを表示することもできます。

    追加のオプション 説明

    EOF遅延(センチ秒)

    EOF遅延をセンチ秒単位で指定できます。Linuxプラットフォームではデフォルト設定を保持できます。ただし、Linux以外のプラットフォームでは、高帯域幅、高レイテンシ・ネットワーク、またはサービス品質(QoS)の設定(DSCPおよびサービス時間(ToS))のあるネットワークに合せて、この設定の調整が必要になることがあります。

    チェックポイント頻度

    チェックポイントを取得しているパスの頻度(秒)。

    TCPフラッシュ・バイト

    TCPフラッシュ・サイズをバイト単位で入力します。

    TCPフラッシュ秒数

    TCPフラッシュ間隔を秒単位で入力します。

    TCPオプション

    セクション

    DSCP

    Differentiated Services Code Point (DSCP)の値をドロップダウン・リストから選択するか、リストから検索します。

    TOS

    サービス・タイプ(TOS)の値をドロップダウン・リストから選択します。

    TCP_NODELAY

    Nagleのオプションの使用時に遅延を防ぐには、このオプションを有効にします。

    クイックACK

    データの受信後にクイック確認応答を送信するには、このオプションを有効にします。

    TCP_CORK

    Nagleのアルゴリズムのコルク・オプションの使用を許可するには、このオプションを有効にします。

    システム送信バッファ・サイズ

    フロー制御のために送信バッファ・サイズの値を設定できます。

    システム受信バッファ・サイズ

    フロー制御のために受信バッファ・サイズの値を設定できます。

    キープ・アライブ

    キープアライブのタイムアウト。

  5. 必要に応じて、「パスの作成」または「作成および実行」をクリックします。
パスが作成された後、「Distribution Service Overview」ページに新しいパスが表示されます。

受信パスの作成

Receipt Serviceは、受信するすべての証跡ファイルを処理します。Receipt Serviceのホームページには、一方の端がExtractで、もう一方の端がReplicatを表している分散パスの状態が表示されます。

ノート

オンプレミスのOracle GoldenGateOCI GoldenGateからの受信パスを作成する場合、データ転送プロトコルはWebSocket Secure (WSS)である必要があります。
受信パスを作成するには:
  1. 「デプロイメントの詳細」ページで、OCI GoldenGateデプロイメント・コンソールを起動してログインします。
  2. On the OCI GoldenGate deployment console dashboard, click Receiver Service.
  3. Click Add Path (+) on the Receiver Service home page.
  4. 「パスの追加」ページで、パスの必須フィールドに入力します。
    オプション 説明

    パス名

    パスの名前を選択します。

    説明

    説明を入力します。たとえば、配布パスに関連付けられたExtractおよびReplicatプロセスの名前です。

    リバース・プロキシは有効ですか。

    リバース・プロキシを使用する場合に選択します。

    ソース: トレイル名

    ドロップダウン・リストからExtractの名前を選択します(トレイル名が自動的に入力されます)。入力されない場合は、Extractの追加時に指定したトレイル名を入力します。

    生成されたソースURI:

    指定したExtractの情報に基づいてトレイルのURIが自動的に生成されます。鉛筆をクリックしてソースを変更することで、このURIを編集できます。通常、リバース・プロキシを使用する場合は、このURIの編集が必要になります。

    ターゲット認証方式

    ターゲットURIの認証メソッドを選択します。

    認証オプションは次のとおりです。

    OAuth: Use the OAuth if the source and target deployments are IDCS-enabled. This option uses the client credentials for authentication from the Distribution Service to the Receiver Service.

    証明書: ドロップダウンから証明書を選択します。この証明書は、サービス・マネージャの「証明書管理」ページを使用して作成されます。How to Add and Manage Certificate for the Deploymentを参照してください。

    UserID Alias

    ターゲット

    パスのターゲット・エンドポイントを入力します。

    ドロップダウン・リストから、データ転送プロトコルを選択します。デフォルトのオプションは、wss (セキュアなWebソケット)です。このオプションを選択した場合は、次の詳細を指定します。

    • ターゲット・ホスト:ターゲット・ホストのURLを入力します。たとえば、ターゲットが同じシステム上にある場合はlocalhostです。

    • ポート番号: Receipt Serviceのポート番号や前に作成したReplicatの証跡名を入力することもできます。これは必須ではありません。ポートは、クラシック・アーキテクチャのManagerのポート番号です。

    • トレイル名:パスはソース証跡を受け取り、ここで指定されたターゲット証跡に日付を送信します。これは、後から作成されるどのReplicatでも使用できます。

    • ドメイン:ターゲット・ドメインの名前。

    • 別名:ターゲット・ドメインのユーザー別名。

    You can also choose ogg or ws (web socket) protocol.

    oggプロトコルの場合は、ターゲットホスト、ポート番号、およびトレールファイル名のみを指定する必要があります。

    wsプロトコルの場合、オプションは、wssプロトコルと同じです。

    生成されたターゲットURI

    指定したターゲット認証方法およびターゲットに基づいて、証跡のターゲットURIが自動的に生成されます。鉛筆をクリックしてターゲットを変更することで、このURIを編集できます。

    ターゲット暗号化アルゴリズム

    ターゲット・トレールの暗号化アルゴリズムを選択します。オプションには、NONE、AES128、AES192、AES256があります。

    ネットワーク圧縮の有効化

    このオプションを有効にした場合は、圧縮しきい値を設定します。

    圧縮しきい値

    このオプションは、ネットワーク圧縮を有効にしたときに表示されます。圧縮しきい値を指定します。

    順序の長さ

    トレイル順序番号の長さ。

    トレイル・サイズ(MB)

    トレイル内のファイルの最大サイズ。

    トレイル形式の構成

    トレイル・ファイル形式を有効にして構成するには、このスイッチを切り替えます。

    タイプ

    次のタイプのトレイル・ファイル形式のいずれかを選択します:
    • プレーン・テキスト

    • XML

    • SQL

    次と互換性がある

    トレイル・ファイルと互換性のあるユーティリティを選択します。オプションは:
    • BCP

    • SQLLOADER

    • COMCAST

    タイムスタンプ精度

    トレイル・ファイルのタイムスタンプ精度値を指定します。

    余分な列

    各レコードの末尾に追加列のためのプレースホルダを含めます。このオプションは、ターゲット表にソース表よりも多くの列がある場合に使用してください。

    1から9の間の値を指定します。

    SYSKEYを含める

    このオプションは、Replicat構成にSYSKEYのある表が含まれる場合に選択します。

    見積形式

    データベース要件に応じて見積形式を選択します。

    列名を含めますか。

    トレイル・ファイルに列名を含めるには、このオプションを有効にします。

    Nullは空白ですか。

    トレイル・ファイルのnull値が空白であることを示す場合は、このオプションを選択します。

    プレース・ホルダを含めますか。

    欠落した列に対してプレースホルダを出力します。

    ヘッダー・フィールドを含めますか。

    トレイル・ファイルにヘッダー・フィールドを含める場合に選択します。

    デリミタ

    代替デリミタ文字。

    修飾名を使用しますか。

    パラメータ・ファイルの完全修飾名を使用する場合に選択します。

    トランザクション情報を含めますか。

    トランザクション情報を含めることができるようにします。

    暗号化プロファイル

    セクション

    開始

    データのロギングを開始する時点を選択します。ドロップダウン・リストから次のオプションを選択できます:

    • 今すぐ

    • カスタム時間

    • ログでの位置(デフォルト)

    ソース順序番号

    ソース・デプロイメントのExtractからのトレイルの順序番号を選択します。

    ソースRBAオフセット

    この設定は相対バイト・アドレス(RBA)オフセット値を提供します。これは、トレイル・ファイル内のプロセスを開始する地点(バイト単位)です。

    クリティカル

    デフォルト値はfalseです。trueに設定した場合、分散パスがデプロイメントにとってクリティカルであることを示します。

    自動再起動

    デフォルト値はFALSEです。trueに設定すると、配布パスが終了すると自動的に再起動されます。

    自動再起動オプション

    セクション

    再試行

    タスク(パス・プロセス)の再開の試行回数。

    遅延

    再試行の間隔。

    ルール構成 説明
    フィルタの有効化

    トグル・ボタンから選択してフィルタリングを有効にし、「ルールの追加」ボタンをクリックすると、「ルール定義」ダイアログ・ボックスが表示されます。

    • ルール名

    • ルール・アクション: 「除外」または「含める」のいずれかを選択します

    • フィルタ・タイプ: 次のオプションのリストから選択します:

      • オブジェクト・タイプ: 3つのオブジェクト・タイプDMLDDLProcedureから選択します

      • オブジェクト名: 既存のオブジェクト名を指定するにはこのオプションを選択します。3部構成の命名規則は、CDBを使用するかどうかに依存します。CDBでは、3部構成の命名規則を使用する必要があります。それ以外の場合、2部構成の規則が必須です。3部構成の規則にはコンテナ、スキーマオブジェクトが含まれます。2部構成の規則にはスキーマオブジェクト名が含まれます。

      • プロシージャ機能名: 既存のプロシージャ機能名に基づいてフィルタするにはこのオプションを選択します。

      • 列ベース: このオプションを選択すると、ルールが適用される表と列の名前を入力するオプションが表示されます。LTGTEQLEGENEの各条件を列の値と一緒に使用してフィルタ処理できます。フィルタされたデータに前イメージまたは後イメージを含めるかどうかも指定できます。

      • タグ: タグに基づいたフィルタを設定するにはこのオプションを選択します。

      • チャンクID: データベース・シャードの構成の詳細が表示されますが、この詳細は編集できません。

    • 否定: 既存のルールを否定する必要がある場合はこのチェック・ボックスを選択します。

    「JSON」タブをクリックして、ルールのJSONスクリプトを表示することもできます。

    追加のオプション 説明

    EOF遅延(センチ秒)

    EOF遅延をセンチ秒単位で指定できます。Linuxプラットフォームではデフォルト設定を保持できます。ただし、Linux以外のプラットフォームでは、高帯域幅、高レイテンシ・ネットワーク、またはサービス品質(QoS)の設定(DSCPおよびサービス時間(ToS))のあるネットワークに合せて、この設定の調整が必要になることがあります。

    チェックポイント頻度

    チェックポイントを取得しているパスの頻度(秒)。

    TCPフラッシュ・バイト

    TCPフラッシュ・サイズをバイト単位で入力します。

    TCPフラッシュ秒数

    TCPフラッシュ間隔を秒単位で入力します。

    TCPオプション

    セクション

    DSCP

    Differentiated Services Code Point (DSCP)の値をドロップダウン・リストから選択するか、リストから検索します。

    TOS

    サービス・タイプ(TOS)の値をドロップダウン・リストから選択します。

    TCP_NODELAY

    Nagleのオプションの使用時に遅延を防ぐには、このオプションを有効にします。

    クイックACK

    データの受信後にクイック確認応答を送信するには、このオプションを有効にします。

    TCP_CORK

    Nagleのアルゴリズムのコルク・オプションの使用を許可するには、このオプションを有効にします。

    システム送信バッファ・サイズ

    フロー制御のために送信バッファ・サイズの値を設定できます。

    システム受信バッファ・サイズ

    フロー制御のために受信バッファ・サイズの値を設定できます。

    キープ・アライブ

    キープアライブのタイムアウト。

  5. 必要に応じて、「パスの作成」または「作成および実行」をクリックします。
パスの作成後、「Receiver Service Overview」ページにパスが表示されます。

チェックポイント表の作成

Replicatを作成する前に、チェックポイント表を作成する必要があります。

チェックポイント表を作成するには:
  1. ナビゲーション・メニューで「構成」をクリックします。
  2. 「管理サービス」タブで、「データベース」タブに移動します。
  3. ターゲット・データベースのデータベース接続アイコンをクリックします。
  4. 「チェックポイントの追加」(+)をクリックします。
  5. 「チェックポイント表」にターゲット・スキーマ名を入力し、「発行」をクリックします。
  6. ターゲット・データベースに再接続します。
チェックポイント表に、ターゲット・スキーマが表示されます。

Replicatの作成

Replicatを作成する前に、まずチェックポイント表を作成してください。
Replicatを作成するには:
  1. On the Administration Service home page, click Add Replicat (+).
  2. Select a Replicat type, and then click Next.
    ノート

    一部のReplicatタイプは特定のデータベースでのみ使用できます。すべてのReplicatタイプはデータベースに適用できない場合があります。

    Replicatのタイプは次のとおりです。

    • 統合Replicat
    • 非統合Replicat
    • 調整Replicat
    • パラレルReplicat

    様々なReplicatタイプの詳細は、「キャプチャおよび適用モードの選択」を参照してください。

  3. Replicatオプション・ページでReplicatの必須オプションを指定し、「次」をクリックします。
  4. (オプション)管理対象プロセスの場合、オプションは次のとおりです。
    オプション 説明

    プロファイル名

    自動開始および自動再起動プロファイルの名前を指定します。デフォルトまたはカスタムのオプションを選択できます。

    すでにプロファイルを作成している場合は、そのプロファイルも選択できます。「カスタム」オプションを選択した場合は、このセクション自体から新しいプロファイルを設定できます。

    デプロイメントのヘルスに不可欠

    (Oracleのみ)プロファイルがデプロイメントのヘルスにとってクリティカルな場合、このオプションを有効にします。
    ノート

    このオプションは、ExtractまたはReplicatの作成時にのみ表示され、「プロファイル」ページで管理対象プロセスを設定する場合には表示されません。

    自動開始

    プロセスの自動開始を有効にします。

    開始の遅延

    プロセスの開始まで待機する時間(秒単位)

    自動再起動

    プロセスが終了した場合にプロセスを再起動する方法を構成します

    最大再試行数

    プロセスの開始の再試行の最大数を指定します

    再試行遅延

    プロセスの開始を試行する際の遅延時間

    再試行期間 プロセスの開始を試行する間隔
    失敗時にのみ再起動 trueの場合、失敗したタスクのみが再開されます
    試行回数に達したらタスクを無効化 trueの場合、プロセスの再起動の最大試行回数に達すると、タスクが無効化されます。
  5. 「次」をクリックします。
  6. 「パラメータ・ファイル」ページでは、GoldenGateパラメータを使用して、Replicatをさらに構成できます。
    ノート

    GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。SETENVを使用して、デフォルト設定をオーバーライドします。例:
    setenv (TZ="US/Eastern")
    setenv (TZ="GMT+5")

    SETENVの詳細を参照してください。

  7. 「作成および実行」をクリックして、Replicatを作成および実行します。

ExtractおよびReplicatの停止

To stop a running Extract or Replicat, on the Administration Service Overview page, select Stop from the Actions menu of the process you want to stop. You can also select Stop (in the background) if the process was started using a background process.

Admin Clientの使用

管理クライアントには、クラウド・シェルからアクセスできます。管理クライアントを使用してOCI GoldenGateに接続し、タスクを構成し、プロセス情報およびログ・メッセージを表示します。

パブリック・エンドポイントを含むOCI GoldenGateデプロイメントへの接続は、クラウド・シェルで次のコマンドを実行する場合と同じくらい簡単です。
> adminclient
OGG (not connected) 1> connect <deployment-public-url-or-ip> as <goldengate-user> password <goldengate-password> !

ただし、プライベートOCI GoldenGateに接続するには、要塞、要塞セッションおよびSSHトンネルを作成する必要があります。

管理クライアントでプライベートOCI GoldenGateデプロイメントに接続するには:

  1. Oracle Cloudコンソールのグローバル・ナビゲーション・バーで、「クラウド・シェル」をクリックします。クラウド・シェルに初めて接続する場合は、接続にしばらくかかります。
  2. 次のコマンドを実行してSSHキーを生成するか、要塞を作成するときにこのステップをスキップしてキーを生成できます。
    ssh-keygen -t rsa

    デフォルトのファイル名を保持し、プロンプトが表示されたらパスフレーズを入力しないでください。秘密キーは~/ssh/id_rsaにあり、公開キーは~/ssh/id_rsa.pubにあります。

  3. デプロイメントの詳細ページで、デプロイメントのプライベートIPおよびサブネット情報をノートにとります。
  4. 要塞を作成します。
    1. Oracle Cloudコンソール・メニューから、「アイデンティティとセキュリティ」「要塞」の順に選択します。
    2. 「要塞の作成」をクリックします。
    3. 「要塞の作成」パネルで、名前を入力し、デプロイメントが存在する同じサブネットを選択します。
    4. CIDRブロック許可リストの場合は、0.0.0.0/0と入力します。
    5. 「要塞の作成」をクリックします。
  5. セッションを作成します。
    1. 要塞が「アクティブ」状態になった後、要塞詳細ページで「セッションの作成」をクリックします。
    2. 「セッション」タイプの場合、select SSH Port Forwarding session
    3. セッションの名前を入力します。
    4. 「次を使用してターゲットに接続」で、「IPアドレス」を選択し、デプロイメントのプライベートIPを入力します。
    5. 「ポート」に、443と入力します。
    6. 「SSHキーの追加」で、パブリック・キー(~/SSH/id_rsa.pub)の内容をCloud Shellからコピーして貼り付けます。
    7. 「セッションの作成」をクリックします。
  6. 要塞セッションの状態がアクティブになったら、「アクション」メニューから「SSHコマンドの表示」を選択します(省略記号アイコン)。
  7. 「SSHの表示」コマンド・ダイアログで、<<private-key>のかわりに秘密キーへのパス(~/SSH/id_rsa)を入力し、<<localport>をクラウド・シェルのポートに置き換えて要塞への接続を転送します。
    ノート

    クラウド・シェルでは、sudoアクセス権を持つ特権ポートでのポート転送が許可されないため、7443のような権限のないポートを使用する必要があります。コマンドをフォアグラウンドで1回実行してBastionホストを known_hostsに追加したあと、コマンドの最後にamperstand (&)を追加し、次回にバックグラウンドで実行できます。
  8. コマンドをコピーしてクラウド・シェルで実行します。bind: Cannot assign requested addressメッセージは無視できます。
  9. 管理クライアントを起動します
    adminclient
  10. OCI GoldenGateデプロイメントに接続します
    connect 127.0.0.1:7443 as <goldengate-user> password <goldengate-password> !
    ノート

    コマンドの最後の感嘆符(!)は非常に重要です。これがない場合、コマンドは失敗し、エラーを返します。
  11. 接続に成功したら、次のいずれかのコマンドを実行できます:
    • OCI GoldenGateプロセスのステータスを表示します:
      info all
    • Extractの統計を表示します:
      view stats
    • ggserrorログ・ファイルの内容を表示します:
      view messages
    • Extractで使用されなくなったトレイル・ファイルをパージします:
      purge exttrail <trail-file-name>

コマンドの完全なリストは、AdminClientコマンドライン・インタフェースのコマンドを参照してください。

トレイル・ファイルの管理

OCI GoldenGate証跡ファイルは、時間の経過とともにすばやく追加されます。これらのトレール・ファイルを管理するためにパージ・タスクを行わない場合、日次バックアップは、完了までに非常に長い時間がかかり、他の場所で使用されるコンピュート・リソースを使用します。

OCI GoldenGateのTrailファイルをパージするには:
  1. トレール・ファイルを表示する手動バックアップを作成します。
    1. On the Deploment Details page, under Resources, click Deployment Backups.
    2. 「バックアップの作成」をクリックします。
    3. 「バックアップの作成」パネルのフィールドに入力し、バックアップの作成をクリックします。
      ノート

      オブジェクト名の場合、ファイル名および拡張子(backup.zipなど)を入力できます。
    4. From the Deployment Backup Details page, click Download.
    5. ダウンロードしたバックアップ・ファイル(<deployment-name>/var/lib/data/)の内容を確認します。
  2. 現在のOCI GoldenGateプロセスを確認します。
    1. OCI GoldenGateデプロイメント・コンソールで、Trailファイルを生成する次のプロセスを確認し、保持するTrailファイルをメモします。
      • In the Administration Service, review the details of each Extract. (Click the Extract name, and then select Details.)
      • レシーバ・サービスで、各レシーバ・パス(ある場合)の詳細を確認します。

    リストにない他のすべてのTrailファイルはパージできます。

  3. 未使用のTrailファイルをクリーンアップするためのパージ・タスクを設定します。
    1. In the OCI GoldenGate Deployment Console, open the navigation menu (hamburger icon) for the Administration Service, and then select Configuration.
    2. 「構成」ページで、「タスク」をクリックし、「証跡のパージ」をクリックします。
    3. Click Add Purge Trails Task (plus icon).
    4. 「新しいパージ・トレイルの作成」タスクで、次のフィールドに入力し、発行をクリックします。
      1. 「操作名」に、パージ・タスクの名前を入力します。
      2. 「Trail」に、Trailファイルの名前を入力し、「Trailの追加」(プラス・アイコン)をクリックします。この手順を繰り返して、Trailファイルをさらに追加します。「選択したTrail」には、Trailファイルの名前が追加されます。
      3. Keep Use Checkpoints enabled if you want to purge after all Extract and Replicat processes are finished with the file(s), as indicated by checkpoints. Disabling this option allows purging without considering checkpoints and a minimum of one file (if no MIN value is specified) or the number of files specifed with MIN are kept.
      4. 「ルールの保持」に、保持する時間、日数またはファイルの数を指定します。
      5. 「パージ頻度」に、このパージ・タスクを実行する頻度を指定します。

    必要に応じて、パージ・タスクをさらに追加したり無効にすることができます。

  4. REST APIを使用して、未使用のExtract Trailファイルをクリーンアップします。

    最初に手動バックアップを作成するようにしてください(タスク1を参照)。OCI GoldenGateデプロイメントへのREST APIコールを使用して、Trailファイルを簡単にパージできます。

    curl <console url> -u <username>:<password> -X POST -H 'Content-Type: application/json' -d 
    '{ 
        "trails": [ 
            {
                "name": "<one or two character trail prefix>"
            } 
        ], 
        "keep": [
            { 
                "type": "min", 
                "units": "<days | hours | files>", 
                "value": <number of units" 
            }
         ], 
        "name":"purge", 
        "purgeType": "trails", 
        "useCheckpoints": true | false 
    }'

    次の例は、異なる条件下でTrailファイルを削除する方法を示しています。

    例4-1:この例では、過去10時間からすべての抽出証跡保持ファイルを削除します。

    curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d 
    '{
        "name": "purge",
        "purgeType": "trails",
        "trails": [
            {
                "name": "L1"
            }
        ],
        "useCheckpoints": false,
        "keep": [
            {
                "type": "min",
                "units": "hours",
                "value": 10
            }
        ]
    }'

    例4-2:この例では、USECHECKPOINTSを使用してすべての抽出Trailファイルを削除します。

    curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d 
    '{
        "name": "purge",
        "purgeType": "trails",
        "trails": [
            {
                "name": "L1"
            }
        ],
        "useCheckpoints": true,
        "keep": [
            {
                "type": "min",
                "units": "days",
                "value": 1
            }
        ]
    }'

    例4-3:この例では、1日以上経過したL1 Extract Trailファイルを削除します。

    curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d 
    '{
        "name": "purge",
        "purgeType": "trails",
        "trails": [
            {
                "name": "L1"
            }
        ],
        "useCheckpoints": false,
        "keep": [
            {
                "type": "min",
                "units": "day",
                "value": 23
            }
        ]
    }'

    例4-4:この例では、すべてのL1 Extract Trailファイルを削除します。

    curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d 
    '{
        "name": "purge",
        "purgeType": "trails",
        "trails": [
            {
                "name": "L1"
            }
        ],
        "useCheckpoints": false,
        "keep": [
            {
                "type": "min",
                "units": "files",
                "value": 0
            }
        ]
    }'
    ノート

    curlオプション-nを使用して、ホーム・ディレクトリにある.netrcファイルからログイン・パスワードをプルし、ユーザー名とパスワードがコマンドラインを通過しないことを確認します。
  5. REST APIを使用して、未使用の初期ロード抽出ファイルまたはレシーバ・パス・トレイル・ファイルをクリーンアップします。
    いくつかの例を示します。

    例5-1:この例では、名前が"IL"に一致するすべてのTrailファイルをパージします。

    curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d 
    '{
        "name": "purge",
        "purgeType": "trails",
        "trails": [
            {
                "name": "IL"
            }
        ],
        "useCheckpoints": false,
        "keep": [
            {
                "type": "min",
                "units": "files",
                "value": 0
            }
        ]
    }'

    例5-2:この例では、アスタリスク(*)で示されているとおり、サブディレクトリdemo内のすべてのTrailファイルをパージします。

    curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d 
    '{
        "name": "purge",
        "purgeType": "trails",
        "trails": [
            {
                "name": "*",
                "path": "/u02/Deployment/var/lib/data/demo"
            }
        ],
        "useCheckpoints": false,
        "keep": [
            {
                "type": "min",
                "units": "files",
                "value": 0
            }
        ]
    }'

    アクティブなTrailファイルが保持されるようにするには、保持するTrailファイルの組合せごとにこのスクリプトを実行します。

    すべてのTrailファイルが削除されるようにするには、別の手動バックアップを作成し、保持するTrailファイルのバックアップの内容を確認します。バックアップが完了する集約サイズの縮小および速度に注意してください。