Microsoft Fabric Eventstreamへの接続

OCI GoldenGateソースまたはターゲットとしてMicrosoft Fabric Eventstreamを使用する接続の作成について学習します。

開始する前に

接続を作成する前に、次のことを確認してください。

  • OCI GoldenGateがソースおよびターゲットに接続する方法を確認します。

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

  • TLS/mTLSを使用している場合は、JKSトラストストアまたはトラストストアおよびキーストアをPKCS12形式に変換して接続で使用します。

    1. JDKのkeytoolユーティリティを使用して、PKCS12形式に変換します。

      キーストアの場合、次の例に示すように、keytoolユーティリティによってパスワードの入力が求められます。 
      keytool -importkeystore -srckeystore [MY_KEYSTORE.jks] -destkeystore [MY_KEYSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]
      トラストストアの場合、次の例に示すように、keytoolユーティリティによってパスワードの入力が求められます。
      keytool -importkeystore -srckeystore [MY_TRUSTSTORE.jks] -destkeystore [MY_TRUSTSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]
    2. キーストアおよびトラストストアを変換した後、次の行をKafkaプロデューサ・プロパティ・ファイルに追加し、変更を保存します:
      ssl.truststore.type=PKCS12
ssl.keystore.type=PKCS12
    3. 拡張オプションの「設定」セクションの接続のプロデューサ・プロパティにファイルをアップロードします。

ソース接続の作成

ソースの Microsoft Fabric Eventstream接続を作成するには:
  1. OCI GoldenGateの「概要」ページで、「接続」をクリックします。
    「はじめに」セクションの「接続の作成」をクリックして、ステップ3にスキップすることもできます。
  2. 「接続」ページで、「接続の作成」をクリックします。
  3. 「接続の作成」ページで、次のようにフィールドに入力します:
    1. 「名前」に、接続の名前を入力します。
    2. (オプション)「説明」に、この接続を他の接続から区別するのに役立つ説明を入力します。
    3. (GoldenGate on Multicloudの場合のみ) サブスクリプションを選択し、次のフィールドに入力します。
      1. 「コンパートメント」ドロップダウンで、リソース・アンカーが存在するコンパートメントを選択します。
      2. マルチクラウド・パートナ・リージョンを選択します。
      3. 「パートナ可用性ゾーン」を選択します。使用可能なオプションは、選択したマルチクラウド・パートナ・リージョンに基づいて移入されます。
    4. 「コンパートメント」で、接続を作成するコンパートメントを選択します。
    5. 「タイプ」ドロップダウンから、「Microsoft Fabric Eventstream」を選択します。
    6. 「Bootstrap servers:
      1. ブートストラップ・サーバーのホストおよびポート番号を入力します。プライベートIPは、ホスト名がサブネットから解決できない場合、またはSSL/TLSを使用する場合にのみ入力します。

        ノート:

        プライベートIPを入力すると、OCI GoldenGateによってプライベートIPがip-10-0-0-0.ociggsvc.oracle.vcn.comという形式でリライトされます。

        ヒント :

        プライベート・エンドポイントに対するトラバースを許可するには、クラスタ内のすべてのノードにFQDNが必要です。
      2. (オプション)別のブートストラップ・サーバを追加するには、「+ブートストラップ・サーバ」をクリックします。
    7. 「セキュリティ・プロトコル」で、次のいずれかを選択し、対応するフィールドに入力します:
      • 平文(Plaintext)
      • SASL over plaintext
      • SASL over SSL
      • SSL
    8. 拡張オプションの表示を展開します。次のオプションを構成できます。
      • セキュリティ
        • この接続にパスワード・シークレットを使用しない場合は、「ボールト・シークレットの使用」の選択を解除します。選択されていない場合:
          • すべての暗号化キー管理をOracleに任せるには、「Oracle管理暗号化キーの使用」を選択します。
          • 「顧客管理暗号化キーの使用」を選択して、接続資格証明を暗号化するOCI Vaultに格納されている特定の暗号化キーを選択します。
      • ネットワーク接続性
        • 共有エンドポイント: 割り当てられたデプロイメントとエンドポイントを共有します。デプロイメントのイングレスIPからの接続を許可する必要があります。
        • 専用エンドポイント: VCN内の割り当てられたサブネット内の専用エンドポイントを介したネットワーク・トラフィック用。この接続のイングレスIPからの接続を許可する必要があります。

          ノート:

          • 専用接続が7日間未割当てのままの場合、サービスはそれを共有接続に変換します。
          • Oracle GoldenGate接続についてさらに学習します。
      • 設定
        • この接続をExtractに使用する場合は、「コンシューマ」または「プロデューサ・プロパティ」ファイル(.properties)をドラッグ・アンド・ドロップするか選択します。
        • Kafkaからキャプチャするには、次のいずれかのデシリアライザまたはコンバータを使用してKafkaコンシューマ・プロパティ・ファイル(.properties)を作成します:
          • JSONデシリアライザのKafkaコンシューマ・プロパティ:
            key.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
