collMod

Opciones del índice

index

La opción puede cambiar index las siguientes propiedades de un índice existente:

Propiedad del índice	Descripción
expireAfterSeconds	El número de segundos que determina el umbral de caducidad de una colección de TTL. Si tiene éxito, el comando devuelve un documento que contiene los valores antiguos y nuevos para la propiedad modificada: expireAfterSeconds_old y expireAfterSeconds_new. Solo se puede modificar un índice TTL existente; es decir, un índice con una propiedad expireAfterSeconds. Si el índice no tiene una propiedad expireAfterSeconds, la operación genera un error con no expireAfterSeconds field to update. Modificar la opción de índice expireAfterSeconds restablece el $indexStats para el índice. 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.
hidden	Un booleano que determina si el índice está oculto o no para el planificador de queries. Si el valor de hidden cambia, el comando devuelve un documento que contiene tanto los valores antiguos como los nuevos de la propiedad modificada: hidden_old y hidden_new. Sin embargo, si el valor de hidden no ha cambiado (es decir, ocultar un índice ya oculto o desocultar un índice ya no oculto), el comando omite los campos hidden_old y hidden_new de la salida. Para ocultar un índice, se debe tener el valor featureCompatibilityVersion de 4.4 o superior. Al modificar la opción de índice hidden se restablece el $indexStats para el índice si el valor cambia.

Para cambiar las opciones de índice, especifique el patrón de clave o el nombre del índice existente y la opción u opciones de índice que desea cambiar:

db.runCommand( {
   collMod: <collection>,
   index: {
      keyPattern: <index_spec> || name: <index_name>,
      expireAfterSeconds: <number>,  // If changing the TTL expiration threshold
      hidden: <boolean>              // If changing the visibility of the index from the query planner
   }
} )

• Hidden Indexes

• db.collection.hideIndex()

• db.collection.unhideIndex()

Validación de documentos

validator

Nuevo en la versión 3.2.

validator permite a los usuarios especificar reglas o expresiones de validación para una colección. Para más información,consulte Validación de esquemas.

La opción validator requiere un documento que especifique las reglas o expresiones de validación. Puedes especificar las expresiones utilizando los mismos operadores que los operadores del query, con la excepción de $near, $nearSphere, $text, y $where.

Nota

• La validación ocurre durante las actualizaciones e inserciones. Los documentos existentes no pasan por comprobaciones de validación hasta que se modifican.

• No se puede especificar un validador para colecciones en las bases de datos admin, local y config.

• No se puede especificar un validador para las colecciones de system.*.

validationLevel

Nuevo en la versión 3.2.

El determina con qué rigor MongoDB aplica las reglas de validación a los documentos existentes durante una validationLevel actualización.

"off"

No hay validación para inserciones o actualizaciones.

"strict"

Por defecto, aplica reglas de validación a todas las inserciones y a todas las actualizaciones.

"moderate"

Aplica reglas de validación a las inserciones y a las actualizaciones en documentos válidos existentes. No apliques reglas a las actualizaciones en documentos inválidos existentes.

validationAction

Nuevo en la versión 3.2.

La opción determina si se debe validationAction aplicar error en documentos no válidos o warn solo aplicar en las infracciones pero permitir los documentos no válidos.

Importante

La validación de documentos solo se aplica a aquellos documentos según lo determinado por el validationLevel.

"error"

Los documentos predeterminados deben pasar la validación antes de la escritura. De lo contrario, la operación falla.

"warn"

Los documentos no necesitan pasar la validación. Si el documento no la supera, la operación de escritura registra el fallo.

Para ver las especificaciones de validación de una colección, utilice el db.getCollectionInfos() método.

Vistas

viewOn

La colección o vista de origen subyacente para la vista. La definición de la vista se determina aplicando el especificado a este pipeline origen.

Necesario si se modifica una vista en una implementación de MongoDB que se ejecuta con control de acceso.

pipeline

La pipeline de agregación que define la vista.

Nota

La definición de vista pipeline no puede incluir $out las etapas ni. Si la definición de vista incluye $merge $lookup $facet una canalización anidada (por ejemplo, la definición de vista incluye las etapas o), esta restricción también se aplica a las canalizaciones anidadas.

Necesario si se modifica una vista en una implementación de MongoDB que se ejecuta con control de acceso.

La definición de la vista es pública; es decir, las operaciones db.getCollectionInfos() y explain en la vista incluirán el pipeline que define la vista. Por lo tanto, evite referirse directamente a campos y valores sensibles en las definiciones de vistas.

