使用Flow Service API将MariaDB连接到Experience Platform

2025年5月21日

主题：

创建对象：

开发人员

阅读本指南，了解如何使用Flow Service API将您的MariaDB帐户连接到Adobe Experience Platform。

开始使用

本指南要求您对Experience Platform的以下组件有一定的了解：

源： Experience Platform允许从各种源摄取数据，同时让您能够使用Experience Platform服务来构建、标记和增强传入数据。
沙盒： Experience Platform提供了将单个Experience Platform实例划分为多个单独的虚拟环境的虚拟沙盒，以帮助开发和改进数字体验应用程序。

以下部分提供使用Flow Service API成功连接到MariaDB所需了解的其他信息。

收集所需的凭据

有关身份验证的信息，请阅读MariaDB 概述。

使用Experience Platform API

有关如何成功调用Experience Platform API的信息，请阅读Experience Platform API快速入门指南。

将MariaDB连接到Experience Platform

有关如何将您的MariaDB帐户连接到Experience Platform的信息，请阅读以下步骤。

为MariaDB创建基本连接

基本连接会保留源与Experience Platform之间的信息，包括源的身份验证凭据、连接的当前状态以及唯一的基本连接ID。基本连接ID允许您浏览和浏览源中的文件，并标识要摄取的特定项目，包括有关其数据类型和格式的信息。

API格式

POST /connections

要创建基本连接ID，请向/connections端点发出POST请求，并为您的MariaDB帐户提供适当的身份验证凭据。

基于连接字符串的身份验证

请求

以下请求使用基于连接字符串的身份验证为MariaDB源创建基本连接。

查看请求示例

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": "MariaDB connection",
    "description": "MariaDB connection",
    "auth": {
        "specName": "Connection String Based Authentication",
        "params": {
            "connectionString": "Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
        }
    },
    "connectionSpec": {
        "id": "3000eb99-cd47-43f3-827c-43caf170f015",
        "version": "1.0"
    }
}'

属性

描述

auth.params.connectionString

与您的MariaDB身份验证关联的连接字符串。 MariaDB连接字符串模式为： Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}。

connectionSpec.id

MariaDB连接规范ID为： 3000eb99-cd47-43f3-827c-43caf170f015。

响应

成功的响应返回新创建的基本连接的详细信息，包括其唯一标识符(id)。

查看响应示例

{
    "id": "be3a2d71-1fb6-4fea-ba2d-711fb61fea50",
    "etag": "\"02002624-0000-0200-0000-5e41f7040000\""
}

基本身份验证

请求

以下请求使用基本身份验证为MariaDB源创建基本连接。

查看请求示例

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": "MariaDB on Experience Platform using basic auth",
      "description": "MariaDB on Experience Platform using basic auth",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "database": "{DATABASE}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "sslMode": "{SSLMODE}"
          }
      },
      "connectionSpec": {
          "id": "3000eb99-cd47-43f3-827c-43caf170f015",
          "version": "1.0"
      }
  }'

属性

描述

auth.params.server

MariaDB数据库的名称或IP。

auth.params.database

数据库的名称。

auth.params.username

与数据库对应的用户名。

auth.params.password

与数据库对应的密码。

auth.params.sslMode

在数据传输期间对数据进行加密的方法。

connectionSpec.id

MariaDB连接规范ID为： 3000eb99-cd47-43f3-827c-43caf170f015。

响应

成功的响应返回新创建的基本连接的详细信息，包括其唯一标识符(id)。

查看响应示例

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

后续步骤

通过完成本教程，您已使用Flow Service API创建了MariaDB基本连接。您可以在下列教程中使用此基本连接ID：

recommendation-more-help