/ /

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

createIndexes (comando de base de datos)

Definición

createIndexes: Compila uno o más índices en una colección.
Tip
En mongosh, este comando también se puede ejecutar a través del db.collection.createIndex() db.collection.createIndexes() Métodos auxiliares y.
Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Compatibilidad

Este comando 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.

Sintaxis

El comando toma la siguiente createIndexes forma:

db.runCommand(
   {
     createIndexes: <collection>,
     indexes: [
         {
             key: {
                 <key-value_pair>,
                 <key-value_pair>,
                 ...
             },
             name: <index_name>,
             <option1>,
             <option2>,
             ...
         },
         { ... },
         { ... }
     ],
     writeConcern: { <write concern> },
     commitQuorum: <int|string>,
     comment: <any>
   }
 )

Campos de comandos

El comando toma los siguientes createIndexes campos:

Campo	Tipo	Descripción
`createIndexes`	string	La colección para la que se crearán índices.
`indexes`	arreglo	Especifica los índices que se crearán. Cada documento de la matriz especifica un índice independiente.
`writeConcern`	Documento	Opcional. Un documento que expresa el nivel de confirmación de escritura. Omite el uso del nivel de confirmación de escritura por defecto.
`commitQuorum`	entero o cadena de texto	Opcional. El número mínimo de miembros del conjunto de réplicas que contienen datos (es decir, el cuórum de confirmación), incluido el principal, que deben informar una compilación de índice exitosa antes de que el principal marque el `indexes` como listo. A partir de MongoDB v,5.0 puede reanudar algunas compilaciones de índices interrumpidas cuando `commit quorum is set` `"votingMembers"`a. Los nodos del conjunto de réplicas en un quórum de confirmación deben tener `members[n].buildIndexes` establecido `true` en. Si algún nodo con derecho a voto tiene `members[n].buildIndexes` establecido `false` en, no podrá usar el `"votingMembers"` quórum de confirmación predeterminado. Configure todos los nodos con `members[n].buildIndexes` establecido en `true` o seleccione un quórum de confirmación diferente. Admite los siguientes valores: `"votingMembers"` - todos los nodos votantes con datos del set de réplicas (por defecto). Nodo "votante" es cualquier nodo del set de réplicas donde `members[n].votes` es mayor que `0`. `"majority"` - una mayoría simple de miembros del conjunto de réplicas que contienen datos. `<int>` - un número específico de miembros del conjunto de réplicas que contienen datos. `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.
`comment`	any	Opcional. Un comentario proporcionado por el usuario para adjuntar a este comando. Una vez configurado, este comentario aparece junto a los registros de este comando en las siguientes ubicaciones: Mensajes de registro de mongod, en el campo `attr.command.cursor.comment`. Salida del perfilador de base de datos, en el campo `command.comment`. `currentOp` de salida, en el campo `command.comment`. Un comentario puede ser de cualquier tipo BSON válido (string, objeto, arreglo, etc.).

Cada documento de la matriz indexes puede tomar los siguientes campos:

Campo

Tipo

Descripción

key

Documento

Especifica los campos del índice. Para cada campo, especifique un par clave-valor donde la clave sea el nombre del campo que se va a indexar y el valor sea la dirección o el tipo de índice. Si se especifica la dirección, especifique 1 para ascendente o -1 para descendente.

MongoDB admite varios tipos de índices diferentes, incluidos:

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

Los índices comodín admiten cargas de trabajo en las que los usuarios realizan consultas 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 detalles, consulteÍndices comodín.

name

string

Un nombre que identifica de forma única el índice.

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.

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:

expresiones de igualdad (es decir, field: value o con el operador $eq)
$exists: true expresión
$gt, $gte, $lt, $lte expresiones
$type expresiones
$and operador
$or operador
$in operador
$geoWithin operador
$geoIntersects operador

Si estás utilizando cifrado a nivel de campo del lado del cliente o Queryable Encryption, un partialFilterExpression no puede hacer referencia a un campo cifrado.

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.

MongoDB ofrece la opción de crear índices parciales. Estos ofrecen una funcionalidad superior a la de los índices dispersos y son los preferidos.

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.

ocultos

booleano

Opcional. Indicador que determina si el índice está oculto para el planificador de consultas. Un índice oculto no se evalúa en la selección del plan de consultas.

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.

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.

default_language

string

Opcional. Para los índices de 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 los lenguajes disponibles y Especificar el lenguaje para índices de texto en MongoDB autogestionado para más información y ejemplos. El valor por defecto es english.

language_override

string

Opcional. Para los índices de texto, el nombre del campo en los documentos de la colección que contiene el idioma de anulación para el documento. El valor es por defecto language. Consulte Especificar el lenguaje para los índices de texto en MongoDB autogestionado para 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 las versiones disponibles, consulta Versiones del índice de texto en implementaciones autogestionadas.

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 las versiones disponibles, consulta Índices 2dsphere.

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.

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.

wildcardProjection

Documento

Opcional.

Permite a los usuarios incluir o excluir rutas de campo específicas de un índice comodín mediante el { "$**" : 1} patrón de clave. Esta opción solo es válida si se crea un índice comodín en todos los campos del documento. No se puede especificar esta opción si se crea un índice comodín en una ruta de campo específica y sus subcampos, por ejemplo,. { "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
  }
}

Todas las instrucciones en el documento wildcardProjection deben ser de inclusión o de exclusión. También puede incluir el campo _id con las instrucciones de exclusión. Esta es la única excepción a la regla.

mongosh proporciona los métodos db.collection.createIndex() y como db.collection.createIndexes() createIndexes envoltorios para el comando.

Considerations

MongoDB no permite la creación de índices de la versión 0.

Nombres de índices

El createIndexes comando y mongosh los ayudantes db.collection.createIndex() y informan un error si crea un índice con un nombre y luego intenta crear el mismo índice nuevamente pero con otro db.collection.createIndexes() nombre.

{
   "ok" : 0,
   "errmsg" : "Index with name: x_1 already exists with a different name",
   "code" : 85,
   "codeName" : "IndexOptionsConflict"
}

En versiones anteriores, MongoDB no recreó el índice, sino que devolvió un objeto de respuesta con un valor ok de 1 y una nota que indicaba que el índice no se había recreado. Por ejemplo:

{
   "numIndexesBefore" : 2,
   "numIndexesAfter" : 2,
   "note" : "all indexes already exist",
   "ok" : 1
}

Conjuntos de réplicas y clústeres fragmentados

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.

Para iniciar una creación de índice con un quórum de confirmación no predeterminado, especifique el commitQuorum.

Utilice el comando para modificar el quórum de confirmación de una compilación de índice en setIndexCommitQuorum curso.

Tipos de intercalación y de índices

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

Text indexes
2d indexes

Tip

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

Stable API

Cuando se debe utilizar Stable API V1:

No puede especificar ninguno de los siguientes campos en la matriz indexes:
- background
- bucketSize
- sparse
- storageEngine
No se pueden crear índices de texto.
El planificador de consultas ignora los tipos de índice no admitidos mencionados anteriormente en modo estricto. Por ejemplo, intentar usar un sparse índice con generará el cursor.hint() siguiente BadValue error:
```
planner returned error :: caused by :: hint provided does not
correspond to an existing index
```

Comportamiento

Simultaneidad

Para featureCompatibilityVersion, "4.2" createIndexes 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 createIndexes createIndexes el bloqueo exclusivo. permite intercalar operaciones de lectura y escritura durante la mayor parte de la compilación del índice.

Para featureCompatibilityVersion, "4.0" createIndexes utiliza el proceso de compilación de índices anterior a,4.2 que, de forma predeterminada, establece un bloqueo exclusivo en la base de datos principal durante todo el proceso de compilación. El proceso de compilación anterior a.4 2 bloquea todas las operaciones en la base de datos y todas sus colecciones hasta que se complete la operación. Losbackground índices no tienen un bloqueo exclusivo.

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

Importante

Si un nodo votante con datos se vuelve inaccesible y el commitQuorum está configurado en el valor por defecto votingMembers, la creación de índices puede quedarse atascada hasta que ese nodo vuelva a estar en linea.

Límite de uso de memoria

createIndexes permite crear uno o más índices en una colección. utiliza una combinación de memoria y archivos temporales en disco para crear índices. El límite de memoria predeterminado escreateIndexes de 200 megabytes por cada comando, que createIndexes se comparte equitativamente entre todos los índices creados con ese comando. Por ejemplo, si crea 10 índices con un solo comando, MongoDB createIndexes asigna 20 megabytes a cada índice para el proceso de creación cuando se utiliza el 200 límite de memoria predeterminado de. Al alcanzar el límite de memoria, MongoDB crea archivos temporales en el _tmp subdirectorio dentro de --dbpath para completar la creación.

Ajuste el límite de memoria con el parámetromaxIndexBuildMemoryUsageMegabytes. Aumentar este parámetro solo es necesario en casos excepcionales, como al ejecutar varias compilaciones de índices simultáneas con un solo comandocreateIndexeso al indexar un conjunto de datos de más de 500GB.

Cada comandocreateIndexestiene un límite demaxIndexBuildMemoryUsageMegabytes. Al usar el valor predeterminadomaxNumActiveUserIndexBuildsde 3, el uso total de memoria para todas las compilaciones de índices simultáneas puede alcanzar hasta 3 veces el valor demaxIndexBuildMemoryUsageMegabytes.

Opciones del índice

Non-Hidden Option

La opción oculta se puede cambiar sin tener que eliminar ni recrear el índice.Consulte "Opción oculta".

Cambiar las opciones del índice

Las opciones de intercalación de un índice existente se pueden actualizar. Para cambiar otras opciones del índice, elimine el índice existente con y db.collection.dropIndex() createIndexes luego ejecute con las nuevas opciones.

Opción de intercalación

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.

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.

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.

Opción oculta

Para cambiar la opción hidden de los índices existentes, puedes usar los siguientes métodos mongosh:

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 } );
```

