릴리스 정보

42.11 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는 준비된 명령문에서 결과 행의 estimated 수를 식별합니다.

RETURN_STATUS

명령문이 상태를 리턴하는 프로시듀어를 호출하는 CALL문인 경우, 이전에 실행된 SQL문과 연관된 저장 프로시듀어에서 리턴된 상태 값을 식별합니다. 이전 명령문이 그러한 명령문이 아닌 경우, 리턴된 값은 의미가 없으며 임의 정수일 수 있습니다.

조건 정보

이전에 실행된 SQL문이 리턴되었다는 오류나 경고 정보를 지정합니다. 오류에 대한 정보가 필요한 경우, GET DIAGNOSTICS문이 오류를 핸들할 핸들러에 지정된 처음 명령문이어야 합니다. 경고에 대한 정보가 필요하며 핸들러가 경고 조건의 제어를 가질 경우, GET DIAGNOSTICS문이 핸들러에 지정된 처음 명령문이어야 합니다. 핸들러가 경고 조건을 제어하지 않는 경우, GET DIAGNOSTICS문은 실행되는 다음 명령문이어야 합니다.

MESSAGE_TEXT

이전에 실행된 SQL문에서 리턴된 오류나 경고 메시지 텍스트를 식별합니다. 메시지 텍스트는 명령문이 처리된 데이터베이스 서버의 언어로 리턴됩니다. 명령문의 SQLCODE가 0으로 완료되는 경우, 빈 문자열이나 공백이 리턴됩니다.

DB2_TOKEN_STRING

이전에 실행된 SQL문에서 리턴된 오류나 경고 메시지 토큰을 식별합니다. 명령문의 SQLCODE가 0으로 완료되거나 SQLCODE에 토큰이 없는 경우, 빈 문자열이나 공백이 리턴됩니다.