BulkWriteResult() (método mongosh)

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Propiedades

BulkWriteResult tiene las siguientes propiedades:

BulkWriteResult.acknowledged

Booleano que indica si se reconoció o no la escritura masiva.

BulkWriteResult.deletedCount

Recuento de documentos eliminados.

BulkWriteResult.insertedCount

Conteo de documentos insertados.

BulkWriteResult.insertedIds

mongosh Versión	Descripción	Ejemplo
v1.x	Arreglo de documentos insertados por ObjectId.	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	Mapea desde cada índice de documento insertado a su ObjectId.	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

BulkWriteResult.matchedCount

Cantidad de documentos coincidentes.

BulkWriteResult.modifiedCount

Cantidad de documentos modificados.

BulkWriteResult.upsertedCount

Conteo de documentos upserted.

BulkWriteResult.upsertedIds

mongosh Versión	Descripción	Ejemplo
v1.x	Arreglo de documentos insertados o actualizados por ObjectId.	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	Mapea desde cada índice de documento insertado a su ObjectId.	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

Excepción writeErrors

Si hay un error de escritura mientras se procesa la escritura masiva, mongosh genera una excepción que contiene una propiedad writeErrors con los siguientes campos:

writeErrors

Un arreglo de documentos que contiene información sobre cualquier error, no relacionado con niveles de confirmaciones de escritura (write concern), encontrado durante la operación de actualización. writeErrors contiene un documento de error para cada operación de guardar que contiene errores.

Cada documento de error contiene los siguientes campos:

writeErrors.index

Entero que identifica la operación de escritura en la lista de operaciones en bloque, que usa un índice basado en cero. Ver también Bulk.getOperations().

writeErrors.code

Valor entero que identifica el error.

writeErrors.errmsg

Descripción del error.

writeErrors.op

Un documento que identifica la operación que falló. Por ejemplo, un error de una operación de actualización o reemplazo devolverá un documento que especifica la query, la actualización, el multi y las opciones upsert. Una operación de inserción devuelve el documento que la operación intentó insertar.

Excepción writeConcernError

Si hay un error de nivel de confirmación de escritura (write concern) al procesar la escritura en bloque, mongosh genera una excepción que contiene una propiedad writeConcernError con los siguientes campos:

writeConcernError

Documento que describe los errores relacionados con el nivel de confirmación de escritura (write concern).

Modificado en la 7.0.6 versión.:

(Tambiéndisponible 6.0.14 en 5.0.30 y): Cuando BulkWriteResult() se recibe desde, siempre se informan errores de escritura, incluso cuando se produce uno o más mongos BulkWriteResult() errores de escritura. En versiones anteriores, la aparición de errores de escritura podía provocar que no informara de errores de escritura.

Los documentos writeConcernError contienen los siguientes campos:

writeConcernError.code

Valor entero que identifica la causa del error en el nivel de confirmación de escritura (write concern).

writeConcernError.errmsg

Descripción de la causa del error de nivel de confirmación de escritura (write concern).

writeConcernError.errInfo.writeConcern

El objeto del nivel de confirmación de escritura (write concern) usado para la operación correspondiente. Para obtener información sobre los campos del objeto de nivel de confirmación de escritura (write concern), se puede consultar Especificación de nivel de confirmación de escritura (write concern).

El objeto del nivel de confirmación de escritura (write concern) también puede contener el siguiente campo, que indica el origen del nivel de confirmación de escritura (write concern):

writeConcernError.errInfo.writeConcern.provenance

Un valor de string que indica dónde se originó el nivel de confirmación de escritura (write concern) (conocido como nivel de confirmación de escritura (write concern) provenance). La siguiente tabla muestra los valores posibles para este campo y su significado:

Origen	Descripción
clientSupplied	El nivel de confirmación de escritura se especificó en la aplicación.
customDefault	El nivel de confirmación de escritura se originó a partir de un valor por defecto personalizado. Vea setDefaultRWConcern.
getLastErrorDefaults	El nivel de confirmación de escritura se originó en el campo settings.getLastErrorDefaults del set de réplicas.
implicitDefault	El nivel de confirmación de escritura (write concern) se originó en el servidor en ausencia de todas las demás especificaciones de nivel de confirmación de escritura (write concern).