Ir para o conteúdo
Promovaweb

Consultas e índices no MongoDB

Sem índice no campo filtrado, o MongoDB compara a consulta com cada documento da coleção, uma leitura que fica lenta à medida que a coleção cresce. A consulta é um filtro escrito como documento. Quando o campo filtrado tem índice, o servidor percorre uma árvore B com os valores desse campo em ordem e lê só os documentos apontados por ela.

Ficha e sumário da página

Referência técnica
MongoDB Community 9.0.8
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. O filtro é um documento
  2. O caminho de uma consulta dentro do servidor
  3. O que um índice guarda
  4. O custo de cada índice
  5. O explain mostra o plano escolhido

O filtro é um documento

No mongosh e nos drivers, você escreve a consulta com a mesma estrutura do documento procurado. O filtro { status: "D" } compara o campo status por igualdade. Operadores começados por cifrão ampliam a comparação. O filtro { qty: { $lt: 30 } } busca quantidades menores que 30, enquanto { status: { $in: ["A", "D"] } } aceita qualquer um dos dois valores. Dois campos no mesmo filtro, como em { status: "A", qty: { $lt: 30 } }, precisam valer ao mesmo tempo, o equivalente a um AND do SQL.

A documentação oficial mostra cada consulta ao lado do SQL correspondente. A busca db.inventory.find({ status: "D" }) equivale a SELECT * FROM inventory WHERE status = "D", com a diferença de que o resultado chega como documentos inteiros, subdocumentos e arrays incluídos. Uma projeção, passada como segundo argumento do find, limita os campos devolvidos quando o app só precisa de alguns deles.

O servidor não devolve todos os documentos de uma vez. Ele abre um cursor, manda o primeiro lote e envia os seguintes conforme o app avança na leitura, de modo que uma consulta que encontra cem mil documentos não ocupa a memória do app com todos eles ao mesmo tempo.

O caminho de uma consulta dentro do servidor

Quando a consulta chega, o planejador de consultas monta os planos possíveis para aquele filtro, escolhe o vencedor e executa o plano em estágios encadeados. O fluxo abaixo segue a consulta do exemplo oficial numa coleção com índice em status:

  1. Consulta

    find({ status: "D" })

    O mongosh ou o driver envia o filtro ao mongod pela porta 27017.

  2. Planejador

    winningPlan

    O servidor testa os planos candidatos e escolhe o que faz menos trabalho.

  3. Índice

    IXSCAN { status: 1 }

    A árvore B leva direto às entradas com status igual a D.

  4. Documentos

    FETCH

    Cada entrada do índice aponta um documento, lido no disco ou na memória.

  5. Resultado

    cursor

    Os documentos voltam ao app em lotes, pelo cursor aberto.

A consulta por status atravessa o planejador, o índice e a leitura dos documentos. Sem o índice, o segundo estágio seria um COLLSCAN, com a leitura de todos os documentos da coleção.

A diferença de tempo aparece no estágio que lê a coleção. O COLLSCAN compara o filtro com cada documento da coleção, o que funciona bem com algumas centenas de registros e fica lento à medida que a coleção cresce. O IXSCAN percorre só o trecho do índice que interessa ao filtro. Quando todos os campos do filtro e da projeção estão no próprio índice, a consulta nem precisa do FETCH, porque o servidor responde direto da árvore, caso que a documentação chama de consulta coberta.

O que um índice guarda

Um índice guarda os valores de um campo, ou de um conjunto de campos, em ordem, dentro de uma árvore B. A ordem atende três tipos de pergunta com a mesma estrutura: a igualdade (status: "D"), a faixa de valores (qty entre 20 e 50) e a ordenação dos itens mais recentes primeiro. Toda coleção já vem com o índice único em _id, que recusa valores repetidos e não pode ser removido.

Os demais índices você cria com createIndex. O comando db.inventory.createIndex({ status: 1 }) monta um índice crescente em status, com o nome padrão status_1, formado pela chave e pela direção, que não pode ser trocado depois da criação. Os tipos de índice cobrem formatos diferentes de campo:

  • Campo únicoUm campo, crescente ou decrescente, como status_1.
  • CompostoVários campos na mesma árvore, na ordem declarada.
  • MultikeyCriado sobre um array, com uma entrada para cada elemento.
  • TextoBusca por palavras dentro de campos de texto.
  • GeoespacialConsultas por proximidade e por área geográfica.
  • HashedValores convertidos em hash, usado na distribuição entre shards.

No índice composto, a ordem dos campos define as consultas que ele atende. Um índice em { status: 1, qty: -1 } serve às consultas que filtram por status e às que filtram por status e qty juntos, mas não serve a uma consulta que filtra só por qty, porque a árvore está ordenada primeiro pelo estado do item.

O custo de cada índice

Cada índice encurta a leitura das consultas que o usam e acrescenta trabalho a cada escrita na coleção. Toda inserção atualiza todos os índices da coleção, enquanto uma atualização mexe nos índices dos campos alterados. Numa coleção com volume de escrita muito maior que o de leitura, como um registro de eventos, índices demais deixam as gravações lentas e ocupam memória sem uso correspondente. A construção de um índice numa coleção já populada também consome recursos do servidor e segura um lock exclusivo na coleção por um instante no começo e outro no fim, liberando leituras e escritas no restante do processo.

Os índices certos saem das consultas que o app faz de verdade. A versão 9.0 liga por padrão o $queryStats, que registra amostras de 1% das leituras e escritas. O resultado mostra quais formatos de consulta aparecem mais. A mesma versão limita cada consulta a 1 GB de memória ou a 20% da memória do servidor, o que for maior. Uma consulta acima desse teto falha com ExceededMemoryLimit, sinal de que falta um índice ou sobra trabalho em memória.

O explain mostra o plano escolhido

O método explain() devolve o plano que o servidor escolheu para uma consulta, sem você adivinhar. No modo queryPlanner, ele mostra o winningPlan e os planos rejeitados. No modo executionStats, executa o plano vencedor e acrescenta os números da execução:

Campo do explainO que medeComo ler
nReturnedDocumentos devolvidos pelo plano vencedor.O tamanho do resultado que o app recebe.
totalKeysExaminedEntradas de índice percorridas.Zero com COLLSCAN, porque nenhum índice entrou.
totalDocsExaminedDocumentos lidos durante a execução.Muito acima de nReturned, aponta um índice ausente ou mal ordenado.

Uma consulta saudável examina perto de tantos documentos quanto devolve. Quando o explain mostra um COLLSCAN com cem mil documentos examinados para devolver dez, um índice no campo filtrado reduz essa leitura ao trecho que interessa. Quando mostra um IXSCAN com muitas entradas percorridas, vale revisar a ordem dos campos do índice composto.

O acesso a essas consultas também passa por usuários e papéis, porque, com o controle de acesso ligado, cada conexão só lê as coleções que o papel dela permite, assunto da página Autenticação e usuários.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.