Conectar o Oracle DB ao Experience Platform usando a API Flow Service

Leia este guia para saber como conectar sua conta do Oracle DB à Adobe Experience Platform usando a Flow Service API.

Introdução

Este guia requer uma compreensão funcional dos seguintes componentes do Experience Platform:

As seções a seguir fornecem informações adicionais que você precisará saber para se conectar com êxito ao Oracle usando a API Flow Service.

Uso de APIs do Experience Platform

Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.

Coletar credenciais necessárias

Leia a Oracle DB visão geral para obter informações sobre autenticação.

Conectar Oracle DB ao Experience Platform no Azure azure

Leia as etapas abaixo para obter informações sobre como conectar sua conta do Oracle DB à Experience Platform no Azure.

Criar uma conexão base para Oracle DB no Experience Platform no Azure azure-base

Uma conexão básica vincula sua origem ao Experience Platform, armazenando detalhes de autenticação, status da conexão e uma ID exclusiva. Use essa ID para procurar arquivos de origem e identificar itens específicos a serem assimilados, incluindo seus tipos de dados e formatos.

Formato da API

POST /connections

Para criar uma ID de conexão base, faça uma solicitação POST para o ponto de extremidade /connections e forneça suas credenciais de autenticação Oracle DB como parte dos parâmetros de solicitação.

Solicitação

A solicitação a seguir cria uma conexão base para Oracle DB usando autenticação de cadeia de conexão.

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

Resposta

Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id).

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

Conectar o Oracle DB ao Experience Platform no Amazon Web Services aws

Leia as etapas abaixo para obter informações sobre como conectar sua conta do Oracle DB ao Experience Platform no AWS.

Criar uma conexão base para Oracle DB no Experience Platform no AWS aws-base

Formato da API

POST /connections

Solicitação

A solicitação a seguir cria uma conexão base para Oracle DB se conectar ao Experience Platform no 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"
      }
  }'

Resposta

Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id) e correspondente. Você pode usar a ID para criar conexão de origem e o etag para atualizar sua conta.

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

Criar um fluxo de dados para dados de Oracle DB

Agora que a conta do Oracle DB foi conectada com êxito, você pode criar um fluxo de dados e assimilar dados do banco de dados na Experience Platform.