crear (comando de base de datos)

string

El nombre de la nueva colección o vista.Consulte Restricciones de nombres.

booleano

Opcional. Para crear una colección con tamaño fijo, especifica true. Si especificas true, también debes establecer un tamaño máximo en el campo size.

string

Requerido al crear una colección de series de tiempo. El nombre del campo que contiene la fecha en cada documento de serie de tiempo. Los documentos en una colección de series de tiempo deben tener una fecha BSON válida como valor para el timeField.

string

Opcional. El nombre del campo que contiene metadatos en cada documento de serie de tiempo. Los metadatos en el campo especificado deben ser datos utilizados para etiquetar una serie única de documentos. Los metadatos deberían cambiar rara vez, o nunca.

El nombre del campo especificado no puede ser _id ni el mismo que el timeseries.timeField. El campo puede ser de cualquier tipo excepto un arreglo.

string

Opcional. Los valores posibles son "seconds" (predeterminado), "minutes" y "hours". Establezca la granularidad en el valor que más coincida con el intervalo de tiempo entre mediciones entrantes consecutivas. Configurar el parámetro granularity con precisión mejora el rendimiento al optimizar el almacenamiento interno de los datos de la colección de series temporales.

Número

Opcional. Especifica los segundos después de los cuales los documentos en una colección de series de tiempo o colección con índice clusterizado expiran. MongoDB elimina automáticamente los documentos caducados.

Documento

A partir de MongoDB 5.3, puedes crear una colección con un índice agrupado. Las colecciones creadas con un índice de clústeres se denominan colecciones con índice clusterizado.

Consultar Colecciones con índice clusterizado.

clusteredIndex tiene la siguiente sintaxis:

clusteredIndex: {
   key: { <string> },
   unique: <boolean>,
   name: <string>
}

key

Requerido. El campo clave del índice agrupado. Debe estar configurado en { _id: 1 }. El valor por defecto del campo _id es un objectId único generado automáticamente, pero puedes establecer tus propios valores de clave de índice agrupado.

unique

Requerido. Debe establecerse en true. Un índice único indica que la colección no aceptará documentos insertados o actualizados si el valor de la clave del índice agrupado coincide con un valor ya existente en el índice.

name

Opcional. Un nombre que identifica de manera única el índice agrupado.

Documento

Opcional.

A partir de MongoDB 6.0, puedes utilizar eventos de flujo de cambios para generar la versión de un documento antes y después de los cambios (las imágenes previas y posteriores del documento):

• La imagen previa es el documento antes de reemplazarlo, actualizarlo o borrarlo. No existe una imagen previa para un documento insertado.

• La imagen posterior es el documento tras insertarse, sustituirse o actualizarse. No hay imagen posterior para un documento borrado.

• Activa changeStreamPreAndPostImages para una colección con db.createCollection(), create o collMod.

changeStreamPreAndPostImages tiene la siguiente sintaxis:

changeStreamPreAndPostImages: {
   enabled: <boolean>
}

Para habilitar las imágenes previas y posteriores del flujo de cambios para la colección, se debe establecer enabled en true.

Para obtener ejemplos completos con la salida del flujo de cambios, consulta Flujos de cambio con imágenes previas y posteriores de documentos.

Para create ver un ejemplo en esta página, consulte Crear una colección con imágenes previas y posteriores al flujo de cambios para documentos.

booleano

Opcional. Especifique false para deshabilitar la creación automática de un índice en el campo _id.

entero

Opcional. Especifica un tamaño máximo en bytes para una colección con tamaño fijo. Una vez que una colección con tamaño fijo alcanza su tamaño máximo, MongoDB remueve los documentos más antiguos para dejar espacio a los nuevos documentos. El campo size es obligatorio para las colecciones con tamaño fijo y se ignora para las demás colecciones.

entero

Opcional. El número máximo de documentos permitidos en la colección con tamaño fijo. El límite de size tiene prioridad sobre este límite. Si una colección con tamaño fijo alcanza el límite size antes de alcanzar el número máximo de documentos, MongoDB remueve los documentos antiguos. Si prefieres usar el límite de max, asegúrate de que el límite de size, que es necesario para una colección con tamaño fijo, sea suficiente para contener el número máximo de documentos.

Documento

Opcional. Disponible solo para el motor de almacenamiento WiredTiger.

