Mysql rise error

message_text — сообщение, которое вы хотите показать при ошибке. Замечание: вы можете добавлять пользовательские сообщения для вывода информации об ошибке. Смотрите следующий раздел статьи.
message_id — id сообщения об ошибке. Если вы хотите вывести пользовательское сообщение, вы можете определить этот идентификатор. Посмотрите список идентификаторов сообщений в sys.messages DMV.
Запрос:

select * from sys.messages

Вывод:

severity — серьезность ошибки. Тип данных переменной severity — smallint, значения находятся в диапазоне от 0 до 25. Допустимыми значениями серьезности ошибки являются:

• 0-10

— информационные сообщения

• 11-18

— ошибки

• 19-25

— фатальные ошибки

Замечание: Если вы создаете пользовательское сообщение, сложность, указанная в этом сообщении, будет перебиваться сложностью, заданной в операторе RAISERROR.
state — уникальное идентификационное число, которое может использоваться для раздела кода, вызывающего ошибку. Тип данных параметра state — smallint, и допустимые значения между 0 и 255.

Теперь давайте перейдем к практическим примерам.

Пример 1: использование оператора SQL Server RAISERROR для вывода сообщения

В этом примере вы можете увидеть, как можно отобразить ошибку или информационное сообщение с помощью оператора RAISERROR.

Предположим, что вы хотите отобразить сообщение после вставки записей в таблицу. Мы можем использовать операторы PRINT или RAISERROR. Ниже — код:

SET nocount ON 

INSERT INTO tblpatients 

            (patient_id, 

             patient_name, 

             address, 

             city) 

VALUES     ('OPD00006', 

            'Nimesh Upadhyay', 

            'AB-14, Ratnedeep Flats', 

            'Mehsana') 

RAISERROR ( 'Patient detail added successfully',1,1) 

Вывод:

Как видно на рисунке выше, ID сообщения равно 50000, поскольку это пользовательское сообщение.

Пример 2: оператор SQL RAISERROR с текстом динамического сообщения

Теперь посмотрите, как мы можем создать текст динамического сообщения для оператора SQL RAISERROR.

Предположим, что мы хотим напечатать в сообщении ID пациента. Я описал локальную переменную с именем @PatientID, которая содержит patient_id. Чтобы отобразить значение переменной @PatientID в тексте сообщения, мы можем использовать следующий код:

DECLARE @PatientID VARCHAR(15) 

DECLARE @message NVARCHAR(max) 

SET @PatientID='OPD00007' 

SET @message ='Patient detail added successfully. The OPDID is %s' 

INSERT INTO tblpatients 

            (patient_id, 

             patient_name, 

             address, 

             city) 

VALUES     ('' + @PatientID + '', 

            'Nimesh Upadhyay', 

            'AB-14, Ratnedeep Flats', 

            'Mehsana') 

RAISERROR ( @message,1,1,@patientID) 

Вывод:

Для отображения строки в операторе RAISERROR, мы должны использовать операторы print в стиле языка Си.

Как видно на изображении выше, для вывода параметра в тексте сообщения я использую опцию %s, которая отображает строковое значение параметра. Если вы хотите вывести целочисленный параметр, вы можете использовать опцию %d.

Использование SQL RAISERROR в блоке TRY..CATCH

В этом примере мы добавляем SQL RAISERROR в блок TRY. При запуске этого кода он выполняет связанный блок CATCH. В блоке CATCH мы будем выводить подробную информацию о возникшей ошибке.

BEGIN try 

    RAISERROR ('Error invoked in the TRY code block.',16,1 ); 

END try 

BEGIN catch 

    DECLARE @ErrorMsg NVARCHAR(4000); 

    DECLARE @ErrSeverity INT; 

    DECLARE @ErrState INT; 

    SELECT @ErrorMsg = Error_message(), 

           @ErrSeverity = Error_severity(), 

           @ErrState = Error_state(); 

    RAISERROR (@ErrorMsg,

               @ErrSeverity,

               @ErrState 

    ); 

