Docs Menu
Docs Home
/ /
Colecciones

db.colección.createIndex() (método de mongosh)

MongoDB con controladores

C#Java SyncNode.jsPyMongoCC++GoJava RSKotlin CoroutineKotlin SyncPHPMotorMongoidRustScalaSwift
db.collection.createIndex(keys, options, commitQuorum)

Crea índices en colecciones.

Este método está disponible en implementaciones alojadas en los siguientes entornos:

  • MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

  • MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

  • MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

El método createIndex() tiene la siguiente forma:

db.collection.createIndex( <keys>, <options>, <commitQuorum>)

El método createIndex() toma los siguientes parámetros:

Parameter
Tipo
Descripción

keys

Documento

Un documento que contiene pares de campo y valor, donde el campo actúa como clave del índice y el valor describe el tipo de índice para ese campo.

Para un índice ascendente en un campo, especifica un valor de 1. Para un índice descendente, especifica un valor de -1.

Un asterisco (*) no es un nombre de índice válido.

MongoDB admite varios tipos de índices diferentes, incluidos:

Consulta tipos de índices para obtener más información.

Los índices comodín son compatibles con cargas de trabajo en las que los usuarios realizan queries sobre campos personalizados o una gran variedad de campos en una colección.

  • Puedes crear un índice comodín en un campo específico y sus subrutas o en todos los campos de un documento.

    Para obtener más información, consulta índices comodín.

options

Documento

Opcional. Un documento que contiene un conjunto de opciones que controlan la creación del índice. Consulta Opciones para obtener más detalles.

entero o cadena de texto

Opcional. El número mínimo de nodos votantes con datos de un set de réplicas que contienen datos (es decir, quórum de confirmación), incluido el primario, que debe informar de una creación de índices exitosa antes de que el primario marque el indexes como listo. Un nodo "votante" es cualquier nodo del set de réplicas donde members[n].votes es mayor que 0.

Admite los siguientes valores:

  • "votingMembers" - todos los nodos votantes con datos del set de réplicas (por defecto).

  • "majority" - una mayoría simple de los nodos votantes con datos del set de réplicas.

  • <int> - un número específico de nodos votantes con datos del set de réplicas.

  • 0 - Desactiva el comportamiento de votación por quórum. Los miembros inician la creación de índices simultáneamente, pero no votan ni esperan el quórum antes de completar la creación de índices. Si inicia una creación de índices con un quórum de confirmación de 0, no podrá modificar posteriormente el quórum de confirmación usando setIndexCommitQuorum.

  • Un nombre de etiqueta de un set de réplicas.

El documento options contiene un conjunto de opciones que controla la creación del índice. Los diferentes tipos de índices pueden tener opciones adicionales específicas para cada tipo.

Se pueden especificar múltiples opciones de índice en el mismo documento. Sin embargo, si se especifican varios documentos de opción, la operación db.collection.createIndex() fallará.

Se debe considerar la siguiente operación de db.collection.createIndex():

db.collection.createIndex(
{
"a": 1
},
{
unique: true,
sparse: true,
expireAfterSeconds: 3600
}
)

Si la especificación de opciones se hubiera dividido en varios documentos como este: { unique: true }, { sparse: true, expireAfterSeconds: 3600 }, la operación de creación del índice habría fallado.

Las siguientes opciones están disponibles para todos los tipos de índice, a menos que se especifique lo contrario:

Parameter
Tipo
Descripción

unique

booleano

Opcional. Crea un índice único para que la colección no acepte la inserción o actualización de documentos cuyo valor de clave de índice coincida con un valor ya existente en el índice.

Especifica true para crear un índice único. El valor por defecto es false.

La opción no está disponible para índices encriptados.

name

string

Opcional. El nombre del índice. Si no se especifica, MongoDB genera un nombre de índice concatenando los nombres de los campos indexados y el orden de clasificación.

partialFilterExpression

Documento

Opcional. Si se especifica, el índice solo hace referencia a los documentos que coinciden con la expresión del filtro. Consulta Índices parciales para obtener más información.

Una expresión de filtro puede incluir:

Puedes especificar una opción partialFilterExpression para todos los tipos de índices de MongoDB.

