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

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

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

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

基礎連線會將您的來源連結至Experience Platform,以儲存驗證詳細資料、連線狀態和唯一ID。 使用此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連線規格識別碼: d6b52d86-f0f8-475f-89d4-ce54c8527328

回應

成功的回應會傳回新建立的基礎連線的詳細資料,包括其唯一識別碼(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多雲端總覽

請閱讀下列步驟,以瞭解如何在AWS上將您的Oracle DB帳戶連結至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值固定為: d6b52d86-f0f8-475f-89d4-ce54c8527328.

回應

成功的回應會傳回新建立的基礎連線的詳細資料,包括其唯一識別碼(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
337b99bb-92fb-42ae-b6b7-c7042161d089