Delen via

Data API Builder bouwen en uitvoeren vanuit broncode

  • Artikel

Data API Builder (DAB) is een opensource-project dat wordt gehost op GitHub. U kunt op elk gewenst moment de broncode 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.

Vereisten

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

De opslagplaats splitsen en klonen

Ga aan de slag door uw eigen fork van de GitHub-opslagplaats azure/data-api-builder te maken. Met deze fork kunt u uw eigen wijzigingen behouden. Als u hiervoor 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. Creatie een fork van de opslagplaats in uw eigen account of organisatie. Wacht totdat de forkingsbewerking is voltooid voordat u doorgaat.

  3. Open een nieuwe terminal.

  4. Kloon de fork.

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

    Tip

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

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

    dotnet build src/Azure.DataApiBuilder.sln

De engine uitvoeren

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 wordt doorgegeven in een configuratiebestand.

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

    Tip

    In het .gitignore-bestand worden alle DAB-configuratiebestanden automatisch genegeerd.

  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 beschikbaar hebt op uw lokale computer. Als u dat 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

    Tip

    De Data API Builder-engine 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 verwerken.

Gerelateerde inhoud