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

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

  • Cikk

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ó a projekt közvetlenül a forráskódból történő létrehozásához szükséges összes lépést tartalmazza.

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

Az adattár elágazása és klónozása

Első lépésként hozza 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őrizze a saját módosításait. Ha így dönt, bármikor megnyithat egy lekéréses kérelmet, és javaslatot tehet a felsőbb rétegbeli adattár módosításaira.

  1. Nyissa meg a https://github.com/azure/data-api-builder/fork címet.

  2. Létrehozás tárház elágazását 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 az elágazást.

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

    Tipp

    Másik lehetőségként megnyithatja az elágaztat 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 nevű új fájlt dab-config.json.

    Tipp

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

  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 elérhető egy SQL Server a helyi gépen. Ha nem, futtathat egy Docker-tárolót SQL Server 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

    Tipp

    A Data API Builder-motor megpróbálja betölteni a konfigurációt az dab-config.json ugyanabban a mappában lévő fájlból, ha van ilyen. Ha nincs dab-config.json fájl, a motor mégis elindul, de nem fog tudni szolgálni semmit.

Kapcsolódó tartalom