createIndexes (comando de base de datos)

string

La colección para la que se crearán índices.

arreglo

Especifica los índices que se crearán. Cada documento de la matriz especifica un índice independiente.

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.

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.

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.).

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, como índices de texto, geoespaciales y hash. Consulte los tipos de índice para obtener más información.

Para ver ejemplos de creación de índices comodín, consulte Crear un índice comodín.

string

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

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.

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 utilizando el $eq operador),

• $exists: true expresión,

• $gt, $gte, $lt, $lte expressions,

• $type expresiones,

• $and operador,

• $or operador,

• $in 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.

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:

• 2dsphere

• 2 d

• geoHaystack

• text

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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
  }
}

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.