END catch;

Так мы добавили оператор RAISERROR с ВАЖНОСТЬЮ МЕЖДУ 11 И 19. Это вызывает выполнение блока CATCH.

В блоке CATCH мы показываем информацию об исходной ошибке, используя оператор RAISERROR.
Вывод:

Как вы можете увидеть, код вернул информацию об исходной ошибке.

Теперь давайте разберемся, как добавить пользовательское сообщение, используя хранимую процедуру sp_addmessage.

Хранимая процедура sp_addmessage

Мы можем добавить пользовательское сообщение, выполнив хранимую процедуру sp_addmessages. Синтаксис процедуры:

EXEC Sp_addmessage 

  @msgnum= 70001, 

  @severity=16, 

  @msgtext='Please enter the numeric value', 

  @lang=NULL, 

  @with_log='TRUE', 

  @replace='Replace'; 

@msgnum: задает номер сообщения. Тип данных параметра — integer. Это ID пользовательского сообщения.
@severity: указывает уровень серьезности ошибки. Допустимые значения от 1 до 25. Тип данных параметра — smallint.
@messagetext: задает текст сообщения, который вы хотите выводить. Тип данных параметра nvarchar(255), значение по умолчанию NULL.
@lang: задает язык, который вы хотите использовать для вывода сообщения об ошибке. Значение по умолчанию NULL.
@with_log: этот параметр используется для записи сообщения в просмотрщик событий. Допустимые значения TRUE и FALSE. Если вы задаете TRUE, сообщение об ошибке будет записано в просмотрщик событий Windows. Если выбрать FALSE, ошибка не будет записана в журнал ошибок Windows.
@replace: если вы хотите заменить существующее сообщение об ошибке на пользовательское сообщение и уровень серьезности, вы можете указать это в хранимой процедуре.

Предположим, что вы хотите создать сообщение об ошибке, которое возвращает ошибку о недопустимом качестве (invalid quality). В операторе INSERT значение invalid_quality находится в диапазоне между 20 и 100. Сообщение следует рассматривать как ошибку с уровнем серьезности 16.

Чтобы создать такое сообщение, выполните следующий запрос:

USE master;

go 

EXEC Sp_addmessage 

  70001, 

  16, 

  N'Product Quantity must be between 20 and 100.'; 

go

После добавления сообщения выполните запрос ниже, чтобы увидеть его:

USE master 

go 

SELECT * FROM   sys.messages WHERE  message_id = 70001 

Вывод:

Как использовать пользовательские сообщения об ошибках

Как упоминалось выше, мы должны использовать message_id в операторе RAISERROR для пользовательских сообщений.

Мы создали сообщение с ID = 70001. Оператор RAISERROR должен быть таким:

USE master 

go 

RAISERROR (70001,16,1 ); 

go

Вывод:

Оператор RAISERROR вернул пользовательское сообщение.

Хранимая процедура sp_dropmessage

Хранимая процедура sp_dropmessage используется для удаления пользовательских сообщений. Синтаксис оператора:

EXEC Sp_dropmessage @msgnum

Здесь @msgnum задает ID сообщения, которое вы хотите удалить.

Теперь мы хотим удалить сообщение, с ID = 70001. Запрос:

EXEC Sp_dropmessage 70001

Выполним следующий запрос для просмотра сообщения после его удаления:

USE master 

go 

SELECT * FROM   sys.messages WHERE  message_id = 70001 

Вывод:

Как видно, сообщение было удалено.

Обработка исключений хранимых процедур MySQL

При использовании хранимых процедур MySQL мы часто сталкиваемся с некоторыми проблемами, в результате которых фактические результаты не достигаются в соответствии с логикой кода.В настоящее время необходимо фиксировать и распечатывать ошибки оператора SQL в хранимой процедуре.

Нужно знать концепции

• condition
• hanlder
• Область диагностики

