Gerenciar índices no Cloud Firestore

Para garantir o melhor desempenho, cada consulta precisa ter um índice no Cloud Firestore. Todos os campos do documento são indexados automaticamente. Isso significa que as consultas que usam apenas cláusulas de igualdade não precisam de índices adicionais. Se você tenta executar uma consulta composta com uma cláusula de intervalo que não esteja mapeada a um índice existente, um erro é recebido. A mensagem desse erro inclui um link direto para você criar o índice ausente no Firebase console.

Abra o link gerado para o Firebase console, revise as informações preenchidas automaticamente e clique em Criar.

Usar o Firebase console

Para criar um novo índice manualmente no Firebase console:

imagem da interface de indexação do Firestore no Firebase console

  1. Consulte a seção Banco de dados do Firebase console.
  2. Acesse a guia Índices e clique em Adicionar índice.
  3. Insira o nome da coleção e defina por quais campos você quer ordenar o índice. Clique em Criar.

Isso pode levar alguns minutos, dependendo do tamanho da consulta. Após a criação, veja os índices e o status na seção "Índices compostos". Se o processo ainda não foi concluído, uma barra de status de criação é exibida no Firebase console.

Usar a Firebase CLI

Você também pode implantar índices com a Firebase CLI. Para começar, execute firebase init firestore no diretório do seu projeto. Durante a configuração, a Firebase CLI gera um arquivo JSON com os índices padrão no formato correto. Edite o arquivo para adicionar mais índices e o implante com o comando firebase deploy. Se você quiser apenas implantar índices, adicione a sinalização --only firestore:indexes. Se você fizer edições nos índices usando o Firebase console, atualize o arquivo de índices local.

Remover índices

Para excluir um índice:

  1. Consulte a seção Banco de dados do Firebase console.
  2. Clique na guia Índices.
  3. Passe o mouse sobre o índice desejado e selecione Excluir no menu de contexto.
  4. Clique em Excluir no alerta para confirmar a ação.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.