使用Oracle DB API連線Flow Service至Experience Platform

最後更新： 2025年8月7日

主題：

建立對象：

開發人員

閱讀本指南，瞭解如何使用Oracle DBAPIFlow Service 將您的帳戶連結至Adobe Experience Platform。

快速入門

本指南需要您深入瞭解下列Experience Platform元件：

來源： Experience Platform允許從各種來源擷取資料，同時讓您能夠使用Experience Platform服務來建構、加標籤以及增強傳入的資料。
沙箱： Experience Platform提供的虛擬沙箱可將單一Experience Platform執行個體分割成個別的虛擬環境，以利開發及改進數位體驗應用程式。

下列章節提供您需瞭解的其他資訊，才能使用Oracle API成功連線到Flow Service。

使用Experience Platform API

如需如何成功呼叫Experience Platform API的詳細資訊，請參閱Experience Platform API快速入門指南。

收集必要的認證

閱讀Oracle DB 總覽以取得驗證的相關資訊。

在Azure上連線Oracle DB至Experience Platform

請閱讀下列步驟，以瞭解如何在Azure上將您的Oracle DB帳戶連線至Experience Platform。

在Azure上的Experience Platform上為Oracle DB建立基礎連線

基礎連線會將您的來源連結至Experience Platform，以儲存驗證詳細資料、連線狀態和唯一ID。使用此ID來瀏覽來源檔案並識別要擷取的特定專案，包括其資料型別和格式。

API格式

POST /connections

若要建立基底連線ID，請對/connections端點提出POST要求，並提供您的Oracle DB驗證認證作為要求引數的一部分。

要求

下列要求使用連線字串驗證為Oracle DB建立基礎連線。

檢視請求

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

參數

說明

auth.params.connectionString

用來連線到Oracle DB的連線字串。 Oracle DB連線字串模式為： Host={HOST};Port={PORT};Sid={SID};User Id={USERNAME};Password={PASSWORD}。

connectionSpec.id

Oracle連線規格識別碼： d6b52d86-f0f8-475f-89d4-ce54c8527328。

回應

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

檢視回應

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

將Oracle DB連線至Amazon Web Services上的Experience Platform

AVAILABILITY

本節適用於在Amazon Web Services (AWS)上執行的Experience Platform實作。目前有限數量的客戶可使用在AWS上執行的Experience Platform 。若要進一步瞭解支援的Experience Platform基礎結構，請參閱Experience Platform多雲端總覽。

請閱讀下列步驟，以瞭解如何在AWS上將您的Oracle DB帳戶連結至Experience Platform。

在AWS上的Experience Platform上為Oracle DB建立基礎連線

API格式

POST /connections

要求

下列要求會建立Oracle DB的基礎連線，以連線至AWS上的Experience Platform。

檢視請求

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

屬性

說明

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值固定為： d6b52d86-f0f8-475f-89d4-ce54c8527328.

回應

成功的回應會傳回新建立的基礎連線的詳細資料，包括其唯一識別碼(id)和對應的識別碼。您可以使用識別碼來建立來源連線，並使用etag來更新您的帳戶。

檢視回應

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

建立Oracle DB資料的資料流

現在您已經成功連線Oracle DB帳戶，您現在可以建立資料流，並將資料庫中的資料擷取到Experience Platform。

recommendation-more-help