A partir do MongoDB 4.4, agora podemos ocultar índices do plano de consulta. Isso nos permite avaliar o impacto potencial de descartar um índice sem realmente descartar o índice.
Se ocultá-lo tiver um impacto negativo, podemos reexibir o índice. Isso evita que tenhamos que descartar o índice e recriá-lo novamente.
Abaixo estão 3 maneiras de ocultar um índice no MongoDB.
O hideIndex()
Método
O
db.collection.hideIndex()
O método faz exatamente o que promete – oculta o índice (do planejador de consultas). Exemplo:
db.pets.hideIndex("idx_weight_-1")
Saída:
{ "hidden_old" : false, "hidden_new" : true, "ok" : 1 }
Isso oculta um índice chamado
idx_weight_-1
nos pets
coleção. Alternativamente, poderíamos fornecer o padrão de chave para o índice em vez do nome. A saída do
hideIndex()
método exibe o valor antigo para o hidden
campo (neste caso false
) e o novo valor (neste caso true
). No entanto, se ocultarmos um índice já oculto (ou exibir um já não oculto), eles não serão exibidos e obteremos apenas o seguinte:
{ "ok" : 1 }
De qualquer forma, o índice agora está oculto.
O
hideIndex()
é na verdade um wrapper para o collMod
comando de administração (abaixo). O collMod
Comando
O
collMod
O comando de administração nos permite adicionar opções a uma coleção ou modificar as definições de visualização. Podemos usá-lo para ocultar um índice passando
hidden: true
. Exemplo:
db.runCommand( {
collMod: "pets",
index: {
name: "idx_weight_-1",
hidden: true
}
} )
Resultado:
{ "hidden_old" : false, "hidden_new" : true, "ok" : 1 }
Isso retorna o mesmo documento que
hideIndex()
retorna. Semelhante a
hideIndex()
, você tem a opção de especificar o nome do índice ou seu padrão de chave. Aqui está um exemplo de uso do padrão de chave:
db.runCommand( {
collMod: "pets",
index: {
keyPattern: { weight : -1 },
hidden: true
}
} )
Nesse caso, o índice foi definido usando
{ weight : -1 }
, e, portanto, essa definição pode ser usada em vez do nome do índice. Para verificar isso, podemos usar
getIndexes()
para ver a definição do índice:db.pets.getIndexes()
Resultado:
[ { "v" : 2, "key" : { "_id" : 1 }, "name" : "_id_" }, { "v" : 2, "key" : { "weight" : -1 }, "name" : "idx_weight_-1", "hidden" : true } ]
Também podemos reexibir o índice passando
hidden: false
. Criar um índice oculto
A terceira maneira de ocultar um índice é criá-lo como um índice oculto.
Para fazer isso, use
hidden: true
como uma das opções ao criar o índice. Exemplo:
db.pets.createIndex(
{ type: 1 },
{ hidden: true }
)
Saída:
{ "createdCollectionAutomatically" : false, "numIndexesBefore" : 2, "numIndexesAfter" : 3, "ok" : 1 }
Agora vamos chamar
getIndexes()
novamente para verificar nosso índice oculto recém-criado:db.pets.getIndexes()
Resultado:
[ { "v" : 2, "key" : { "_id" : 1 }, "name" : "_id_" }, { "v" : 2, "key" : { "weight" : -1 }, "name" : "idx_weight_-1", "hidden" : true }, { "v" : 2, "hidden" : true, "key" : { "type" : 1 }, "name" : "type_1" } ]
Podemos ver que ele foi criado com
"hidden": true
. Não é possível ocultar índices? Verifique esta configuração.
O
mongod
featureCompatibilityVersion
deve ser pelo menos 4.4
antes que você possa ocultar índices. No entanto, uma vez oculto, um índice permanecerá oculto mesmo com featureCompatibilityVersion
definido como 4.2 nos binários do MongoDB 4.4. Você pode verificar a
featureCompatibilityVersion
configuração com o seguinte código:db.adminCommand(
{
getParameter: 1,
featureCompatibilityVersion: 1
}
)
Você pode configurá-lo usando o
setFeatureCompatibilityVersion
comando:db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )
A
setFeatureCompatibilityVersion
comando precisa ser executado no admin
base de dados. Observe também que você não pode ocultar o
_id
índice.