將適用於 MySQL 的 Azure 資料庫執行個體連線至您在 Azure Spring 應用程式中的應用程式

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。 建議您轉換至 Azure Container Apps。 如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。 建議您轉換至 Azure Container Apps。 如需詳細資訊，請參閱 將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container Apps。

本文適用於： ✔️ Java ✔️ C#

本文適用於： ✔️ 基本/標準 ✔️ 企業

透過 Azure Spring Apps，您可以自動將選取的 Azure 服務連線到您的應用程式，而不必手動設定 Spring Boot 應用程式。 本文說明如何將應用程式連線到 適用於 MySQL 的 Azure 資料庫 實例。

必要條件

• 部署至 Azure Spring Apps 的應用程式。 如需詳細資訊，請參閱快速入門：將第一個應用程式部署至 Azure Spring Apps。
• 適用於 MySQL 的 Azure 資料庫 彈性伺服器實例。
• Azure CLI 2.45.0 版或更新版本。

準備您的專案

Java

1. 在專案的 pom.xml 檔案中，新增下列相依性：

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-jpa</artifactId>
   </dependency>
   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>spring-cloud-azure-starter-jdbc-mysql</artifactId>
   </dependency>
   

2. 在 application.properties 檔案中，移除任何spring.datasource.*屬性。

3. 執行 az spring app deploy來更新目前的應用程式，或執行 az spring app deployment create來建立此變更的新部署。

通數國語文的人

所有 連接字串 和認證都會插入為環境變數，您可以在應用程式程式代碼中參考這些變數。

如需默認環境變數名稱，請參閱整合 適用於 MySQL 的 Azure 資料庫 與 Service Connector。

將您的應用程式連線至 適用於 MySQL 的 Azure 資料庫 實例

服務連接器

注意

根據預設，服務連接器會在應用層級建立。 若要覆寫連線，您可以在部署中再次建立其他連線。

請遵循下列步驟來設定 Spring 應用程式，以使用系統指派的受控識別連線到 適用於 MySQL 的 Azure 資料庫 彈性伺服器。

1. 使用下列命令來安裝 Azure CLI 的 Service Connector 無密碼擴充功能。

   az extension add --name serviceconnector-passwordless --upgrade
   

2. 然後，使用下列命令建立使用者指派的受控識別，以進行 Microsoft Entra 驗證。 請務必將範例中的變數取代為實際值。 如需詳細資訊，請參閱為適用於 MySQL 的 Azure 資料庫 - 彈性伺服器設定 Microsoft Entra 驗證。

   export AZ_IDENTITY_RESOURCE_ID=$(az identity create \
       --name $AZURE_USER_IDENTITY_NAME \
       --resource-group $AZURE_IDENTITY_RESOURCE_GROUP \
       --query id \
       --output tsv)
   

3. az spring connection create執行 命令，如下列範例所示。 請務必將範例中的變數取代為實際值。

   az spring connection create mysql-flexible \
       --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
       --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
       --app $APP_NAME \
       --target-resource-group $MYSQL_RESOURCE_GROUP \
       --server $MYSQL_SERVER_NAME \
       --database $DATABASE_NAME \
       --system-identity mysql-identity-id=$AZ_IDENTITY_RESOURCE_ID
   

Terraform

下列 Terraform 腳本示範如何使用 適用於 MySQL 的 Azure 資料庫 設定 Azure Spring Apps 應用程式。

provider "azurerm" {
  features {}
}

variable "application_name" {
  type        = string
  description = "The name of your application"
  default     = "demo-abc"
}

variable "administrator_login" {
  type        = string
  description = "The MySQL administrator login"
  default     = "myadmin"
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "random_password" "password" {
  length           = 32
  special          = true
  override_special = "_%@"
}

resource "azurerm_mysql_server" "database" {
  name                = "mysql-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location

  administrator_login          = var.administrator_login
  administrator_login_password = random_password.password.result

  sku_name                          = "B_Gen5_1"
  storage_mb                        = 5120
  version                           = "5.7"
  auto_grow_enabled                 = true
  backup_retention_days             = 7
  geo_redundant_backup_enabled      = false
  infrastructure_encryption_enabled = false
  public_network_access_enabled     = true
  ssl_enforcement_enabled           = true
  ssl_minimal_tls_version_enforced  = "TLS1_2"
}

resource "azurerm_mysql_database" "database" {
  name                = "mysqldb-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  server_name         = azurerm_mysql_server.database.name
  charset             = "utf8"
  collation           = "utf8_unicode_ci"
}

# This rule is to enable the 'Allow access to Azure services' checkbox
resource "azurerm_mysql_firewall_rule" "database" {
  name                = "mysqlfw-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  server_name         = azurerm_mysql_server.database.name
  start_ip_address    = "0.0.0.0"
  end_ip_address      = "0.0.0.0"
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "example-springcloud"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
}

resource "azurerm_spring_cloud_app" "example" {
  name                = "example-springcloudapp"
  resource_group_name = azurerm_resource_group.example.name
  service_name        = azurerm_spring_cloud_service.example.name
  is_public           = true
  https_only          = true
}

resource "azurerm_spring_cloud_java_deployment" "example" {
  name                = "default"
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  quota {
    cpu    = "2"
    memory = "4Gi"
  }
  instance_count      = 2
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.datasource.url" : "jdbc:mysql://${azurerm_mysql_server.database.fqdn}:3306/${azurerm_mysql_database.database.name}?useSSL=true&requireSSL=false&useLegacyDatetimeCode=false&serverTimezone=UTC"
    "spring.datasource.username" : "${var.administrator_login}@${azurerm_mysql_server.database.name}"
    "spring.datasource.password" : random_password.password.result
    "spring.jpa.properties.hibernate.dialect" : "org.hibernate.dialect.MySQL5InnoDBDialect"
  }
}

resource "azurerm_spring_cloud_active_deployment" "example" {
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  deployment_name     = azurerm_spring_cloud_java_deployment.example.name
}

下一步

在本文中，您已瞭解如何將 Azure Spring Apps 中的應用程式連線到 適用於 MySQL 的 Azure 資料庫 實例。 若要深入瞭解如何將服務連線到應用程式，請參閱 將 Azure Cosmos DB 資料庫連線至 Azure Spring Apps 中的應用程式。