Conectar o MariaDB ao Experience Platform usando a API Flow Service
Criado para:
- Desenvolvedor
Leia este guia para saber como conectar sua conta do MariaDB à 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 MariaDB usando a API Flow Service.
Coletar credenciais necessárias
Leia a MariaDB visão geral para obter informações sobre autenticação.
Uso de APIs do Experience Platform
Leia o manual sobre introdução às APIs do Experience Platform para obter informações sobre como fazer chamadas com êxito para as APIs do Experience Platform.
Conectar MariaDB ao Experience Platform
Leia as etapas abaixo para obter informações sobre como conectar sua conta do MariaDB à Experience Platform.
Criar uma conexão base para MariaDB
Uma conexão base retém informações entre sua origem e a Experience Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e a ID de conexão base exclusiva. A ID de conexão básica permite explorar e navegar pelos arquivos de dentro da origem e identificar os itens específicos que deseja assimilar, incluindo informações sobre os 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 as credenciais de autenticação apropriadas para sua conta MariaDB.
Solicitação
A solicitação a seguir cria uma conexão base para uma origem MariaDB usando autenticação baseada em 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": "MariaDB connection",
"description": "MariaDB connection",
"auth": {
"specName": "Connection String Based Authentication",
"params": {
"connectionString": "Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
}
},
"connectionSpec": {
"id": "3000eb99-cd47-43f3-827c-43caf170f015",
"version": "1.0"
}
}'
auth.params.connectionStringServer={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}.connectionSpec.id3000eb99-cd47-43f3-827c-43caf170f015.Resposta
Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id).
{
"id": "be3a2d71-1fb6-4fea-ba2d-711fb61fea50",
"etag": "\"02002624-0000-0200-0000-5e41f7040000\""
}
Solicitação
A solicitação a seguir cria uma conexão base para uma origem MariaDB usando autenticação básica.
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": "MariaDB on Experience Platform using basic auth",
"description": "MariaDB on Experience Platform using basic auth",
"auth": {
"specName": "Basic Authentication",
"params": {
"server": "{SERVER}",
"database": "{DATABASE}",
"username": "{USERNAME}",
"password": "{PASSWORD}",
"sslMode": "{SSLMODE}"
}
},
"connectionSpec": {
"id": "3000eb99-cd47-43f3-827c-43caf170f015",
"version": "1.0"
}
}'
auth.params.serverauth.params.databaseauth.params.usernameauth.params.passwordauth.params.sslModeconnectionSpec.id3000eb99-cd47-43f3-827c-43caf170f015.Resposta
Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id).
{
"id": "f847950c-1c12-4568-a550-d5312b16fdb8",
"etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}
Próximas etapas
Seguindo este tutorial, você criou uma conexão de base MariaDB usando a API Flow Service. Você pode usar essa ID de conexão básica nos seguintes tutoriais: