Exceção: Mongo::Error

Herda:
StandardError
  • Objeto
mostrar tudo
Inclui:
ChangeStreamResumable, Labelable, Notável, WriteRetryable
Definido em:
lib/mongo/error.rb,
lib/mongo/error/parser.rb,
lib/mongo/error/notable.rb,
lib/mongo/error/kms_error.rb,
lib/mongo/error/labelable.rb,
lib/mongo/error/auth_error.rb,
lib/mongo/error/lint_error.rb,
lib/mongo/error/pool_error.rb,
lib/mongo/error/crypt_error.rb,
lib/mongo/error/invalid_uri.rb,
lib/mongo/error/invalid_file.rb,
lib/mongo/error/socket_error.rb,
lib/mongo/error/client_closed.rb,
lib/mongo/error/closed_stream.rb,
lib/mongo/error/invalid_nonce.rb,
lib/mongo/error/max_bson_size.rb,
lib/mongo/error/session_ended.rb,
lib/mongo/error/timeout_error.rb,
lib/mongo/error/file_not_found.rb,
lib/mongo/error/no_srv_records.rb,
lib/mongo/error/handshake_error.rb,
lib/mongo/error/invalid_address.rb,
lib/mongo/error/invalid_session.rb,
lib/mongo/error/write_retryable.rb,
lib/mongo/error/bulk_write_error.rb,
lib/mongo/error/extra_file_chunk.rb,
lib/mongo/error/invalid_document.rb,
lib/mongo/error/max_message_size.rb,
lib/mongo/error/missing_password.rb,
lib/mongo/error/multi_index_drop.rb,
lib/mongo/error/unmet_dependency.rb,
lib/mongo/error/invalid_signature.rb,
lib/mongo/error/mismatched_domain.rb,
lib/mongo/error/operation_failure.rb,
lib/mongo/error/pool_closed_error.rb,
lib/mongo/error/pool_paused_error.rb,
lib/mongo/error/server_not_usable.rb,
lib/mongo/error/invalid_txt_record.rb,
lib/mongo/error/missing_connection.rb,
lib/mongo/error/missing_file_chunk.rb,
lib/mongo/error/missing_service_id.rb,
lib/mongo/error/pool_cleared_error.rb,
lib/mongo/error/unsupported_option.rb,
lib/mongo/error/connection_perished.rb,
lib/mongo/error/invalid_read_option.rb,
lib/mongo/error/need_primary_server.rb,
lib/mongo/error/no_server_available.rb,
lib/mongo/error/server_api_conflict.rb,
lib/mongo/error/unexpected_response.rb,
lib/mongo/error/invalid_read_concern.rb,
lib/mongo/error/missing_resume_token.rb,
lib/mongo/error/raise_original_error.rb,
lib/mongo/error/read_write_retryable.rb,
lib/mongo/error/sdam_error_detection.rb,
lib/mongo/error/server_timeout_error.rb,
lib/mongo/error/socket_timeout_error.rb,
lib/mongo/error/unknown_payload_type.rb,
lib/mongo/error/unsupported_features.rb,
lib/mongo/error/internal_driver_error.rb,
lib/mongo/error/invalid_config_option.rb,
lib/mongo/error/invalid_database_name.rb,
lib/mongo/error/invalid_file_revision.rb,
lib/mongo/error/invalid_min_pool_size.rb,
lib/mongo/error/invalid_write_concern.rb,
lib/mongo/error/unsupported_collation.rb,
lib/mongo/error/connection_unavailable.rb,
lib/mongo/error/credential_check_error.rb,
lib/mongo/error/invalid_bulk_operation.rb,
lib/mongo/error/invalid_max_connecting.rb,
lib/mongo/error/sessions_not_supported.rb,
lib/mongo/error/change_stream_resumable.rb,
lib/mongo/error/invalid_collection_name.rb,
lib/mongo/error/invalid_update_document.rb,
lib/mongo/error/mongocryptd_spawn_error.rb,
lib/mongo/error/unexpected_chunk_length.rb,
lib/mongo/error/bad_load_balancer_target.rb,
lib/mongo/error/invalid_application_name.rb,
lib/mongo/error/invalid_cursor_operation.rb,
lib/mongo/error/invalid_server_auth_host.rb,
lib/mongo/error/session_not_materialized.rb,
lib/mongo/error/unsupported_message_type.rb,
lib/mongo/error/invalid_server_preference.rb,
lib/mongo/error/unsupported_array_filters.rb,
lib/mongo/error/server_certificate_revoked.rb,
lib/mongo/error/transactions_not_supported.rb,
lib/mongo/error/invalid_bulk_operation_type.rb,
lib/mongo/error/connection_check_out_timeout.rb,
lib/mongo/error/insufficient_iteration_count.rb,
lib/mongo/error/invalid_replacement_document.rb,
lib/mongo/error/invalid_server_auth_response.rb,
lib/mongo/error/failed_string_prep_validation.rb,
lib/mongo/error/invalid_transaction_operation.rb,
lib/mongo/error/missing_scram_server_signature.rb,
lib/mongo/error/unchangeable_collection_option.rb,
lib/mongo/error/no_service_connection_available.rb,
lib/mongo/error/snapshot_session_invalid_server_version.rb,
lib/mongo/error/snapshot_session_transaction_prohibited.rb

