快速入门：将数据 API 生成器与 MySQL 配合使用

2025-06-11

在本快速入门中，你将生成一组数据 API 生成器配置文件，以面向本地 MySQL 数据库。

先决条件

Docker
.NET 8
数据管理客户端
- 如果没有安装客户端，请安装 Azure Data Studio

小窍门

或者，在 GitHub Codespaces 中打开本快速入门，其中包含已安装的所有开发人员先决条件。只需自带 Azure 订阅即可。 GitHub 帐户包括使用免费的存储和核心小时数的权利。有关详细信息，请参阅包含的 GitHub 帐户存储和核心小时数。

安装数据 API 生成器 CLI

将 NuGet 中的 Microsoft.DataApiBuilder 包安装为 .NET 工具。

请使用dotnet tool install安装带--global参数的Microsoft.DataApiBuilder最新版本。
```
dotnet tool install --global Microsoft.DataApiBuilder
```
注释

如果包已安装，请改用 dotnet tool update更新包。
```
dotnet tool update --global Microsoft.DataApiBuilder
```
使用--global参数验证是否已安装dotnet tool list工具。
```
dotnet tool list --global
```

配置本地数据库

首先配置并运行本地数据库。然后，可以使用示例数据为新容器设定种子。

从 Docker Hub 获取 mysql:8 容器映像的最新副本。
```
docker pull mysql:8
```

通过设置密码并发布端口 3306 来启动 docker 容器。将 <your-password> 替换为一个自定义密码。

docker run \
    --publish 3306:3306 \
    --env "MYSQL_ROOT_PASSWORD=<your-password>" \
    --detach \
    mysql:8

使用首选数据管理环境连接到本地数据库。示例包括但不限于： MySQL Workbench、 Azure Data Studio 和适用于 Visual Studio Code 的 MySQL shell。

小窍门

如果对 Docker Linux 容器映像使用默认网络，则连接字符串可能是 Server=localhost;Port=3306;Uid=root;Pwd=<your-password>;。将 <your-password> 替换为您之前设置的密码。
创建新 bookshelf 数据库并使用数据库进行剩余查询。
```
CREATE DATABASE IF NOT EXISTS bookshelf;

USE bookshelf;
```

创建一个新 dbo.authors 表，并使用基本数据为表设定种子。

CREATE TABLE IF NOT EXISTS authors
(
    id INT NOT NULL PRIMARY KEY,
    first_name VARCHAR(100) NOT NULL,
    middle_name VARCHAR(100),
    last_name VARCHAR(100) NOT NULL
);

INSERT INTO authors VALUES
    (01, 'Henry', NULL, 'Ross'),
    (02, 'Jacob', 'A.', 'Hancock'),
    (03, 'Sydney', NULL, 'Mattos'),
    (04, 'Jordan', NULL, 'Mitchell'),
    (05, 'Victoria', NULL, 'Burke'),
    (06, 'Vance', NULL, 'DeLeon'),
    (07, 'Reed', NULL, 'Flores'),
    (08, 'Felix', NULL, 'Henderson'),
    (09, 'Avery', NULL, 'Howard'),
    (10, 'Violet', NULL, 'Martinez');

创建配置文件

使用 DAB CLI 创建基线配置文件。再然后，用您的当前凭据来添加开发配置文件。

使用 dab init.. 创建典型配置文件。将--connection-string参数与第一节中的数据库连接字符串一起添加。将<your-password>替换为您在本指南前面设置的密码。此外，将 Database=bookshelf 值添加到连接字符串。
```
dab init --database-type "mysql" --host-mode "Development" --connection-string "Server=localhost;Port=3306;Database=bookshelf;Uid=root;Pwd=<your-password>;"
```

使用 dab add 添加 Author 实体。

dab add Author --source "authors" --permissions "anonymous:*"

观察当前的 dab-config.json 配置文件。该文件应包含具有单个实体、REST API 终结点和 GraphQL 终结点的 API 的基线实现。

使用本地数据库测试 API

现在，启动数据 API 生成器工具，验证配置文件在开发过程中是否已合并。

使用 dab start 运行工具并为您的实体创建 API 终结点。
```
dab start
```
该工具的输出应包含用于导航到正在运行的 API 的地址。
```
      Successfully completed runtime initialization.
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: <http://localhost:5000>
info: Microsoft.Hosting.Lifetime[0]
```
小窍门

在此示例中，应用程序在端口 5000 上运行localhost。正在运行的应用程序可能有不同的地址和端口。
首先，通过向该 API 发出 GET 请求 /api/Author来手动尝试该 API。

小窍门

在此示例中，URL 为 https://localhost:5000/api/Author. 可以使用 Web 浏览器导航到此 URL。
接下来，导航到 Swagger 文档页面。/swagger

小窍门

在此示例中，URL 为 https://localhost:5000/swagger. 同样，可以使用 Web 浏览器导航到此 URL。

后续步骤

REST 终结点

通过