Инструкцията SQL RAISERROR се използва за изпращане на персонализирано съобщение до клиентското приложение. Може също да се използва за отстраняване на грешки в приложението и се прилага към механизма за обработка на грешки.
Синтаксис и параметри на изявление за SQL RAISERROR
Синтаксисът на SQL израза RAISERROR е следният:
RAISERROR ( { message_text | message_id | @local_variable }
{ ,severity ,state }
[ ,argument [ ,...n ] ]
[ WITH option [ ,...n ] ];
По-долу можете да видите обяснението на параметрите на ключовата дума RAISERROR, които можете да посочите:
текст_съобщение – съобщението, което искате да изведете за грешка. Забележка: Можем да добавим персонализирани съобщения, за да покажем информацията за грешката. Вижте го обяснено във втория раздел на статията.
идентификатор_съобщение – идентификаторът на съобщението за грешка. Ако искате да покажете дефинираното от потребителя съобщение, трябва да го дефинирате. Вижте списъка с message_ids в sys.messages DMV .
Запитване
select * from sys.messages
Изходът:
![](https://lh3.googleusercontent.com/hqU8MVMoGbTNU6UfLpl7Zl5RnipJepBcPtv7UvGAx5ReyEMpwy46Rir2uh6lNOvuWp7EwKYvivimxJyZppRY2Pvlb-YdFQ6pLxH00OPKMLtnTDkMT93sqmm4D9d1w67XbCRiYFB-mZpLqtenQZMni97_XBo8dPzxE3oFwuN5GRoigFxUjSMEo1IAK2Kmtw_LW4CMRg2gcpS6sbIyIU5wBUBn7Q0d8QHVcneQjcCTytq5pWICfZgsCSegy2ofOWpplif9vZvDJC5UXlmqkRD0djDo2mbh-zicuMcySPi5d-RgbdNU-1wQ0VfhqTFgZQPXXJXV122B-qpRSkUSGiokX9bellZuUq7xI0FqkoRwKiZIcCzCMinX3BjCdsIjdlxjtXEM_lMnP74f1Q4vUgGqYjWWaDL6CcGoJI45eLxhmmEPM78PxoE14BGl3tZgv0_gcw1vLnnOQIarUKD_zM-y6FVZ-WdrJOE8_L0hCKWkj2eY8ukSMMlprqSmehT8RcLT9VtHB8PaozMueDuMqQw9veg9qcHdbzuAA7QTlTKMsM82SK-o8kOwpvkzFFkwqpbV2gcxwZkEcT-1Q3xgBVh6z21y6LzDniWrx87Suy3wKUOv_kh8HfwIU61qqaJJwA1mFY2CEnjPo18-45Ri2q8fXRuSAfUBfATpc_H3BOw1wmYhVY8MLKa1z-JQV14L6bL2qrFzAeMkXmDrniTe5_ktXNs=w1097-h521-no?authuser=0.a1b2c3d4.jpg)
тежест – сериозността на грешката. Типът данни на тежостта променлива емалък и стойностите са между 0 и 25. Валидни стойности за сериозност на грешката са както следва:
- 0-10 – информационни съобщения
- 11-18 – грешки
- 19-25 – фатални грешки
Забележка : Ако създадете дефинирано от потребителя съобщение, сериозността, посочена в дефинираното от потребителя съобщение, ще бъде отменена от сериозността, посочена в израза RAISERROR.
състояние – уникалният идентификационен номер, който можете да използвате, за да идентифицирате кодовата секция, която причинява грешката. Типът данни на параметъра на състоянието емалък и стойностите са между 0 и 255.
Сега да преминем към практическите примери.
Пример 1:Използвайте SQL Server RAISERROR изявление за отпечатване на изхода
В този пример можете да видите как можем да покажем съобщението за грешка или информация с помощта на оператора RAISERROR.
Да предположим, че искате да покажете съобщението след вмъкване на записи в таблицата. Можем да използваме SQL оператори 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)
Изходът:
![](https://lh3.googleusercontent.com/j0HiyuAbGCQeIibFui4QAgNG3vIzD-XwuEJgvim8_0jgu5Zvj02WkBtWDCyvO5T_4-N3TlF1jNKH-BzLRxdZSRF91CaODC9yL48__tV3phMOTxgOfhnkAmy7tN5PiERfeX3Z3NbOLDjnOq6qZ_pbZe8Rd_tb5GKzqeUfAzTNKmf8qceyDVLwADBUPeXfwuhmbmdhfhmxi31uG-rXLbTYZjqEQ9gBewYKw7hjgbppPUT9idA8i2svrxjAJotTgNfjnz38qA4F9zEvOg4PAAnovQ3Rct44aGtD9h9PDwWn5FL7GC0HBQZxOKpCxFRkxEnGTuLKAaDzimpndJu-umsG0otcmO85AyShOHd5Ygs0v6wRg0qZ1ELdDPoZwtZAFGDrL681HFvjUlDprYb1bnYR36xmPXBsBQ1Rvx_XjCLcslK6P7ziLOr0xwsH1G9yliyghpBlv8n6vPIWTyOZ04gGS3mssmH_YVn45GX_9DcP1vOSLSx59F4eccALM0hGXyrdNAg8ULM4lALXdIltQI816bdXlmDfOgY14yvOw7S2xikGKPnqaneMknUNAWKG3QbD1GOB8MqbWo0z0d19TKHxO4oiuB8WhpGmJGbhKaKpRJiZ7DTY_Oz09ZNH7C9pYHYYd2wTPVa2FNmEasEM2FqjkVEPBCUYiKK9Cg7t5uRsnGQZtfp0m0c7QmhMwQDT4MVI3ikpeR1OzC9Bf1NCq5ydf20=w994-h221-no?authuser=0.a1b2c3d4.jpg)
Както можете да видите на изображението по-горе, идентификационният номер на съобщението е 50000, тъй като е съобщение, дефинирано от потребителя.
Пример 2:Инструкция за SQL RAISERROR с текста на динамичното съобщение
Сега вижте как можем да създадем динамичния текст на съобщението за оператора SQL RAISERROR.
Да предположим, че искаме да отпечатаме идентификатора на пациента в съобщението. Дефинирах локалната променлива с име @PatientID , който съдържа patent_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)
Изходът:
![](https://lh3.googleusercontent.com/fYlpDA3S49rBHISFZxSIXOYDrHQWyD5dZepfCv27ZllnlBuoSrqeRhAPUvzT-phWogfo4OaoD1pNTwuebK0Db9z9H8sAqEalhOsXZqcaO8Ey9JFXXCIkOJWLIahHzsY8Z-YaZKJDqVXHwDSZmIKbkJHOVd8qusy4R-NGqkKXGgrP-qnISLWlK4LXa9cmL-UZHwXUL0eWT0JTGYqGXIKoXWjm1StWQbdBLonnT7QHTdlj2c9YeJZ69smQaKjI_GywMdkB9nc1Zb8d7fRIx7hRzxXlIEX2rQ9JrNzd6jVPvu2HwAT2KiM88V4wjGqjyIf8zQ26T0O6PWpElzAEAtQQeIrHHCqArhM9SkvhWSBhkTT2juFK2owg3fpSFUY5VVrqsec8EbLGbYAvZ9nsbGCY--j25qj-PEb8Nic3I4QEb9ZI0HBbdCLkXrJs-Oq7PxU2whYMnJ3REMXsczP_lXQPu6JUV72ocMyeKp7Ej_Hhd0x33tqMGkP2DTU9foIXjiv_dnNT4xZlYe9PYTxAG1AtNBAZoZxhO3CERVY676YEfKuVnjqQ67qkXew5VReyKLBD5bl1QEf_RiklXKZnor_O5H2BJh-rEHdEby0Yz1s5WDsO9iGct3wPMpMlJfR4Zs0qWJZx9LuvS1k1yAhE0v_KT_iXXDguWrDeFOeYO88jWz4iFABzo5TeVlgKHe9BoGRBoPec094UMjEQZVac48VXNgc=w866-h291-no?authuser=0.a1b2c3d4.jpg)
За да покажем низа в израза RAISERROR, трябва да използваме операторите за печат в стил C.
Както можете да видите на изображението по-горе, до показване на параметъра в текста на съобщението, използвах опцията %s който показва стойността на низа на параметъра . Ако искате да покажете целочисления параметър , можете да използвате опцията %d .
Използвайте SQL RAISERROR в TRY..CATCH Block
В този пример добавяме 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.
Изходът:
![](https://lh3.googleusercontent.com/UxAX923UczK7TWB-SkqRwC9Ednb1DEkc4yeyok9fx2Lo9djXMY06bSbgs7apzfwcMOWLcIvR1joQfrY8W42YG8eipHZUkO6nbQGlaCGQup3CdYpYnuoOfnlsZwE9aKHdnJHjYzmlL_Fh5S6IGJ8Ntzo0ZRkwI_2B-m__k_r0vtM5Zms2iN67FjDLNXXlVzsbIiLzZM0bfN__WzsiSkZydFzyPsgsUNjgYY6jYKNwvfjl2ywfb8KTyqZ-ofs_YQx0htgmfipfjvDy7dZhwghflgyd9axbwWlvihg0BVthvo3sCdbJ235eB4ih5K4UVADORNIXMO3sjg-JLgMbXpu_onNJ_cmRCDDpBuu2IyQDXgjVEAVnP6nS0fil4QRNx3GrIpV01KIFSeix-NfCt9OmcLaH7GWkHQAsoZG225QRzI29ZhaJob3UrGeXJ3n6HIlyLjPlkMz0aVnZUowp_1QDC7uSFMfK6lMAh8kaCRHDJquqt-wNEwRANWTQmY7C3u3GKZctCY3p_N-ldwltfXLkUMl0r6yxTIWO8_8hRnXcTBa-KeT9bL9b826IFHj57jWGYq1h3IyBDJs5KhGbd3HWb1WwCba7IeDdubglDEwVSZ3iW6m6-exB9f31KDmZPJQ_9K3L4M75yxvvBxhpFL4jsX27uUHXV2Rk2rmnFQCXGfoDb1cG_nT2HYe7U7QicoMx94zOFvYD7CsD-ey51Z7GOtU=w634-h385-no?authuser=0.a1b2c3d4.jpg)
Както можете да видите, кодът е върнал информацията за първоначалната грешка.
Сега нека разберем как можем да добавим персонализирано съобщение с помощта на 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: Посочете номера на съобщението. Типът данни на параметъра е цяло число. Това е идентификатор на съобщението за дефинираното от потребителя съобщение.
@тежест: Посочете нивото на сериозност на грешката. Валидните стойности са между 1 и 25. Типът данни на параметъра е smallint.
@messagetext: Посочете съобщението, което искате да покажете. Типът данни на параметъра е nvarchar(255), и стойността по подразбиране е NULL.
@lang: Посочете езика, който искате да използвате за показване на съобщението за грешка. Стойността по подразбиране е NULL.
@with_log: Този параметър се използва за написване на съобщението до зрителя на събития. Валидни стойности са TRUE и FALSE. Ако посочите TRUE, съобщението за грешка ще бъде написано в програмата за преглед на събития на Windows. Ако изберете FALSE, грешката няма да бъде записана в регистъра за грешки на Windows.
@замяна: Ако искате да замените съществуващото съобщение за грешка с дефинирано от потребителя съобщение и ниво на сериозност, можете да посочите замяната в съхранената процедура.
Да предположим, че искате да създадете съобщение за грешка, което връща невалидно качество грешка. В оператора INSERT стойността на количество_продукт е между 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
Изходът:
![](https://lh3.googleusercontent.com/qvt1cDdYg3fM5CNhz1qT0xKi3I3ukCkwyAeymI10U6JIVKmXW3bCYvLScVxzIz6qGeE2dgSSp_G7MMJKnUiIMzAof1JJCWSeEBNQ485xHEuj0mTrXWYe58Z_X_dobNqdNh1YFoHTAEdzjM2dExMxZADvePLWV6AnCWXThAOjPpKbT2d4rImG8vhDtivL3LyXmKtkPy7dn-VWIthKHSMBAdfkZcTAEnDf-O8ceDYUSlSB6UTE7JSY5unmyPlEubbHU7ZdbFrI2ook6xaUl8gNUSzUgFwR5fkC6a6RwDkR4160CBNDxhJr9hVg5mpIv6uDzdgWEulw5g5_-ikXGsO3141rSaSmYj9iI65yJd4sQOVyGyYwGbWyN3lKC07WBYDrdND3j83ey3MmH6p4um1t7CtRhuk30DKitmwO-X_dRn_QgjwiXBgUmQ8ITDjkUD9lxGT0LlCKiP3ye5ptC3RSzUEaZtNDaOTFnUVKcgUuuSyAJtwERtq1FT4k0Xvu9p9KsCOnobv1BcMoDnU69-uDj3TWB3KM6iPRubABiiIw-NxhyUqLsAb0zNM9MO4SeNWGoo0G3cUckw1L1Fi1QpVal6SSqhWjOiM0cq2ldWPYeIzEoFyF_ItG-0s0nj_3EGIyk1YRE33PbHRNwEzHObjEov-TiGqsf8bYcW2345Gdbd8meNU1mM8Rpq0-tVa1AikhFmNVOZvAFwH33Lhs_E5iKyA=w579-h215-no?authuser=0.a1b2c3d4.jpg)
Как да използвате дефинирани от потребителя съобщения за грешки
Както споменах по-рано, трябва да използваме message_id в израза RAISERROR за дефинираните от потребителя съобщения.
Създадохме съобщение с идентификатор 70001. Инструкцията RAISERROR трябва да бъде както следва:
USE master
go
RAISERROR (70001,16,1 );
go
Изходът:
![](https://lh3.googleusercontent.com/1XfbzF339XsDftJtSgK2sdmT1muonVM6bJa6At6eRSnJP9a0DEV86qxZIMart-ivgaUP8fcRMmlzMrJ_OLCbuA4F6NDETKwGfBfq8Nb5VObsT2u9X6K3oFPqvXI2ruCUh1GKofrCQmH8565FxyRK44U05MpCmpH5cG5RaKE5Rw_oCJ37q55Bt8dq4RmZAncs5apBaPgrl-9OyvlfyqzPkoX6KqemNOObWKAz0yg0mJUm3b8OYUgaqc5QAo_FAfpOTiczKWAUHGgUHf7LusSF3YSh1s1B6eS7T3xvFVxms1CaImUmWgzs5DTOq9ggJ027RY1AoJE7GEqYas0B47nIfHhHxsHRpHsTaLzUSgCdmyt7UXiS_Edrflj2NYDDoOnS3vHdXaanqOK3bYQcrq2vzTJtJ4tzFYvlhfHZ9iDn7dHAzsiVdzVadlIIla0SY_FRU-_2ww2ljdMnnvHVfjGJXU_Nh0fhhUpSQRgPfDjV_XsT4B8Kd-rCPsj73Bg2C34N9rhyHrzfHqsbz2dMYD0a-LFHAo5Co1-wpWEapAyBjRTL5W4sbD0V_qNtug1lhqTOPhereV4_lwMXTzfZ4ezyCDwqs7EtifNE1OXt21U7Yb_FnB5TkOA4HsPxobuDKz88qSfnlbqZnF2UfUZeacELDfi4VR8pKhepORKZWOOi5m_Q2LN_g-KDZOXt1ZPzGiFwxcwO5rbXA44ae1U-snXt6U0=w582-h206-no?authuser=0.a1b2c3d4.jpg)
Инструкцията RAISERROR върна дефинираното от потребителя съобщение.
sp_dropmessage Съхранена процедура
sp_dropmessage Съхранената процедура се използва за изтриване на дефинирани от потребителя съобщения. Синтаксисът е следният:
EXEC Sp_dropmessage @msgnum
В синтаксиса @msgnum определя идентификатора на съобщението, което искате да изтриете.
Сега искаме да изтрием съобщението, чийто идентификатор е 70001 . Запитването е както следва:
EXEC Sp_dropmessage 70001
След като съобщението бъде изтрито, изпълнете следната заявка, за да го видите:
USE master
go
SELECT * FROM sys.messages WHERE message_id = 70001
Изходът:
![](https://lh3.googleusercontent.com/nyzk7PkZt-Ey_8yHpVg_CMGKpVVxEjxqU-D6gr9pmRAThwCtjUw4y3E0d56LZ9rtRz2x9f0HVDNv-xy7QCdRLt-DJiAfQsRlnd5lnNAy6QMir_l5LVXqMMkF0C0FTLDY1_20Yx1YemeSXeVuIuLn4DWAQM_m5Lx2M57RQVGrIMMXXgJJSy-bHsQco_Zek5QN-UwszrlzZSrSP7h12XFeOWWjZ1V0ao9_wxgMHDlv-BrmDLpqb2tnw8_3yMghqEp3aI2rSKVVsIUNPg79HFXz7YiV5FQl0gx8btT6TD6bdXFP05fTYnsR1DOdTMz9xWK_aX7Z8oDg6ZRzup5fmIvu3bfMP-f6P8FTuCd5C2wOmMjXgxRT4l_aHYckROP89oUE01PMN_JqMs_E7P75cNT_VqPAguhRnwzlJ5RsxblpojpjiWXHc_LN8i-eZCEg44S_t38RQLgkS1WXijM49o2lvl2bBorV_6v6Ue_qXXtTiVoCBLhCvwhNQtmsJjm27rPj8z5o6gwCJuZTaVUWRT1IdbG3xcJhNuAubqDnP3CCrkCRkmmgRHW8UcwT9LC6YA6zHvwKIQA9k3dsI24JNg-4k7gunYD4ommebMn6SQ4BslNDy9zN3pr2RkjSUGMVtIuTiX-G9wf43sV1e-3tD9iEgx-6WVwpu03kFAWpRNJPl_uSuXKY1LSVVTW3_S-wzyvRu1YeebRt3V2do_bVwGT16Bw=w613-h184-no?authuser=0.a1b2c3d4.jpg)
Както можете да видите, съобщението е изтрито.
Резюме
По този начин ние проучихме израза RAISERROR, неговите параметри и демонстрирахме използването му в практически примери. Също така изяснихме използването на sp_addmessage и sp_dropmessage съхранени процедури. Надяваме се, че тази статия ви донесе полезна информация за вашите работни цели.
Винаги се радваме да чуем вашите коментари и може би допълнителни практически съвети, ако искате да ги споделите.