Menu Docs

Página inicial do DocsDesenvolver aplicaçõesManual do MongoDB

BulkWriteResult()

Nesta página

  • Propriedades
BulkWriteResult()

Um encapsulador que contém os resultados do método Bulk.execute().

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ção Bulk.find.upsert() , consulte o campo nUpserted .

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 atualizará o valor para o valor atual, nMatched poderá ser maior que nModified.

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 que nMatched. Os documentos inseridos não afetam o número de nModified; consulte os campos nInserted e nUpserted .

BulkWriteResult.nRemoved

O número de documentos removidos.

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.upserted.index

Um número inteiro que identifica a operação na lista de operações em massa, que utiliza um índice baseado em zero.

BulkWriteResult.upserted._id

O valor _id do documento inserido.

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.code

Um valor inteiro identificando o erro.

BulkWriteResult.writeErrors.errmsg

Uma descrição do erro.

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ções upsert ; 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.errmsg

Uma descrição da 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ência
Descrição
clientSupplied
A preocupação de escrita foi especificada no aplicativo.
customDefault
A write concern originou-se de um valor padrão personalizado definido. Consulte setDefaultRWConcern.
getLastErrorDefaults
A write concern originada do campo settings.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.
← BinData()

Nesta página