Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Indexes

Crie um índice

Nesta página

  • Sobre esta tarefa
  • Procedimento
  • Exemplo
  • Resultados
  • Saiba mais

Os índices suportam a execução eficiente de consultas no MongoDB. Se seu aplicativo estiver executando consultas repetidamente nos mesmos campos, poderá criar um índice nesses campos para melhorar o desempenho dessas consultas.

Para criar um índice, use o método shell createIndex() ou método equivalente para seu driver. Esta página mostra exemplos para o MongoDB Shell e drivers.

Sobre esta tarefa

Ao executar um comando de criação de índice no MongoDB Shell ou em um driver, o MongoDB só cria o índice se não existir um índice com a mesma especificação.

Embora os índices melhorem o desempenho da consulta, adicionar um índice tem impacto negativo no desempenho para operações de gravação. Para coleções com alta taxa de gravação para leitura, os índices são caros porque cada inserção e atualização também devem atualizar quaisquer índices.

Procedimento

➤ Para definir a linguagem dos exemplos nesta página, use o menu suspenso Selecione a linguagem no painel de navegação à direita.

Para criar um índice em mongosh, use db.collection.createIndex().

db.collection.createIndex( <key and index type specification>, <options> )

Para criar um índice usando o driver .NET, use MongoCollection.CreateIndex.

collection.CreateIndex( IndexKeys<collection>.<key and index type specification>, <options> );

Para criar um índice usando o driver Java Async, use com.mongodb.async.client.MongoCollection.createIndex.

collection.createIndex( <key and index type specification>, <options>, <callbackFunction>)

Para criar um índice usando o driver Java, use com.mongodb.client.MongoCollection.createIndex.

collection.createIndex( <key and index type specification>, <options> )å

Para criar um índice usando o driver do motor, use motor.motor_asyncio.AsyncIOMotorCollection.create_index.

await db.collection.create_index([(<key and index type specification>)], <options> )

Para criar um índice usando o driver Node.JS, use createIndex().

collection.createIndex( { <key and index type specification> }, function(err, result) {
   console.log(result);
   callback(result);
}

Para criar um índice usando o driver Perl, use create_one().

my $indexes = $db->get_collection( <collection> )->indexes;
$indexes->create_one( [ <key and index type specification> ] );

Para criar um índice usando o driver PHP, use MongoDB\\Collection::createIndex().

$collection->createIndex(<key and index type specification>, <options>);

Para criar um índice usando o driver Python, use o método pymongo.collection.Collection.create_index :

db.collection.create_index([(<key and index type specification>)], <options> )

Para criar um índice usando o driver Ruby, use Mongo::Index::View#create_one.

client[:collection].indexes.create_one({ <key and index type specification> }, {options})

Para criar um índice usando o driver Scala,useorg.mongodb.scala.model.Indexes.

collection.createIndex(<key and index type specification>)

Exemplo

Este exemplo cria um índice decrescente de chave única no campo name:

db.collection.createIndex( { name: -1 } )

Este exemplo cria um índice decrescente de chave única no campo name:

collection.CreateIndex( IndexKeys<collection>.Descending("name") );

Este exemplo cria um índice decrescente de chave única no campo name:

collection.createIndex(Indexes.descending("name"), someCallbackFunction());

Este exemplo cria um índice decrescente de chave única no campo name:

collection.createIndex(Indexes.descending("name"));

Este exemplo cria um índice decrescente de chave única no campo name:

await collection.create_index([("name", pymongo.DESCENDING)])

Este exemplo cria um índice decrescente de chave única no campo name:

 collection.createIndex( { name : -1 }, function(err, result) {
   console.log(result);
   callback(result);
}

Este exemplo cria um índice decrescente de chave única no campo name:

my $indexes = $db->get_collection( <collection> )->indexes;
$indexes->create_one( [ name => -1 ] );

Este exemplo cria um índice decrescente de chave única no campo name:

$collection->createIndex(['name' => -1]);

Este exemplo cria um índice decrescente de chave única no campo name:

collection.create_index([("name", pymongo.DESCENDING)])

Este exemplo cria um índice decrescente de chave única no campo name:

client[:collection].indexes.create_one({ name: -1 })

Este exemplo cria um índice decrescente de chave única no campo name:

collection.createIndex(descending("name"))

Observação

Ordem de Classificação dos Índices

Usar um índice de campo único descendente pode impacto negativamente o desempenho do índice. Para obter o melhor desempenho, use somente índices de campo único ascendentes.

Resultados

Para confirmar que o índice foi criado, utilize mongosh para executar o método db.collection.getIndexes():

db.collection.getIndexes()

Saída:

[
  { v: 2, key: { _id: 1 }, name: '_id_' },
  { v: 2, key: { name: -1 }, name: 'name_-1' }
]

Para visualizar informações sobre índices criados usando um driver, consulte a documentação do seu driver.

Saiba mais

Voltar

Indexes

Próximo

Especifique um nome