BulkWriteResult() (método mongosh)

Compatibilidade

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

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

• 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 versão 7.0.6:

(also available in 6.0.14 and 5.0.30): When BulkWriteResult() is received from mongos, write concern errors are always reported, even when one or more write errors occur. In previous releases, the occurrence of write errors could cause the BulkWriteResult() to not report write concern errors.

Os documentos writeConcernError 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 write concern 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 write concern originou-se do servidor na ausência de todas as outras especificações de write concern.