Aceda à sua base de dados

Esta página descreve como aceder a uma base de dados do Firestore no modo Datastore a partir de diferentes plataformas.

Antes de começar

Este documento pressupõe que já criou uma base de dados no modo Datastore. Se não tiver criado uma base de dados, siga as instruções no Início rápido do Firestore no modo Datastore.

Aceda à sua base de dados a partir do App Engine

Para começar a usar o modo Datastore e o App Engine, consulte uma das seguintes páginas específicas do idioma:

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

Autorizações do modo Datastore para o App Engine

As apps do App Engine podem aceder a uma base de dados do modo Datastore no mesmo projeto por predefinição. Cada app do App Engine usa uma conta de serviço predefinida do App Engine para gerir o acesso a Google Cloud serviços como o Firestore. Por predefinição, a conta de serviço predefinida do App Engine tem a função de IAM de editor do projeto, que inclui acesso total de leitura e escrita ao modo Datastore.

Pode modificar as autorizações da IAM da conta de serviço predefinida do App Engine, mas a sua app pode perder o acesso ao Firestore, a menos que atribua uma função da IAM com as autorizações do Firestore necessárias. As funções do IAM Datastore Owner e Datastore User, por exemplo, concedem acesso de leitura e escrita ao Firestore no modo Datastore.

Se desativar ou eliminar a conta de serviço predefinida do App Engine, a sua app do App Engine perde o acesso à base de dados do modo Datastore. Se desativou a sua conta de serviço do App Engine, pode reativá-la. Consulte o artigo Ativar uma conta de serviço. Se eliminou a sua conta de serviço do App Engine nos últimos 30 dias, pode restaurá-la. Consulte o artigo sobre como anular a eliminação de uma conta de serviço.

Aceda à sua base de dados a partir de uma instância do Compute Engine

Esta secção mostra como ativar e aceder a uma base de dados do modo Datastore a partir de uma instância de VM do Compute Engine num projeto novo ou existente.

Autorizações do modo Datastore para o Compute Engine

As apps do Compute Engine podem aceder a uma base de dados do modo Datastore no mesmo projeto por predefinição. Cada app do Compute Engine usa uma conta de serviço predefinida do Compute Engine para gerir o acesso a Google Cloud serviços como o Firestore. Por predefinição, a conta de serviço predefinida do Compute Engine tem a função de IAM de editor do projeto, que inclui acesso total de leitura e escrita ao modo Datastore.

Para aceder à sua base de dados a partir de uma instância do Compute Engine, conclua os passos seguintes:

  1. Ative a API Google Compute Engine para o seu projeto.
    Ative a API Compute Engine
  2. Verify that billing is enabled for your Google Cloud project.

  3. Crie uma instância do Compute Engine.

Consola

  1. Na Google Cloud consola, aceda à página Instâncias de VM.
  2. Clique no botão Criar instância.
  3. Na secção Identidade e acesso à API, defina os Âmbitos de acesso para conceder acesso ao Datastore. Clique em Permitir acesso total a todas as APIs Cloud para conceder acesso a todas as APIs Google Cloud ou clique em Definir acesso para cada API, clique no menu pendente de Armazenamento de dados e, de seguida, clique em Ativado para conceder acesso ao armazenamento de dados.
  4. Clique no botão Criar para criar a instância de VM.
  5. Confirme que a sua instância está em execução.
  6. Para usar esta nova instância de VM do Compute Engine, ligue-se à mesma através do navegador.

gcloud

  1. Se ainda não o fez, instale a CLI Google Cloud e configure gcloud compute.
  2. Adicione uma instância de VM do Compute Engine e inicie-a 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 cloud-platform ou o datastore âmbito conforme mostrado no exemplo seguinte.

    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 criou anteriormente e [YOUR_INSTANCE_NAME] pelo nome que quer usar para a sua instância de VM.

  3. Confirme que a sua instância está em execução.

  4. Para usar esta nova instância de VM, estabeleça ligação à VM.

Neste ponto, todos os serviços e autorizações estão configurados para o seu projeto e pode começar a escrever código ou explorar a API.

Aceda à sua base de dados a partir de outra plataforma

Esta secção mostra como aceder à base de dados do modo Datastore a partir de uma aplicação externa executada numa plataforma fora do Google Cloud.

Primeiro, crie uma conta de serviço:

  1. Na Google Cloud consola, aceda à página Criar conta de serviço.

    Aceda a Criar conta de serviço

  2. Selecione um projeto.

  3. No campo Nome da conta de serviço, introduza um nome. A Google Cloud consola preenche o campo ID da conta de serviço com base neste nome.

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

  5. Clique em Criar.

  6. Clique no campo Selecionar uma função.

    Em Todas as funções, selecione uma função que conceda acesso à sua base de dados, como Datastore > Utilizador do Cloud Datastore.

  7. Clique em Continuar.

  8. Clique em Concluído para terminar de criar a conta de serviço.

    Não feche a janela do navegador. Vai usá-lo no procedimento seguinte.

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

  1. Na Google Cloud consola, clique no endereço de email da conta de serviço que criou.
  2. Clique em Chaves.
  3. Clique em Adicionar chave e, de seguida, em Criar nova chave.
  4. Clique em Criar. É transferido um ficheiro de chave JSON para o seu computador.
  5. Clique em Fechar.

Use esta conta de serviço para configurar as credenciais do código da sua aplicação, conforme descrito em Fornecer credenciais da conta de serviço.

Quotas e faturação

Está disponível uma determinada quantidade de quota gratuita, conforme descrito em Preços e quota. Isto significa que não tem de ativar a faturação para começar nem para usar o Firestore no modo Datastore até aos limites da quota gratuita. No entanto, se precisar de mais recursos do que os fornecidos pela quota gratuita, tem de ativar a faturação.

O que se segue?

Para ativar a faturação, consulte o artigo Ative a faturação para um projeto.