DocumentaciónExperience PlatformGuía de conectores de origen

Conectar MySQL a Experience Platform mediante la API Flow Service

Última actualización: 21 de mayo de 2025
  • Temas:

Creado para:

  • Desarrollador

Lea esta guía para aprender a conectar su cuenta de MySQL a Adobe Experience Platform mediante la Flow Service API.

Introducción

Esta guía requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:

  • Fuentes: Experience Platform permite la ingesta de datos de varias fuentes al tiempo que le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Experience Platform.
  • Zonas protegidas: Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Experience Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.

Las secciones siguientes proporcionan información adicional que necesitará conocer para conectarse correctamente a MySQL mediante la API Flow Service.

Recopilar credenciales necesarias

Lea la MySQL descripción general para obtener información sobre la autenticación.

Uso de API de Experience Platform

Lea la guía sobre introducción a las API de Experience Platform para obtener información sobre cómo realizar llamadas a las API de Experience Platform correctamente.

Conectar MySQL a Experience Platform en Azure

Lea los pasos a continuación para obtener información sobre cómo conectar su cuenta de MySQL a Experience Platform en Azure.

Crear una conexión base para MySQL en Experience Platform en Azure

Una conexión base vincula el origen a Experience Platform y almacena los detalles de autenticación, el estado de la conexión y un ID único. Utilice este ID para examinar los archivos de origen e identificar elementos específicos que se van a introducir, incluidos sus tipos de datos y formatos.

Formato de API

POST /connections

Para crear un identificador de conexión base, realice una petición POST al extremo /connections y proporcione sus credenciales de autenticación MySQL como parte de los parámetros de solicitud.

Solicitud

La siguiente solicitud crea una conexión base para MySQL mediante la autenticación basada en la cadena de conexión.

Ver ejemplo de solicitud
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"
      }
  }'
Propiedad
Descripción
auth.params.connectionString
La cadena de conexión MySQL asociada a su cuenta. El patrón de cadena de conexión MySQL es: Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}.
connectionSpec.id
Identificador de especificación de conexión MySQL: 26d738e0-8963-47ea-aadf-c60de735468a.

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id).

Ver ejemplo de respuesta
{
    "id": "1a444165-3439-4c16-8441-653439dc166a",
    "etag": "\"5b04c219-0000-0200-0000-5e179c8f0000\""
}

Solicitud

La siguiente solicitud crea una conexión base para un origen de MySQL mediante autenticación básica.

Ver ejemplo de solicitud
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"
      }
  }'
Propiedad
Descripción
auth.params.server
El nombre o IP de su base de datos MySQL.
auth.params.database
Nombre de la base de datos.
auth.params.username
El nombre de usuario que corresponde con su base de datos.
auth.params.password
La contraseña que corresponde a su base de datos.
auth.params.sslMode
Método por el que se cifran los datos durante la transferencia de datos.
connectionSpec.id
El id. de especificación de conexión MySQL es: 26d738e0-8963-47ea-aadf-c60de735468a.

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id).

Ver ejemplo de respuesta
{
    "id": "025d4158-4113-403b-b551-e81724d3880c",
    "etag": "\"ae004437-0000-0200-0000-67ee107e0000\""
}

Conectar MySQL a Experience Platform en Amazon Web Service

AVAILABILITY
Esta sección se aplica a las implementaciones de Experience Platform que se ejecutan en Amazon Web Service (AWS). Experience Platform que se ejecuta en AWS está disponible actualmente para un número limitado de clientes. Para obtener más información sobre la infraestructura de Experience Platform compatible, consulte la descripción general de la nube múltiple de Experience Platform.

Lea los pasos a continuación para obtener información sobre cómo conectar su cuenta de MySQL a Experience Platform en AWS.

Crear una conexión base para MySQL en Experience Platform en AWS

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para que MySQL se conecte a Experience Platform en AWS.

Ver ejemplo de solicitud
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"
      }
  }'
Propiedad
Descripción
auth.params.server
El nombre o IP de su base de datos MySQL.
auth.params.database
Nombre de la base de datos.
auth.params.username
El nombre de usuario que corresponde con su base de datos.
auth.params.password
La contraseña que corresponde a su base de datos.
auth.params.sslMode
Un valor booleano que controla si SSL se aplica o no, según la compatibilidad con el servidor. El valor predeterminado de esta configuración es false.
connectionSpec.id
El id. de especificación de conexión MySQL es: 26d738e0-8963-47ea-aadf-c60de735468a.

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id).

Ver ejemplo de respuesta
{
    "id": "f847950c-1c12-4568-a550-d5312b16fdb8",
    "etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}

Crear un flujo de datos para MySQL datos

Ahora que ha conectado correctamente su base de datos de MySQL, puede crear un flujo de datos e introducir datos de su base de datos en Experience Platform.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089