Gerenciar o Cloud Firestore com o Firebase console

É possível executar as ações a seguir no Cloud Firestore ao usar o Console do Firebase:

  • Ver, adicionar, editar e excluir dados.
  • Criar e atualizar regras de segurança do Cloud Firestore.
  • Gerenciar índices.
  • Monitorar o uso.

Ver dados

É possível ver todos os dados do Cloud Firestore no Console do Firebase. Na guia Dados, do Cloud Firestore, clique em um documento ou coleção para abrir os dados aninhados nesse item.

Abrir um caminho específico

Para abrir um documento ou uma coleção em um caminho específico, use o botão Editar caminho :

Clique no botão "Editar caminho" para abrir uma coleção ou um documento específico.

Filtrar documentos em uma coleção

Para filtrar os documentos listados em uma coleção, use o botão Filtrar lista .

Clique no botão "Filtrar lista" para filtrar os documentos listados.

Documentos ancestrais inexistentes

Um documento pode existir mesmo se um ou mais dos seus ancestrais estiverem ausentes. Por exemplo, o documento no caminho /mycoll/mydoc/mysubcoll/mysubdoc pode existir mesmo se o documento ancestral /mycoll/mydoc não existir. No visualizador de dados do Cloud Firestore, um documento ancestral inexistente é exibido assim:

  • Na lista de documentos de uma coleção, os IDs de documentos ancestrais inexistentes estão em itálico.
  • Em um painel de informações de um documento ancestral inexistente, o visualizador de dados indica que ele está ausente.

Documento ancestral inexistente no console.

Consultar dados

É possível consultar documentos na guia Criador de consultas da página de dados do Cloud Firestore.

  1. Acessar a página de dados do Cloud Firestore

  2. Clique na guia Criador de consultas.

  3. Selecione um escopo de consulta.

    Selecione Coleção para consultar uma única coleção. No campo de texto, insira um caminho para uma coleção.

    Selecione Grupo de coleções para consultar todas as que têm o mesmo ID. No campo Grupo de coleções, insira o ID de um grupo de coleções.

    A tabela mostra automaticamente os documentos da coleção ou grupo especificado.

  4. Clique em Adicionar à consulta para filtrar o conjunto retornado de documentos. Por padrão, o criador de consultas adiciona uma cláusula WHERE, que é possível modificar usando os menus suspensos e os campos de texto ou mudar para uma das outras cláusulas disponíveis. Para continuar criando consultas mais complexas, clique em Adicionar à consulta.

    Para remover uma cláusula de consulta, clique no botão de remoção. Para remover todas as cláusulas de consulta, clique em Limpar.

  5. Clique em Executar para recuperar os resultados do seu banco de dados.

Requisitos e limitações da consulta

Ao usar o criador de consultas, considere os seguintes requisitos e limitações para consultas.

  • Todas as consultas precisam ser compatíveis com um ou mais índices. Se o banco de dados não encontrar um índice compatível com a consulta, ele retornará um erro com um link para criar o índice necessário.

  • As cláusulas ORDER BY precisam ser correspondentes aos campos nas cláusulas WHERE e vir na mesma ordem. Por padrão, os resultados são ordenados por ID de documento. Se você filtrar por qualquer outro campo com algo diferente de uma igualdade (==), adicione uma cláusula ORDER BY para esse campo.

  • Cláusulas de consulta de intervalo (<, <=, > e >=) e de valores diferentes (!= e not-in) precisam filtrar no mesmo campo.

Para mais detalhes, confira Limitações de consulta.

Gerenciar dados

No Cloud Firestore, você armazena dados em documentos que podem ser organizados em coleções. Antes de começar a adicionar dados, saiba mais sobre o modelo de dados do Cloud Firestore.

É possível adicionar, editar e excluir documentos e coleções no Console do Firebase. Para gerenciar os dados, abra a guia Dados na seção Cloud Firestore:

Adicionar dados

  1. Clique em Adicionar coleção e digite o nome da coleção. Em seguida, clique em Próxima.
  2. Digite um código de documento específico ou clique em Código automático e, em seguida, adicione campos para os dados do seu documento.
  3. Clique em Salvar. Sua nova coleção e documento aparecem na visualização de dados.
  4. Para adicionar mais documentos à coleção, clique em Adicionar documento.

Editar dados

  1. Clique em uma coleção para exibir os documentos dela. Depois, clique em um documento para ver os campos e subcoleções dele.
  2. Clique em um campo para editar o valor dele. Para adicionar campos ou subcoleções ao documento selecionado, clique em Adicionar campo ou Adicionar coleção.

Excluir dados

Para excluir uma coleção, faça o seguinte:

  1. Selecione a coleção que você quer excluir.
  2. Clique no ícone de menu na parte superior da coluna de documentos e depois clique em Excluir coleção.

Clique em &quot;Excluir coleção&quot; no menu da coluna de documentos

Para excluir um documento ou todos os campos dele, faça o seguinte:

  1. Selecione o documento que você quer excluir.
  2. Clique no ícone de menu na parte superior da coluna de detalhes do documento. Selecione Excluir documento ou Excluir campos do documento.

Ao excluir um documento, você também exclui todos os dados e as subcoleções dele. Porém, excluir os campos de um documento não exclui as subcoleções.

Clique em &quot;Excluir documento&quot; ou &quot;Excluir campos do documento&quot; no menu de contexto da coluna de detalhes do documento

Para excluir um campo específico de um documento, faça o seguinte:

  1. Selecione o documento para ver os campos dele.
  2. Clique no ícone de exclusão ao lado do campo que você quer remover.

Clique no ícone de exclusão para remover o campo de um documento

Gerenciar regras de segurança do Cloud Firestore

Para adicionar, editar e excluir regras de segurança do Cloud Firestore no Console do Firebase, acesse a guia Regras na seção Cloud Firestore. Saiba mais sobre como configurar e personalizar regras.

Gerenciar índices

Para criar novos índices para suas consultas e gerenciar índices existentes no Console do Firebase, vá para a guia Índices na seção Cloud Firestore. Saiba mais sobre como gerenciar índices.

Monitorar o uso

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.