Skip to content

how-to-integrate-mysql.md

Latest commit

 

History

History
465 lines (356 loc) · 37.7 KB

how-to-integrate-mysql.md

File metadata and controls

465 lines (356 loc) · 37.7 KB
title Integrate Azure Database for MySQL with Service Connector
description Integrate Azure Database for MySQL into your application with Service Connector
author maud-lv
ms.author malev
ms.service service-connector
ms.topic how-to
ms.custom engagement-fy23
ms.date 03/14/2025

Integrate Azure Database for MySQL with Service Connector

This article covers supported authentication methods, clients, and sample code you can use to connect your apps to Azure Database for MySQL - Flexible Server using Service Connector. In this article, you'll also find default environment variable names, values, and configuration obtained when creating service connections.

[!INCLUDE Azure-database-for-mysql-single-server-deprecation]

Supported compute services

Service Connector can be used to connect the following compute services to Azure Database for MySQL:

  • Azure App Service
  • Azure Container Apps
  • Azure Functions
  • Azure Kubernetes Service (AKS)
  • Azure Spring Apps

Supported authentication types and client types

The table below shows which combinations of authentication methods and clients are supported for connecting your compute services to Azure Database for MySQL using Service Connector. A “Yes” indicates that the combination is supported, while a “No” indicates that it is not supported.

Client type System-assigned managed identity User-assigned managed identity Secret/connection string Service principal
.NET Yes Yes Yes Yes
Go (go-sql-driver for mysql) Yes Yes Yes Yes
Java (JDBC) Yes Yes Yes Yes
Java - Spring Boot (JDBC) Yes Yes Yes Yes
Node.js (mysql) Yes Yes Yes Yes
Python (mysql-connector-python) Yes Yes Yes Yes
Python-Django Yes Yes Yes Yes
PHP (MySQLi) Yes Yes Yes Yes
Ruby (mysql2) Yes Yes Yes Yes
None Yes Yes Yes Yes

Note

System-assigned managed identity, user-assigned managed identity and service principal authentication is only supported on Azure CLI.

Default environment variable names or application properties and sample code

Reference the connection details and sample code in following tables, according to your connection's authentication type and client type, to connect compute services to Azure Database for MySQL. For more information about naming conventions, check the Service Connector internals article.

System-assigned managed identity

.NET

Default environment variable name Description Example value
AZURE_MYSQL_CONNECTIONSTRING ADO.NET MySQL connection string Server=<MySQL-DB-name>.mysql.database.azure.com;Database=<MySQL-DB-name>;Port=3306;User Id=<MySQL-DBusername>;SSL Mode=Required;

Java

Default environment variable name Description Example value
AZURE_MYSQL_CONNECTIONSTRING JDBC MySQL connection string jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required&user=<MySQL-DB-username>

Spring Boot

Application properties Description Example value
spring.datasource.azure.passwordless-enabled Enable passwordless authentication true
spring.datasource.url Spring Boot JDBC database URL jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required
spring.datasource.username Database username <MySQL-DB-username>

Python

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>

Django

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>

Go

Default environment variable name Description Example value
AZURE_MYSQL_CONNECTIONSTRING Go-sql-driver connection string <MySQL-DB-username>@tcp(<server-host>:<port>)/<MySQL-DB-name>?tls=true

NodeJS

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username MySQL-DB-username
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true

PHP

Default environment variable name Description Example value
AZURE_MYSQL_DBNAME Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_FLAG SSL or other flags MySQL_CLIENT_SSL
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>

Ruby

Default environment variable name Description Example value
AZURE_MYSQL_DATABASE Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_SSLMODE SSL option required

Other

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username MySQL-DB-username
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true

Sample code

Refer to the steps and code below to connect to Azure Database for MySQL using a system-assigned managed identity. [!INCLUDE code sample for mysql system mi]

User-assigned managed identity

.NET

Default environment variable name Description Example value
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>
AZURE_MYSQL_CONNECTIONSTRING ADO.NET MySQL connection string Server=<MySQL-DB-name>.mysql.database.azure.com;Database=<MySQL-DB-name>;Port=3306;User Id=<MySQL-DBusername>;SSL Mode=Required;

Java

Default environment variable name Description Example value
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>
AZURE_MYSQL_CONNECTIONSTRING JDBC MySQL connection string jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required&user=<MySQL-DB-username>

Spring Boot

Application properties Description Example value
spring.datasource.azure.passwordless-enabled Enable passwordless authentication true
spring.cloud.azure.credential.client-id Your client ID <identity-client-ID>
spring.cloud.azure.credential.client-managed-identity-enabled Enable client managed identity true
spring.datasource.url Database URL jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required
spring.datasource.username Database username username

Python

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_CLIENTID Your client ID identity-client-ID

Django

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>

Go

Default environment variable name Description Example value
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>
AZURE_MYSQL_CONNECTIONSTRING Go-sql-driver connection string <MySQL-DB-username>@tcp(<server-host>:<port>)/<MySQL-DB-name>?tls=true

NodeJS

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username MySQL-DB-username
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>

PHP

Default environment variable name Description Example value
AZURE_MYSQL_DBNAME Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_FLAG SSL or other flags MySQL_CLIENT_SSL
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>

Ruby

Default environment variable name Description Example value
AZURE_MYSQL_DATABASE Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_SSLMODE SSL option required
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>

Other

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username MySQL-DB-username
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>

Sample code