Tip

Hidden Indexes

Índices 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
  }
}
```
Todas las instrucciones en el documento wildcardProjection deben ser de inclusión o de exclusión. También puede incluir el campo _id con las instrucciones de exclusión. Esta es la única excepción a la regla.
Los índices comodín no son compatibles con:
Los índices comodín son índices escasos. No ofrecen soporte para consultas cuando no existe un campo indexado. Un índice comodín indexará el documento si el campo comodín tiene un valor de null.
A partir de MongoDB 7.0, los índices comodín admiten el orden de clasificación ascendente (1) y descendente (-1). Las versiones anteriores solo admitían el orden ascendente.

Para obtener más información, consulta:

Transacciones

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 createIndexes 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á.

Tip

Crear colecciones e índices en una transacción

Quórum de confirmación en contraste con el nivel de confirmación de escritura

Existen diferencias importantes entre los quórums de confirmación y las preocupaciones de escritura:

La creación de índices utiliza quórums de confirmación.
Las operaciones de guardado utilizan el nivel de confirmación de escritura.

Cada nodo que lleva datos en un clúster es un miembro votante.

El quórum de confirmación especifica cuántos miembros con derecho a voto que contienen datos o qué miembros con derecho a voto, incluido el primario, deben estar preparados para comprometerse a una creación de índices simultánea antes de que el primario ejecute la confirmación.

El nivel de confirmación de escritura es el nivel de reconocimiento de que la escritura se propagó a la cantidad especificada de instancias.

Modificado en la versión 8.0: El quórum de confirmación especifica cuántos miembros deben estar listos para completar la creación de índices antes de que el primario confirme la creación de índices. Por el contrario, cuando el primario ha confirmado la creación de índices, el nivel de confirmación de escritura especifica cuántos nodos deben replicar la entrada del oplog de creación de índices antes de que el comando devuelva éxito.

En versiones anteriores, cuando el nodo primario confirmaba la creación de índices, el nivel de confirmación de escritura especificaba cuántos nodos debían completar la creación de índices antes de que el comando devolviera éxito.

Ejemplo

El siguiente comando crea dos índices en la colección inventory de la base de datos products:

db.getSiblingDB("products").runCommand(
  {
    createIndexes: "inventory",
    indexes: [
        {
            key: {
                item: 1,
                manufacturer: 1,
                model: 1
            },
            name: "item_manufacturer_model",
            unique: true
        },
        {
            key: {
                item: 1,
                supplier: 1,
                model: 1
            },
            name: "item_supplier_model",
            unique: true
        }
    ],
    writeConcern: { w: "majority" }
  }
)

Cuando los índices terminan de construirse exitosamente, MongoDB devuelve un documento de resultados que incluye un estado de "ok" : 1.

Crear un índice comodín

Nota

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:

Crear un índice comodín en una ruta de un solo campo
Crear un índice comodín en todas las rutas de campos
Crear un índice comodín en múltiples rutas de campos específicos
Crear un índice comodín que excluya varias rutas de campos específicos

Crear un índice comodín en una ruta de un solo campo

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.runCommand(
  {
    createIndexes: "products_catalog",
    indexes: [
      {
        key: { "product_attributes.$**" : 1 },
        name: "wildcardIndex"
      }
    ]
  }
)

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.

Crear un índice comodín en todas las rutas de campos

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.runCommand(
  {
    createIndexes: "products_catalog",
    indexes: [
      {
        key: { "$**" : 1 },
        name: "wildcardIndex"
      }
    ]
  }
)

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.

Crear un índice comodín en múltiples rutas de campos específicos

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.runCommand(
  {
    createIndexes: "products_catalog",
    indexes: [
      {
        key: { "$**" : 1 },
        "wildcardProjection" : {
          "product_attributes.elements" : 1,
          "product_attributes.resistance" : 1
        },
        name: "wildcardIndex"
      }
    ]
  }
)

Aunque el patrón clave "$**" abarca todos los campos del documento, el campo wildcardProjection limita el índice solo a los campos incluidos y los campos anidados relacionados.

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.

Crear un índice comodín que excluya varias rutas de campos específicos

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.runCommand(
  {
    createIndexes: "products_catalog",
    indexes: [
      {
        key: { "$**" : 1 },
        "wildcardProjection" : {
           "product_attributes.elements" : 0,
           "product_attributes.resistance" : 0
        },
        name: "wildcardIndex"
      }
    ]
  }
)

Mientras que el patrón de clave "$**" cubre todos los campos del documento, el campo wildcardProjection excluye los campos especificados del índice.

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

Crear un índice con quórum de confirmación

Nota

Requiere featureCompatibilityVersion 4.4+

Para establecer el quórum de confirmación, utiliza createIndexes para especificar el valor de commitQuorum.

commitQuorum especifica cuántos nodos votantes con datos o cuáles, incluido el primario, deben estar preparados para confirmar la creación de índices antes de que el primario ejecute la confirmación. El quórum de confirmación por defecto es votingMembers, lo que significa todos los nodos con datos.

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

db.getSiblingDB("examples").runCommand(
  {
    createIndexes: "invoices",
    indexes: [
      {
        key: { "invoices" : 1 },
        "name" : "invoiceIndex"
      }
    ],
    "commitQuorum" : "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.

Salida

El comando devuelve un documento que indica el éxito de la operación. El documento contiene algunos de los siguientes campos, pero no todos, según el createIndexes resultado:

createIndexes.createdCollectionAutomatically: Si es true, entonces la colección no existía y se creó en el proceso de creación del índice.

createIndexes.numIndexesBefore: El número de índices al inicio del comando.

createIndexes.numIndexesAfter: El número de índices al final del comando.

createIndexes.ok: Un valor de 1 indica que los índices están implementados. Un valor de 0 indica un error.

createIndexes.note: Se devuelve este note si ya existen uno o más índices. Esto indica que el índice no se creó ni se modificó.

createIndexes.errmsg: Devuelve información sobre cualquier error.

createIndexes.code: El código de error que representa el tipo de error.

Ejemplo de salida

El siguiente bloque de código ilustra un ejemplo de la salida createIndexes en un clúster fragmentado. En un clúster fragmentado, createIndexes genera un documento incrustado raw que contiene un documento por cada fragmento en el que se basa el índice. Las claves del documento incrustado raw son concatenaciones del ID del fragmento, el nombre de host y el puerto de los nodos individuales que lo componen.

{
  raw: {
    'atlas-2m11gv-shard-1/atlas-2m11gv-shard-01-00.cpfgx.mongodb.net:27017,atlas-2m11gv-shard-01-01.cpfgx.mongodb.net:27017,atlas-2m11gv-shard-01-02.cpfgx.mongodb.net:27017': {
      numIndexesBefore: 3,
      numIndexesAfter: 5,
      createdCollectionAutomatically: false,
      commitQuorum: 'votingMembers',
      ok: 1
    },
    'atlas-2m11gv-shard-0/atlas-2m11gv-shard-00-00.cpfgx.mongodb.net:27017,atlas-2m11gv-shard-00-01.cpfgx.mongodb.net:27017,atlas-2m11gv-shard-00-02.cpfgx.mongodb.net:27017': {
      numIndexesBefore: 3,
      numIndexesAfter: 5,
      createdCollectionAutomatically: false,
      commitQuorum: 'votingMembers',
      ok: 1
    }
  },
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1743624296, i: 7 }),
    signature: {
      hash: Binary.createFromBase64('22j0GK8SIK806T+0OdCY6qYHocM=', 0),
      keyId: Long('7438621020069560323')
    }
  },
  operationTime: Timestamp({ t: 1743624296, i: 7 })
}

Volver

Cree

currentOp