Compartilhar via

Compilar e executar o Construtor de API de Dados no código-fonte

  • Artigo

O DAB (Construtor de API de Dados) é um projeto de software livre hospedado no GitHub. A qualquer momento, você pode baixar o código-fonte, modificar o código e executar o projeto diretamente da origem. Este guia inclui todas as etapas necessárias para compilar o projeto diretamente de seu código-fonte.

Pré-requisitos

Bifurcar e clonar o repositório

Comece criando sua própria bifurcação do azure/data-api-builder repositório GitHub. Essa bifurcação permite que você persista suas próprias alterações. Se você escolher, sempre poderá abrir uma solicitação de pull e sugerir as alterações no repositório upstream.

  1. Navegue até https://github.com/azure/data-api-builder/fork.

  2. Create uma bifurcação do repositório em sua própria conta ou organização. Aguarde a conclusão da operação de bifurcação antes de continuar.

  3. Abrir um novo Terminal.

  4. Clone o fork.

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

    Dica

    Como alternativa, você pode abrir a bifurcação ou o repositório original como um Codespace do GitHub.

  5. Crie a src/Azure.DataApiBuilder.sln solução.

    dotnet build src/Azure.DataApiBuilder.sln

Executar o mecanismo

A Azure.DataApiBuilder solução inclui vários projetos. Para executar a ferramenta da origem, execute o Azure.DataApiBuilder.Service projeto passando um arquivo de configuração.

  1. No diretório raiz, crie um novo arquivo chamado dab-config.json.

    Dica

    O arquivo .gitignore ignora automaticamente todos os arquivos de configuração do DAB.

  2. Adicione o conteúdo a seguir ao arquivo de configuração.

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

    Importante

    Essa é uma configuração de exemplo que pressupõe que você tenha uma SQL Server disponível em seu computador local. Se você não fizer isso, poderá executar um contêiner do Docker para SQL Server com seus dados de exemplo. Para obter mais informações, consulte criando dados de exemplo.

  3. Execute o projeto src/Service/Azure.DataApiBuilder.Service.csproj. Use o --ConfigFileName argumento para especificar o arquivo de configuração criado na etapa anterior.

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

    Dica

    O mecanismo do construtor de API de Dados tentará carregar a configuração do dab-config.json arquivo na mesma pasta, se presente. Se não houver nenhum dab-config.json arquivo, o mecanismo será iniciado de qualquer maneira, mas não poderá servir nada.

Conteúdo relacionado