Data API Builder létrehozása és futtatása forráskódból

A Data API Builder (DAB) egy nyílt forráskódú projekt, amely a GitHubon fut. Bármikor letöltheti a forráskódot, módosíthatja a kódot, és közvetlenül a forrásból futtathatja a projektet. Ez az útmutató tartalmazza a projekt forráskódból való közvetlen létrehozásához szükséges összes lépést.

Előfeltételek

  • GitHub-fiók
  • Git
    • Ez az oktatóanyag feltételezi a Git-parancsok és -eszközök alapszintű ismeretét.
  • .NET 8

Adattár forkolása, majd klónozása

Első lépésként hozzon létre saját elágazását a azure/data-api-builder GitHub-adattárból. Ez a fork lehetővé teszi a saját módosítások megőrzését. Ha így dönt, bármikor megnyithat egy lekéréses kérelmet, és javasolhatja a felsőbb rétegbeli adattár módosításait.

  1. Navigáljon ide: https://github.com/azure/data-api-builder/fork.

  2. Hozzon létre egy elágazást az adattárból a saját fiókjában vagy szervezetében. A folytatás előtt várja meg, amíg az ágaztatási művelet befejeződik.

  3. Nyisson meg egy új terminált.

  4. Klónozza a forkot.

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

    Jótanács

    Alternatív megoldásként megnyithatja a forkot vagy az eredeti adattárat a GitHub Codespace-ben.

  5. Hozza létre a src/Azure.DataApiBuilder.sln megoldást.

    dotnet build src/Azure.DataApiBuilder.sln

A motor futtatása

A Azure.DataApiBuilder megoldás több projektet is tartalmaz. Az eszköz forrásból való futtatásához futtassa a Azure.DataApiBuilder.Service projektet egy konfigurációs fájlban.

  1. A gyökérkönyvtárban hozzon létre egy új fájlt dab-config.json néven.

    Jótanács

    A .gitignore fájl automatikusan figyelmen kívül hagyja a DAB-konfigurációs fájlokat.

  2. Adja hozzá a következő tartalmat a konfigurációs fájlhoz.

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

    Fontos

    Ez egy mintakonfiguráció, amely feltételezi, hogy rendelkezik a helyi gépen elérhető SQL Serverrel. Ha nem teszi meg, futtathat egy SQL Server Docker-tárolót a saját mintaadataival. További információ: mintaadatok létrehozása.

  3. Futtassa a src/Service/Azure.DataApiBuilder.Service.csproj projektet. --ConfigFileName Az argumentum használatával adja meg az előző lépésben létrehozott konfigurációs fájlt.

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

    Jótanács

    A Data API builder motorja megpróbálja betölteni a konfigurációt a dab-config.json fájlból ugyanabban a mappában, ha van ilyen. Ha nincs dab-config.json fájl, a motor egyébként elindul, de nem fog tudni kiszolgálni semmit.

Kapcsolódó tartalom

  • Last updated on