crear (comando de base de datos)

string

El nombre de la nueva colección o vista.Consulte Restricciones de nombres. Si intenta crear una colección o vista ya existente y proporciona opciones idénticas para ella, no se realizará ninguna acción y se devolverá el resultado.

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 los metadatos en cada documento de serie de tiempo. Los metadatos del campo especificado deben ser datos que se utilicen para etiquetar una serie única de documentos. Los metadatos difícilmente cambien. El nombre del campo especificado no puede ser _id ni el mismo que el timeseries.timeField. El campo puede ser de cualquier tipo de dato.

Aunque el campo metaField es opcional, el uso de metadatos puede mejorar la optimización de query. Por ejemplo, MongoDB crea un índice compuesto automáticamente en los campos metaField y timeField para las nuevas colecciones. Si no proporcionas un valor para este campo, los datos se agrupan únicamente en función del tiempo.

string

Opcional, no lo utilices si se configura bucketRoundingSeconds y bucketMaxSpanSeconds. Los valores posibles son seconds (por defecto), minutes y hours.

Configura granularity al valor que más se asemeje al intervalo de tiempo entre las marcas de tiempo entrantes consecutivas. Esto mejora el rendimiento al optimizar cómo MongoDB almacena internamente los datos en la colección.

Para obtener más información sobre la granularidad y los intervalos de agrupación, consulta Configurar granularidad para datos de series de tiempo.

entero

Opcional, se utiliza con bucketRoundingSeconds como una alternativa a granularity. Establece el tiempo máximo entre marcas de tiempo en el mismo bucket. Los valores posibles son de 1 a 31536000. Si configuras bucketMaxSpanSeconds, debes configurar bucketRoundingSeconds al mismo valor.

Para degradar a una versión anterior a MongoDB 6.3, debes modificar la colección para utilizar el valor granularity correspondiente o descartar la colección. Para obtener más detalles, consulta collMod.

entero

Opcional, se usa con bucketMaxSpanSeconds como alternativa a granularity. Establece el número de segundos que se redondearán a la baja cuando MongoDB establezca la marca de tiempo mínima para un nuevo bucket. Debe ser igual a bucketMaxSpanSeconds.

Por ejemplo, al establecer ambos parámetros en 1800, los nuevos intervalos se redondean a los 30 minutos más cercanos. Si un documento con una marca de tiempo de 2023-03-27T18:24:35Z no encaja en un bucket existente, MongoDB crea un nuevo bucket con un tiempo mínimo de 2023-03-27T18:00:00Z y un tiempo máximo de 2023-03-27T18:30:00Z.

entero

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. Los índices agrupados se almacenan en el mismo archivo WiredTiger de la colección. La colección resultante se llama colección con índice clusterizado.

El campo clusteredIndex tiene la siguiente sintaxis:

clusteredIndex: {
   key: <object>,
   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. Por ejemplo, cuando se utiliza el comando collMod:

  db.runCommand( {
     collMod: <collection>,
     changeStreamPreAndPostImages: { enabled: true }
  } )

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 un ejemplo de create en esta página, se debe consultar Crear una colección con imágenes previas y posteriores de Change Stream para documentos.

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.

A partir de MongoDB 7.2, no se pueden especificar opciones de cifrado del motor de almacenamiento wiredTiger al crear una colección con db.createCollection(). Para configurar el cifrado para el motor de almacenamiento WiredTiger, consulta Cifrado en reposo.

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.

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 Tutoriales de cifrado consultable.

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