Conectar MySQL a Experience Platform mediante la API Flow Service

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 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 azure-base

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.

Autenticación basada en cadena de conexión

Solicitud

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

accordion
Ver ejemplo de solicitud
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": "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"
      }
  }'
table 0-row-2 1-row-2 2-row-2
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).

accordion
Ver ejemplo de respuesta
code language-json
{
    "id": "1a444165-3439-4c16-8441-653439dc166a",
    "etag": "\"5b04c219-0000-0200-0000-5e179c8f0000\""
}
Autenticación básica

Solicitud

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

accordion
Ver ejemplo de solicitud
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": "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"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
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).

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

Conectar MySQL a Experience Platform en Amazon Web Service aws

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 aws-base

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
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": "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"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
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
code language-json
{
    "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