Conectar o MySQL ao Experience Platform usando a API Flow Service
Criado para:
- Desenvolvedor
Leia este guia para saber como conectar sua conta do MySQL à Adobe Experience Platform usando a Flow Service API.
Introdução
Este manual necessita de uma compreensão funcional dos seguintes componentes da Adobe 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 MySQL usando a API Flow Service.
Coletar credenciais necessárias
Leia a MySQL 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 MySQL ao Experience Platform no Azure
Leia as etapas abaixo para obter informações sobre como conectar sua conta do MySQL à Experience Platform no Azure.
Criar uma conexão base para MySQL 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 MySQL como parte dos parâmetros de solicitação.
Solicitação
A solicitação a seguir cria uma conexão base para MySQL 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": "MySQL Base Connection to Experience Platform",
"description": "Via Connection String,
"auth": {
"specName": "Connection String Based Authentication",
"params": {
"connectionString": "Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
}
},
"connectionSpec": {
"id": "26d738e0-8963-47ea-aadf-c60de735468a",
"version": "1.0"
}
}'
auth.params.connectionStringServer={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}.connectionSpec.id26d738e0-8963-47ea-aadf-c60de735468a.Resposta
Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id).
{
"id": "1a444165-3439-4c16-8441-653439dc166a",
"etag": "\"5b04c219-0000-0200-0000-5e179c8f0000\""
}
Solicitação
A solicitação a seguir cria uma conexão base para uma origem MySQL 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": "MySQL Base Connection to Experience Platform",
"description": "Via Basic Authentication",
"auth": {
"specName": "Basic Authentication",
"params": {
"server": "localhost",
"port": "443",
"database": "mysql-acme",
"username": "acme",
"password": "xxxx",
"sslMode": "DISABLED"
}
},
"connectionSpec": {
"id": "26d738e0-8963-47ea-aadf-c60de735468a",
"version": "1.0"
}
}'
auth.params.serverauth.params.databaseauth.params.usernameauth.params.passwordauth.params.sslModeconnectionSpec.id26d738e0-8963-47ea-aadf-c60de735468a.Resposta
Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id).
{
"id": "025d4158-4113-403b-b551-e81724d3880c",
"etag": "\"ae004437-0000-0200-0000-67ee107e0000\""
}
Conectar o MySQL ao Experience Platform no Amazon Web Services
AVAILABILITYLeia as etapas abaixo para obter informações sobre como conectar sua conta do MySQL ao Experience Platform no AWS.
Criar uma conexão base para MySQL no Experience Platform no AWS
Formato da API
POST /connections
Solicitação
A solicitação a seguir cria uma conexão base para MySQL 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": "MySQL on Experience Platform AWS",
"description": "MySQL on Experience Platform AWS",
"auth": {
"specName": "Basic Authentication",
"params": {
"server": "localhost",
"port": "443",
"database": "mysql-acme",
"username": "acme",
"password": "xxxx",
"sslMode": "false"
}
},
"connectionSpec": {
"id": "26d738e0-8963-47ea-aadf-c60de735468a",
"version": "1.0"
}
}'
auth.params.serverauth.params.databaseauth.params.usernameauth.params.passwordauth.params.sslModefalse.connectionSpec.id26d738e0-8963-47ea-aadf-c60de735468a.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\""
}
Criar um fluxo de dados para dados de MySQL
Agora que você conectou com êxito o banco de dados MySQL, agora é possível criar um fluxo de dados e assimilar dados do banco de dados na Experience Platform.