Guia de início rápido: usar o construtor de API de dados com o NoSQL

Neste Guia de início rápido, você cria um conjunto de arquivos de configuração do construtor de API de dados para direcionar o emulador do Azure Cosmos DB para NoSQL.

Pré-requisitos

Sugestão

Como alternativa, abra este Guia de início rápido no GitHub Codespaces com todos os pré-requisitos do desenvolvedor já instalados. Basta trazer sua própria assinatura do Azure. As contas do GitHub incluem um direito de armazenamento e horas essenciais sem nenhum custo. Para obter mais informações, consulte armazenamento incluído e horas principais para contas do GitHub.

Instalar a CLI do construtor de API de dados

Instale o Microsoft.DataApiBuilder pacote do NuGet como uma ferramenta .NET.

Use dotnet tool install para instalar a versão mais recente do Microsoft.DataApiBuilder com o --global argumento.
```
dotnet tool install --global Microsoft.DataApiBuilder
```
Observação

Se o pacote já estiver instalado, atualize-o usando dotnet tool update.
```
dotnet tool update --global Microsoft.DataApiBuilder
```
Verifique se a ferramenta está instalada com dotnet tool list utilizando o argumento --global.
```
dotnet tool list --global
```

Configurar o banco de dados local

Comece executando o emulador local. Em seguida, você pode semear um novo recipiente com dados de amostra.

Obtenha a cópia mais recente da imagem do mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest contêiner do Docker Hub.
```
docker pull mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest
```

Inicie o contêiner do docker publicando a porta 8081 e o intervalo de portas 10250-10255.

docker run \
    --publish 8081:8081 \
    --publish 10250-10255:10250-10255 \
    --detach \
    mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest

Baixe o certificado autoassinado para o emulador

curl -k https://localhost:8081/_explorer/emulator.pem > ~/emulatorcert.crt

Instale o certificado autoassinado usando as etapas Bash para Linux ou as etapas do PowerShell para Windows.

sudo cp ~/emulatorcert.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates

certutil -f -addstore "Root" emulatorcert.crt

Conecte-se ao seu banco de dados local usando seu ambiente de gerenciamento de dados preferido. Os exemplos incluem, mas não estão limitados a: a extensão de Bancos de Dados do Azure para Visual Studio Code.

Sugestão

A cadeia de conexão padrão para o emulador é AccountEndpoint=https://localhost:8081;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;.
Crie um novo bookshelf banco de dados e authors contêiner.

Semeie o contêiner com esses dados JSON básicos.

[
  {
    "id": "01",
    "firstName": "Henry",
    "lastName": "Ross"
  },
  {
    "id": "02",
    "firstName": "Jacob",
    "middleName": "A.",
    "lastName": "Hancock"
  },
  {
    "id": "03",
    "firstName": "Sydney",
    "lastName": "Mattos"
  },
  {
    "id": "04",
    "firstName": "Jordan",
    "lastName": "Mitchell"
  },
  {
    "id": "05",
    "firstName": "Victoria",
    "lastName": "Burke"
  },
  {
    "id": "06",
    "firstName": "Vance",
    "lastName": "DeLeon"
  },
  {
    "id": "07",
    "firstName": "Reed",
    "lastName": "Flores"
  },
  {
    "id": "08",
    "firstName": "Felix",
    "lastName": "Henderson"
  },
  {
    "id": "09",
    "firstName": "Avery",
    "lastName": "Howard"
  },
  {
    "id": "10",
    "firstName": "Violet",
    "lastName": "Martinez"
  }
]

Criar arquivos de configuração

Crie um arquivo de configuração de linha de base usando a CLI do DAB. Em seguida, adicione um arquivo de configuração de desenvolvimento com suas credenciais atuais.

Crie um novo arquivo chamado schema.graphql com esse conteúdo de esquema.

type Author @model {
  id: ID!
  firstName: String!
  middleName: String
  lastName: String!
}

Crie um arquivo de configuração típico usando dab init. Adicione o argumento --connection-string com a cadeia de conexão padrão do emulador.

dab init --database-type "cosmosdb_nosql" --host-mode "Development" --cosmosdb_nosql-database bookshelf --graphql-schema schema.graphql --connection-string "AccountEndpoint=https://localhost:8081;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;"

Adicione uma entidade Autor usando dab add.

dab add Author --source "authors" --permissions "anonymous:*"

API de teste com o banco de dados local

Agora, inicie a ferramenta Data API builder para validar que seus arquivos de configuração são mesclados durante o desenvolvimento.

Use dab start para executar a ferramenta e criar endpoints de API para a sua entidade.
```
dab start
```
A saída da ferramenta deve incluir o endereço a ser usado para navegar até a API em execução.
```
      Successfully completed runtime initialization.
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: <http://localhost:5000>
info: Microsoft.Hosting.Lifetime[0]
```
Sugestão

Neste exemplo, o aplicativo está sendo executado na localhost porta 5000. Seu aplicativo em execução pode ter um endereço e uma porta diferentes.
Vá até o endpoint GraphQL navegando para /graphql e execute esta operação.
```
query {
  authors {
    items {
      id
      firstName
      lastName
    }
  }
}
```
Sugestão

Neste exemplo, a URL seria https://localhost:5000/graphql. Você pode navegar até esse URL usando seu navegador da Web.

Próximo passo

Guia de início rápido: implantar o construtor de API de dados no Azure

Feedback

Esta página foi útil?

Last updated on 2026-01-28