db.runCommand( {
   collMod: "myView",
   viewOn: "activities",
   pipeline: [
     { $match: { status: "Q" } },
     { $project: { user: 1, date: 1, description: 1} } ]
} )

Colecciones de series de tiempo

Para habilitar la eliminación automática de documentos o cambiar el expireAfterSeconds valor del parámetro para una colección de series de tiempo existente, emita el siguiente collMod comando:

db.runCommand({
   collMod: <collection>,
   expireAfterSeconds: <Number> || "off"
})

El campo expireAfterSeconds debe ser:

• Un número decimal no negativo (>=0)

• La cadena "off".

Un número especifica la cantidad de segundos tras los cuales caducan los documentos. La cadena "off" elimina el parámetro expireAfterSeconds y desactiva la eliminación automática.

Adjuntar comentario

comment

Opcional. Se puede adjuntar un comentario a este comando. El comentario debe ser un campo de nivel superior y puede ser cualquier tipo BSON válido. El comentario que se especifique aparece junto con 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.

Nivel de confirmación de escritura

w

Opcional. Un documento que expresa el nivel de confirmación de escritura del comando collMod.

Omite usar el nivel de confirmación de escritura por defecto.

Bloqueo de recursos

El comando collMod obtiene un bloqueo de colección sobre la colección especificada mientras dura la operación.

Cambiar el valor de caducidad de los índices

El siguiente ejemplo actualiza la propiedad expireAfterSeconds de un índice TTL existente { lastAccess: 1 } en una colección llamada user_log. La propiedad de expireAfterSeconds actual para el índice se establece en 1800 segundos (o 30 minutos) y el ejemplo cambia el valor a 3600 segundos (o 60 minutos).

db.runCommand({
   collMod: "user_log",
   index: {
      keyPattern: { lastAccess: 1 },
      expireAfterSeconds: 3600
   }
})

Si es exitosa, la operación devuelve un documento que incluye el valor anterior y el nuevo de la propiedad modificada:

{ "expireAfterSeconds_old" : 1800, "expireAfterSeconds_new" : 3600, "ok" : 1 }

Ocultar un índice del planificador de query

El siguiente ejemplo oculta un índice existente en la colección orders. En concreto, la operación oculta el índice con la especificación { shippedDate: 1 } del planificador de query.

db.runCommand({
   collMod: "orders",
   index: {
      keyPattern: { shippedDate: 1 },
      hidden: true
   }
})

Si es exitosa, la operación devuelve un documento que incluye el valor anterior y el nuevo de la propiedad modificada:

{ "hidden_old" : false, "hidden_new" : true, "ok" : 1 }

Para ocultar un índice de texto, se debe especificar el índice por name y no por keyPattern.

Agregar validación de documentos a una colección existente

El siguiente ejemplo agrega un validador a una colección existente llamada contacts.

db.runCommand( { collMod: "contacts",
   validator: { $jsonSchema: {
      bsonType: "object",
      required: [ "phone" ],
      properties: {
         phone: {
            bsonType: "string",
            description: "must be a string and is required"
         },
         email: {
            bsonType : "string",
            pattern : "@mongodb\.com$",
            description: "must be a string and match the regular expression pattern"
         },
         status: {
            enum: [ "Unknown", "Incomplete" ],
            description: "can only be one of the enum values"
         }
      }
   } },
   validationLevel: "moderate",
   validationAction: "warn"
} )

moderate validationLevelCon, MongoDB aplica reglas de validación para insertar y actualizar operaciones en documentos existentes que ya cumplen los criterios de validación. No se comprueba la validez de las actualizaciones de documentos existentes que no cumplen los criterios de validación.

warn validationActionCon, MongoDB registra cualquier violación pero permite que la inserción o actualización continúe.

Por ejemplo, la siguiente operación de inserción viola la regla de validación.

db.contacts.insertOne( { name: "Amanda", status: "Updated" } )

Sin embargo, dado que validationAction es solo warn, MongoDB solo registra el mensaje de violación de validación y permite que la operación continúe:

2017-12-01T12:31:23.738-05:00 W STORAGE  [conn1] Document would fail validation collection: example.contacts doc: { _id: ObjectId('5a2191ebacbbfc2bdc4dcffc'), name: "Amanda", status: "Updated" }

Para obtener más información, consulte Validación de esquema.