云数据库 GAUSSDB-调试:语法

时间：2024-01-23 20:09:23

云数据库 GAUSSDB

RAISE有以下五种语法格式：

图1 raise_format::=

图2 raise_condition::=

图3 raise_sqlstate::=

图4 raise_option::=

图5 raise::=

参数说明：

level选项用于指定错误级别，有DEBUG， LOG ，INFO，NOTICE，WARNING以及EXCEPTION（默认值）。EXCEPTION抛出一个正常终止当前事务的异常，其他的仅产生不同异常级别的信息。特殊级别的错误信息是否报告到客户端、写到服务器日志由log_min_messages和client_min_messages这两个配置参数控制。
format：格式字符串，指定要报告的错误消息文本。格式字符串后可跟表达式，用于向消息文本中插入。在格式字符串中，%由format后面跟着的参数的值替换，%%用于打印出%。例如：
```
--v_job_id 将替换字符串中的 %：
RAISE NOTICE 'Calling cs_create_job(%)',v_job_id;
```
option = expression：向错误报告中添加另外的信息。关键字option可以是MESSAGE、DETAIL、HINT以及ERRCODE，并且每一个expression可以是任意的字符串。
- MESSAGE，指定错误消息文本，这个选项不能用于在USING前包含一个格式字符串的RAISE语句中。
- DETAIL，说明错误的详细信息。
- HINT，用于打印出提示信息。
- ERRCODE，向报告中指定错误码（SQLSTATE）。可以使用条件名称或者直接用五位字符的SQLSTATE错误码。
condition_name：错误码对应的条件名。
sqlstate：错误码。