sparse

booleano

Opcional. Si true, el índice solo hace referencia a documentos con el campo especificado. Estos índices utilizan menos espacio, pero se comportan de manera diferente en algunas situaciones (particularmente en ordenamientos). El valor por defecto es false. Consulta índices dispersos para obtener más información.

Los siguientes tipos de índices son escasos por defecto e ignoran esta opción:

Para un índice compuesto que incluye claves de índice 2dsphere junto con claves de otros tipos, solo los campos de índice 2dsphere determinan si el índice hace referencia a un documento.

Tip

Los índices parciales ofrecen un superconjunto de la funcionalidad de los índices dispersos. A menos que su aplicación tenga un requisito específico, utilice índices parciales en lugar de índices dispersos.

expireAfterSeconds

entero

Opcional. Especifica un valor, en segundos, como tiempo de vida (TTL) para controlar cuánto tiempo MongoDB retiene los documentos en esta colección. Esta opción solo se aplica a los índices TTL. Consulta Caducar datos de colecciones configurando TTL para obtener más información.

Si utilizas índices TTL creados antes de MongoDB 5.0, o si deseas sincronizar datos creados en MongoDB 5.0 con una versión anterior a la instalación 5.0, consulta Índices configurados usando NaN para evitar problemas de configuración errónea.

El valor del índice TTL expireAfterSeconds debe estar entre 0 y 2147483647, inclusive.

booleano

Opcional. Una bandera que determina si el índice está oculto para el planificador de queries. Un índice oculto no se evalúa como parte de la selección del plan de la query.

El valor por defecto es false.

storageEngine

Documento

Opcional. Permite a los usuarios configurar el motor de almacenamiento por índice al crear un índice.

La opción storageEngine debe tomar la siguiente forma:

storageEngine: { <storage-engine-name>: <options> }

Las opciones de configuración del motor de almacenamiento especificadas al crear índices se validan y se registran en el oplog durante la replicación para admitir conjuntos de réplicas con miembros que utilizan diferentes motores de almacenamiento.

Parameter
Tipo
Descripción

collation

Documento

Opcional. Especifica la intercalación para el índice.

La intercalación permite a los usuarios especificar reglas propias del lenguaje para la comparación de strings, como reglas para el uso de mayúsculas y minúsculas y marcas de acento.

Si has especificado una intercalación a nivel de colección, entonces:

  • Si no especificas una intercalación al crear el índice, MongoDB crea el índice con la intercalación por defecto de la colección.

  • Si especificas una intercalación al crear el índice, MongoDB crea el índice con la intercalación especificada.

La opción de intercalación tiene la siguiente sintaxis:

collation: {
locale: <string>,
caseLevel: <boolean>,
caseFirst: <string>,
strength: <int>,
numericOrdering: <boolean>,
alternate: <string>,
maxVariable: <string>,
backwards: <boolean>
}

Al especificar la intercalación, el campo locale es obligatorio; todos los demás campos de intercalación son opcionales. Para las descripciones de los campos, consulta Documento de intercalación.

Los siguientes índices solo soportan la comparación binaria simple y no soportan la intercalación:

Tip

Para crear un índice text, 2d o geoHaystack en una colección que tiene una intercalación no simple, debe especificar explícitamente {collation: {locale: "simple"} } al crear el índice.

Si has especificado una intercalación a nivel de colección, entonces:

  • Si no especificas una intercalación al crear el índice, MongoDB crea el índice con la intercalación por defecto de la colección.

  • Si especificas una intercalación al crear el índice, MongoDB crea el índice con la intercalación especificada.

Tip

Al especificar una intercalación strength de 1 o 2, puedes crear un índice insensible a mayúsculas y minúsculas. El índice con una intercalación strength de 1 es insensible tanto a diacríticos como a mayúsculas.

Puedes crear múltiples índices en las mismas claves con diferentes intercalaciones. Para crear índices con el mismo patrón de clave pero diferentes intercalaciones, debes proporcionar nombres de índice únicos.

Para utilizar un índice para las comparaciones de cadenas, una operación también debe especificar la misma intercalación. Es decir, un índice con una intercalación no puede soportar una operación que realice comparaciones de strings en los campos indexados si la operación especifica una intercalación diferente.

