BulkWriteResult() (método mongosh)

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

BulkWriteResult tem as seguintes propriedades:

BulkWriteResult.acknowledged

Booleano que indica se a escrita em massa foi ou não reconhecida.

BulkWriteResult.deletedCount

Contagem de documentos excluídos.

BulkWriteResult.insertedCount

Contagem de documentos inseridos.

BulkWriteResult.insertedIds

mongosh Versão	Descrição	Exemplo
v1.x	Array de documentos inseridos por ObjectId.	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	Mapeamento de cada índice de documento inserido para seu ObjectId.	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

BulkWriteResult.matchedCount

Contagem de documentos correspondentes.

BulkWriteResult.modifiedCount

Contagem de documentos modificados.

BulkWriteResult.upsertedCount

Contagem de documentos atualizados.

BulkWriteResult.upsertedIds

mongosh Versão	Descrição	Exemplo
v1.x	Array de documentos upserted ObjectId.	[ ObjectId(...), ObjectId(...), ObjectId(...) ]
v2.x	Mapeamento de cada índice de documento upserted para seu ObjectId.	{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

Exceção writeErrors

Se houver um erro de escrita durante o processamento da escrita em massa, mongosh gerará uma exceção que contém uma propriedade writeErrors com os seguintes campos:

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

writeErrors.index

Inteiro que identifica a operação de escrita na lista de operações em massa, que utiliza um índice baseado em zero. Consulte também Bulk.getOperations().

writeErrors.code

Valor inteiro que identifica o erro.

writeErrors.errmsg

Descrição do erro.

writeErrors.op

Um documento que identifica a operação que falhou. Por exemplo, um erro de atualização ou substituição da operação retorna um documento especificando a query, a atualização, o multi e as opções de upsert. Uma operação de inserção retorna o documento que a operação tentou inserir.

Exceção writeConcernError

Se houver um erro de write concern durante o processamento da escrita em massa, mongosh gerará uma exceção que contém uma propriedade writeConcernError com os seguintes campos:

writeConcernError

Documento descrevendo erros relacionados à preocupação de gravação.

Alterado na 7.0.6 versão: (também disponível em 6.0.14 e 5.0.30): Quando é BulkWriteResult() mongos recebido de , 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 BulkWriteResult() não relatasse erros de preocupação de gravação .

Cada documento de erro contém os seguintes campos:

writeConcernError.code

Valor inteiro que identifica a causa do erro da write concern.

writeConcernError.errmsg

Descrição da causa do erro da write concern.

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:

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.