Ir para o console

Uso e limites

Use este guia para ver informações sobre os limites do Cloud Firestore. Consulte Preços do Cloud Firestore para uma explicação completa e detalhada dos custos relacionados, incluindo itens a serem observados.

Monitorar o uso

Para monitorar o uso do Cloud Firestore, abra a guia Uso no Console do Firebase. Utilize o painel para avaliar o uso em diferentes períodos.

Uso detalhado no Console do Google Cloud Platform

Ao criar um projeto do Firebase, você também cria um no Google Cloud Platform. Na página Cotas do App Engine no Console do Cloud Platform, é possível rastrear mais informações de uso do Cloud Firestore, como dados armazenados e saída de rede.

Cota gratuita

O Cloud Firestore oferece uma cota gratuita que permite começar sem nenhum custo. Os montantes das cotas gratuitas estão listados abaixo. Se você precisar de mais cota, é necessário ativar o faturamento para o projeto do Cloud Platform.

As cotas são aplicadas diariamente e redefinidas aproximadamente à meia-noite do Horário do Pacífico.

Nível gratuito Cota
Dados armazenados 1 GiB
Leituras de documento 50.000 por dia
Gravações de documento 20.000 por dia
Exclusões de documento 20.000 por dia
Saída de rede 10 GiB por mês

Limites padrão

Nas tabelas a seguir, você vê os limites que se aplicam ao uso do Cloud Firestore.

Coleções, documentos e campos

Limite Detalhes
Restrições em códigos de coleções
  • Precisam ser caracteres UTF-8 válidos
  • Não podem ter mais de 1.500 bytes
  • Não podem conter uma barra (/)
  • Não podem consistir apenas em um único ponto (.) ou em pontos duplos (..)
  • Não podem corresponder à expressão regular __.*__
Profundidade máxima das subcoleções 100
Restrições em códigos de documentos
  • Precisam ser caracteres UTF-8 válidos
  • Não podem ter mais de 1.500 bytes
  • Não podem conter uma barra (/)
  • Não podem consistir unicamente em um único ponto (.) ou em pontos duplos (..)
  • Não podem corresponder à expressão regular __.*__
Tamanho máximo do nome de um documento 6 KiB
Tamanho máximo de um documento 1 MiB (1.048.576 bytes)
Restrições em nomes de campo Precisam ser caracteres UTF-8 válidos
Tamanho máximo de um nome de campo 1.500 bytes
Restrições em caminhos de campo
  • Os nomes de campo precisam ser separados por um único ponto (.)
  • Cada nome de campo precisa estar entre crases, a menos que atenda aos seguintes requisitos:
    • O nome do campo contém apenas os caracteres a-z, A-Z, 0-9 e sublinhado (_)
    • O nome do campo não começa com 0-9
Tamanho máximo de um caminho de campo 1.500 bytes
Tamanho máximo do valor de um campo 1 MiB — 89 bytes (1.048.487 bytes)
Profundidade máxima de campos em um mapa ou uma matriz 20

Gravações e transações

Limite Detalhes
Tamanho máximo da solicitação da API 10 MiB
Gravações máximas por segundo por banco de dados 10.000 (até 10 MiB por segundo)
Taxa máxima de gravação em um documento 1 por segundo
Taxa máxima de gravação para uma coleção na qual os documentos têm valores sequenciais em um campo indexado 500 por segundo
Número máximo de gravações que podem ser transmitidas para uma operação Commit ou realizadas em uma transação 500
Número máximo de transformações de campo que podem ser realizadas em um único documento em uma operação Commit ou em uma transação 500
Prazo para uma transação 270 segundos, com tempo de expiração por inatividade de 60 segundos

Atualizações em tempo real

Limite Detalhes
Conexões simultâneas máximas para clientes em dispositivos móveis/Web por banco de dados 1.000.000

Índices

Os limites a seguir se aplicam a índices de campo único e compostos:

Limite Detalhes
Número máximo de índices compostos de um projeto 200
Número máximo de isenções de índice de campo único para um banco de dados 200

Número máximo de entradas de índice para cada documento

40.000

O número de entradas de índice é a soma do valor a seguir para um documento:

  • número de entradas de índice de campo único
  • número de entradas de índice composto
Tamanho máximo de uma entrada de índice

7,5 KiB

Para ver como o Cloud Firestore calcula o tamanho da entrada do índice, consulte o tamanho da entrada do índice.

Soma máxima dos tamanhos das entradas de índice de um documento

8 MiB

O tamanho total é a soma dos seguintes itens para um documento:

  • A soma do tamanho das entradas de índice de campo único de um documento
  • A soma do tamanho das entradas de índice composto de um documento
  • Tamanho máximo de um valor de campo indexado

    1.500 bytes

    Valores de campo acima de 1500 bytes são truncados. As consultas que envolvem valores de campo truncados podem retornar resultados inconsistentes.

    Regras de segurança

    Limite Detalhes
    Número máximo de chamadas exists(), get() e getAfter() por solicitação
    • 10 para solicitações de documento único e de consulta.
    • 20 para leituras de vários documentos, transações e gravações em lote. O limite anterior de 10 também se aplica a cada operação.

      Por exemplo, imagine que você crie uma solicitação de gravação em lote com três operações de gravação, e que suas regras de segurança usem duas chamadas de acesso a documentos para validar cada gravação. Nesse caso, cada gravação usa duas das 10 chamadas de acesso, e a solicitação de gravação em lote usa seis das 20 chamadas de acesso.

    Ao exceder qualquer um desses limites, ocorrerá um erro de permissão negada.

    Algumas chamadas de acesso a documentos podem ser armazenadas em cache. Elas não entram na conta dos limites.

    Profundidade máxima da chamada da função 20
    Número máximo de chamadas de função recorrentes ou cíclicas 0 (não permitido)
    Número máximo de expressões avaliadas por solicitação 1.000
    Tamanho máximo de um conjunto de regras 64 KB

    Gerenciar gastos

    Para evitar cobranças inesperadas na sua conta, estabeleça limites de gastos e alertas.

    Definir um limite de gasto diário

    Para controlar o uso do Cloud Firestore, defina limites de gasto diário no Google App Engine. Você configura esses limites nos recursos associados ao App Engine, incluindo o Cloud Firestore. O limite do App Engine não se aplica a outros produtos do Firebase.

    1. Ative o faturamento do seu projeto no Console do Cloud Platform se ainda não tiver feito isso.
    2. Acesse a página Configurações do aplicativo do App Engine no console do Cloud Platform.
    3. Clique em Editar e estabeleça um limite de Gasto diário.
    4. Clique em Salvar. O novo limite entra em vigor imediatamente e é redefinido diariamente.

    Definir um orçamento mensal

    Para acompanhar os custos do Cloud Firestore, crie um orçamento mensal no Console do Cloud Platform. Os orçamentos não limitarão seu uso, mas é possível configurar alertas que avisarão quando você estiver se aproximando do limite de custos planejados para o mês ou quando tiver excedido esse valor.

    Para definir um orçamento, acesse a seção Faturamento no console do Cloud Platform e crie um orçamento para sua conta de faturamento. Use alertas com as configurações padrão ou modifique-os para enviar notificações em porcentagens diferentes do seu orçamento mensal.

    Saiba mais sobre como definir um orçamento no Console do Cloud Platform.