Megosztás a következőn keresztül:

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

Adágazd el és klónozd a repositoryt

Első lépésként hozzon létre saját elágazását a azure/data-api-builder GitHub-adattárból. Ez az elágazás lehetővé teszi, hogy megőrizd a saját módosításaidat. 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 elá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

    Másik lehetőségként megnyithatja az elágazást vagy az eredeti adattárat GitHub Codespace-ként.

  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, és nevezze el dab-config.json-nek.

    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, futtathat egy Docker-tárolót az SQL Serverhez a mintaadatokkal. 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 ugyanabba a mappába, ha van ilyen. Ha nincs dab-config.json fájl, a motor egyébként is elindul, de nem fog tudni semmit kiszolgálni.

Kapcsolódó tartalom

  • Last updated on