Refer to the steps and code below to connect to Azure Database for MySQL using a user-assigned managed identity. [!INCLUDE code sample for mysql system mi]

Connection string

Warning

Microsoft recommends that you use the most secure authentication flow available. The authentication flow described in this procedure requires a very high degree of trust in the application, and carries risks that are not present in other flows. You should only use this flow when other more secure flows, such as managed identities, aren't viable.

.NET

Default environment variable name Description Example value
AZURE_MYSQL_CONNECTIONSTRING ADO.NET MySQL connection string Server=<MySQL-DB-name>.mysql.database.azure.com;Database=<MySQL-DB-name>;Port=3306;User Id=<MySQL-DBusername>;Password=<MySQL-DB-password>;SSL Mode=Required

Java

Default environment variable name Description Example value
AZURE_MYSQL_CONNECTIONSTRING JDBC MySQL connection string jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required&user=<MySQL-DB-username>&password=<Uri.EscapeDataString(<MySQL-DB-password>)

Spring Boot

Application properties Description Example value
spring.datasource.url Spring Boot JDBC database URL jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required
spring.datasource.username Database username <MySQL-DB-username>
spring.datasource.password Database password MySQL-DB-password

After created a springboot client type connection, Service Connector service will automatically add properties spring.datasource.url, spring.datasource.username, spring.datasource.password. So Spring boot application could add beans automatically.

Python

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_PASSWORD Database password MySQL-DB-password

Django

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_PASSWORD Database password MySQL-DB-password

Go

Default environment variable name Description Example value
AZURE_MYSQL_CONNECTIONSTRING Go-sql-driver connection string <MySQL-DB-username>:<MySQL-DB-password>@tcp(<server-host>:<port>)/<MySQL-DB-name>?tls=true

NodeJS

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username MySQL-DB-username
AZURE_MYSQL_PASSWORD Database password MySQL-DB-password
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true

PHP

Default environment variable name Description Example value
AZURE_MYSQL_DBNAME Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_FLAG SSL or other flags MySQL_CLIENT_SSL
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>
AZURE_MYSQL_PASSWORD Database password <MySQL-DB-password>

Ruby

Default environment variable name Description Example value
AZURE_MYSQL_DATABASE Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_PASSWORD Database password <MySQL-DB-password>
AZURE_MYSQL_SSLMODE SSL option required

Other

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username MySQL-DB-username
AZURE_MYSQL_PASSWORD Database password MySQL-DB-password
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true

Sample code

Refer to the steps and code below to connect to Azure Database for MySQL using a connection string. [!INCLUDE code sample for mysql secrets]

Service principal

.NET

Default environment variable name Description Example value
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>
AZURE_MYSQL_CONNECTIONSTRING ADO.NET MySQL connection string Server=<MySQL-DB-name>.mysql.database.azure.com;Database=<MySQL-DB-name>;Port=3306;User Id=<MySQL-DBusername>;SSL Mode=Required

Java

Default environment variable name Description Example value
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>
AZURE_MYSQL_CONNECTIONSTRING JDBC MySQL connection string jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required&user=<MySQL-DB-username>

Spring Boot

Application properties Description Example value
spring.datasource.azure.passwordless-enabled Enable passwordless authentication true
spring.cloud.azure.credential.client-id Your client ID <client-ID>
spring.cloud.azure.credential.client-secret Your client secret <client-secret>
spring.cloud.azure.credential.tenant-id Your tenant ID <tenant-ID>
spring.datasource.url Database URL jdbc:mysql://<MySQL-DB-name>.mysql.database.azure.com:3306/<MySQL-DB-name>?sslmode=required
spring.datasource.username Database username username

Python

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>

Django

Default environment variable name Description Example value
AZURE_MYSQL_NAME Database name MySQL-DB-name
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>

Go

Default environment variable name Description Example value
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>
AZURE_MYSQL_CONNECTIONSTRING Go-sql-driver connection string <MySQL-DB-username>@tcp(<server-host>:<port>)/<MySQL-DB-name>?tls=true

NodeJS

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USER Database username MySQL-DB-username
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>

PHP

Default environment variable name Description Example value
AZURE_MYSQL_DBNAME Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_FLAG SSL or other flags MySQL_CLIENT_SSL
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>

Ruby

Default environment variable name Description Example value
AZURE_MYSQL_DATABASE Database name <MySQL-DB-name>
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username <MySQL-DB-username>@<MySQL-DB-name>
AZURE_MYSQL_SSLMODE SSL option required
AZURE_MYSQL_CLIENTID Your client ID <client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>

Other

Default environment variable name Description Example value
AZURE_MYSQL_HOST Database host URL <MySQL-DB-name>.mysql.database.azure.com
AZURE_MYSQL_USERNAME Database username MySQL-DB-username
AZURE_MYSQL_DATABASE Database name <database-name>
AZURE_MYSQL_PORT Port number 3306
AZURE_MYSQL_SSL SSL option true
AZURE_MYSQL_CLIENTID Your client ID <identity-client-ID>
AZURE_MYSQL_CLIENTSECRET Your client secret <client-secret>
AZURE_MYSQL_TENANTID Your tenant ID <tenant-ID>

Sample code

Refer to the steps and code below to connect to Azure Database for MySQL using a service principal. [!INCLUDE code sample for mysql system mi]

Next steps

Follow the documentations to learn more about Service Connector.

[!div class="nextstepaction"] Learn about Service Connector concepts