O Python 2 não é mais compatível com a comunidade. Recomendamos que você migre aplicativos do Python 2 para o Python 3.

Como usar o Cloud Firestore no modo Datastore

O Firestore é um banco de dados de documentos NoSQL criado para fornecer escalonamento automático, alto desempenho e facilidade no desenvolvimento de aplicativos. O Firestore é a mais nova versão do Datastore e apresenta várias melhorias sobre o Datastore.

Recomendamos o uso do Firestore no modo Datastore para bancos de dados que serão usados principalmente por aplicativos do App Engine. Para mais informações sobre os modos do Firestore, consulte Como escolher entre o modo nativo e o modo Datastore.

Os aplicativos do App Engine em execução no ambiente de execução padrão do Python 2 só podem usar uma biblioteca de cliente NDB para interagir com o modo Datastore. Recomendamos que você migre para o Cloud NDB como parte da migração de seus aplicativos do Python 2 para o Python 3. O App Engine NDB não está disponível no ambiente de execução do Python 3.

Como usar o modo Datastore com o App Engine

Para usar o modo Datastore com o App Engine:

  1. Se ainda não tiver feito isso, crie um banco de dados e escolha o Firestore no modo Datastore.

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

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

Como configurar índices

O modo Datastore usa índices para cada consulta feita pelo 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 modo Datastore cria automaticamente índices de propriedade única para uso com tipos simples de consultas. Para consultas complexas que incluem várias propriedades, é preciso configurar índices compostos no arquivo index.yaml do aplicativo.

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

Também é possível adicionar os índices ao arquivo index.yaml do aplicativo manualmente se não executar testes locais ou se os testes não incluírem consultas complexas.

Como configurar permissões de banco de dados

Por padrão, seu aplicativo tem todas as permissões necessárias para ler e gravar no modo Datastore e nos bancos de dados do Firestore no projeto do Google Cloud.

Para gerenciar essas permissões, cada aplicativo do App Engine usa uma conta de serviço padrão que concede acesso total de leitura e gravação ao modo Datastore e aos bancos de dados do Firestore no mesmo projeto do aplicativo. É possível alterar as permissões da conta de serviço padrão, mas o app pode perder o acesso, a menos que você atribua 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 modo Datastore oferece uma cota gratuita 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.