1. Определить условие

DECLARE condition_name CONDITION FOR condition_value
condition_value:
mysql_error_code
| SQLSTATE [VALUE] sqlstate_value

Функция этого оператора состоит в том, чтобы связать ошибку, которую необходимо обработать, с именем, которое будет вызываться в следующем операторе объявления-обработчика. Фактически, он должен дать имя обрабатываемой ошибке, чтобы ее можно было вызвать позже.

Например: определить условие «таблица не содержит ошибок»

DECLARE no_such_table CONDITION FOR 1051;
DECLARE CONTINUE HANDLER FOR no_such_table
BEGIN
-- body of handler
END;

DECLARE no_such_table CONDITION FOR SQLSTATE '42S02';
DECLARE CONTINUE HANDLER FOR no_such_table
BEGIN
-- body of handler
END;

2.declare handler

    DECLARE handler_action HANDLER
    FOR condition_value [, condition_value] ...
    statement
    handler_action:
    CONTINUE
    | EXIT
    | UNDO
    condition_value:
    mysql_error_code
    | SQLSTATE [VALUE] sqlstate_value
    | condition_name
    | SQLWARNING
    | NOT FOUND
    | SQLEXCEPTION

Обработчик используется для обработки одного или нескольких условий.Если условие в операторе определения обработчика возникает, то выполняется оператор, определенный в обработчике.

Оператор обработчика объявления должен появляться после оператора условия объявления и оператора определения переменной.

Пример:

1. Используйте код ошибки для определения обработчика.

    DECLARE CONTINUE HANDLER FOR 1051
    BEGIN
    -- body of handler
    END;

2. Используйте значение sqlstate для определения обработчика.

    DECLARE CONTINUE HANDLER FOR SQLSTATE '42S02'
    BEGIN
    -- body of handler
    END;

3.SQLWARNING представляет значение sqlstate, начинающееся с 01

    DECLARE CONTINUE HANDLER FOR SQLWARNING
    BEGIN
    -- body of handler
    END;

4.NOT FOUND представляет значение sqlstate, начинающееся с 02

    DECLARE CONTINUE HANDLER FOR NOT FOUND
    BEGIN
    -- body of handler
    END;

5.SQLEXCEPTION представляет значение SQLstate, начинающееся с 00, 01, 02.

    DECLARE CONTINUE HANDLER FOR SQLEXCEPTION
    BEGIN
    -- body of handler
    END;

Одно замечание:
В хранимой процедуре, если условие определено, но обработчик не определен, в это время, если возникает ошибка, определенная в условии, MySQL обработает ее следующим образом, и метод обработки зависит от условия Виды.

Условие типа SQLEXCEPTION
Обработчик EXIT по умолчанию используется для обработки. Если хранимая процедура вызывается другой хранимой процедурой в это время, для обработки будет использоваться обработчик, определенный в вызывающей программе.

SQLWARNING условие типа
По умолчанию для обработки используется обработчик CONTINUE, и хранимая процедура продолжает выполняться.

Условие типа НЕ НАЙДЕНО
Если условие выполняется нормально, хранимая процедура выполняется нормально, если оно вызывается SIGNAL или RESIGNAL, хранимая процедура завершается.

нота:
Оператор объявления условия должен появиться перед объявлением курсора и объявлением обработчика

Взгляните на пример официального сайта:

mysql> CREATE TABLE test.t (s1 INT, PRIMARY KEY (s1));
Query OK, 0 rows affected (0.00 sec)
mysql> delimiter //
mysql> CREATE PROCEDURE handlerdemo ()
-> BEGIN
-> DECLARE CONTINUE HANDLER FOR SQLSTATE '23000' SET @x2 = 1;
-> SET @x = 1;
-> INSERT INTO test.t VALUES (1);
-> SET @x = 2;
-> INSERT INTO test.t VALUES (1);
-> SET @x = 3;
-> END;
-> //
Query OK, 0 rows affected (0.00 sec)
mysql> CALL handlerdemo()//
Query OK, 0 rows affected (0.00 sec)
mysql> SELECT @x//
+------+
| @x |
+------+
| 3 |
+------+
1 row in set (0.00 sec)

