通过

从源代码生成和运行数据 API 生成器

数据 API 生成器 （DAB） 是 GitHub 上托管的开源项目。 可以随时下载源代码、修改代码，直接从源运行项目。 本指南包括直接从其源代码生成项目所需的所有步骤。

先决条件

分叉和克隆存储库

开始时，先在 azure/data-api-builder GitHub 存储库上创建您自己的克隆。 通过此分支，可以保留自己的更改。 如果你愿意的话，你可以随时打开一个拉取请求，并建议对上游仓库进行更改。

  1. 转到 https://github.com/azure/data-api-builder/fork。

  2. 在自己的帐户或组织中创建存储库分支。 等待分叉操作完成后再继续。

  3. 打开新的终端。

  4. 克隆分叉。

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

    小窍门

    或者，可以将分支或原始存储库作为 GitHub Codespace 打开。

  5. 构建src/Azure.DataApiBuilder.sln解决方案。

    dotnet build src/Azure.DataApiBuilder.sln

运行引擎

该 Azure.DataApiBuilder 解决方案包括多个项目。 若要从源代码运行该工具, 请运行项目 Azure.DataApiBuilder.Service, 并传入配置文件。

  1. 在根目录中，创建一个新文件，名为dab-config.json。

    小窍门

    .gitignore 文件会自动忽略任何 DAB 配置文件。

  2. 将以下内容添加到配置文件。

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

    重要

    这是一个示例配置，假定本地计算机上提供了 SQL Server。 如果没有，可以使用示例数据为 SQL Server 运行 Docker 容器。 有关详细信息，请参阅 创建示例数据。

  3. 运行 src/Service/Azure.DataApiBuilder.Service.csproj 项目。 使用 --ConfigFileName 参数指定在上一步中创建的配置文件。

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

    小窍门

    数据 API 生成器引擎尝试从 dab-config.json 同一文件夹中的文件加载配置（如果存在）。 dab-config.json如果没有文件，引擎无论如何都会启动，但无法提供任何服务。

相关内容

  • Last updated on