Connexion de MySQL à Experience Platform à l’aide de l’API Flow Service
Créé pour :
- Développeur
Lisez ce guide pour savoir comment connecter votre compte MySQL à Adobe Experience Platform à l’aide de l’Flow Service API.
Prise en main
Ce guide nécessite une compréhension professionnelle des composants suivants d’Adobe Experience Platform :
- Sources : Experience Platform permet d’ingérer des données provenant de diverses sources tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services d’Experience Platform.
- Sandbox : Experience Platform fournit des sandbox virtuels qui divisent une instance Experience Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Les sections suivantes contiennent des informations supplémentaires que vous devez connaître pour réussir à vous connecter à MySQL à l’aide de l’API Flow Service.
Collecter les informations d’identification requises
Lisez la MySQL présentation pour plus d’informations sur l’authentification.
Utilisation des API Experience Platform
Lisez le guide sur Prise en main des API Experience Platform pour plus d’informations sur la manière d’effectuer avec succès des appels vers les API Experience Platform.
Connecter MySQL à Experience Platform sur Azure
Pour plus d’informations sur la connexion de votre compte MySQL à Experience Platform sur Azure, lisez les étapes ci-dessous.
Créer une connexion de base pour MySQL sur Experience Platform sur Azure
Une connexion de base lie votre source à Experience Platform, stockant les détails d’authentification, le statut de connexion et un identifiant unique. Utilisez cet identifiant pour parcourir les fichiers sources et identifier les éléments spécifiques à ingérer, y compris leurs types et formats de données.
Format d’API
POST /connections
Pour créer un identifiant de connexion de base, envoyez une requête POST au point d’entrée /connections et indiquez vos informations d’authentification MySQL dans les paramètres de la requête.
Requête
La requête suivante crée une connexion de base pour MySQL à l’aide de l’authentification par chaîne de connexion.
Afficher l’exemple de requête
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.Réponse
Une réponse réussie renvoie les détails de la nouvelle connexion de base, y compris son identifiant unique (id).
Afficher l’exemple de réponse
{
"id": "1a444165-3439-4c16-8441-653439dc166a",
"etag": "\"5b04c219-0000-0200-0000-5e179c8f0000\""
}
Requête
La requête suivante crée une connexion de base pour une source MySQL à l’aide de l’authentification de base.
Afficher l’exemple de requête
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.Réponse
Une réponse réussie renvoie les détails de la nouvelle connexion de base, y compris son identifiant unique (id).
{
"id": "025d4158-4113-403b-b551-e81724d3880c",
"etag": "\"ae004437-0000-0200-0000-67ee107e0000\""
}
Connexion de MySQL à Experience Platform sur Amazon Web Services
AVAILABILITYPour plus d’informations sur la connexion de votre compte MySQL à Experience Platform sur AWS, lisez les étapes ci-dessous.
Créer une connexion de base pour MySQL sur Experience Platform sur AWS
Format d’API
POST /connections
Requête
La requête suivante crée une connexion de base pour MySQL connecter à Experience Platform sur 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.Réponse
Une réponse réussie renvoie les détails de la nouvelle connexion de base, y compris son identifiant unique (id).
{
"id": "f847950c-1c12-4568-a550-d5312b16fdb8",
"etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}
Créer un flux de données pour les données MySQL
Maintenant que vous avez correctement connecté votre base de données MySQL, vous pouvez créer un flux de données et ingérer les données de votre base de données dans Experience Platform.