WriteResult()
Nesta página
Definição
WriteResult()
Um wrapper que contém o status do resultado dos métodos de escrita
mongosh
.Observação
db.collection.insert()
edb.collection.update()
estão obsoletos.Os resultados retornados pelos métodos de substituição têm um formato diferente. Para uma saída semelhante a
WriteResult()
, considere usardb.collection.bulkWrite()
.
Propriedades
O WriteResult()
tem as seguintes propriedades:
WriteResult.nInserted
O número de documentos inseridos, excluindo os documentos
upserted
. ConsulteWriteResult.nUpserted
para saber o número de documentos inseridos por meio de um upsert.
WriteResult.nMatched
O número de documentos selecionados para atualização. Se a operação de atualização não resultar em alterações no documento, por exemplo, a expressão
$set
atualiza o valor para o valor atual,nMatched
pode ser maior quenModified
.
WriteResult.nModified
O número de documentos existentes atualizados. Se a operação de atualização/substituição não resultar em nenhuma alteração no documento, como a definição do valor do campo para seu valor atual,
nModified
poderá ser menor quenMatched
.
WriteResult.nUpserted
O número de documentos inseridos por upsert.
WriteResult._id
O
_id
do documento inserido porupsert
. Retornado somente se umupsert
resultar em uma inserção.
WriteResult.writeError
Um documento que contém informações sobre qualquer erro, exceto erros de write concern, encontrado durante a operação de escrita.
WriteResult.writeError.errInfo
Um documento que contém informações sobre qualquer erro de escrita, exceto erros de preocupação de gravação , que foram encontrados durante a operação de escrita. Quando uma operação falha na validação do documento , o servidor produz um erro nesse campo explicando por que o documento não correspondeu à expressão validador da coleção.
WriteResult.writeConcernError
Documento descrevendo erros relacionados à preocupação de gravação.
Alterado na versão 7.1: Quando
WriteResult()
é recebido demongos
, os erros de preocupação de gravação são sempre relatados, mesmo quando ocorrem um ou mais erros de escrita.Em versões anteriores, a ocorrência de erros de gravação poderia fazer com que
WriteResult()
não relatasse erros de preocupação de gravação .WriteResult.writeConcernError.errInfo.writeConcern
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:
WriteResult.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.