Delen via

Data API Builder bouwen en uitvoeren vanuit broncode

Data API Builder (DAB) is een opensource-project dat wordt gehost op GitHub. U kunt de broncode op elk gewenst moment downloaden, de code wijzigen en het project rechtstreeks vanuit de bron uitvoeren. Deze handleiding bevat alle stappen die nodig zijn om het project rechtstreeks vanuit de broncode te bouwen.

Vereiste voorwaarden

  • GitHub-account
  • Git
    • In deze zelfstudie wordt ervan uitgegaan dat u bekend bent met Git-opdrachten en -hulpprogramma's.
  • .NET 8

Fork en kloon de opslagplaats

Ga aan de slag door uw eigen fork van de azure/data-api-builder GitHub-opslagplaats te maken. Met deze fork kunt u uw eigen wijzigingen behouden. Als u dit kiest, kunt u altijd een pull-aanvraag openen en de wijzigingen in de upstream-opslagplaats voorstellen.

  1. Navigeer naar https://github.com/azure/data-api-builder/fork.

  2. Maak een kopie ('fork') van de repository in je eigen account of organisatie. Wacht totdat de forkingsbewerking is voltooid voordat u doorgaat.

  3. Open een nieuwe terminal.

  4. Kopieer de fork.

    git clone https://github.com/<your-username>/data-api-builder.git

    Aanbeveling

    U kunt de fork of de oorspronkelijke opslagplaats ook openen als een GitHub Codespace.

  5. Bouw de src/Azure.DataApiBuilder.sln oplossing.

    dotnet build src/Azure.DataApiBuilder.sln

De motor starten

De Azure.DataApiBuilder oplossing omvat meerdere projecten. Als u het hulpprogramma vanuit de bron wilt uitvoeren, voert u het Azure.DataApiBuilder.Service project uit dat een configuratiebestand doorgeeft.

  1. Maak in de hoofdmap een nieuw bestand met de naam dab-config.json.

    Aanbeveling

    Het .gitignore-bestand negeert automatisch eventuele DAB-configuratiebestanden.

  2. Voeg de volgende inhoud toe aan het configuratiebestand.

    {
  "$schema": "https://github.com/Azure/data-api-builder/releases/latest/download/dab.draft.schema.json",
  "data-source": {
    "database-type": "mssql",
    "connection-string": "Server=localhost,1433;Initial Catalog=Library;User Id=sa;Password=<your-password>;TrustServerCertificate=true;"
  },
  "entities": {
    "book": {
      "source": "dbo.Books",
      "permissions": [
        {
          "actions": [
            "read"
          ],
          "role": "anonymous"
        }
      ]
    }
  }
}

    Belangrijk

    Dit is een voorbeeldconfiguratie die ervan uitgaat dat u een SQL Server hebt die beschikbaar is op uw lokale computer. Als u dit niet doet, kunt u een Docker-container uitvoeren voor SQL Server met uw voorbeeldgegevens. Zie voorbeeldgegevens maken voor meer informatie.

  3. Voer het src/Service/Azure.DataApiBuilder.Service.csproj project uit. Gebruik het --ConfigFileName argument om het configuratiebestand op te geven dat in de vorige stap is gemaakt.

    dotnet run --project src/Service/Azure.DataApiBuilder.Service.csproj --ConfigFileName ../../dab-config.json

    Aanbeveling

    De engine voor data-API builder probeert de configuratie uit het dab-config.json bestand in dezelfde map te laden, indien aanwezig. Als er geen dab-config.json bestand is, wordt de engine toch gestart, maar kan deze niets leveren.

Verwante inhoud

  • Last updated on