Use este guia para entender os limites do Cloud Firestore e consulte Preços do Cloud Firestore para obter uma explicação completa e detalhada dos custos do Cloud Firestore, incluindo itens a serem observados.
Monitore seu uso
Para monitorar o uso do Cloud Firestore, abra a guia Uso do Cloud Firestore no console do Firebase. Use o painel para avaliar seu uso em diferentes períodos de tempo.
Uso detalhado no console do Google Cloud
Ao criar um projeto do Firebase, você também cria um projeto do Google Cloud. As páginas Cotas da API Cloud Firestore e Cotas do App Engine no console do Google Cloud rastreiam o uso do Cloud Firestore e informações de cota.
Cota gratuita
O Cloud Firestore oferece cota gratuita que permite que você comece a usar seu banco de dados (default)
sem nenhum custo. Os valores das cotas gratuitas estão listados abaixo. Se precisar de mais cota, você deverá ativar o faturamento para seu projeto do Google Cloud .
As cotas são aplicadas diariamente e redefinidas por volta da meia-noite, horário do Pacífico.
Somente o banco de dados (default)
se qualifica para a cota gratuita.
Nível gratuito | Contingente |
---|---|
Dados armazenados | 1 GiB |
Leituras de documentos | 50.000 por dia |
Gravações de documentos | 20.000 por dia |
Exclusões de documentos | 20.000 por dia |
Transferência de dados de saída | 10 GiB por mês |
As seguintes operações e recursos não incluem uso gratuito. Você deve ativar o faturamento para usar estes recursos:
- Uso de bancos de dados nomeados (não padrão)
- Exclusões de TTL
- Dados PITR
- Dados de backup
- Operações de restauração
Para obter mais informações sobre como esses recursos são cobrados, consulte Preços de armazenamento .
Limites padrão
As tabelas a seguir mostram os limites aplicáveis ao Cloud Firestore. Estes são limites rígidos, salvo indicação em contrário.
Bancos de dados
Limite | Detalhes |
---|---|
Número máximo de bancos de dados por projeto | 100 Você pode entrar em contato com o suporte para solicitar um aumento nesse limite. |
Coleções, documentos e campos
Limite | Detalhes |
---|---|
Restrições nos IDs de coleta |
|
Profundidade máxima de subcoleções | 100 |
Restrições em IDs de documentos |
|
Tamanho máximo para um nome de documento | 6 KiB |
Tamanho máximo para um documento | 1 MiB (1.048.576 bytes) |
Restrições em nomes de campos | Deve ter caracteres UTF-8 válidos |
Tamanho máximo de um nome de campo | 1.500 bytes |
Restrições em caminhos de campo |
` ). Por exemplo, foo.`x&y` refere-se ao campo x&y aninhado no campo foo . Para construir um nome de campo com o caractere de crase, escape do caractere de crase com o caractere de barra invertida ( \ ). Por conveniência, você pode evitar nomes de campos entre aspas passando o caminho do campo como um objeto FieldPath ( por exemplo, consulte JavaScript FieldPath ). |
Tamanho máximo de um caminho de campo | 1.500 bytes |
Tamanho máximo de um valor de campo | 1 MiB - 89 bytes (1.048.487 bytes) |
Profundidade máxima de campos em um mapa ou array | 20 |
Gravações e transações
Além desses limites, você também deve ver as práticas recomendadas para projetar em escala .
Limite | Detalhes |
---|---|
Tamanho máximo da solicitação de API | 10 MiB |
Limite de tempo para uma transação | 270 segundos, com um tempo de expiração inativo de 60 segundos |
Índices
Os seguintes limites se aplicam a índices de campo único e índices compostos :
Limite | Detalhes |
---|---|
Número máximo de índices compostos para um banco de dados |
|
Número máximo de configurações de campo único para um banco de dados |
Uma configuração em nível de campo pode conter diversas configurações para o mesmo campo. Por exemplo, uma isenção de indexação de campo único e uma política de TTL no mesmo campo contam como uma configuração de campo para o limite. |
Número máximo de entradas de índice para cada documento | 40.000 O número de entradas de índice é a soma do seguinte para um documento:
Para ver como o Cloud Firestore transforma um documento e um conjunto de índices em entradas de índice, consulte este exemplo de contagem de entradas de índice . |
Número máximo de campos em um índice composto | 100 |
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 tamanho da entrada do índice . |
Soma máxima dos tamanhos das entradas de índice de um documento | 8 MiB O tamanho total é a soma do seguinte para um documento: |
Tamanho máximo de um valor de campo indexado | 1.500 bytes Valores de campo acima de 1.500 bytes são truncados. Consultas envolvendo valores de campo truncados podem retornar resultados inconsistentes. |
Tempo de vida (TTL)
Limite | Detalhes |
---|---|
Número máximo de configurações de campo único para um banco de dados |
Uma configuração em nível de campo pode conter diversas configurações para o mesmo campo. Por exemplo, uma isenção de indexação de campo único e uma política de TTL no mesmo campo contam como uma configuração de campo para o limite. |
Exportar importar
Os seguintes limites se aplicam às operações gerenciadas de importação e exportação :
Limite | Detalhes |
---|---|
Número máximo total de solicitações de exportação e importação permitidas por minuto para um projeto | 20 |
Número máximo de exportações e importações simultâneas | 50 |
Número máximo de filtros de ID de coleção para solicitações de exportação e importação | 100 |
Regras de segurança
Limite | Detalhes |
---|---|
Número máximo de exists() , get() e getAfter() por solicitação |
Exceder qualquer um dos limites resulta em um erro de permissão negada. Algumas chamadas de acesso a documentos podem ser armazenadas em cache e as chamadas armazenadas em cache não contam para os limites. |
Profundidade máxima da instrução match aninhada | 10 |
Comprimento máximo do caminho, em segmentos de caminho, permitido em um conjunto de instruções match aninhadas | 100 |
Número máximo de variáveis de captura de caminho permitidas em um conjunto de instruções match aninhadas | 20 |
Profundidade máxima de chamada de função | 20 |
Número máximo de argumentos de função | 7 |
Número máximo de ligações de variáveis let por função | 10 |
Número máximo de chamadas de função recursivas 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 | Os conjuntos de regras devem obedecer a dois limites de tamanho:
|
Gerenciar gastos
Para ajudar a evitar cobranças inesperadas na sua fatura, defina orçamentos e alertas mensais.
Defina um orçamento mensal
Para acompanhar os custos do Cloud Firestore, crie um orçamento mensal no console do Google Cloud. Os orçamentos não limitarão seu uso, mas você pode definir alertas para notificá-lo quando estiver se aproximando ou excedendo os custos planejados para o mês.
Para definir um orçamento, acesse a seção Faturamento no console do Google Cloud e crie um orçamento para sua conta do Cloud Billing. Você pode usar as configurações de alerta padrão ou modificar os alertas para enviar notificações em diferentes porcentagens do seu orçamento mensal.
Saiba mais sobre como configurar orçamentos e alertas de orçamento .