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

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

トピック：
Sources

作成対象：

Developer

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

はじめに

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

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

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

必要な資格情報の収集

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

Experience Platform APIの使用

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

MySQLをAzure上のExperience Platformに接続 azure

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

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

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

API 形式

POST /connections

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

接続文字列ベースの認証

リクエスト

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

accordion

リクエストの例を表示

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": "MySQL Base Connection to Experience Platform",
      "description": "Via Connection String,
      "auth": {
          "specName": "Connection String Based Authentication",
          "params": {
              "connectionString": "Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
          }
      },
      "connectionSpec": {
          "id": "26d738e0-8963-47ea-aadf-c60de735468a",
          "version": "1.0"
      }
  }'

table 0-row-2 1-row-2 2-row-2
プロパティ	説明
`auth.params.connectionString`	アカウントに関連付けられているMySQL接続文字列。 MySQL接続文字列パターンは`Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}`です。
`connectionSpec.id`	MySQL接続仕様ID: `26d738e0-8963-47ea-aadf-c60de735468a`。

応答

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

accordion

応答の例を表示

code language-json
`{ "id": "1a444165-3439-4c16-8441-653439dc166a", "etag": "\"5b04c219-0000-0200-0000-5e179c8f0000\"" }`

基本認証

リクエスト

次のリクエストは、基本認証を使用してMySQL ソースのベース接続を作成します。

accordion

リクエストの例を表示

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": "MySQL Base Connection to Experience Platform",
      "description": "Via Basic Authentication",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "localhost",
              "port": "443",
              "database": "mysql-acme",
              "username": "acme",
              "password": "xxxx",
              "sslMode": "DISABLED"
          }
      },
      "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
プロパティ	説明
`auth.params.server`	MySQL データベースの名前またはIP。
`auth.params.database`	データベースの名前。
`auth.params.username`	データベースに対応するユーザー名。
`auth.params.password`	データベースに対応するパスワード。
`auth.params.sslMode`	データ転送時にデータを暗号化する方法。
`connectionSpec.id`	MySQL 接続仕様 ID は `26d738e0-8963-47ea-aadf-c60de735468a` です。

応答

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

accordion

応答の例を表示

code language-json
`{ "id": "025d4158-4113-403b-b551-e81724d3880c", "etag": "\"ae004437-0000-0200-0000-67ee107e0000\"" }`

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

AVAILABILITY

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

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

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

API 形式

POST /connections

リクエスト

次のリクエストは、MySQLが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": "MySQL on Experience Platform AWS",
      "description": "MySQL on Experience Platform AWS",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "localhost",
              "port": "443",
              "database": "mysql-acme",
              "username": "acme",
              "password": "xxxx",
              "sslMode": "false"
          }
      },
      "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
プロパティ	説明
`auth.params.server`	MySQL データベースの名前またはIP。
`auth.params.database`	データベースの名前。
`auth.params.username`	データベースに対応するユーザー名。
`auth.params.password`	データベースに対応するパスワード。
`auth.params.sslMode`	サーバーサポートに応じて、SSLが適用されるかどうかを制御するブール値。この設定のデフォルト値は`false`です。
`connectionSpec.id`	MySQL 接続仕様 ID は `26d738e0-8963-47ea-aadf-c60de735468a` です。

応答

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

応答の例を表示

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

MySQL データのデータフローを作成

これで、MySQL データベースを正常に接続できました。これで、データフローを作成し、データベースからExperience Platformにデータを取り込むことができます。

recommendation-more-help

experience-platform-help-sources