Если вы хотите, чтобы обработчик не выполнял никакой обработки захваченного условия, вы можете определить обработчик следующим образом:

DECLARE CONTINUE HANDLER FOR SQLWARNING BEGIN END;

Примечание два
Диапазон кода тега не включает диапазон кода обработчика объявления.

В этом примере область повторения тега — это область цикла повторения.
означает, что повторная попытка тега не может быть вызвана в обработчике

CREATE PROCEDURE p ()
BEGIN
DECLARE i INT DEFAULT 3;
retry:
    REPEAT
     BEGIN
        DECLARE CONTINUE HANDLER FOR SQLWARNING
         BEGIN
            ITERATE retry; # Это запрещено
         END;
        IF i < 0 THEN
         LEAVE retry; # Необходимо вызвать повторную попытку метки вне определения объявления
        END IF;
        SET i = i - 1;
    END;
    UNTIL FALSE END REPEAT;
END;

3. Область диагностики

Выполнение оператора SQL генерирует диагностическую информацию и сохраняет ее в области диагностики.
Используйте оператор GET DIAGNOSTICS, чтобы получить содержимое в области диагностики, которое не требует специальных разрешений.

Диагностика делится на текущую область диагностики и область диагностики стека. Содержимое текущей области диагностики получается с помощью ключевого слова CURRENT, а содержимое области диагностики стека получается с помощью STACKED. Область диагностики стека может использоваться только в том случае, если контекст является обработчиком состояния. Если ключевое слово не указано, информация по умолчанию будет получена из текущей области диагностики.

Получить данные в области диагностики на клиенте
DROP TABLE test.no_such_table;
GET DIAGNOSTICS CONDITION 1
@p1 = RETURNED_SQLSTATE, @p2 = MESSAGE_TEXT;
SELECT @p1, @p2;

В настоящее время нельзя использовать содержимое области диагностики стека GET STACKED DIAGNOSTICS.
, потому что GET STACKED DIAGNOSTICS можно использовать только в обработчике условий.

Сводка области диагностики содержит информацию двух типов:
1. Информация об утверждении, например количество условий и количество затронутых строк.
2. Информация об условиях, включая коды ошибок и сообщения об ошибках. Если оператор SQL выдает несколько условий, то в этой части области диагностики область условий будет выделена для каждого условия. Если Если условие не выбрано, оно не будет назначено

В стандарте SQL первое условие касается значения SQLstate, возвращаемого предыдущим оператором SQL.
Но в MySQL это не может быть гарантировано. Для получения основной ошибки нельзя использовать следующий метод:

GET DIAGNOSTICS CONDITION 1 @errno = MYSQL_ERRNO;

Вместо этого сначала получите номер условия, а затем используйте значение, чтобы указать условие для просмотра.
Правильный способ:

GET DIAGNOSTICS @cno = NUMBER;
GET DIAGNOSTICS CONDITION @cno @errno = MYSQL_ERRNO;

Что касается области диагностики, примеры официального сайта:

CREATE PROCEDURE do_insert(value INT)
BEGIN
-- Declare variables to hold diagnostics area information
DECLARE code CHAR(5) DEFAULT '00000';
DECLARE msg TEXT;
DECLARE rows INT;
DECLARE result TEXT;
-- Declare exception handler for failed insert
DECLARE CONTINUE HANDLER FOR SQLEXCEPTION
BEGIN
GET DIAGNOSTICS CONDITION 1
code = RETURNED_SQLSTATE, msg = MESSAGE_TEXT;
END;
-- Perform the insert
INSERT INTO t1 (int_col) VALUES(value);
-- Check whether the insert was successful
IF code = '00000' THEN
GET DIAGNOSTICS rows = ROW_COUNT;
SET result = CONCAT('insert succeeded, row count = ',rows);
ELSE
SET result = CONCAT('insert failed, error = ',code,', message = ',msg);
END IF;
-- Say what happened
SELECT result;
END;

