Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

BulkWriteResult()

Nesta página

  • Propriedades
  • Exceção writeErrors
  • Exceção writeConcernError
BulkWriteResult()

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

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(...) }`

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.

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.1: Quando BulkWriteResult() é recebido de mongos, 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 pode fazer com que o BulkWriteResult() não relate erros de preocupação de gravação .

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

Voltar

BSONRegExp