发行说明

|42.7 GET DIAGNOSTICS 语句中的附加选项

|GET DIAGNOSTICS 语句

|GET DIAGNOSTICS 语句用来获取有关先前执行的 SQL 语句的信息。此语句的语法已作了如下更新。

|命令语法

|>>-GET DIAGNOSTICS---------------------------------------------->
| 
|>--+-SQL-variable-name--=--+-ROW_COUNT-----+-+-----------------><
|   |                       '-RETURN_STATUS-' |
|   '-| condition-information |---------------'
| 
|condition-information
| 
||--EXCEPTION--1------------------------------------------------->
| 
|   .-,------------------------------------------.
|   V                                            |
|>----SQL-variable-name--=--+-MESSAGE_TEXT-----+-+---------------|
|                           '-DB2_TOKEN_STRING-'
| 
| 

|命令参数 |

|SQL-variable-name

|标识作为赋值目标的变量。如果指定 ROW_COUNT 或 RETURN_STATUS，该变量必须是整数变量。否则，该变量必须是 CHAR 或 VARCHAR。SQL |变量可在复合语句中定义。

|ROW_COUNT

|标识与先前的 SQL 语句相关联的行数。如果先前的 SQL 语句为 DELETE、INSERT 或 UPDATE 语句，则 ROW_COUNT 标识该语句删除的、插入的或更新的行数，受触发器或引用完整性约束影响的行除外。如果先前的语句为 PREPARE 语句，则 ROW_COUNT 标识准备语句中的结果行的估计数目。

|RETURN_STATUS

|如果该语句是调用返回状态的过程的 CALL 语句，则此项标识与先前执行的 SQL 语句相关联的存储过程返回的状态值。如果先前的语句不是这样一个语句，则返回值没有任何意义，且可能是任何整数。

|condition-information

|指定要返回的关于先前执行的 SQL 语句的错误或警告信息。如果需要关于错误的信息，则 GET DIAGNOSTICS 语句必须是在将处理该错误的处理程序中指定的第一个语句。如果需要关于警告的信息，且如果处理程序将控制警告条件，则 GET DIAGNOSTICS 语句必须是在该处理程序中指定的第一个语句。如果该处理程序不控制警告条件，则 GET DIAGNOSTICS 语句必须是要执行的下一个语句。 |

|MESSAGE_TEXT

|标识先前执行的 SQL 语句返回的任何错误或警告信息文本。信息文本是以处理该语句的数据库服务器使用的语言返回的。如果语句完成且 SQLCODE 为零，则返回空字符串或空白。

|DB2_TOKEN_STRING

|标识先前执行的 SQL 语句返回的任何错误或警告信息记号。如果语句完成且 SQLCODE 为零，或者 SQLCODE 没有任何记号，则返回空字符串或空白。 |

|