cursor.hint()

Definição

cursor.hint(index)

Importante

Método mongosh

Esta página documenta um método mongosh. Esta não é a documentação de um driver de idioma específico, como Node.js.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

Chame esse método em uma query para substituir a seleção de índice padrão do MongoDB e o processo de otimização da query. Use db.collection.getIndexes() para retornar a lista dos índices atuais em uma coleção.

O método cursor.hint() tem o seguinte parâmetro:

Parâmetro	Tipo	Descrição
index	string ou documento	O índice para "dica" ou forçar o MongoDB a usar ao executar a query. Especifique o índice pelo nome do índice ou pelo documento de especificação do índice. Você também pode especificar { $natural : 1 } para forçar a query a executar uma varredura de coleção direta ou { $natural : -1 } para uma varredura de coleção inversa.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Comportamento

• Quando existe um filtro de índice para a forma de query, o MongoDB ignora o hint().

• Se uma query incluir uma expressão $text, você não poderá usar hint() para especificar o índice a ser usado na query.

• Você não pode utilizar hint() em um índice oculto.

• Em coleções de séries temporais, você só pode especificar dicas usando o nome do índice, não o padrão de chave de índice.

Exemplos

db.users.find().hint( { age: 1 } )

db.users.find().hint( "age_1" )

db.users.find().hint( { $natural : 1 } )

db.users.find().hint( { $natural : -1 } )