使用Flow Service API連線MariaDB至Experience Platform

Last update: Wed May 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

閱讀本指南，瞭解如何使用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

若要建立基底連線識別碼，請對/connections端點提出POST要求，並為您的MariaDB帳戶提供適當的驗證認證。

以連線字串為基礎的驗證

要求

下列要求使用以連線字串為基礎的驗證，為MariaDB來源建立基礎連線。

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": "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"
    }
}'

table 0-row-2 1-row-2 2-row-2
屬性	說明
`auth.params.connectionString`	與您的MariaDB驗證關聯的連線字串。 MariaDB連線字串模式為： `Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}`。
`connectionSpec.id`	MariaDB連線規格識別碼為： `3000eb99-cd47-43f3-827c-43caf170f015`。

回應

成功的回應會傳回新建立的基礎連線的詳細資料，包括其唯一識別碼(id)。

accordion

檢視回應範例

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

基本驗證

要求

下列要求使用基本驗證建立MariaDB來源的基本連線。

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": "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"
      }
  }'

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`	MariaDB資料庫的名稱或IP。
`auth.params.database`	資料庫的名稱。
`auth.params.username`	與您的資料庫對應的使用者名稱。
`auth.params.password`	與資料庫對應的密碼。
`auth.params.sslMode`	資料傳輸期間加密資料的方法。
`connectionSpec.id`	MariaDB連線規格識別碼為： `3000eb99-cd47-43f3-827c-43caf170f015`。

回應

成功的回應會傳回新建立的基礎連線的詳細資料，包括其唯一識別碼(id)。

accordion

檢視回應範例

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

後續步驟

依照此教學課程，您已使用Flow Service API建立MariaDB基礎連線。您可以在下列教學課程中使用此基本連線ID：

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089