你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用托管标识将 Azure SQL 数据库连接到 Azure Spring Apps 上部署的应用

项目
10/01/2024

注意

从 2025 年 3 月中旬开始，基本、标准和企业计划将弃用，停用期为三年。建议过渡到 Azure 容器应用。有关详细信息，请参阅 Azure Spring Apps 停用公告。

从 2024 年 9 月 30 日开始，标准消耗和专用计划将弃用，六个月后将完全关闭。建议过渡到 Azure 容器应用。有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于：✔️ Java ✔️ C#

本文适用于：✔️ 基本版/标准版 ✔️ 企业版

本文介绍如何为部署到 Azure Spring Apps 的应用创建托管标识，并使用该标识来访问 Azure SQL 数据库。

Azure SQL 数据库是面向云生成的一项可缩放的智能关系数据库服务。它始终处于最新状态，具有 AI 支持的自动化功能，可优化性能和持续性。无服务器计算和超大规模存储选项会自动按需缩放资源，因此你可以专注于构建新的应用程序，而无需担心存储大小或资源管理。

先决条件

具有活动订阅的 Azure 帐户。免费创建帐户。
Azure CLI 版本 2.45.0 或更高版本。
遵循 Spring Data JPA 教程预配 Azure SQL 数据库并将该数据库在本地与 Java 应用结合使用。
遵循 Azure Spring Apps 系统分配的托管标识教程在 Azure Spring Apps 中预配一个启用托管标识的应用。

使用托管标识连接到 Azure SQL 数据库

可以遵循手动步骤，使用托管标识或服务连接器将应用程序连接到 Azure SQL 数据库。

手动配置
服务连接器

向托管标识授予权限

连接到 SQL Server 并运行以下 SQL 查询：

CREATE USER [<managed-identity-name>] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [<managed-identity-name>];
ALTER ROLE db_datawriter ADD MEMBER [<managed-identity-name>];
ALTER ROLE db_ddladmin ADD MEMBER [<managed-identity-name>];
GO

<managed-identity-name> 占位符的值遵循规则 <service-instance-name>/apps/<app-name>；例如：myspringcloud/apps/sqldemo。还可以在 Azure CLI 中使用以下命令查询托管标识名称：

az ad sp show --id <identity-object-ID> --query displayName

配置 Java 应用以使用托管标识

打开 src/main/resources/application.properties 文件，然后在 spring.datasource.url 行的末尾添加 Authentication=ActiveDirectoryMSI;，如以下示例所示。请确保为 $AZ_DATABASE_NAME 变量使用正确的值。

spring.datasource.url=jdbc:sqlserver://$AZ_DATABASE_NAME.database.windows.net:1433;database=demo;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;Authentication=ActiveDirectoryMSI;

注意

服务连接器是在部署级别创建的。因此，如果创建了另一个部署，则需要再次创建连接。

使用 az spring connection create 命令，将部署到 Azure Spring Apps 的应用配置为使用系统分配的托管标识连接到 Azure SQL 数据库，如以下示例中所示。

使用以下命令，为 Azure CLI 安装服务连接器无密码扩展：
```
az extension add --name serviceconnector-passwordless --upgrade
```

使用以下命令以连接到数据库：

az spring connection create sql \
    --resource-group $SPRING_APP_RESOURCE_GROUP \
    --service $SPRING_APP_SERVICE_NAME \
    --app $APP_NAME \
    --deployment $DEPLOYMENT_NAME \
    --target-resource-group $SQL_RESOURCE_GROUP \
    --server $SQL_SERVER_NAME \
    --database $DATABASE_NAME \
    --system-identity

使用以下命令检查创建结果：

export CONNECTION_NAME=$(az spring connection list \
   --resource-group $SPRING_APP_RESOURCE_GROUP \
   --service $SPRING_APP_SERVICE_NAME \
   --app $APP_NAME  \
   --query '[0].name' \
   --output tsv)

az spring connection list-configuration \
   --resource-group $SPRING_APP_RESOURCE_GROUP \
   --service $SPRING_APP_SERVICE_NAME \
   --app $APP_NAME  \
   --connection $CONNECTION_NAME

生成应用并将其部署到 Azure Spring Apps

重新生成应用，并将其部署到“先决条件”下第二个项目符号中预配的 Azure Spring Apps。现在，你已有通过托管标识进行身份验证的 Spring Boot 应用程序，它在 Azure Spring Apps 中使用 JPA 存储并检索 Azure SQL 数据库中的数据。

通过