value.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
          • JSONコンバータのKafkaコンシューマ・プロパティ:
            key.converter=org.apache.kafka.connect.json.JsonConverter
value.converter=org.apache.kafka.connect.json.JsonConverter
          • AvroコンバータのKafkaコンシューマ・プロパティ:
            key.converter=io.confluent.connect.avro.AvroConverter
value.converter=io.confluent.connect.avro.AvroConverter
      • セキュリティ属性: Zero Trust Packet Routing (ZPR)を使用して、この接続へのアクセスを制御するセキュリティ属性を追加します。
      • タグ: タグを追加すると、リソースを編成できます。
  4. 「作成」をクリックします。
接続が作成されると、「接続」リストに表示されます。接続をデプロイメントに割り当てて、レプリケーションのソースまたはターゲットとして使用するようにしてください。

ターゲット接続の作成

ターゲットの Microsoft Fabric Eventstream接続を作成するには:
  1. OCI GoldenGateの「概要」ページで、「接続」をクリックします。
    「はじめに」セクションの「接続の作成」をクリックして、ステップ3にスキップすることもできます。
  2. 「接続」ページで、「接続の作成」をクリックします。
  3. 「接続の作成」ページで、次のようにフィールドに入力します:
    1. 「名前」に、接続の名前を入力します。
    2. (オプション)「説明」に、この接続を他の接続から区別するのに役立つ説明を入力します。
    3. (GoldenGate on Multicloudの場合のみ) サブスクリプションを選択し、次のフィールドに入力します。
      1. 「コンパートメント」ドロップダウンで、リソース・アンカーが存在するコンパートメントを選択します。
      2. マルチクラウド・パートナ・リージョンを選択します。
      3. 「パートナ可用性ゾーン」を選択します。使用可能なオプションは、選択したマルチクラウド・パートナ・リージョンに基づいて移入されます。
    4. 「コンパートメント」で、接続を作成するコンパートメントを選択します。
    5. 「タイプ」ドロップダウンから、「Microsoft Fabric Eventstream」を選択します。
    6. 「Bootstrap servers:
      1. ブートストラップ・サーバーのホストおよびポート番号を入力します。プライベートIPは、ホスト名がサブネットから解決できない場合、またはSSL/TLSを使用する場合にのみ入力します。

        ノート:

        プライベートIPを入力すると、OCI GoldenGateによってプライベートIPがip-10-0-0-0.ociggsvc.oracle.vcn.comという形式でリライトされます。

        ヒント :

        プライベート・エンドポイントに対するトラバースを許可するには、クラスタ内のすべてのノードにFQDNが必要です。
      2. (オプション)別のブートストラップ・サーバを追加するには、「+ブートストラップ・サーバ」をクリックします。
    7. 「セキュリティ・プロトコル」で、次のいずれかを選択し、対応するフィールドに入力します:
      • 平文(Plaintext)
      • SASL over plaintext
      • SASL over SSL
      • SSL
    8. 拡張オプションの表示を展開します。次のオプションを構成できます。
      • セキュリティ
        • この接続にパスワード・シークレットを使用しない場合は、「ボールト・シークレットの使用」の選択を解除します。選択されていない場合:
          • すべての暗号化キー管理をOracleに任せるには、「Oracle管理暗号化キーの使用」を選択します。
          • 「顧客管理暗号化キーの使用」を選択して、接続資格証明を暗号化するOCI Vaultに格納されている特定の暗号化キーを選択します。
      • ネットワーク接続性
        • 共有エンドポイント: 割り当てられたデプロイメントとエンドポイントを共有します。デプロイメントのイングレスIPからの接続を許可する必要があります。
        • 専用エンドポイント: VCN内の割り当てられたサブネット内の専用エンドポイントを介したネットワーク・トラフィック用。この接続のイングレスIPからの接続を許可する必要があります。

          ノート:

          • 専用接続が7日間未割当てのままの場合、サービスはそれを共有接続に変換します。
          • Oracle GoldenGate接続についてさらに学習します。
      • 設定KafkaレプリケーションでSnappy圧縮を使用するには、プロデューサ・プロパティをドラッグ・アンド・ドロップまたは選択し、圧縮OCI GoldenGate (Confluent) Kafkaレプリケーションの使用の説明に従ってレプリケーション設定を変更します。
      • セキュリティ属性: Zero Trust Packet Routing (ZPR)を使用して、この接続へのアクセスを制御するセキュリティ属性を追加します。
      • タグ: タグを追加すると、リソースを編成できます。
  4. 「作成」をクリックします。
接続が作成されると、「接続」リストに表示されます。接続をデプロイメントに割り当てて、レプリケーションのソースまたはターゲットとして使用するようにしてください。