Advertencia

Debido a que los índices configurados con intercalación utilizan claves de intercalación ICU para lograr el orden de clasificación, las claves de índice que consideran la intercalación pueden ser más grandes que las claves de índice para los índices sin intercalación.

Una colección restaurants tiene los siguientes documentos:

db.restaurants.insertMany( [
{ _id: 1, category: "café", status: "Open" },
{ _id: 2, category: "cafe", status: "open" },
{ _id: 3, category: "cafE", status: "open" }
] )

La colección restaurants tiene un índice en un campo de string category con la intercalación de la localización "fr".

db.restaurants.createIndex( { category: 1 }, { collation: { locale: "fr" } } )

La siguiente query, que especifica la misma intercalación que el índice, puede utilizar el índice:

db.restaurants.find( { category: "cafe" } ).collation( { locale: "fr" } )

Sin embargo, la siguiente operación de query, que por defecto utiliza el intercalador binario "simple", no puede usarse el índice:

db.restaurants.find( { category: "cafe" } )

Para un índice compuesto donde las claves prefijo del índice no son cadenas, arreglos ni documentos incrustados, una operación que especifique una intercalación diferente puede seguir utilizando el índice para soportar comparaciones en las claves prefijo del índice.

Por ejemplo, la colección restaurants tiene un índice compuesto en los campos numéricos score y price y el campo de string category; el índice se crea con la localización de intercalación "fr" para comparaciones de strings:

db.restaurants.createIndex(
{ score: 1, price: 1, category: 1 },
{ collation: { locale: "fr" } } )

Las siguientes operaciones, que utilizan la intercalación binaria "simple" para las comparaciones de strings, pueden usar el índice:

db.restaurants.find( { score: 5 } ).sort( { price: 1 } )
db.restaurants.find( { score: 5, price: { $gt: Decimal128( "10" ) } } ).sort( { price: 1 } )

La siguiente operación, que utiliza la intercalación binaria "simple" para las comparaciones de string en el campo category indexado, puede usar el índice para cumplir solo con la parte score: 5 de la query:

db.restaurants.find( { score: 5, category: "cafe" } )

Para confirmar si una consulta ha utilizado un índice, ejecuta la consulta con la opción explain().

Importante

Las coincidencias con claves de documentos, incluidas las claves de documentos incrustadas, utilizan una comparación binaria simple. Esto significa que una query para una clave como "type.café" no coincidirá con la clave "type.cafe", independientemente del valor que se establezca para el parámetro strength.

Las siguientes opciones están disponibles solo para los índices de texto:

Parameter
Tipo
Descripción

weights

Documento

Opcional. Para los índices de texto, un documento que contiene pares de campo y peso. El peso es un número entero que tiene un rango de 1 a 99,999 y denota la importancia del campo en relación con los otros campos indexados en términos de la puntuación. Puedes especificar pesos para algunos o todos los campos indexados. Consulta Asignar pesos a los resultados de búsqueda de texto en implementaciones autogestionadas para ajustar las puntuaciones. El valor es por defecto 1.

A partir de MongoDB 5.0, la opción pesos solo está permitida para los índices de texto.

default_language

string

Opcional. Para los índices texto, el lenguaje que determina la lista de palabras vacías y las reglas para el stemmer y el tokenizador. Consulta Lenguajes de búsqueda de texto en implementaciones autogestionadas para ver los lenguajes disponibles y Especifica el lenguaje por defecto para un índice de texto en implementaciones autogestionadas para obtener más información y ejemplos. El valor por defecto es english.

language_override

string

Opcional. Para índices de texto, el nombre del campo, en los documentos de la colección, que contiene el idioma de reemplazo del documento. El valor predeterminado es. Consulte language "Usar cualquier campo para especificar el idioma de un documento" para ver un ejemplo.

textIndexVersion

entero

Opcional. El número de versión del índice text. Los usuarios pueden utilizar esta opción para sobrescribir el número de versión por defecto.

Para conocer las versiones disponibles, consulte Versiones.

La siguiente opción está disponible únicamente para índices 2dsphere:

