Acessar seu banco de dados

Esta página descreve como acessar um banco de dados do Firestore no modo Datastore em diferentes plataformas.

Antes de começar

Neste documento, consideramos que você já criou um banco de dados do modo Datastore. Se você não criou um banco de dados, siga as instruções no Início rápido do Firestore no modo Datastore.

Acessar seu banco de dados pelo App Engine

Para começar a usar o modo Datastore e o App Engine, consulte uma destas páginas específicas para cada linguagem de programação:

Ambiente padrão do App Engine Ambiente flexível do App Engine

Permissões do modo Datastore para o App Engine

Os aplicativos do App Engine podem acessar um banco de dados do modo Datastore no mesmo projeto por padrão. Cada aplicativo do App Engine usa uma conta de serviço padrão do App Engine para gerenciar o acesso a serviços do Google Cloud, como o Firestore. Por padrão, a conta de serviço padrão do App Engine tem o papel de IAM Editor do projeto, que inclui acesso total de leitura e gravação ao modo Datastore.

É possível modificar as permissões de IAM da sua conta de serviço padrão do App Engine, mas seu app pode perder o acesso ao Firestore, a menos que você atribua um papel de IAM às permissões exigidas do Firestore. Os papéis de IAM Proprietário do Datastore e Usuário do Datastore, por exemplo, concedem acesso de leitura e gravação ao Firestore no modo Datastore.

Ao desativar ou excluir sua conta de serviço padrão do App Engine, seu aplicativo do App Engine perderá o acesso ao banco de dados do modo Datastore. Se você desativou sua conta de serviço do App Engine, poderá reativá-la. Consulte este link para ver como fazer isso. Se você excluiu sua conta de serviço do App Engine nos últimos 30 dias, poderá restaurá-la. Consulte Como cancelar a exclusão de uma conta de serviço.

Acessar seu banco de dados em uma instância do Compute Engine

Veja nesta seção como ativar e acessar um banco de dados do modo Datastore por uma instância de VM do Compute Engine em um projeto novo ou existente.

Permissões do modo Datastore para o Compute Engine

Os apps do Compute Engine podem acessar um banco de dados do modo Datastore no mesmo projeto por padrão. Cada app do Compute Engine usa uma conta de serviço padrão do Compute Engine para gerenciar o acesso a serviços do Google Cloud, como o Firestore. Por padrão, a conta de serviço padrão do Compute Engine tem o papel de IAM Editor do projeto, que inclui acesso total de leitura e gravação ao modo Datastore.

Para acessar o banco de dados em uma instância do Compute Engine, siga estas etapas:

  1. Ative a API Google Compute Engine referente ao seu projeto.
    Ativar a API Compute Engine

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Crie uma instância do Compute Engine.

Console

  1. No console do Google Cloud, acesse a página Instâncias de VM.
  2. Clique no botão Criar instância.
  3. Na seção Identidade e acesso à API, defina Escopos de acesso para fornecer acesso ao Datastore. Clique em Permitir acesso total a todas as APIs do Cloud para conceder acesso a todas as APIs do Google Cloud ou clique em Definir o acesso para cada API, clique no menu suspenso de Datastore e, em seguida, clique em Ativado para conceder acesso ao Datastore.
  4. Clique no botão Criar para criar a instância de VM.
  5. Verifique se sua instância está em execução.
  6. Para usar essa nova instância de VM do Compute Engine, conecte-se a ela pelo navegador.

gcloud

  1. Se ainda não tiver feito isso, instale a Google Cloud CLI e configure gcloud compute.

  2. Adicione e inicie uma instância de VM do Compute Engine seguindo as instruções para iniciar uma instância na documentação do Compute Engine. Especifique o ID do projeto, o nome da instância de VM e o escopo cloud-platform ou datastore, conforme mostrado no exemplo a seguir.

    export PROJECT_ID=[YOUR_PROJECT_ID]
export INSTANCE_NAME=[YOUR_INSTANCE_NAME]
gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore

    Substitua [YOUR_PROJECT_ID] pelo ID do projeto que você criou anteriormente e [YOUR_INSTANCE_NAME] pelo nome que você quer usar para a instância de VM.

  3. Verifique se sua instância está em execução.

  4. Para usar essa nova instância de VM, conecte-se a ela.

Nesse ponto, todos os serviços e autorizações estão configurados para seu projeto. É possível escrever o código ou explorar a API.

Acessar seu banco de dados por outra plataforma

Nesta seção, mostramos como acessar seu banco de dados do modo Datastore por um aplicativo externo em execução em uma plataforma fora do Google Cloud.

Crie primeiro uma conta de serviço:

  1. No Console do Google Cloud, acesse a página Criar conta de serviço.

    Acesse "Criar conta de serviço"

  2. Selecione um projeto.

  3. No campo Nome da conta de serviço, insira um nome. O console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.

  4. Opcional: no campo Descrição da conta de serviço, digite uma descrição.

  5. Clique em Criar.

  6. Clique no campo Selecionar um papel.

    Em Todos os papéis, selecione um papel que concede acesso ao banco de dados, como Datastore > Usuário do Cloud Datastore.

  7. Clique em Continuar.

  8. Clique em Concluído para terminar a criação da conta de serviço.

    Não feche a janela do navegador. Você precisará usá-la no próximo procedimento.

Em seguida, crie uma chave da conta de serviço:

  1. No console do Google Cloud, clique no endereço de e-mail da conta de serviço que você criou.
  2. Clique em Chaves.
  3. Clique em Adicionar chave e, depois, em Criar nova chave.
  4. Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
  5. Clique em Fechar.

Use esta conta de serviço para configurar as credenciais do seu código do aplicativo, conforme descrevemos em Como fornecer credenciais da conta de serviço.

Cotas e faturamento

Há uma determinada quantidade de cota disponível, como descrito em Preços e cota. Isso significa que não é preciso ativar o faturamento para usar o Firestore no modo Datastore até os limites de cota gratuitos. No entanto, se você precisar de mais recursos do que o fornecido gratuitamente, ative o faturamento.

A seguir

Para ativar o faturamento, consulte Ativar o faturamento de um projeto.