Visão geral

Classe de erro base para todos os erros relacionados ao mongo .

Desde:

  • 2.0.0

Definido sob namespace

Módulos: ChangeStreamResumable, Labelable, Notable, ReadWriteRetryable, SdamErrorDetection, WriteRetryable Classes: AuthError, BadLoadBalancerTarget, BulkWriteError, ClientClosed, ClosedStream, ConnectionCheckOutTimeout, ConnectionPerished, ConnectionUnavailable, CredentialCheckError, CryptError, ExtraFileChunk, FailedStringPrepValidation, FileNotFound, HandshakeError, InsufficientIterationCount, InternalDriverError, InvalidAddress, InvalidApplicationName, InvalidBulkOperation , InvalidBulkOperationType, InvalidCollectionName, InvalidConfigOption, InvalidCursorOperation, InvalidDatabaseName, InvalidDocument, InvalidFile, InvalidFileRevision, InvalidMaxConnecting, InvalidMinPoolSize, InvalidNonce, InvalidReadConcern, InvalidReadOption, InvalidReplacementDocument, InvalidServerAuthHost, InvalidServerAuthResponse, InvalidServerPreference, InvalidSession, InvalidSignature, InvalidTXTRecord, InvalidTransactionOperation, InvalidURI, InvalidUpdateDocument, InvalidWriteConcern, KmsError , LintError, MaxB SONSize, MaxMessageSize, MismatchedDomain, MissingConnection, MissingFileChunk, MissingPassword, MissingResumeToken, MissingScramServerSignature, MissingServiceId, MongocryptdSpawnError, MultiIndexDrop, NeedPrimaryServer, NoSRVRecords, NoServerAvailable, NoServiceConnectionAvailable, OperationFailure, Parser, PoolClearedError, PoolClosedError, PoolError, PoolPausedError, RaiseOriginalError, ServerApiConflict, ServerCertificateRevoked, ServerNotUsable, ServerTimeoutError, SessionEnded, SessionNotMaterialized, SessionsNotSupported, SnapshotSessionInvalidServerVersion, SnapshotSessionTransactionProhibited, SocketError, SocketTimeoutError, TimeoutError, TransactionsNotSupported, UnchangeableCollectionOption, UnexpectedChunkLength, UnexpectedResponse, UnknownPayloadType, UnmetDependency, UnsupportedArrayFilters, UnsupportedCollation, UnsupportedFeatures, UnsupportedMessageType, UnsupportedOption

Colapsode resumo constante

COD =

O campo de código de erro.

Desde:

  • 2.0.0

'código'
ERRMSG =
Obsoleto.