Parameter
Tipo
Descripción

2dsphereIndexVersion

entero

Opcional. El número de versión del índice 2dsphere. Los usuarios pueden utilizar esta opción para sobrescribir el número de versión por defecto.

Para conocer las versiones disponibles, consulte Versiones.

Las siguientes opciones están disponibles solo para los índices 2d:

Parameter
Tipo
Descripción

bits

entero

Opcional. Para los índices 2d, el número de cifras significativas del valor geohash almacenado de los datos de ubicación.

El valor bits va de 1 a 32 inclusive. El valor por defecto es 26.

min

Número

Opcional. Para índices d, el límite inferior inclusivo para los valores de longitud y latitud. El valor 2 predeterminado -180.0 es.

max

Número

Opcional. Para índices d, el límite superior inclusivo para los valores de longitud y latitud. El valor 2 predeterminado 180.0 es.

La siguiente opción está disponible únicamente para los índices geoHaystack:

Parameter
Tipo
Descripción

bucketSize

Número

Para los índices geoHaystack, especifique el número de unidades dentro de las cuales agrupar los valores de ubicación; es decir, agrupe en el mismo contenedor aquellos valores de ubicación que estén dentro del número especificado de unidades entre sí.

El valor debe ser mayor que 0.

Nota

Eliminado en MongoDB 5.0

MongoDB 5.0 elimina el geoHaystack índice obsoleto y el geoSearch comando. En su 2lugar, utilice un índice d con o uno de $geoNear los operadores de consulta geoespaciales compatibles.

Actualizar su instancia de MongoDB a 5.0 y configurar featureCompatibilityVersion en 5.0 eliminará cualquier índice geoHaystack preexistente.

La siguiente opción está disponible solo para índices comodín:

Parameter
Tipo
Descripción

wildcardProjection

Documento

Opcional. Permitir que los usuarios incluyan o excluyan rutas de campo específicas de un índice comodín usando el patrón clave { "$**" : 1}. Esta opción solo es válida si se crea un índice comodín en todos los campos del documento. No puedes especificar esta opción si estás creando un índice comodín en una ruta de campo específica y sus subcampos, p. ej. { "path.to.field.$**" : 1 }

La opción wildcardProjection tiene la siguiente forma:

wildcardProjection: {
"path.to.field.a" : <value>,
"path.to.field.b" : <value>
}

El <value> puede ser uno de los siguientes:

  • 1 o true para incluir el campo en el índice comodín.

  • 0 o false para excluir el campo del índice comodín.

Los índices comodín omiten el campo _id por defecto. Para incluir el campo _id en el índice comodín, debes incluirlo explícitamente en el documento wildcardProjection:

{
"wildcardProjection" : {
"_id" : 1,
"<field>" : 0|1
}
}

Con la excepción de incluir explícitamente el campo _id, no se pueden combinar declaraciones de inclusión y exclusión en el documento wildcardProjection.

Cambiado en la versión 4.2.

MongoDB utiliza un proceso de compilación optimizado que obtiene y mantiene un bloqueo exclusivo en la colección especificada al inicio y al final de la compilación del índice. Todas las operaciones posteriores en la colección deben esperar hasta que libere createIndex() createIndex() el bloqueo exclusivo. permite intercalar operaciones de lectura y escritura durante la mayor parte de la compilación del índice.

Para obtener más información sobre el comportamiento de bloqueo createIndex() de, consulte Construcciones de índices en colecciones pobladas.

Si se llama a db.collection.createIndex() para un índice que ya existe, MongoDB no recrea el índice.

Con la excepción de la opción de intercalación, si se crea un índice con un conjunto de opciones de índice y luego intenta volver a crear el mismo índice, pero con opciones de índice diferentes, MongoDB no cambiará las opciones ni volverá a crear el índice.

La opción oculta se puede cambiar sin eliminar ni volver a crear el índice. Consulta Opción oculta.

Para cambiar las otras opciones del índice, se debe descartar el índice existente con db.collection.dropIndex() antes de ejecutar db.collection.createIndex() con las nuevas opciones.

