Flow Service APIを使用してOracle DBをExperience Platformに接続します

最終更新日： 2025年10月14日

トピック：
Sources

作成対象：

Developer

このガイドでは、Flow Service APIを使用してOracle DB アカウントをAdobe Experience Platformに接続する方法について説明します。

はじめに

このガイドは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

ソース : Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
サンドボックス : Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。

次の節では、Flow Service APIを使用してOracleに正常に接続するために知っておく必要がある追加情報を示します。

Experience Platform APIの使用

Experience Platform APIの呼び出しを正常に行う方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。

必要な資格情報の収集

認証について詳しくは、Oracle DB 概要を参照してください。

Oracle DBをAzure上のExperience Platformに接続 azure

Oracle DB アカウントをAzure上のExperience Platformに接続する方法について詳しくは、以下の手順を参照してください。

Azure上のExperience PlatformでOracle DBのベース接続を作成する azure-base

ベース接続は、認証の詳細、接続ステータス、一意のIDを保存して、ソースをExperience Platformにリンクします。このIDを使用して、ソースファイルを参照し、取り込む特定の項目（データタイプや形式など）を特定します。

API 形式

POST /connections

ベース接続IDを作成するには、/connections エンドポイントにPOST リクエストを行い、リクエストパラメーターの一部としてOracle DB認証情報を指定します。

リクエスト

次のリクエストは、接続文字列認証を使用してOracle DBのベース接続を作成します。

リクエストを表示

code language-shell

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Oracle DB base connection",
    "description": "A base connection to connect Oracle DB to Experience Platform on Azure",
    "auth": {
      "specName": "ConnectionString",
      "params": {
        "connectionString": "Host={HOST};Port={PORT};Sid={SID};UserId={USERNAME};Password={PASSWORD}"
      }
    },
    "connectionSpec": {
      "id": "d6b52d86-f0f8-475f-89d4-ce54c8527328",
      "version": "1.0"
    }
  }'

table 0-row-2 1-row-2 2-row-2
パラメーター	説明
`auth.params.connectionString`	Oracle DBへの接続に使用される接続文字列。 Oracle DB接続文字列パターンは`Host={HOST};Port={PORT};Sid={SID};User Id={USERNAME};Password={PASSWORD}`です。
`connectionSpec.id`	Oracle接続仕様ID: `d6b52d86-f0f8-475f-89d4-ce54c8527328`。

応答

リクエストが成功した場合は、一意の ID（id）を含め、新しく作成されたベース接続の詳細が返されます。

応答を表示

code language-json
`{ "id": "f088e4f2-2464-480c-88e4-f22464b80c90", "etag": "\"43011faa-0000-0200-0000-5ea740cd0000\"" }`

Oracle DBをAmazon Web Services上のExperience Platformに接続 aws

AVAILABILITY

この節は、Amazon Web Services（AWS）で動作するExperience Platformの実装に適用されます。 AWS上で動作するExperience Platformは、現在、一部のお客様にご利用いただけます。サポートされているExperience Platform インフラストラクチャについて詳しくは、Experience Platform マルチクラウドの概要を参照してください。

Oracle DB アカウントをAWS上のExperience Platformに接続する方法について詳しくは、以下の手順を参照してください。

AWS上のExperience PlatformでOracle DBのベース接続を作成する aws-base

API 形式

POST /connections

リクエスト

次のリクエストは、Oracle DBがAWS上のExperience Platformに接続するためのベース接続を作成します。

リクエストを表示

code language-shell

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Oracle DB on Experience Platform AWS",
      "description": "Oracle DB on Experience Platform AWS",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "diy.us-dawkins-1.oraclecloud.com",
              "port": "1521",
              "database": "mcmg_profits_diy.oraclecloud.com",
              "username": "Admin",
              "password": "xxxx",
              "schema": "ADMIN",
              "sslMode": "true"
          }
      },
      "connectionSpec": {
          "id": "26d738e0-8963-47ea-aadf-c60de735468a",
          "version": "1.0"
      }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
プロパティ	説明
`auth.params.server`	Oracle DB サーバーのIP アドレスまたはホスト名。
`auth.params.port`	Oracle DB サーバーのポート番号。
`auth.params.database`	接続先のOracle DB インスタンスの名前。
`auth.params.username`	Oracle DB インスタンスに関連付けられているユーザーアカウント。
`auth.prams.password`	Oracle DB ユーザーアカウントに対応するパスワード。
`auth.params.schema`	データベースオブジェクトを含むスキーマ。
`auth.params.sslMode`	SSL メジャーが適用されるかどうかを示すブール値。
`connectionSpec.id`	Oracle DB ソースに対応する接続仕様ID。このID値は次のように固定されています：`d6b52d86-f0f8-475f-89d4-ce54c8527328.`

応答

応答が成功すると、新しく作成されたベース接続の詳細（一意の識別子（id）とそれに対応する識別子を含む）が返されます。 IDを使用してソース接続を作成し、etagからアカウントを更新できます。

応答を表示

code language-json
`{ "id": "f847950c-1c12-4568-a550-d5312b16fdb8", "etag": "\"0c0099f4-0000-0200-0000-67da91710000\"" }`

Oracle DB データのデータフローを作成

Oracle DB アカウントを正常に接続したので、データフローを作成し、データベースからExperience Platformにデータを取り込むことができます。

recommendation-more-help

experience-platform-help-sources