Skip to content

DbError ​

DbError é o tipo estruturado de erro para falhas recuperáveis de banco de dados.

Assinaturainterface DbError { readonly code: string; readonly message: string }

Campos ​

CampoTipoFinalidade
codestringIdentificador estável para tratamento programático, como ERR_DB_QUERY_FAILED.
messagestringExplicação legível da falha.

Operações de banco retornam Promise<Result<T, DbError>>. Aguarde cada chamada para receber o Result e então trate falhas com onfail, ? ou pattern matching. A API tyrus:db não usa throws.

Códigos em runtime ​

CódigoSignificado
ERR_DB_CONNECTION_FAILEDNão foi possível conectar ao backend de banco configurado.
ERR_DB_CONNECTION_TIMEOUTA tentativa de conexão PostgreSQL, MySQL ou MongoDB excedeu connectTimeoutMs.
ERR_DB_POOL_TIMEOUTO pool PostgreSQL ou MySQL não forneceu uma conexão, ou o runtime MongoDB não liberou uma vaga de operação, antes de acquireTimeoutMs.
ERR_DB_QUERY_TIMEOUTUma operação PostgreSQL, MySQL ou MongoDB excedeu queryTimeoutMs.
ERR_DB_BUSYA fila limitada do worker de banco já contém 128 solicitações pendentes.
ERR_DB_CONNECTION_CONFIGURATIONA variável de ambiente indicada por database.connectionEnv está ausente.
ERR_DB_INVALID_CONFIGURATIONO destino de banco em runtime está malformado ou não corresponde a uma configuração suportada.
ERR_DB_INVALID_CONNECTIONA variável de conexão não contém uma URL ou URI válida para o backend configurado. O valor da conexão nunca é incluído na mensagem de erro.
ERR_DB_TLS_CONFIGURATIONUm arquivo TLS configurado para o banco conflita com a URL de conexão ou não permite verificar o certificado e o hostname.
ERR_DB_BACKEND_UNAVAILABLEO backend configurado ainda não tem driver de runtime nesta build.
ERR_DB_INVALID_SQLNão foi possível preparar o SQL para o backend configurado.
ERR_DB_FEATURE_UNSUPPORTEDO backend configurado não oferece suporte ao recurso de banco solicitado.
ERR_DB_SQLITE_BUSYSQLite não obteve o bloqueio necessário antes do timeout.
ERR_DB_SQLITE_CONSTRAINTUma restrição do banco recusou a alteração.
ERR_DB_EXECUTE_FAILEDO backend de banco configurado recusou ou não conseguiu executar o comando.
ERR_DB_INVALID_PARAMETERSOs parâmetros não puderam ser codificados como valores suportados.
ERR_DB_PARAMETER_LIMITUma instrução tentou vincular mais de 999 parâmetros.
ERR_DB_DECODE_FAILEDO banco retornou um valor que não pôde ser decodificado para um tipo suportado.
ERR_DB_VALUE_OUT_OF_RANGEUm valor não pôde ser representado pelo tipo de banco de destino.
ERR_DB_DOCUMENT_TOO_LARGEUm documento BSON ou filtro MongoDB serializado excede 16 MiB.
ERR_DB_VALUE_TOO_DEEPUm valor estruturado MongoDB excede 100 níveis de aninhamento.
ERR_DB_INVALID_TEMPORAL_VALUEUm Instant MongoDB tem campos seconds ou nanoseconds inválidos.
ERR_DB_INVALID_MODEL_VALUEUm valor de Model do MongoDB omite um campo obrigatório ou não corresponde ao tipo declarado.