Como usar o Cloud Datastore

O Cloud Datastore é um banco de dados de documentos NoSQL criado para fornecer escalonamento automático, alto desempenho e facilidade no desenvolvimento de aplicativos.

Os apps do App Engine em execução no ambiente de execução padrão do Python 2 só podem usar a biblioteca de cliente NDB para interagir com o Cloud Datastore. A biblioteca de cliente do Google Cloud não está disponível para apps do Python 2 em execução no ambiente padrão do App Engine.

Como usar o Datastore com o App Engine

Para usar o Cloud Datastore com o App Engine, siga estas etapas:

  1. Se você ainda não tiver um banco de dados, crie um.

    Se você for criar um novo banco de dados, selecione o Cloud Firestore no modo Datastore. Essa opção é a próxima versão principal do Cloud Datastore e uma reformulação do produto. O modo Datastore é recomendado para bancos de dados que serão usados principalmente com o App Engine.

    É possível usar bancos de dados atuais do Cloud Datastore com aplicativos do App Engine. Esses bancos de dados atuais serão atualizados automaticamente para o Cloud Firestore no modo Datastore.

  2. No seu app, declare o Cloud Datastore como uma dependência adicionando google-cloud-datastore ao arquivo requirements.txt do aplicativo.

  3. Use o NDB para criar, recuperar e gerenciar entidades no seu banco de dados do Cloud Datastore.

Como configurar índices

O Cloud Datastore usa índices para todas as consultas feitas pelo seu aplicativo. Esses índices são atualizados sempre que uma entidade sofre alterações para que, dessa forma, os resultados sejam retornados com rapidez quando o aplicativo fizer uma consulta.

O Cloud Datastore cria automaticamente índices de propriedade única para uso com tipos simples de consultas. Para consultas complexas que incluem várias propriedades, você precisará configurar índices compostos no arquivo index.yaml do aplicativo.

O servidor de desenvolvimento do App Engine atualizará seu arquivo index.yaml com os índices compostos necessários para executar seus testes. Da mesma maneira, o emulador do Cloud Datastore pode gerar índices ao executar testes.

Se você não executar testes locais ou se os testes não incluírem consultas complexas, será possível adicionar manualmente os índices ao arquivo index.yaml do aplicativo (/appengine/docs/standard/python/config/indexref#automatic).

Como configurar permissões de banco de dados

Por padrão, o aplicativo tem todas as permissões necessárias de leitura e gravação nos bancos de dados do Cloud Datastore e do Cloud Firestore no projeto do Google Cloud Platform.

Para gerenciar essas permissões, cada aplicativo do App Engine usa uma conta de serviço padrão que fornece acesso total de leitura e gravação aos bancos de dados do Cloud Datastore e do Cloud Firestore no mesmo projeto do aplicativo. É possível alterar as permissões da conta de serviço padrão, mas seu aplicativo pode perder o acesso, a menos que você atribua a ele um papel do IAM com as permissões necessárias.

Para informações sobre como permitir que outros usuários, aplicativos ou projetos acessem um banco de dados, consulte Como acessar o banco de dados.

Preços, cotas e limites

O Cloud Datastore oferece uma cota grátis com limites diários. As contas pagas oferecem operações ilimitadas de armazenamento, leitura e gravação. Para mais informações, consulte a página Cotas do Datastore.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Python 2