BulkWriteResult()
Nesta página
BulkWriteResult()
Um wrapper que contém os resultados do método
Bulk.execute()
.
Propriedades
BulkWriteResult()
tem as seguintes propriedades:
BulkWriteResult.nInserted
O número de documentos inseridos usando o método
Bulk.insert()
. Para documentos inseridos por meio de operações com a opçãoBulk.find.upsert()
, consulte o camponUpserted
.
BulkWriteResult.nMatched
O número de documentos existentes selecionados para atualização ou substituição. Se a operação de atualização/substituição não resultar em alterações em um documento existente, por exemplo, A expressão
$set
atualiza o valor para o valor atual,nMatched
pode ser maior quenModified
.
BulkWriteResult.nModified
O número de documentos existentes atualizados ou substituídos. Se a operação de atualização/substituição não resultar em alterações em um documento existente, como definir o valor do campo para seu valor atual,
nModified
poderá ser menor quenMatched
. Os documentos inseridos não afetam o número denModified
; consulte os camposnInserted
enUpserted
.
BulkWriteResult.nUpserted
O número de documentos inseridos por meio de operações com a opção
Bulk.find.upsert()
.
BulkWriteResult.upserted
Uma matriz de documentos que contém informações para cada documento inserido por meio de operações com a opção
Bulk.find.upsert()
.Cada documento contém as seguintes informações:
BulkWriteResult.writeErrors
Um array de documentos que contém informações sobre qualquer erro, não relacionado a preocupações de escrita, encontrado durante a operação de atualização. A array
writeErrors
contém um documento de erro para cada operação de escrita que apresenta erro.Cada documento de erro contém os seguintes campos:
BulkWriteResult.writeErrors.index
Um número inteiro que identifica a operação de gravação na lista de operações em massa, que utiliza um índice baseado em zero. Consulte também
Bulk.getOperations()
.
BulkWriteResult.writeErrors.op
Um documento que identifica a operação que falhou. Por exemplo, um erro de atualização/substituição da operação retorna um documento especificando a query, a atualização, o
multi
e as opçõesupsert
; uma operação de inserção retornará o documento que a operação tentou inserir.
BulkWriteResult.writeConcernError
Documento que descreve o erro relacionado ao write concern e contém o campo:
BulkWriteResult.writeConcernError.code
Um valor inteiro que identifica a causa do erro de write concern.
BulkWriteResult.writeConcernError.errInfo.writeConcern
Novidades na versão 4.4.
O objeto de write concern usado para a operação correspondente. Para obter informações sobre os campos de objeto de write concern, consulte Especificação de write concern.
O objeto de write concern também pode conter o seguinte campo, indicando a origem da write concern:
BulkWriteResult.writeConcernError.errInfo.writeConcern.provenance
Um valor de string que indica a origem do write concern (conhecido como write concern
provenance
). A tabela a seguir mostra os valores possíveis para este campo e sua significância:ProveniênciaDescriçãoclientSupplied
A preocupação de gravação foi especificada no aplicativo.customDefault
A preocupação de gravação originou-se de um valor padrão personalizado definido. ConsultesetDefaultRWConcern
.getLastErrorDefaults
A preocupação de gravação originada do camposettings.getLastErrorDefaults
do conjunto de réplicas.implicitDefault
A preocupação de gravação originou-se do servidor na ausência de todas as outras especificações de preocupação de gravação.