Предполагая, что тип поля таблицы t1 в приведенной выше хранимой процедуре — int, а не null, выполните следующие операции для вставки ненулевых и нулевых значений в таблицу t1, соответственно, и получите следующие результаты:

# Вставить ненулевое значение
mysql> CALL do_insert(1);
+---------------------------------+
| result                          |
+---------------------------------+
| insert succeeded, row count = 1 |
+---------------------------------+

 ## Insert null
mysql> CALL do_insert(NULL);
+---- ------------------------------------------------------------+
| result                                                          |
+-----------------------------------------------------------------+insert failed, error = 23000, message = Column 'int_col' cannot be null
+-----------------------------------------------------------------+

Когда обработчик условий в хранимой процедуре активируется, произойдет событие, помещенное в стек в области диагностики:
1. Текущая область диагностики (первая область диагностики) станет областью диагностики стека (вторая область диагностики), а новая область диагностики будет создана как область текущей диагностики.
2. В обработчике условий GET [CURRENT] DIAGNOSTICS и GET STACKED DIAGNOSTICS могут использоваться для получения содержимого текущей области диагностики или области диагностики стека.
3. Вначале текущая область диагностики и область диагностики стека будут возвращать один и тот же результат, поэтому можно получить соответствующую информацию об активированном состоянии обработчика из текущей области диагностики, если В настоящее время в обработчике нет другого оператора SQL для изменения содержимого в текущей области диагностики.
4. При выполнении оператора в обработчике содержимое текущей области диагностики будет очищено или изменено в соответствии с определенными правилами.

Таким образом, более надежный способ получить информацию в активированном обработчике условий — получить соответствующую информацию из области диагностики стека, потому что содержимое области диагностики стека не будет изменяться операторами в обработчике условий, за исключением операторов RESIGNAL.

В следующем примере показано, как получить информацию об исключениях обработчика с помощью оператора GET STACKED DIAGNOSTICS в условии, даже если текущая область диагностики была очищена или изменена в это время.

DROP TABLE IF EXISTS t1;
CREATE TABLE t1 (c1 TEXT NOT NULL);

DROP PROCEDURE IF EXISTS p;

delimiter //
CREATE PROCEDURE p ()
BEGIN
-- Declare variables to hold diagnostics area information
    DECLARE errcount INT;
    DECLARE errno INT;
    DECLARE msg TEXT;
DECLARE EXIT HANDLER FOR SQLEXCEPTION
BEGIN
-- Here the current DA is nonempty because no prior statements
-- executing within the handler have cleared it
GET CURRENT DIAGNOSTICS CONDITION 1
errno = MYSQL_ERRNO, msg = MESSAGE_TEXT;
SELECT 'current DA before mapped insert' AS op, errno, msg;
GET STACKED DIAGNOSTICS CONDITION 1
errno = MYSQL_ERRNO, msg = MESSAGE_TEXT;
SELECT 'stacked DA before mapped insert' AS op, errno, msg;
-- Map attempted NULL insert to empty string insert
INSERT INTO t1 (c1) VALUES('');
-- Here the current DA should be empty (if the INSERT succeeded),
-- so check whether there are conditions before attempting to
-- obtain condition information
GET CURRENT DIAGNOSTICS errcount = NUMBER;
IF errcount = 0
THEN
SELECT 'mapped insert succeeded, current DA is empty' AS op;
ELSE
GET CURRENT DIAGNOSTICS CONDITION 1
errno = MYSQL_ERRNO, msg = MESSAGE_TEXT;
SELECT 'current DA after mapped insert' AS op, errno, msg;
END IF ;
GET STACKED DIAGNOSTICS CONDITION 1
errno = MYSQL_ERRNO, msg = MESSAGE_TEXT;
SELECT 'stacked DA after mapped insert' AS op, errno, msg;
END;
INSERT INTO t1 (c1) VALUES('string 1');
INSERT INTO t1 (c1) VALUES(NULL);
END;
//

