Краткое руководство: Использование Построителя API данных с Azure SQL и приложениями Azure Container Apps

2025-07-17

В этом кратком руководстве вы развертываете Data API builder (DAB) в качестве контейнера Docker в контейнерных приложениях Azure. Вы используете шаблон интерфейса командной строки разработчика Azure (AZD) для развертывания DAB вместе с базой данных Azure SQL с использованием последнего передового опыта. Шаблон также развертывает пример веб-приложения, которое подключается к конечной точке DAB с помощью GraphQL.

Предпосылки

Azure Developer CLI (Интерфейс командной строки для разработчиков Azure)
.NET 9.0

Если у вас нет аккаунта Azure, создайте бесплатную учетную запись перед началом.

Инициализируйте проект

Используйте интерфейс командной строки разработчика Azure (azd) для создания учетной записи SQL Azure, развертывания DAB в качестве контейнерного решения и развертывания контейнерного примера приложения. Пример приложения использует DAB для запроса примеров данных.

Откройте терминал в пустом каталоге.
Если вы еще не прошли проверку подлинности, выполните проверку подлинности в интерфейсе командной строки разработчика Azure с помощью azd auth login. Следуйте инструкциям, указанным инструментом, чтобы выполнить аутентификацию в CLI, используя ваши предпочитаемые учетные данные Azure.
```
azd auth login
```
Используйте azd init для инициализации проекта.
```
azd init --template dab-azure-sql-quickstart
```
Во время инициализации настройте уникальное имя среды.
Перед продолжением следующего шага убедитесь, что Docker запущен на компьютере.
Разверните полное решение в Azure с помощью azd up. Шаблоны Bicep развертывают учетную запись Azure SQL DAB для приложений Azure Container Apps и пример веб-приложения.
```
azd up
```
Во время процесса настройки выберите ваш тариф и желаемый регион. Дождитесь завершения процесса настройки. Процесс может занять около семи минут.

После завершения подготовки ресурсов Azure в выходные данные будет включен 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.

Запишите значения для URL-адреса API и веб-служб . Эти значения используются далее в этом руководстве.

Настройка подключения к базе данных

Теперь перейдите к каждому контейнеризованному приложению в приложениях контейнеров Azure, чтобы убедиться, что они работают должным образом.

Сначала перейдите по URL-адресу для сервиса api. Этот URL-адрес ссылается на активный экземпляр DAB.
Просмотрите выходные данные JSON из DAB. Он должен указывать, что контейнер DAB запущен, а состояние в норме.
```
{
  "status": "healthy",
  "version": "1.4.35",
  "app-name": "dab_oss_1.4.35"
}
```
Перейдите к пути /swagger, относительному для DAB экземпляра. Этот URL-адрес должен открыть Swagger UI, интегрированную среду разработки REST (IDE).
В интегрированной среде разработки Swagger выполните запрос GET для всех строк в таблице products SQL Azure.
Наконец, перейдите по URL-адресу веб-сервиса . Этот URL-адрес ссылается на работающее веб-приложение, которое подключается к конечной точке GraphQL, к которому вы обращаетесь на предыдущем шаге.
Просмотрите работающее веб-приложение и просмотрите выходные данные.

Очистка

Когда вы больше не нуждаетесь в демонстрационном приложении или ресурсах, удалите соответствующее развертывание и все ресурсы.

Удалите развертывание из подписки Azure.
```
azd down
```
Удалите работающее пространство кода, чтобы максимально увеличить объем хранилища и основных прав, если вы используете GitHub Codespaces.

Следующий шаг

конечных точек REST