NAME
MongoDB::WriteResult - MongoDB write result document
VERSION
version v0.708.3.0
SYNOPSIS
# returned directly
my $result = $bulk->execute;
# from a WriteError or WriteConcernError
my $result = $error->result;
DESCRIPTION
This class encapsulates the results from a bulk write operation. It may be returned directly from execute
or it may be in the result
attribute of a MongoDB::DatabaseError
subclass like MongoDB::WriteError
or MongoDB::WriteConcernError
.
ATTRIBUTES
nInserted
Number of documents inserted
nUpserted
Number of documents upserted
nMatched
Number of documents matched for an update or replace operation.
nRemoved
Number of documents removed
nModified
Number of documents actually modified by an update operation. This is not necessarily the same as "nMatched" if the document was not actually modified as a result of the update.
This field is not available from legacy servers before version 2.6. If results are seen from a legacy server (or from a mongos proxying for a legacy server) this attribute will be undef
.
upserted
An array reference containing information about upserted documetns (if any). Each document will have the following fields:
index — 0-based index indicating which operation failed
_id — the object ID of the upserted document
writeErrors
An array reference containing write errors (if any). Each error document will have the following fields:
index — 0-based index indicating which operation failed
code — numeric error code
errmsg — textual error string
op — a representation of the actual operation sent to the server
writeConcernErrors
An array reference containing write concern errors (if any). Each error document will have the following fields:
index — 0-based index indicating which operation failed
code — numeric error code
op_count
The number of operations sent to the database.
batch_count
The number of database commands issued to the server. This will be less than the op_count
if multiple operations were grouped together.
METHODS
count_writeErrors
Returns the number of write errors
count_writeConcernErrors
Returns the number of write errors
last_errmsg
Returns the last errmsg
field from either the list of writeErrors
or writeConcernErrors
or the empty string if there are no errors.
AUTHORS
David Golden <david@mongodb.com>
Mike Friedman <friedo@friedo.com>
Kristina Chodorow <k.chodorow@gmail.com>
Florian Ragwitz <rafl@debian.org>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2015 by MongoDB, Inc..
This is free software, licensed under:
The Apache License, Version 2.0, January 2004