BulkWriteResult()

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Propriedades

O 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 atualiza o valor para o valor atual, nMatched pode 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 gravação foi especificada no aplicativo.
customDefault	A preocupação de gravação originou-se de um valor padrão personalizado definido. Consulte setDefaultRWConcern.
getLastErrorDefaults	A preocupação de gravação 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.