Sdílet prostřednictvím

Sestavení a spuštění tvůrce rozhraní Data API ze zdrojového kódu

Tvůrce rozhraní DATA API (DAB) je opensourcový projekt hostovaný na GitHubu. Kdykoli si můžete stáhnout zdrojový kód, upravit kód a spustit projekt přímo ze zdroje. Tato příručka obsahuje všechny kroky potřebné k sestavení projektu přímo ze zdrojového kódu.

Požadavky

  • GitHub účet
  • Git
    • V tomto kurzu se předpokládá základní znalost příkazů a nástrojů Gitu.
  • .NET 8

Vytvoření forku a klonování úložiště

Začněte vytvořením vlastního forku úložiště azure/data-api-builder GitHub. Tento fork umožňuje zachovat vlastní změny. Pokud tak zvolíte, můžete kdykoli otevřít žádost o přijetí změn a navrhnout změny v upstreamovém úložišti.

  1. Přejděte na https://github.com/azure/data-api-builder/fork.

  2. Vytvořte fork úložiště ve vašem vlastním účtu nebo organizaci. Než budete pokračovat, počkejte na dokončení větvení operace.

  3. Otevřete nový terminál.

  4. Naklonujte fork.

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

    Návod

    Případně můžete fork nebo původní úložiště otevřít jako GitHub Codespace.

  5. src/Azure.DataApiBuilder.sln Sestavte řešení.

    dotnet build src/Azure.DataApiBuilder.sln

Spusťte motor

Řešení Azure.DataApiBuilder obsahuje více projektů. Pokud chcete nástroj spustit ze zdroje, spusťte projekt Azure.DataApiBuilder.Service s předáním konfiguračního souboru.

  1. V kořenovém adresáři vytvořte nový soubor s názvem dab-config.json.

    Návod

    Soubor .gitignore automaticky ignoruje všechny konfigurační soubory DAB.

  2. Do konfiguračního souboru přidejte následující obsah.

    {
  "$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"
        }
      ]
    }
  }
}

    Důležité

    Jedná se o ukázkovou konfiguraci, která předpokládá, že máte SQL Server dostupný na místním počítači. Pokud to neuděláte, můžete spustit kontejner Dockeru pro SQL Server s ukázkovými daty. Další informace najdete v tématu vytváření ukázkových dat.

  3. Spusťte projekt src/Service/Azure.DataApiBuilder.Service.csproj. Pomocí argumentu --ConfigFileName zadejte konfigurační soubor vytvořený v předchozím kroku.

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

    Návod

    Modul tvůrce rozhraní Data API se pokusí načíst konfiguraci ze dab-config.json souboru ve stejné složce, pokud je k dispozici. Pokud soubor dab-config.json neexistuje, modul se přesto spustí, ale nebude moct zpracovávat nic.

Související obsah

  • Last updated on