Class: Mongo::Error::BulkWriteError

Inherits:
Error
  • Object
show all
Defined in:
lib/mongo/error/bulk_write_error.rb

Overview

Note:

A bulk operation that resulted in a BulkWriteError may have written some of the documents to the database. If the bulk write was unordered, writes may have also continued past the write that produced a BulkWriteError.

Exception raised if there are write errors upon executing a bulk operation.

Unlike OperationFailure, BulkWriteError does not currently expose individual error components (such as the error code). The result document (which can be obtained using the result attribute) provides detailed error information and can be examined by the application if desired.

Since:

  • 2.0.0

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(result, server_addresses: nil) ⇒ BulkWriteError

Instantiate the new exception.

Examples:

Instantiate the exception.

Mongo::Error::BulkWriteError.new(response)

Parameters:

  • result (Hash) —

    A processed response from the server reporting results of the operation.

  • server_addresses (Array<String | Mongo::Address | Mongo::Server::Description>) (defaults to: nil) —

    Addresses of the servers that produced this error. Entries are normalized to "host:port" strings.

Since:

  • 2.0.0



54
55
56
57
58
59
60
61
62
 
# File 'lib/mongo/error/bulk_write_error.rb', line 54

def initialize(result, server_addresses: nil)
  @result = result
  @server_addresses = normalize_server_addresses(server_addresses)

  # Exception constructor behaves differently for a nil argument and
  # for no argument. Avoid passing nil explicitly.
  message = build_message
  message ? super(message) : super()
end

Instance Attribute Details

#result ⇒ BSON::Document (readonly)

Returns result The error result.

Returns:

  • (BSON::Document) —

    result The error result.

Since:

  • 2.0.0



35
36
37
 
# File 'lib/mongo/error/bulk_write_error.rb', line 35

def result
  @result
end

#server_addresses ⇒ Array<String> (readonly)

Returns Deduplicated list of "host:port" addresses of the servers that produced this bulk write error. Empty when no addresses were supplied.

Returns:

  • (Array<String>) —

    Deduplicated list of "host:port" addresses of the servers that produced this bulk write error. Empty when no addresses were supplied.

Since:

  • 2.0.0



40
41
42
 
# File 'lib/mongo/error/bulk_write_error.rb', line 40

def server_addresses
  @server_addresses
end