快速入門：搭配 MySQL 使用數據 API 產生器

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 殼層。

小提示

如果您使用 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 組態檔。檔案應該包含 API 的基準實作，其中包含單一實體、REST API 端點和 GraphQL 端點。

使用本機資料庫測試 API

現在，啟動 Data 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執行。執行中的應用程式可能有不同的位址和埠。
首先，向發出 GET 要求 /api/Author，以手動嘗試 API。

小提示

在這裡範例中，URL 會是 https://localhost:5000/api/Author。您可以使用網頁瀏覽器流覽至此 URL。
接下來，前往 Swagger 文件頁面，位於 /swagger。

小提示

在這裡範例中，URL 會是 https://localhost:5000/swagger。同樣地，您可以使用網頁瀏覽器流覽至此 URL。

後續步驟

REST 端點

共用方式為