Puedes crear múltiples índices en las mismas claves con diferentes intercalaciones. Para crear índices con el mismo patrón de clave pero diferentes intercalaciones, debes proporcionar nombres de índice únicos.

Para ocultar o mostrar índices existentes, puede utilizar los siguientes mongosh métodos:

Por ejemplo,

  • Para cambiar la opción hidden de un índice a true, utiliza el método db.collection.hideIndex():

    db.restaurants.hideIndex( { borough: 1, ratings: 1 } );
  • Para cambiar la opción hidden de un índice a false, utiliza el método db.collection.unhideIndex():

    db.restaurants.unhideIndex( { borough: 1, city: 1 } );

Puede crear colecciones e índices dentro de una transacción distribuida si la transacción es No es una transacción de escritura entre fragmentos.

Para usar db.collection.createIndex() en una transacción, la transacción debe usar el nivel de consistencia de lectura "local". Si especificas un nivel de consistencia de lectura distinto de "local", la transacción fallará.

El siguiente ejemplo crea un índice ascendente en el campo orderDate.

db.collection.createIndex( { orderDate: 1 } )

Si el documento keys especifica más de un campo, entonces createIndex() crea un índice compuesto.

El siguiente ejemplo crea un índice compuesto en el campo orderDate (en orden ascendente) y en el campo zipcode (en orden descendente).

db.collection.createIndex( { orderDate: 1, zipcode: -1 } )

Los índices compuestos pueden incluir un solo campo encriptado. Los índices compuestos encriptados requieren que featureCompatibilityVersion se establezca al menos en 5.0.

El siguiente ejemplo crea un índice compuesto en el campo state (en orden ascendente) y en el campo zipcode (encriptado):

db.collection.createIndex( { "state" : 1, "zipcode" : "hashed" } )

El orden de los campos en un índice compuesto es importante para admitir operaciones sort() utilizando el índice.

El siguiente ejemplo crea un índice llamado category_fr. El ejemplo crea el índice con la intercalación que especifica la localización fr y la fuerza de comparación 2:

db.restaurants.createIndex(
{ category: 1 },
{ name: "category_fr", collation: { locale: "fr", strength: 2 } }
)

El siguiente ejemplo crea un índice compuesto llamado date_category_fr con una intercalación. La intercalación se aplica solo a las claves de índice con valores de string.

db.collection.createIndex(
{ orderDate: 1, category: 1 },
{ name: "date_category_fr", collation: { locale: "fr", strength: 2 } }
)

La intercalación se aplica a las claves indexadas cuyos valores son string.

Para queries u operaciones de ordenación en las claves indexadas que utilizan las mismas reglas de intercalación, MongoDB puede usar el índice. Los índices utilizan la intercalación de strength: 2, lo que da lugar a queries que no distinguen entre mayúsculas y minúsculas cuando se utiliza el índice. Para obtener más detalles, consulta Intercalación y uso del índice.

Nuevo en la versión 4.2.

La mongod versión de compatibilidad de características debe ser 4.2 para crear índices comodín. Para obtener instrucciones sobre cómo configurar fCV, consulte "Establecer la versión de compatibilidad de características en 6.0 las implementaciones de MongoDB ".

  • Los índices comodín omiten el campo _id por defecto. Para incluir el campo _id en el índice comodín, debes incluirlo explícitamente en el documento wildcardProjection:

    {
    "wildcardProjection" : {
    "_id" : 1,
    "<field>" : 0|1
    }
    }

    Con la excepción de incluir explícitamente el campo _id, no se pueden combinar declaraciones de inclusión y exclusión en el documento wildcardProjection.

  • Los índices comodín no admiten los siguientes tipos de índice o propiedades:

    Nota

    Los índices comodín son distintos de los índices de texto comodín y son incompatibles con ellos. No admiten consultas con el $text operador.

    Para obtener documentación completa sobre las restricciones de índice comodín, consulte Restricciones de índice comodín.

Para obtener documentación completa sobre los índices comodín, consulte Índices comodín.

Las siguientes listas muestran ejemplos de la creación de índices comodín:

Considere una colección products_catalog donde los documentos pueden contener un campo product_attributes. El campo product_attributes puede contener campos anidados arbitrarios, incluyendo documentos y matrices incrustados:

