Conectar o Oracle DB ao Experience Platform usando a API Flow Service
Criado para:
- Desenvolvedor
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:
- Fontes: o Experience Platform permite a assimilação de dados de várias fontes, ao mesmo tempo em que fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
- Sandboxes: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
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
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
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.
Exibir solicitaçã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"
}
}'
auth.params.connectionStringHost={HOST};Port={PORT};Sid={SID};User Id={USERNAME};Password={PASSWORD}.connectionSpec.idd6b52d86-f0f8-475f-89d4-ce54c8527328.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
AVAILABILITYLeia 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
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"
}
}'
auth.params.serverauth.params.portauth.params.databaseauth.params.usernameauth.prams.passwordauth.params.schemaauth.params.sslModeconnectionSpec.idd6b52d86-f0f8-475f-89d4-ce54c8527328.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.