Noções básicas sobre o faturamento do Cloud Firestore

Neste documento, você verá mais detalhes sobre os preços do Cloud Firestore. Também aprenderá a limitar e a monitorar seus gastos no Cloud Firestore.

Se você fizer pagamentos em uma moeda que não seja o dólar americano, os preços listados na página SKUs do Cloud Platform serão aplicados na sua moeda.

Visão geral de preços

Quando você usa o Cloud Firestore, os seguintes itens são cobrados:

• O número de documentos lidos, gravados e excluídos.
• O número de entradas de índice que aparecem nas consultas de agregação. É cobrada 1 leitura de documento para cada lote de até 1.000 entradas de índice que aparecem em uma consulta.
• A quantidade de armazenamento utilizada pelo seu banco de dados, incluindo a sobrecarga de metadados e índices.
• A quantidade de largura de banda de rede que você usa.

O uso de armazenamento e largura de banda é calculado em gibibytes (GiB), sendo que 1 GiB = 2³⁰ bytes. Todas as cobranças se acumulam diariamente.

Nas seções a seguir, você vê detalhes sobre a cobrança pelo uso do Cloud Firestore.

Preços por local

Na tabela a seguir, estão listados os preços de leituras, gravações, exclusões e armazenamento para cada local do Cloud Firestore:

Selecionar região

Se você não paga em dólar americano, valem os preços na sua moeda local listados na página SKUs do Cloud Platform.

Leituras, gravações e exclusões

Cada leitura, gravação e exclusão de documento realizada por você com o Cloud Firestore é cobrada.

As cobranças por gravações e exclusões são diretas. Com relação a gravações, cada operação set ou update conta como uma única gravação.

As cobranças por leituras têm algumas nuances que você precisa considerar. As seções a seguir explicam essas nuances em detalhes.

Consultas de agregação

Para consultas de agregação, como count(), cobramos 1 leitura de documento para cada lote de até 1.000 entradas de índice que aparecem na consulta. Caso nenhuma entrada seja encontrada na consulta, haverá uma cobrança mínima de 1 leitura de documento.

Por exemplo, as operações count() com 0 a 1.000 entradas de índice são faturadas como 1 leitura de documento. Para uma operação count() que tiver 1.500 entradas de índice, serão cobradas 2 leituras de documentos.

Como detectar os resultados da consulta

O Cloud Firestore permite que você detecte os resultados de uma consulta e receba atualizações em tempo real quando os resultados da consulta forem alterados.

Quando você ouve os resultados de uma consulta, cobramos uma leitura sempre que um documento no conjunto de resultados é adicionado ou atualizado. Você também é cobrado por uma leitura quando um documento é removido do conjunto de resultados por ter sido alterado. Por outro lado, quando um documento for excluído, você não vai receber cobranças por uma leitura.

O faturamento de listeners nos SDKs para dispositivos móveis e Web também depende da ativação da permanência off-line:

• Se a permanência off-line estiver ativada, e o listener ficar desconectado por mais de 30 minutos (por exemplo, se o usuário estiver off-line), você vai receber cobranças por leituras como se tivesse criado uma nova consulta.

• Se a permanência off-line estiver desativada, você vai receber cobranças por leituras como se tivesse emitido uma nova consulta sempre que o listener se desconectar e se reconectar.

Como gerenciar grandes conjuntos de resultados

O Cloud Firestore tem vários recursos para ajudar você a gerenciar consultas que retornam uma grande quantidade de resultados:

• Cursores, que permitem retomar uma consulta de longa duração.
• Tokens de página, que ajudam a paginar os resultados da consulta.
• Limites, que especificam quantos resultados serão recuperados.
• Deslocamentos, que permitem ignorar uma quantidade fixa de documentos.

Não há custos adicionais para usar cursores, tokens de página e limites. Na verdade, esses recursos ajudam você a economizar por meio da leitura apenas dos documentos realmente necessários.

No entanto, ao enviar uma consulta que inclui um deslocamento, será cobrada uma leitura para cada documento ignorado. Por exemplo, se a consulta usa um deslocamento de 10 e a consulta retorna um documento, você será cobrado por 11 leituras. Devido a esse custo adicional, recomendamos o uso de cursores em vez de deslocamentos sempre que possível.

Consultas que não sejam leituras de documentos

