Aprimorando o tratamento de exceções com diagnósticos empilhados
Transações e Tratamento de Erros no PostgreSQL
Jason Myers
Principal Engineer
Capturando mais informações do erro
DO $$
BEGIN
UPDATE inventory SET cost = 35.0 WHERE name = 'Macaron';
UPDATE inventory SET cost = 3.50 WHERE name = 'Panellets';
EXCEPTION
WHEN others THEN
INSERT INTO errors (msg) VALUES ('Max cost is 10!');
RAISE INFO 'Max cost is 10!';
END;
$$ language 'plpgsql';
Usando diagnósticos empilhados
DO $$ DECLARE exc_message text; exc_detail text;BEGIN UPDATE inventory SET cost = 35.0 WHERE name = 'Macaron'; UPDATE inventory SET cost = 3.50 WHERE name = 'Panellets';EXCEPTION WHEN others THEN GET STACKED DIAGNOSTICS exc_message = MESSAGE_TEXT, exc_detail = PG_EXCEPTION_DETAIL; INSERT INTO errors (msg, detail) VALUES (exc_message, exc_detail); RAISE INFO 'Exception Messaage: % | Exception Details: %', exc_message, exc_detail; END$$;
Exemplo de saída de diagnóstico
INFO: Exception Messaage: new row for relation "inventory" violates check constraint
"cost_check" | Exception Details: Failing row contains (7, 35, Macaron).
DO
postgres=# \x on
Expanded display is on.
postgres=# select msg, detail from errors;
-[ RECORD 1 ]-------------------------------------------------------------------
msg | new row for relation "inventory" violates check constraint "cost_check"
detail | Failing row contains (7, 35, Macaron).
O que mais dá para obter?
| Name | Description |
|---|---|
| RETURNED_SQLSTATE | o código SQLSTATE do erro da exceção |
| COLUMN_NAME | o nome da coluna relacionada à exceção |
| CONSTRAINT_NAME | o nome da restrição relacionada à exceção |
| MESSAGE_TEXT | o texto da mensagem principal da exceção |
| PG_EXCEPTION_DETAIL | o texto da mensagem de detalhes da exceção, se houver |
1 https://www.postgresql.org/docs/12/plpgsql-control-structures.html
Mais pontos de diagnóstico
| Name | Description |
|---|---|
| PG_DATATYPE_NAME | o nome do tipo de dado relacionado à exceção |
| TABLE_NAME | o nome da tabela relacionada à exceção |
| SCHEMA_NAME | o nome do schema relacionado à exceção |
| PG_EXCEPTION_HINT | o texto da mensagem de dica da exceção, se houver |
| PG_EXCEPTION_CONTEXT | linha(s) do stack de chamadas no momento da exceção |
Vamos praticar!
Transações e Tratamento de Erros no PostgreSQL
