Rychlý start: Použití Tvůrce rozhraní Data API s MySQL

Článek
05/17/2024

V tomto rychlém startu vytvoříte sadu konfiguračních souborů Tvůrce rozhraní API pro cílení na místní databázi MySQL.

Požadavky

Docker
.NET 8
Klient správy dat
- Pokud nemáte nainstalovaného klienta, nainstalujte Azure Data Studio.

Tip

Případně můžete otevřít tento rychlý start v GitHub Codespaces s již nainstalovanými všemi požadavky pro vývojáře. Jednoduše si přineste vlastní předplatné Azure. Účty GitHub zahrnují nárok na hodiny úložiště a jádra bez poplatků. Další informace najdete v tématu zahrnuté hodiny úložiště a doby jádra pro účty GitHubu.

Instalace rozhraní příkazového řádku Tvůrce data API

Microsoft.DataApiBuilder Nainstalujte balíček z NuGetu jako nástroj .NET.

Pomocí příkazu dotnet tool install nainstalujte nejnovější verzi nástroje Microsoft.DataApiBuilder s argumentem --global .
```
dotnet tool install --global Microsoft.DataApiBuilder
```
Poznámka

Pokud už je balíček nainstalovaný, místo toho ho aktualizujete pomocí .dotnet tool update
```
dotnet tool update --global Microsoft.DataApiBuilder
```
Pomocí argumentu --global ověřte, že je nástroj nainstalovaný s dotnet tool list nástrojem .
```
dotnet tool list --global
```

Konfigurace místní databáze

Začněte konfigurací a spuštěním místní databáze. Pak můžete do nového kontejneru přidat ukázková data.

Získejte nejnovější kopii image kontejneru mysql:8 z Docker Hub.
```
docker pull mysql:8
```

Spusťte kontejner Dockeru nastavením hesla a publikováním portu 3306. Nahraďte <your-password> vlastním heslem.

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

Připojte se k místní databázi pomocí upřednostňovaného prostředí pro správu dat. Mezi příklady mimo jiné patří: MySQL Workbench, Azure Data Studio a prostředí MySQL pro Visual Studio Code.

Tip

Pokud pro image kontejnerů Dockeru s Linuxem používáte výchozí síť, připojovací řetězec bude pravděpodobně Server=localhost;Port=3306;Uid=root;Pwd=<your-password>;. Nahraďte <your-password> heslem, které jste nastavili dříve.
Create novou bookshelf databázi a pro zbývající dotazy ji použijte.
```
CREATE DATABASE IF NOT EXISTS bookshelf;

USE bookshelf;
```

Create novou dbo.authors tabulku a dosadíte do tabulky základní data.

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');

Create konfigurační soubory

Create standardní konfigurační soubor pomocí ROZHRANÍ PŘÍKAZOVÉHO ŘÁDKU DAB. Pak přidejte konfigurační soubor pro vývoj s aktuálními přihlašovacími údaji.

Create typický konfigurační soubor pomocí .dab init --connection-string Přidejte argument s databází připojovací řetězec z první části. Nahraďte <your-password> heslem, které jste nastavili dříve v této příručce. Database=bookshelf Přidejte také hodnotu do připojovací řetězec.
```
dab init --database-type "mysql" --host-mode "Development" --connection-string "Server=localhost;Port=3306;Database=bookshelf;Uid=root;Pwd=<your-password>;"
```

Přidejte entitu Author (Autor ) pomocí dab add.

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

Sledujte aktuální konfigurační soubor dab-config.json . Soubor by měl obsahovat základní implementaci rozhraní API s jednou entitou, koncovým bodem rozhraní REST API a koncovým bodem GraphQL.

Testování rozhraní API s místní databází

Teď spusťte nástroj Tvůrce rozhraní DATA API a ověřte, že se konfigurační soubory během vývoje sloučí.

Použijte dab start ke spuštění nástroje a vytvoření koncových bodů rozhraní API pro vaši entitu.
```
dab start
```
Výstup nástroje by měl obsahovat adresu, která se má použít k přechodu na spuštěné rozhraní API.
```
      Successfully completed runtime initialization.
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: <http://localhost:5000>
info: Microsoft.Hosting.Lifetime[0]
```
Tip

V tomto příkladu aplikace běží na localhost portu 5000. Spuštěná aplikace může mít jinou adresu a port.
Nejprve vyzkoušejte rozhraní API ručně vydáním požadavku GET na /api/Authoradresu .

Tip

V tomto příkladu by adresa URL byla https://localhost:5000/api/Author. Na tuto adresu URL můžete přejít pomocí webového prohlížeče.
Pak přejděte na stránku dokumentace ke Swaggeru na adrese /swagger.

Tip

V tomto příkladu by adresa URL byla https://localhost:5000/swagger. Na tuto adresu URL můžete znovu přejít pomocí webového prohlížeče.

Další krok

Koncové body REST

Sdílet prostřednictvím