Розширення обробки винятків зібраною діагностикою

Транзакції та обробка помилок у PostgreSQL

Jason Myers

Principal Engineer

Збирання більшої інформації про помилки

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';

Використання зібраної діагностики

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$$;

Зразок діагностичного виводу

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).

Що саме можна отримати?

Name	Description
RETURNED_SQLSTATE	код помилки SQLSTATE для винятку
COLUMN_NAME	назва стовпця, пов'язаного з винятком
CONSTRAINT_NAME	назва обмеження, пов'язаного з винятком
MESSAGE_TEXT	текст основного повідомлення винятку
PG_EXCEPTION_DETAIL	текст детального повідомлення винятку, якщо є

¹ https://www.postgresql.org/docs/12/plpgsql-control-structures.html

Більше діагностичних даних

Name	Description
PG_DATATYPE_NAME	назва типу даних, пов'язаного з винятком
TABLE_NAME	назва таблиці, пов'язаної з винятком
SCHEMA_NAME	назва схеми, пов'язаної з винятком
PG_EXCEPTION_HINT	текст підказки щодо винятку, якщо є
PG_EXCEPTION_CONTEXT	рядки тексту стеку викликів на момент винятку

Давайте потренуємось!

Транзакції та обробка помилок у PostgreSQL