db.collection.insert() (método mongosh)

Parámetros

Nivel de confirmación de escritura

El método insert() utiliza el comando insert, que utiliza la nivel de confirmación de escritura (write concern) predeterminada. Para especificar un nivel de confirmación de escritura (write concern) diferente, incluya el nivel de confirmación de escritura (write concern) en el parámetro de opciones.

Creación de colección y campo _id

Si la colección no existe, insert() crea la colección.

Si el documento a insertar no especifica un campo _id, entonces mongod agrega el campo _id y asigna un ObjectId() único para el documento. La mayoría de los controladores crean un ObjectId e insertan el campo _id, pero el mongod lo creará y completará el _id si el controlador o la aplicación no lo hacen.

Si el documento contiene un campo _id, el valor de _id debe ser único dentro de la colección para evitar un error de clave duplicada.

Transacciones

insert() puede usarse dentro de transacciones distribuidas.

Entradas de OpLog

Si una operación de insert() inserta correctamente un documento, la operación agrega una entrada en el oplog (registro de operaciones). Si la operación falla, la operación no agrega una entrada en el registro opcional (oplog).

Insertar un documento sin especificar un campo _id

El siguiente ejemplo inserta un documento sin un campo _id en la colección movies:

db.movies.insert( { title: "Inception", year: 2010, genres: [ "Action", "Sci-Fi" ] } )

{
  acknowledged: true,
  insertedIds: { '0': "..." }
}

Debido a que el documento insertado no _id incluye, crea y agregamongod el _id campo y le asigna un valor ObjectId() único.

Los valores de ObjectId son específicos de la máquina y del momento en que se ejecuta la operación. Por lo tanto, tus valores pueden diferir de los del ejemplo.

Insertar un documento que especifique un campo _id

El siguiente ejemplo especifica el campo _id del documento insertado en la colección movies. El valor de _id debe ser único dentro de la colección para evitar un error de clave duplicada.

db.movies.insert( { _id: 10, title: "Inception", year: 2010 } )

{
  acknowledged: true,
  insertedIds: { '0': 10 }
}

Inserta varios documentos

El siguiente ejemplo realiza una inserción masiva pasando un array de documentos insert() a. Por defecto, MongoDB realiza una inserción ordenada. Con las inserciones ordenadas, si se produce un error durante la inserción de uno de los documentos, MongoDB devuelve un error sin procesar los documentos restantes del array.

El primer documento especifica un _id campo. Dado que el segundo y el tercer documento no contienen un _id campo, crea y agregamongod el _id campo para esos documentos durante la inserción:

db.movies.insert(
   [
     { _id: 11, title: "Inception", year: 2010, genres: [ "Action", "Sci-Fi" ] },
     { title: "The Matrix", year: 1999 },
     { title: "Interstellar", year: 2014 }
   ]
)

{
  acknowledged: true,
  insertedIds: {
    '0': 11,
    '1': "...",
    '2': "..."
  }
}

Realizar una inserción no ordenada

El siguiente ejemplo realiza una inserción no ordenada de tres documentos. Con las inserciones desordenadas, si se produce un error durante la inserción de uno de los documentos, MongoDB continúa insertando los documentos restantes en el arreglo.

db.movies.insert(
   [
     { _id: 20, title: "2001: A Space Odyssey", year: 1968 },
     { _id: 21, title: "A Clockwork Orange", year: 1971 },
     { _id: 22, title: "The Shining", year: 1980 }
   ],
   { ordered: false }
)

Anular el nivel de confirmación de escritura (write concern) por defecto

La siguiente operación a un set de réplicas especifica un nivel de confirmación de escritura (write concern) de w: 2 con un wtimeout de 5000 milisegundos. Esta operación regresa después de que el guardado se propaga tanto al primario como a un secundario, o expira después de 5 segundos.

db.movies.insert(
    { title: "The Revenant", year: 2015 },
    { writeConcern: { w: 2, j: true, wtimeout: 5000 } }
)

Resultados exitosos

Con éxito, el objeto WriteResult devuelto contiene información sobre el número de documentos insertados:

WriteResult({ "nInserted" : 1 })

Errores de nivel de confirmación de escritura

Si insert() encuentra errores de nivel de confirmación de escritura (write concern), los resultados incluyen el campo WriteResult.writeConcernError:

WriteResult({
  "nInserted" : 1,
  "writeConcernError"({
     "code" : 64,
     "errmsg" : "waiting for replication timed out",
     "errInfo" : {
       "wtimeout" : true,
       "writeConcern" : {
         "w" : "majority",
         "wtimeout" : 100,
         "provenance" : "getLastErrorDefaults"
       }
     }
})

Errores no relacionados con el nivel de confirmación de escritura (write concern)

Si insert() encuentra un error de nivel de confirmación de escritura (write concern), los resultados incluyen el campo WriteResult.writeError:

WriteResult({
   "nInserted" : 0,
   "writeError" : {
      "code" : 11000,
      "errmsg" : "insertDocument :: caused by :: 11000 E11000 duplicate key error index: test.foo.$_id_  dup key: { : 1.0 }"
   }
})