delimiter ;

CALL p();

SELECT * FROM t1;

В вышеупомянутой хранимой процедуре определяется обработчик состояния. В начале этого обработчика получается содержимое текущей области диагностики и области диагностики стека, затем выполняется инструкция вставки, а затем запрашивается содержимое текущей области диагностики и области диагностики стека соответственно. . После завершения определения обработчика это основное тело хранимой процедуры, то есть два оператора вставки. Один из операторов вставки является ненулевой строкой, а другой вставкой — нулевым значением, поэтому последовательность выполнения хранимой процедуры выглядит следующим образом:

1. Сначала успешно выполните INSERT INTO t1 (c1) VALUES («строка 1»);
2. Выполните INSERT INTO t1 (c1) VALUES (NULL); поскольку вставлять нулевые значения в таблицу t1 запрещено, будет выдано исключение.
3. Сгенерированное исключение перехватывается обработчиком условия, и обработчик условия активируется для запуска логики обработки в нем и печати содержимого текущей области диагностики и области диагностики стека в обработчике условий, оба содержимого тот же самый.
4. Выполняется инструкция INSERT INTO t1 (c1) VALUES (’’); в обработчике условий, и выполнение инструкции очищает содержимое в текущей области диагностики.
±———————————±——±—————————+
| op | errno | msg |
±———————————±——±—————————+
| stacked DA before mapped insert | 1048 | Column ‘c1’ cannot be null |
±———————————±——±—————————+

5. Снова распечатайте содержимое области текущей диагностики и области диагностики стека в обработчике состояния. В это время, поскольку содержимое текущей области диагностики опустошено, напечатайте «сопоставленная вставка выполнена успешно, текущий DA пуст», а затем распечатайте содержимое области диагностики стека, потому что Содержимое в области диагностики стека не будет очищено при выполнении оператора, поэтому содержимое, отображаемое в области диагностики стека, остается:
±——————————-±——±—————————+
| op | errno | msg |
±——————————-±——±—————————+
| stacked DA after mapped insert | 1048 | Column ‘c1’ cannot be null |
±——————————-±——±—————————+

нужно знать
1. Оператор GET DIAGNOSTICS также очищает содержимое в текущей области диагностики, поэтому удалите оператор вставки в обработчике условия в приведенном выше коде, и результат будет таким же.

2. Если указанная выше хранимая процедура изменяется следующим образом, то есть оператор трех объявляемых переменных помещается в
В обработчике объявления фактический результат будет зависеть от версии MySQL. Если это версия до MySQL-5.7.2, следующие изменения не повлияют на содержимое области диагностики. Фактический результат такой же, как и результат выше.Если он находится в MySQL-5.7.2 и более поздних версиях, оператор объявления переменной очистит содержимое в текущей области диагностики.

CREATE PROCEDURE p ()
BEGIN
DECLARE EXIT HANDLER FOR SQLEXCEPTION
BEGIN
-- Declare variables to hold diagnostics area information
DECLARE errcount INT;
DECLARE errno INT;
DECLARE msg TEXT;
GET CURRENT DIAGNOSTICS CONDITION 1
errno = MYSQL_ERRNO, msg = MESSAGE_TEXT;
SELECT 'current DA before mapped insert' AS op, errno, msg;

GET STACKED DIAGNOSTICS CONDITION 1
errno = MYSQL_ERRNO, msg = MESSAGE_TEXT;
SELECT 'stacked DA before mapped insert' AS op, errno, msg;
...

Поэтому, когда вам нужно получить содержимое в области диагностики, вы должны получить его из области диагностики стека, а не из текущей области диагностики.