Oracle Object Storageへの接続

OCI GoldenGateでターゲットとして使用されるOracleオブジェクト・ストレージへの接続の作成について学習します。

開始する前に

リソース・プリンシパルを使用して認証し、OCIリソースに接続する場合は、次のことを確認してください。

デプロイメントの動的グループを作成します。単一のデプロイメントを認可するか、コンパートメントまたはテナンシ内のすべてのデプロイメントを認可するかを選択できます。動的グループを定義する一致ルールの記述を参照してください。たとえば:
```
ALL {resource.type = 'goldengatedeployment', resource.compartment.id = 'compartment_ocid'}
```
動的グループの必要なポリシーを追加します。たとえば:
```
allow dynamic-group <dynamic-group-name> to manage object-family in tenancy
```

Vaultおよびシークレットを使用する場合は、シークレットの使用、ボールトの使用、シークレット・バンドルの読取りなど、アクセスを有効にするためのポリシーを追加してください。詳細は、「最小推奨ポリシー」を参照してください。

接続の作成

Oracle Object Storageの接続を作成するには:

OCI GoldenGateの「概要」ページで、「接続」を選択します。

「はじめに」セクションの「接続の作成」を選択して、ステップ3にスキップすることも可能です。
「接続」ページで、「接続の作成」を選択します。
「接続の作成」ページで、次のようにフィールドに入力します:
1. 「名前」に、接続の名前を入力します。
2. (オプション)「説明」に、この接続を他の接続から区別するのに役立つ説明を入力します。
3. (マルチクラウド上のGoldenGateの場合のみ)「サブスクリプション」を選択し、次のフィールドに入力します。
  1. 「コンパートメント」ドロップダウンで、リソース・アンカーが存在するコンパートメントを選択します。
  2. マルチクラウド・パートナ・リージョンを選択します。
  3. 「パートナ可用性ゾーン」を選択します。使用可能なオプションは、選択したマルチクラウド・パートナ・リージョンに基づいて移入されます。
4. 「コンパートメント」で、接続を作成するコンパートメントを選択します。
5. 「タイプ」で、「Oracle Object Storage」を選択します。
6. 「リージョン」で、「Oracle Object Storage」リージョンを選択します。
7. 「ユーザー」で、次のいずれかのオプションを選択します:
  - 現在のテナンシおよびユーザーを使用し、次の情報を入力します:
    1. 秘密キー・シークレットを選択します。別のコンパートメントにある場合は、ドロップダウンを使用してコンパートメントを変更します。
    2. (オプション)「秘密キーのパスフレーズ・シークレット」を選択します。別のコンパートメントにある場合は、ドロップダウンを使用してコンパートメントを変更します。
    3. 「公開キー・フィンガープリント」に、ユーザー用に作成されたAPIキーを入力します。
  - リソース・プリンシパルを使用して、他のOCIリソースを認証およびアクセスします。
  - 別のテナンシおよびユーザーを指定してから、次の情報を入力します:
    1. テナンシのOCIDを入力します。
    2. 「ユーザーOCID」と入力します。
    3. 秘密キー・シークレットを選択します。別のコンパートメントにある場合は、ドロップダウンを使用してコンパートメントを変更します。
    4. 「秘密キー・パスフレーズ・シークレット」を選択します。別のコンパートメントにある場合は、ドロップダウンを使用してコンパートメントを変更します。
    5. 「公開キー・フィンガープリント」に、ユーザー用に作成されたAPIキーを入力します。
  ノート:
  - シークレットとは、パスワード、証明書、SSHキー、OCIサービスで使用する認証トークンなどの資格証明です。シークレットを作成するには、シークレットの作成を参照してください。次を確認します:
    - 「手動シークレット生成」を選択します。
    - 資格証明をシークレット・コンテンツに貼り付けます。
  - パスワード・シークレットを使用しない場合は、このフォームの下部にある「拡張オプション」の下の「セキュリティ」セクションで「ボールトでシークレットを使用」の選択を解除してください。
  - シークレット・コンテンツを更新する必要がある場合は、次のことを確認してください:
    - プレーン・テキスト・テンプレートを使用して新しいシークレット・バージョンを作成し、更新されたコンテンツを指定します。詳細は、シークレットのコンテンツの更新を参照してください。
    - キャッシュされたシークレット・コンテンツをクリアするには、接続をリフレッシュします。
8. 拡張オプションの表示を展開します。次のオプションを構成できます。
  - セキュリティ
    - この接続にパスワード・シークレットを使用しない「ボールト・シークレットの使用」の選択を解除します。選択されていない場合:
      - すべての暗号化キー管理をOracleに任せるには、「Oracle管理暗号化キーの使用」を選択します。
      - 「顧客管理暗号化キーの使用」を選択して、OCI Vaultに格納されている特定の暗号化キーを選択し、接続資格証明を暗号化します。
  - ネットワーク接続性
    - 共有エンドポイント: 割り当てられたデプロイメントとエンドポイントを共有します。デプロイメントのイングレスIPからの接続を許可する必要があります。
    - 専用エンドポイント: VCN内の割り当てられたサブネット内の専用エンドポイントを介したネットワーク・トラフィック用。この接続のイングレスIPからの接続を許可する必要があります。
      ノート:
      
      専用接続が7日間未割当てのままの場合、サービスはそれを共有接続に変換します。
      
      Oracle GoldenGate接続についてさらに学習します。
  - セキュリティ属性: Zero Trust Packet Routing (ZPR)を使用して、この接続へのアクセスを制御するセキュリティ属性を追加します。
  - タグ: タグを追加すると、リソースを編成できます。
「作成」を選択します。

接続が作成されると、「接続」リストに表示されます。接続をデプロイメントに割り当てて、レプリケーションのターゲットとして使用するようにしてください。

次の手順

既知の問題

リソース・プリンシパル使用時のOracle Object Storageレプリケーション・エラー

Oracle Object Storage接続でリソース・プリンシパル認証が使用されている場合、Replicatは次のエラーで失敗します。

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

回避方法:この問題を回避するには、接続を編集してから、別の認証方法を選択します。

Oracleオブジェクト・ストレージ接続のユーザーOCIDが一致しない(フェデレーテッド・ユーザーのみ)

フェデレーテッド・ユーザーがOracleオブジェクト・ストレージ接続の作成時に「現在のユーザーを使用」を選択した場合、そのOCIDがシステムによって取得されたOC IDと一致しません。

回避策: Oracleオブジェクト・ストレージ接続を作成する場合は、必ず「別のユーザーの指定」を選択し、フェデレーテッド・ユーザーのOCIDを入力してください。

ユーザーOCIDを検索するには、Oracle Cloudコンソールのグローバル・ヘッダーで「プロファイル」を選択し、ユーザー名を選択します。「ユーザーの詳細」ページの「ユーザー情報」で、OCIDの「表示」を選択します。