Connetti Oracle DB ad Experience Platform utilizzando l'API Flow Service

Leggi questa guida per scoprire come collegare il tuo account Oracle DB a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Experience Platform:

Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per connettersi correttamente a Oracle utilizzando l'API Flow Service.

Utilizzo delle API di Experience Platform

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, consulta la guida introduttiva alle API di Experience Platform.

Raccogli le credenziali richieste

Per informazioni sull'autenticazione, leggere la Oracle DB panoramica.

Connetti Oracle DB ad Experience Platform su Azure azure

Per informazioni su come collegare l'account Oracle DB ad Experience Platform su Azure, leggere la procedura seguente.

Crea una connessione di base per Oracle DB in Experience Platform su Azure azure-base

Una connessione di base collega l’origine ad Experience Platform, memorizzando i dettagli di autenticazione, lo stato della connessione e un ID univoco. Utilizza questo ID per sfogliare i file sorgente e identificare elementi specifici da acquisire, compresi i relativi tipi di dati e formati.

Formato API

POST /connections

Per creare un ID connessione di base, effettuare una richiesta POST all'endpoint /connections e fornire le credenziali di autenticazione Oracle DB come parte dei parametri della richiesta.

Richiesta

La richiesta seguente crea una connessione di base per Oracle DB utilizzando l'autenticazione della stringa di connessione.

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

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id).

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

Connetti Oracle DB ad Experience Platform su Amazon Web Services aws

Per informazioni su come collegare il tuo account Oracle DB ad Experience Platform su AWS, leggi i passaggi seguenti.

Crea una connessione di base per Oracle DB su Experience Platform su AWS aws-base

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per Oracle DB per connettersi ad Experience Platform su AWS.

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

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso l'identificatore univoco (id) e i corrispondenti. Puoi usare l'ID per creare la connessione di origine e etag per aggiornare l'account.

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

Crea un flusso di dati per Oracle DB dati

Dopo aver connesso correttamente l'account Oracle DB, è ora possibile creare un flusso di dati e acquisire dati dal database in Experience Platform.