db.products_catalog.insertMany( [
{
_id : ObjectId("5c1d358bf383fbee028aea0b"),
product_name: "Blaster Gauntlet",
product_attributes: {
price: {
cost: 299.99,
currency: "USD"
}
}
},
{
_id: ObjectId("5c1d358bf383fbee028aea0c"),
product_name: "Super Suit",
product_attributes: {
superFlight: true,
resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
}
}
] )

La siguiente operación crea un índice comodín en el campo product_attributes:

use inventory
db.products_catalog.createIndex( { "product_attributes.$**" : 1 } )

Con este índice comodín, MongoDB indexa todos los valores escalares de product_attributes. Si el campo es un documento o arreglo anidado, el índice comodín recorre el documento/arreglo e indexa todos los campos escalares del documento/arreglo.

El índice comodín puede brindar soporte a queries arbitrarias de un solo campo en product_attributes o en uno de sus campos anidados:

db.products_catalog.find( { "product_attributes.superFlight" : true } )
db.products_catalog.find( { "product_attributes.maxSpeed" : { $gt : 20 } } )
db.products_catalog.find( { "product_attributes.elements" : { $eq: "water" } } )

Nota

La sintaxis del índice comodín específica de la ruta es incompatible con la opción wildcardProjection. Consulte la documentación de parámetros para obtener más información.

Considere una colección products_catalog donde los documentos pueden contener un campo product_attributes. El campo product_attributes puede contener campos anidados arbitrarios, incluyendo documentos y matrices incrustados:

db.products_catalog.insertMany( [
{
_id : ObjectId("5c1d358bf383fbee028aea0b"),
product_name: "Blaster Gauntlet",
product_attributes: {
price: {
cost: 299.99,
currency: "USD"
}
}
},
{
_id: ObjectId("5c1d358bf383fbee028aea0c"),
product_name: "Super Suit",
product_attributes: {
superFlight: true,
resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
}
}
] )

La siguiente operación crea un índice comodín en todos los campos escalares (excluyendo el campo _id):

use inventory
db.products_catalog.createIndex( { "$**" : 1 } )

Con este índice comodín, MongoDB indexa todos los campos escalares de cada documento de la colección. Si un campo dado es un documento o arreglo anidado, el índice comodín recorre el documento/arreglo e indexa todos los campos escalares del documento/arreglo.

El índice creado puede soportar queries sobre cualquier campo arbitrario dentro de los documentos de la colección:

db.products_catalog.find( { "product_price" : { $lt : 25 } } )
db.products_catalog.find( { "product_attributes.elements" : { $eq: "water" } } )

Nota

Los índices comodín omiten el campo _id por defecto. Para incluir el campo _id en el índice comodín, se debe incluir explícitamente en el documento wildcardProjection. Consulta la documentación de parámetros para obtener más información.

Considere una colección products_catalog donde los documentos pueden contener un campo product_attributes. El campo product_attributes puede contener campos anidados arbitrarios, incluyendo documentos y matrices incrustados:

db.products_catalog.insertMany( [
{
_id : ObjectId("5c1d358bf383fbee028aea0b"),
product_name: "Blaster Gauntlet",
product_attributes: {
price: {
cost: 299.99,
currency: "USD"
}
}
},
{
_id: ObjectId("5c1d358bf383fbee028aea0c"),
product_name: "Super Suit",
product_attributes: {
superFlight: true,
resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
}
}
] )

La siguiente operación crea un índice comodín y utiliza la opción wildcardProjection para incluir únicamente los valores escalares de los campos product_attributes.elements y product_attributes.resistance en el índice.

use inventory
db.products_catalog.createIndex(
{ "$**" : 1 },
{
"wildcardProjection" : {
"product_attributes.elements" : 1,
"product_attributes.resistance" : 1
}
}
)

Mientras que el patrón de clave "$**" abarca todos los campos del documento, el wildcardProjection campo limita el índice únicamente a los campos incluidos. Para obtener la documentación completa wildcardProjection sobre, consulte Opciones para wildcard índices.

