DocumentationExperience PlatformSource Connectors Guide

MySQL

Last update: May 20, 2025
  • Topics:
  • Sources

CREATED FOR:

  • Developer

MySQL is an open-source relational database management system used to store and manage structured data. It organizes data into tables and uses SQL (Structured Query Language) for querying and updating information. MySQL is widely used in web applications, supports multiple platforms, and is known for its speed, reliability, and ease of use.

You can use the MySQL source to connect your account and ingest data from your MySQL database to Adobe Experience Platform.

Prerequisites

Read the following sections to complete the prerequisite setup before you connect your MySQl account to Experience Platform.

IP address allowlist

You must add region-specific IP addresses to your allowlist prior to connecting your sources to Experience Platform on either Azure or Amazon Web Services (AWS). For more information, read the guide on allowlisting IP addresses to connect to Experience Platform on Azure and AWS for more information.

Authenticate to Experience Platform on Azure

You can use either account key authentication or basic authentication to connect your MySQL database to Experience Platform on Azure.

Account key authentication

Provide values for the following credentials to connect your MySQL database to Experience Platform using account key authentication.

CredentialDescription
connectionStringThe MySQL connection string associated with your account. The MySQL connection string pattern is: Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}.
connectionSpec.idThe connection spec returns a source’s connector properties, including authentication specs related to creating the base and source connections. The connection spec ID for MySQL is 26d738e0-8963-47ea-aadf-c60de735468a.

For more information, read the MySQL documentation on connection strings.

Basic authentication

Provide values for the following credentials to connect your MySQL database to Experience Platform using basic authentication.

CredentialDescription
serverThe name or IP address of your MySQL database.
usernameThe username associated with your MySQL database authentication.
passwordThe password associated with your MySQL database authentication.
databaseThe name of the MySQL database that you want to connect to.
sslMode

The Secure Sockets Layer (SSL) method to be applied to your connection. The available values are:

  • DISABLED: Use this option to disable SSL. If your server requires an SSL configuration, then the connection will fail
  • PREFERRED: Use this option to prefer SSL connections given that the server supports them. This option also allows for non-SSL connections.
  • REQUIRED: Use this option to make SSL connections mandatory. If the server does not support SSL, then the connections will fail.
  • Verify-Ca: Use this option to verify server certificates while failing connections if the server does not support SSL.
  • Verify Identity: Use this option to verify server certificates with the host’s name while failing connections if the server does not support SSL.

Authenticate to Experience Platform on Amazon Web Services (AWS)

AVAILABILITY
This section applies to implementations of Experience Platform running on Amazon Web Services (AWS). Experience Platform running on AWS is currently available to a limited number of customers. To learn more about the supported Experience Platform infrastructure, see the Experience Platform multi-cloud overview.

You must provide values for the following credentials to connect MySQL to Experience Platform on AWS.

CredentialDescription
serverThe name or IP of your MySQL database.
usernameThe name of your database.
passwordThe username that corresponds with your database.
databaseThe password that corresponds with your database.
sslModeA boolean value that controls whether SSL is enforced or not, depending on your server support. This configuration defaults to false.
connectionSpec.idThe connection specification returns a source’s connector properties, including authentication specifications related to creating the base and source connections. The connection specification ID for MySQL is 26d738e0-8963-47ea-aadf-c60de735468a. Note: This credential is only required when connecting through the Flow Service API.

Connect MySQL to Experience Platform using APIs

  • Connect your MySQL database using the Flow Service API
  • Explore data tables using the Flow Service API
  • Create a dataflow for a database source using the Flow Service API

Connect MySQL to Experience Platform using the UI

  • Connect your MySQL database to Experience Platform using the UI
  • Create a dataflow for a database source connection in the UI
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089