Conectar Oracle DB a Experience Platform mediante la API Flow Service

Lea esta guía para aprender a conectar su cuenta de Oracle DB a Adobe Experience Platform mediante la Flow Service API.

Introducción

Esta guía requiere una comprensión práctica de los siguientes componentes de Experience Platform:

Las secciones siguientes proporcionan información adicional que necesitará conocer para conectarse correctamente a Oracle mediante la API Flow Service.

Uso de API de Experience Platform

Para obtener información sobre cómo realizar llamadas correctamente a las API de Experience Platform, consulte la guía sobre introducción a las API de Experience Platform.

Recopilar credenciales necesarias

Lea la Oracle DB descripción general para obtener información sobre la autenticación.

Conectar Oracle DB a Experience Platform en Azure azure

Lea los pasos a continuación para obtener información sobre cómo conectar su cuenta de Oracle DB a Experience Platform en Azure.

Crear una conexión base para Oracle DB en Experience Platform en Azure azure-base

Una conexión base vincula el origen a Experience Platform y almacena los detalles de autenticación, el estado de la conexión y un ID único. Utilice este ID para examinar los archivos de origen e identificar elementos específicos que se van a introducir, incluidos sus tipos de datos y formatos.

Formato de API

POST /connections

Para crear un identificador de conexión base, realice una petición POST al extremo /connections y proporcione sus credenciales de autenticación Oracle DB como parte de los parámetros de solicitud.

Solicitud

La siguiente solicitud crea una conexión base para Oracle DB mediante la autenticación de cadena de conexión.

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

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id).

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

Conectar Oracle DB a Experience Platform en Amazon Web Service aws

Lea los pasos a continuación para obtener información sobre cómo conectar su cuenta de Oracle DB a Experience Platform en AWS.

Crear una conexión base para Oracle DB en Experience Platform en AWS aws-base

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para que Oracle DB se conecte a Experience Platform en 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"
      }
  }'

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id) y sus correspondientes. Puede usar la ID para crear conexión de origen y la etag para actualizar su cuenta.

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

Crear un flujo de datos para Oracle DB datos

Ahora que ha conectado correctamente su cuenta de Oracle DB, puede crear un flujo de datos e introducir datos de su base de datos en Experience Platform.