Connetti MySQL ad Experience Platform utilizzando l'API Flow Service
Creato per:
- Sviluppatore
Leggi questa guida per scoprire come collegare il tuo account MySQL a Adobe Experience Platform utilizzando Flow Service API.
Introduzione
Questa guida richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
- Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
- Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per connettersi correttamente a MySQL utilizzando l'API Flow Service.
Raccogli le credenziali richieste
Per informazioni sull'autenticazione, leggere la MySQL panoramica.
Utilizzo delle API di Experience Platform
Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, leggi la guida guida introduttiva alle API di Experience Platform.
Connetti MySQL ad Experience Platform su Azure
Per informazioni su come collegare l'account MySQL ad Experience Platform su Azure, leggere la procedura seguente.
Crea una connessione di base per MySQL in Experience Platform su Azure
Una connessione di base collega l’origine ad Experience Platform, memorizzando i dettagli di autenticazione, lo stato della connessione e un ID univoco. Utilizza questo ID per sfogliare i file sorgente e identificare elementi specifici da acquisire, compresi i relativi tipi di dati e formati.
Formato API
POST /connections
Per creare un ID connessione di base, effettuare una richiesta POST all'endpoint /connections
e fornire le credenziali di autenticazione MySQL come parte dei parametri della richiesta.
Richiesta
La richiesta seguente crea una connessione di base per MySQL utilizzando l'autenticazione basata su stringa di connessione.
Esempio di richiesta View
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.connectionString
Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}
.connectionSpec.id
26d738e0-8963-47ea-aadf-c60de735468a
.Risposta
In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id
).
{
"id": "1a444165-3439-4c16-8441-653439dc166a",
"etag": "\"5b04c219-0000-0200-0000-5e179c8f0000\""
}
Richiesta
La richiesta seguente crea una connessione di base per un'origine MySQL utilizzando l'autenticazione di base.
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.server
auth.params.database
auth.params.username
auth.params.password
auth.params.sslMode
connectionSpec.id
26d738e0-8963-47ea-aadf-c60de735468a
.Risposta
In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id
).
{
"id": "025d4158-4113-403b-b551-e81724d3880c",
"etag": "\"ae004437-0000-0200-0000-67ee107e0000\""
}
Connetti MySQL ad Experience Platform su Amazon Web Services
Per informazioni su come collegare il tuo account MySQL ad Experience Platform su AWS, leggi i passaggi seguenti.
Crea una connessione di base per MySQL su Experience Platform su AWS
Formato API
POST /connections
Richiesta
La richiesta seguente crea una connessione di base per MySQL per connettersi ad Experience Platform su 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.server
auth.params.database
auth.params.username
auth.params.password
auth.params.sslMode
false
.connectionSpec.id
26d738e0-8963-47ea-aadf-c60de735468a
.Risposta
In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id
).
{
"id": "f847950c-1c12-4568-a550-d5312b16fdb8",
"etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}
Crea un flusso di dati per MySQL dati
Dopo aver connesso correttamente il database MySQL, è ora possibile creare un flusso di dati e acquisire dati dal database in Experience Platform.