Snabbstart: Använda Data API Builder med MySQL

2025-07-17

I den här snabbstarten skapar du en uppsättning konfigurationsfiler för Data API Builder för att rikta in dig på en lokal MySQL-databas.

Förutsättningar

Tips/Råd

Du kan också öppna den här snabbstarten i GitHub Codespaces med alla krav för utvecklare redan installerade. Ta bara med din egen Azure-prenumeration. GitHub-konton innehåller en berättigande till lagring och kärntimmar utan kostnad. Mer information finns i inkluderade lagrings- och kärntimmar för GitHub-konton.

Installera CLI för Data API-builder

Microsoft.DataApiBuilder Installera paketet från NuGet som ett .NET-verktyg.

Använd dotnet tool install för att installera den senaste versionen av Microsoft.DataApiBuilder med --global argumentet .
```
dotnet tool install --global Microsoft.DataApiBuilder
```
Anmärkning

Om paketet redan är installerat uppdaterar du paketet i stället med .dotnet tool update
```
dotnet tool update --global Microsoft.DataApiBuilder
```
Kontrollera att verktyget är installerat med dotnet tool list genom att använda argumentet --global.
```
dotnet tool list --global
```

Konfigurera den lokala databasen

Börja med att konfigurera och köra den lokala databasen. Sedan kan du skapa en ny container med exempeldata.

Hämta den senaste kopian av containeravbildningen mysql:8 från Docker Hub.
```
docker pull mysql:8
```
Starta docker-containern genom att ange lösenordet och publicera port 3306. Ersätt <your-password> med ett anpassat lösenord.
```
docker run \
    --publish 3306:3306 \
    --env "MYSQL_ROOT_PASSWORD=<your-password>" \
    --detach \
    mysql:8
```
Anslut till din lokala databas med hjälp av önskad datahanteringsmiljö. Exempel är, men är inte begränsade till: MySQL Workbench och MySQL-gränssnittet för Visual Studio Code.

Tips/Råd

Om du använder standardnätverk för dina Docker Linux-containeravbildningar blir anslutningssträngen troligen Server=localhost;Port=3306;Uid=root;Pwd=<your-password>;. Ersätt <your-password> med det lösenord som du angav tidigare.
Skapa en ny bookshelf databas och använd databasen för dina återstående frågor.
```
CREATE DATABASE IF NOT EXISTS bookshelf;

USE bookshelf;
```

Skapa en ny dbo.authors tabell och mata in grundläggande data i tabellen.

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

Skapa konfigurationsfiler

Skapa en baslinjekonfigurationsfil med hjälp av DAB CLI. Lägg sedan till en utvecklingskonfigurationsfil med dina aktuella autentiseringsuppgifter.

Skapa en typisk konfigurationsfil med .dab init --connection-string Lägg till argumentet med databasanslutningssträngen från det första avsnittet. Ersätt <your-password> med lösenordet som du angav tidigare i den här guiden. Lägg också till Database=bookshelf värdet i anslutningssträngen.
```
dab init --database-type "mysql" --host-mode "Development" --connection-string "Server=localhost;Port=3306;Database=bookshelf;Uid=root;Pwd=<your-password>;"
```

Lägg till en entitet för författare med hjälp av dab add.

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

Titta på din aktuella dab-config.json konfigurationsfil. Filen ska innehålla en baslinjeimplementering av ditt API med en enda entitet, en REST API-slutpunkt och en GraphQL-slutpunkt.

Testa API:et med den lokala databasen

Starta nu verktyget Data API Builder för att verifiera att dina konfigurationsfiler sammanfogas under utvecklingen.

Använd dab start för att köra verktyget och skapa API-slutpunkter för din entitet.
```
dab start
```
Utdata från verktyget ska innehålla adressen som ska användas för att navigera till api:et som körs.
```
      Successfully completed runtime initialization.
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: <http://localhost:5000>
info: Microsoft.Hosting.Lifetime[0]
```
Tips/Råd

I det här exemplet körs programmet på localhost port 5000. Ditt program som körs kan ha en annan adress och port.
Prova först API:et manuellt genom att utfärda en GET-begäran till /api/Author.

Tips/Råd

I det här exemplet skulle URL:en vara https://localhost:5000/api/Author. Du kan navigera till den här URL:en med hjälp av webbläsaren.
Gå sedan till sidan Swagger-dokumentation: /swagger.

Tips/Råd

I det här exemplet skulle URL:en vara https://localhost:5000/swagger. Återigen kan du navigera till den här URL:en med hjälp av webbläsaren.

Nästa steg

REST-slutpunkter

Feedback

Var den här sidan till hjälp?