快速入门：将数据 API 生成器与 Azure SQL 和 Azure 容器应用配合使用

2025-07-18

在本快速入门中，你将数据 API 生成器（DAB）作为 Docker 容器部署到 Azure 容器应用。使用 Azure 开发人员 CLI （AZD）模板通过最新的最佳做法部署 DAB 和 Azure SQL 数据库。该模板还部署使用 GraphQL 连接到 DAB 终结点的示例 Web 应用程序。

先决条件

Azure Developer CLI
.NET 9.0

如果没有 Azure 帐户，请在开始前创建一个免费帐户。

初始化项目

使用 Azure 开发人员 CLI （azd）创建 Azure SQL 帐户，将 DAB 部署为容器化解决方案，并部署容器化示例应用程序。示例应用程序使用 DAB 查询示例数据。

在空目录中打开终端。
如果尚未经过身份验证，请使用 azd auth login 向 Azure Developer CLI 进行身份验证。按照工具指定的步骤，使用首选的 Azure 凭据向 CLI 进行身份验证。
```
azd auth login
```

使用 azd init 来初始化项目。

azd init --template dab-azure-sql-quickstart

在初始化期间，配置唯一的环境名称。
在继续执行下一步之前，请确保 Docker 在计算机上运行。
使用 azd up将完整解决方案部署到 Azure。 Bicep 模板将 Azure SQL 帐户 DAB 部署到 Azure 容器应用，以及示例 Web 应用程序。
```
azd up
```
在预配过程中，选择订阅和所需位置。等待预配过程完成。此过程可能需要大约 7 分钟。

预配 Azure 资源后，输出中将包含正在运行的 Web 应用程序的 URL。

Deploying services (azd deploy)

(✓) Done: Deploying service api
- Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>

(✓) Done: Deploying service web
- Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>

SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.

记录 API 和 web 服务的 URL 值。您将在本指南中稍后使用这些值。

配置数据库连接

现在，浏览到 Azure 容器应用中的每个容器化应用程序，以验证它们是否按预期工作。

首先，访问 API 服务的 URL。此 URL 链接到正在运行的 DAB 实例。
观察 DAB 的 JSON 输出。它应指示 DAB 容器正在运行，状态为健康。
```
{
  "status": "healthy",
  "version": "1.4.35",
  "app-name": "dab_oss_1.4.35"
}
```
导航到 DAB 实例的相对 /swagger 路径。此 URL 应打开 Swagger UI REST 集成开发环境（IDE）。
在 Swagger IDE 中，针对 Azure SQL GET 表中的所有行运行 products 请求。
最后，导航到网络服务的 URL。此 URL 链接到正在运行的示例 Web 应用程序，该应用程序连接到在上一步中访问的 GraphQL 终结点。
观察正在运行的 Web 应用程序并查看输出数据。

清除

不再需要示例应用程序或资源时，请删除相应的部署和所有资源。

从 Azure 订阅中删除部署。
```
azd down
```
如果使用的是 GitHub Codespaces，请删除正在运行的代码空间，以最大化存储和核心权利。

后续步骤

REST 终结点