Si un campo es un documento o un arreglo anidado, el índice comodín recorre el documento/arreglo e indexa todos los campos escalares del documento/arreglo.

El índice creado puede admitir consultas en cualquier campo escalar incluido en wildcardProjection:

db.products_catalog.find( { "product_attributes.elements" : { $eq: "Water" } } )
db.products_catalog.find( { "product_attributes.resistance" : "Bludgeoning" } )

Nota

Los índices comodín no soportan mezclar instrucciones de inclusión y exclusión en el documento wildcardProjection excepto cuando se incluye explícitamente el campo _id. Para obtener más información sobre wildcardProjection, consulta la documentación de los parámetros.

Considere una colección products_catalog donde los documentos pueden contener un campo product_attributes. El campo product_attributes puede contener campos anidados arbitrarios, incluyendo documentos y matrices incrustados:

db.products_catalog.insertMany( [
{
_id : ObjectId("5c1d358bf383fbee028aea0b"),
product_name: "Blaster Gauntlet",
product_attributes: {
price: {
cost: 299.99,
currency: "USD"
}
}
},
{
_id: ObjectId("5c1d358bf383fbee028aea0c"),
product_name: "Super Suit",
product_attributes: {
superFlight: true,
resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
}
}
] )

La siguiente operación crea un índice comodín y utiliza el wildcardProjection documento para indexar todos los campos escalares de cada documento de la colección, excluyendo los product_attributes.elements product_attributes.resistance campos y:

use inventory
db.products_catalog.createIndex(
{ "$**" : 1 },
{
"wildcardProjection" : {
"product_attributes.elements" : 0,
"product_attributes.resistance" : 0
}
}
)

Mientras que el patrón de clave "$**" cubre todos los campos del documento, el wildcardProjection campo excluye del índice los campos especificados. Para obtener la documentación completa wildcardProjection sobre, consulte Opciones para wildcard índices.

Si un campo es un documento o un arreglo anidado, el índice comodín recorre el documento/arreglo e indexa todos los campos escalares del documento/arreglo.

El índice creado puede admitir consultas en cualquier campo escalar excepto aquellos excluidos wildcardProjection por:

db.products_catalog.find( { "product_attributes.maxSpeed" : { $gt: 25 } } )
db.products_catalog.find( { "product_attributes.superStrength" : true } )

Nota

Los índices comodín no soportan mezclar instrucciones de inclusión y exclusión en el documento wildcardProjection excepto cuando se incluye explícitamente el campo _id. Para obtener más información sobre wildcardProjection, consulta la documentación de los parámetros.

Nota

Requiere featureCompatibilityVersion 4.4+

Cada mongod en el set de réplicas o clúster debe tener featureCompatibilityVersion configurada al menos en 4.4 para iniciar la creación de índices simultáneamente en los miembros del set de réplicas.

La creación de índices en un set de réplicas o en un clúster se realiza simultáneamente en todos los miembros del set de réplicas que contienen datos. Para clústeres fragmentados, la creación de índices solo ocurre en fragmentos que contienen datos para la colección que se está indexando. El primario requiere un número mínimo de nodos portadores de datos voting (es decir, quórum de confirmación), incluido él mismo, que deben completar la compilación antes de marcar el índice como listo para usar. Consulta creación de índices en entornos replicados para obtener más información.

Especifique el parámetro commitQuorum en la operación para establecer el número mínimo de miembros con derecho a voto que contienen datos (es decir, el quórum de confirmación), incluido el principal, que debe completar la creación del índice antes de que el principal marque los índices como listos. El quórum de confirmación createIndex() predeterminado votingMembers es, o todos los miembros del conjunto de réplicas con derecho a voto que contienen datos.

La siguiente operación crea un índice con un quórum de confirmación de "majority", o una mayoría simple de miembros votantes con datos:

db.getSiblingDB("examples").invoices.createIndex(
{ "invoices" : 1 },
{ },
"majority"
)

El primario marca la creación de índices como lista solo después de que una mayoría simple de nodos votantes con datos "vote" para confirmar la creación de índices. Para obtener más información sobre la creación de índices y el proceso de votación, consulta Creación de índices en entornos replicados.

Volver

db.collection.countDocuments

En esta página