Documentazione Experience Platform Guida ai connettori di origini

Connetti MariaDB ad Experience Platform utilizzando l'API Flow Service

Last update: Wed May 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore

Leggi questa guida per scoprire come collegare il tuo account MariaDB a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di 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 MariaDB utilizzando l'API Flow Service.

Raccogli le credenziali richieste

Per informazioni sull'autenticazione, leggere la MariaDB 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 MariaDB ad Experience Platform

Per informazioni su come collegare il tuo account MariaDB ad Experience Platform, leggi i passaggi seguenti.

Crea una connessione di base per MariaDB

Una connessione di base mantiene le informazioni tra l’origine e Experience Platform, incluse le credenziali di autenticazione dell’origine, lo stato corrente della connessione e l’ID univoco della connessione di base. L’ID della connessione di base consente di esplorare e navigare tra i file dall’interno dell’origine e identificare gli elementi specifici che desideri acquisire, comprese le informazioni relative ai tipi di dati e ai 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 appropriate per l'account MariaDB.

Autenticazione basata su stringa di connessione

Richiesta

La richiesta seguente crea una connessione di base per un'origine MariaDB utilizzando l'autenticazione basata su stringa di connessione.

accordion

Esempio di richiesta View

code language-shell

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"
    }
}'

table 0-row-2 1-row-2 2-row-2
Proprietà	Descrizione
`auth.params.connectionString`	Stringa di connessione associata all'autenticazione MariaDB. Schema della stringa di connessione MariaDB: `Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}`.
`connectionSpec.id`	ID della specifica di connessione MariaDB: `3000eb99-cd47-43f3-827c-43caf170f015`.

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id).

accordion

Visualizza esempio di risposta

code language-json
`{ "id": "be3a2d71-1fb6-4fea-ba2d-711fb61fea50", "etag": "\"02002624-0000-0200-0000-5e41f7040000\"" }`

Autenticazione di base

Richiesta

La richiesta seguente crea una connessione di base per un'origine MariaDB utilizzando l'autenticazione di base.

accordion

Esempio di richiesta View

code language-shell

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"
      }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Proprietà	Descrizione
`auth.params.server`	Il nome o l'IP del database MariaDB.
`auth.params.database`	Nome del database.
`auth.params.username`	Il nome utente che corrisponde al database.
`auth.params.password`	La password che corrisponde al database.
`auth.params.sslMode`	Il metodo con cui i dati vengono crittografati durante il trasferimento.
`connectionSpec.id`	ID della specifica di connessione MariaDB: `3000eb99-cd47-43f3-827c-43caf170f015`.

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id).

accordion

Visualizza esempio di risposta

code language-json
`{ "id": "f847950c-1c12-4568-a550-d5312b16fdb8", "etag": "\"0c0099f4-0000-0200-0000-67da91710000\"" }`

Passaggi successivi

Seguendo questa esercitazione, è stata creata una connessione di base MariaDB utilizzando l'API Flow Service. Puoi utilizzare questo ID connessione di base nelle seguenti esercitazioni:

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089