Tratamento de erros de operação

Visão geral

Esta página descreve os erros que você pode encontrar ao usar o MongoDB Rust Driver para executar operações do MongoDB. Depois de entender os tipos de erros de operação que o driver gera, você pode tomar a ação apropriada para gerenciá-los ou corrigir o código que causa o erro.

Tipo de erro

Se o driver encontrar um erro ao executar uma operação, ele retornará um erro do tipo Erro.

O tipo Error contém o campo kind , que descreve o tipo de erro que ocorreu. O kind campo tem um valor de enum ErrorKind. O enum ErrorKind tem variantes para diferentes tipos de erros, incluindo os seguintes:

• InvalidArgument: você forneceu um argumento inválido para um método

• Authentication: o driver encontrou um erro durante a autenticação

• ServerSelection: o cliente não conseguiu selecionar um servidor para a operação

• Write: ocorreu um erro durante uma operação de escrita

• Transaction: ocorreu um erro durante uma transação

Por exemplo, se você tentar executar uma operação de inserção que duplica um valor de campo _id que já está na collection, o driver retornará uma instância Error e imprimirá a seguinte mensagem de erro:

Error: Error { kind: Write(WriteError(WriteError { code: 11000,
code_name: None, message: "E11000 duplicate key error collection:
db.test_coll index: _id_ dup key: { _id: 1 }", details: None })), labels:
{}, wire_version: None, source: None }

Na mensagem de erro anterior, o valor do campo kind é Write. Para saber mais sobre esse tipo de erro, consulte a seção Tipos de erro de gravação deste guia.

Erros de conexão

Um erro de operação simultânea pode limpar o pool de conexões, interrompendo sua conexão com o servidor. Nessa situação, o driver gera um tipo Error no qual o valor do campo kind é ConnectionPoolCleared. A mensagem de erro descreve o motivo da falha da operação simultânea.

Para saber como ajustar seu pool de conexões para resolver esse erro, consulte Tuting Your Connection Pool Settings no manual do Servidor MongoDB.

Dependendo das circunstâncias que produzem o erro, o driver pode adicionar um rótulo RetryableWriteError ao erro, conforme mostrado na seguinte mensagem de erro:

Error { kind: ConnectionPoolCleared { message: "Connection pool for
localhost:27017 cleared because another operation failed with: Kind:
I/O error: timed out, labels: {}" }, labels: {"RetryableWriteError"},
wire_version: None, source: None }

Essa etiqueta indica que o erro pode ser gravado novamente, o que significa que o driver faz uma tentativa de repetição.

Tipos de erro de gravação

Quando o driver experimenta um erro ao executar uma operação de gravação, ele gera uma instância Error com um valor de campo kind de Write. O corpo da Write variante é o enum WriteFailure, que recebe um valor do tipo WriteError ou WriteConcernError.

Error: Error { kind: Write(WriteError(WriteError { code: 121, code_name:
None, message: "Document failed validation", details:
Some(Document({"failingDocumentId": Int32(1), "details":
Document({"operatorName": String("$jsonSchema"), "title":
String("Numerical Validation"), "schemaRulesNotSatisfied":
Array(...)})})) })), labels: {},
wire_version: None, source: None }