O campo de mensagem de erro padrão

Desde:

  • 2.0.0

'errmsg'
WRITE_ERRORS =
Obsoleto.

A constante da array writeErrors.

Desde:

  • 2.0.0

'writeErrors'
WRITE_CONCERN_ERROR =
Obsoleto.

A constante para um erro de preocupação de gravação .

Desde:

  • 2.0.0

'WriteConcernError'
WRITE_CONCERN_ERRORS =
Obsoleto.

A constante para erros de write concern.

Desde:

  • 2.1.0

'Erros de preocupação de gravação'
UNKNOWN_ERROR =

Constante para um erro desconhecido.

Desde:

  • 2.0.0

8
BAD_VALUE =

Constante para um erro de valor incorreto.

Desde:

  • 2.0.0

2
CURSOR_NOT_FOUND =

Constante para um erro de cursor não encontrado.

Desde:

  • 2.2.3

'Cursor não encontrado.'
UNKNOWN_TRANSACTION_COMMIT_RESULT_LAbel =
Obsoleto.

Etiqueta de erro descrevendo erros de commitTransaction que podem ou não ocorrer novamente se um commit for manualmente repetido pelo usuário.

Desde:

  • 2.6.0

'UnknownTransactionCommitResult'
TRANSIENT_TRANSACTION_ERROR_LABEL =
Obsoleto.

Etiqueta de erro que descreve erros que provavelmente não ocorrerão se uma transação for repetida manualmente desde o início.

Desde:

  • 2.6.0

'TransientTransactionError'

Resumo do atributo de instância

Atributos incluídos de Notável

#connection_global_id, # generação, #service_id

Recolhimento do Resumo do método de instância

Métodos incluídos do WriteRetryable

#write_retryable?

Métodos incluídos do Labelable

#add_label, #label?, #labels

Métodos incluídos do Notable

#add_note, #add_notes, #notes, #to_s

Detalhes do construtor

#initialize(msg = nil) ➤ Erro

Retorna uma nova instância de Error.

Desde:

  • 2.0.0



99
100
101
102
# Arquivo 'lib/mongo/error.rb', linha 99

def inicializar(mensagem = nada)
  super
  @write_concern_error_labels = []
end

Detalhes do método de instância

#change_stream_resumable?true, false

O change stream no qual ocorreu esse erro pode ser retomado, desde que a operação que acionou esse erro tenha sido um getMore?

Exemplos:

O erro é retomável para o fluxo de alterações?

error.change_stream_resumable?

Retorna:

  • (verdadeiro, falso)

    Se o erro é retomável.

Desde:

  • 2.6.0



81
82
83
# Arquivo 'lib/mongo/error.rb', linha 81

def change_stream_resumable?
  false
end

#network_error?true, false

Retorna se este erro foi causado por um erro de rede.

Retorna:

  • (verdadeiro, falso)

    se este erro foi causado por um erro de rede.

Desde:

  • 2.0.0



28
29
30
# File 'lib/mongo/error/kms_error.rb', linha 28

def network_error?
  @network_error == true
end

#write_concern_error_label?(label) ➤ Booleano

O erro de write concern tem o rótulo fornecido?

Parâmetros:

  • etiqueta (string)

    O rótulo para verificar a presença.

Retorna:

  • (Booleano)

    Se o erro de preocupação de gravação tem o rótulo fornecido.

Desde:

  • 2.0.0



109
110
111
# Arquivo 'lib/mongo/error.rb', linha 109

def write_concern_error_label?(etiqueta)
  @write_concern_error_labels.incluir?(etiqueta)
end

#write_concern_error_labels ➤ Array<String>

O conjunto de rótulos de erro associados ao erro de preocupação de gravação .

Retorna:

  • (Array<String>)

    A lista de rótulos de erro.

Desde:

  • 2.0.0



116
117
118
# Arquivo 'lib/mongo/error.rb', linha 116

def write_concern_error_labels
  @write_concern_error_labels.dup
end