Para consultas que não sejam leituras de documentos, como uma solicitação de uma lista de IDs da coleção, você será cobrado por uma leitura de documento. Se a busca do conjunto completo de resultados exigir mais que uma solicitação, por exemplo, se você estiver usando paginação, você será cobrado uma vez por solicitação.

Cobrança mínima por consultas

Há uma cobrança mínima de uma leitura de documento por cada consulta realizada, mesmo que não retorne resultados.

Regras de segurança do Cloud Firestore

Em bibliotecas de cliente para dispositivos móveis e Web, se as Regras de segurança do Cloud Firestore usarem exists(), get(), ou getAfter() para ler um ou mais documentos do seu banco de dados, você será cobrado por leituras extras da seguinte maneira:

• Você vai receber cobranças por leituras necessárias para avaliar suas regras de segurança do Cloud Firestore.

  Por exemplo, se as regras se referirem a três documentos, mas o Cloud Firestore só precisar ler dois deles para avaliar suas regras, você será cobrado por duas leituras adicionais para os documentos dependentes.

  Você só é cobrado por uma leitura por documento dependente, mesmo que suas regras façam referência a esse documento mais de uma vez.

• Você será cobrado pela avaliação de regras apenas uma vez por solicitação.

  Como resultado, pode custar menos ler vários documentos do que ler documentos individualmente, porque a leitura de vários documentos requer menos solicitações.

• Ao detectar os resultados de uma consulta, você será cobrado pela avaliação de regras em todos os casos a seguir:

  • Ao emitir a consulta.
  • Sempre que os resultados da consulta forem atualizados.
  • Sempre que o dispositivo do usuário ficar off-line e voltar a ficar on-line.
  • Sempre que você atualizar suas regras.
  • Sempre que atualizar os documentos dependentes em suas regras.

Tamanho do armazenamento

Você será cobrado pelo montante de dados armazenados no Cloud Firestore, incluindo a sobrecarga do armazenamento. O montante da sobrecarga inclui metadados, índices automáticos e índices compostos. Os metadados a seguir são necessários para cada documento armazenado no Cloud Firestore:

• O ID do documento, incluindo o ID da coleção e o nome do documento.
• O nome e o valor de cada campo. Como o Cloud Firestore não depende de um esquema, o nome de cada campo em um documento precisa ser armazenado com o valor do campo.
• Todos os índices de campo único e compostos que se referem ao documento. Cada entrada de índice contém o código da coleção, qualquer número de valores de campo, dependendo da definição do índice, e o nome do documento.

Saiba como o armazenamento no Cloud Firestore é calculado em Cálculos de tamanho de armazenamento. Para ver a quantidade de armazenamento que seu banco de dados usa, visite a página Detalhes de cota do App Engine no Console do GCP.

Largura de banda da rede

Você vai receber cobranças pela largura de banda da rede usada pelas solicitações do Cloud Firestore, conforme mostrado nas seções a seguir. O custo de largura de banda da rede referente a uma solicitação do Cloud Firestore depende do tamanho e do destino da resposta e também do local do banco de dados do Cloud Firestore.

O Cloud Firestore calcula o tamanho da resposta com base em um formato de mensagem serializado. A sobrecarga de protocolo, como a de SSL, não conta como uso da largura de banda da rede. Isso também se aplica às solicitações negadas pelas regras de segurança do Cloud Firestore.

Para saber a quantidade de largura de banda da rede que você usou, utilize o Console do GCP para exportar os dados de faturamento para um arquivo.

Preços gerais de rede

Para solicitações originadas no Google Cloud Platform, por exemplo, de um aplicativo em execução no Google Compute Engine, você será cobrado da seguinte maneira:

Se você não paga em dólar americano, valem os preços na sua moeda local listados na página SKUs do Cloud Platform.

O Cloud Firestore também está sujeito a taxas adicionais de saída de Internet para os seguintes itens:

• Solicitações do Google Cloud entre regiões, não incluindo o tráfego entre as regiões dos EUA
• Solicitações de fora do Google Cloud, por exemplo, do dispositivo móvel de um usuário.

Consulte as taxas de saída de Internet do Google Cloud.

Consultar um exemplo de determinação de preço

Para ver como os custos de faturamento do Cloud Firestore são acumulados em um app de amostra real, consulte o Exemplo de faturamento do Cloud Firestore.

Gerenciar gastos

Para evitar cobranças inesperadas na sua fatura, defina orçamentos mensais e alertas usando o console de faturamento do Google Cloud.

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