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

Ultimo aggiornamento: 7 agosto 2025
  • Argomenti:

Creato per:

  • Sviluppatore

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:

  • Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
  • Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

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

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

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.

Visualizza richiesta
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"
    }
  }'
Parametro
Descrizione
auth.params.connectionString
Stringa di connessione utilizzata per connettersi a Oracle DB. Schema della stringa di connessione Oracle DB: Host={HOST};Port={PORT};Sid={SID};User Id={USERNAME};Password={PASSWORD}.
connectionSpec.id
ID della specifica di connessione Oracle: d6b52d86-f0f8-475f-89d4-ce54c8527328.

Risposta

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

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