Permite a los usuarios especificar la configuración para el motor de almacenamiento por colección al crear una colección. El valor de la opción storageEngine debe tomar la siguiente forma:

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

La configuración del motor de almacenamiento especificada al crear colecciones se valida y se registra en el oplog durante la replicación para soportar conjuntos de set de réplicas con miembros que utilizan diferentes motores de almacenamiento.

Para obtener más información, consulte Especificar opciones del motor de almacenamiento.

Documento

Opcional. Permite a los usuarios especificar reglas o expresiones de validación para la 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.

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

string

Opcional. Determina con qué rigor MongoDB aplica las reglas de validación a los documentos existentes durante una 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.

string

Opcional. Determina si se debe mostrar error en documentos no válidos o solo warn sobre las infracciones, pero permite que se inserten documentos no válidos.

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.

Documento

Opcional. Permite a los usuarios especificar una configuración por defecto para los índices al crear una colección.

La opción indexOptionDefaults acepta un documento storageEngine, el cual debe tener la siguiente forma:

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

La configuración del motor de almacenamiento especificada al crear índices se valida y se registra en el oplog durante la replicación para admitir sets de réplicas con miembros que utilizan diferentes motores de almacenamiento.

string

El nombre de la colección o vista de origen desde la que se creará la vista. El nombre no es el espacio de nombres completo de la colección o vista; es decir, no incluye el nombre de la base de datos e implica la misma base de datos que la vista que se va a crear. Debe crear las vistas en la misma base de datos que la colección de origen.

Consulte también db.createView().

arreglo

Una matriz que consta de las etapas de la canalización de agregación. create crea la vista aplicando el especificado pipeline a la viewOn colección o vista.

Una definición de vista pipeline no puede incluir la etapa $out o la $merge. Esta restricción también se aplica a pipelines integradas, como las pipelines usadas en las etapas de $lookup o $facet.

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.

Consulte también db.createView().

Especifica la intercalación predeterminada para la colección o la vista.

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.

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.

Si especificas una intercalación a nivel de colección:

• Los índices de esa colección se crearán con esa intercalación a menos que la operación de creación del índice especifique explícitamente una intercalación diferente.

• Las operaciones en esa colección utilizan la intercalación por defecto de la colección, a menos que especifiquen explícitamente una intercalación diferente.

  No puedes especificar varias intercalaciones para una operación. Por ejemplo, no puedes especificar diferentes intercalaciones por campo, o si realizas una búsqueda con un ordenamiento, no puedes usar una intercalación para la búsqueda y otra para el ordenamiento.

Si no se especifica ninguna intercalación para la colección o para las operaciones, MongoDB utiliza la comparación binaria simple usada en versiones anteriores para las comparaciones de strings.

Para una vista, si no se especifica ninguna intercalación, la intercalación predeterminada es la intercaladora de comparación binaria simple. Para una vista de una colección, la vista no hereda la configuración de intercalación de la colección. Para una vista de otra vista, la vista que se va a crear debe especificar la misma configuración de intercalación.

Después de crear la colección o la vista, no es posible actualizar su intercalación predeterminada.

Para ver un ejemplo que especifica la intercalación predeterminada durante la creación de una colección, consulte Especificar intercalación.

Documento

Opcional. Un documento que expresa el nivel de confirmación de escritura para la operación. Omite usar el nivel de confirmación de escritura por defecto.

Cuando se emite en un clúster particionado, mongos convierte el nivel de confirmación de escritura del comando create y su asistente db.createCollection() a "majority".

Documento

Opcional. Un documento que configura el cifrado consultable para la colección que se está creando.

Para usar campos cifrados en una colección, especifique una nueva opción de configuración. Debe tener permisos para crear y modificar una colección para crear o editar esta configuración.

La configuración incluye una lista de campos y sus identificadores clave correspondientes, tipos y queries compatibles.

encryptedFieldsConfig = {
    "fields": [
      {
        "keyId": UUID,                    // required
        "path": String,                   // path to field, required
        "bsonType": "string" | "int" ..., // required
        "queries":                        // optional
        [
          { "queryType": "equality" },
        ]
      }
    ],
    "queryPatterns": [                    // optional
       {"fieldName": queryType, "fieldName": queryType, … }
    ]
}

Para obtener más detalles, consulte Inicio rápido.

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