Notas del release
La sentencia GET DIAGNOSTICS se utiliza para obtener información sobre la
sentencia de SQL ejecutada anteriormente. La sintaxis de esta sentencia
se ha actualizado de la siguiente manera:
Sintaxis del mandato
>>-GET DIAGNOSTICS---------------------------------------------->
>--+-nombre-variable-SQL--=--+-ROW_COUNT-----+-+---------------><
| '-RETURN_STATUS-' |
'-| información-condición |-----------------'
información-condición
|--EXCEPTION--1------------------------------------------------->
.-,--------------------------------------------.
V |
>----nombre-variable-SQL--=--+-MESSAGE_TEXT-----+-+-------------|
'-DB2_TOKEN_STRING-'
Parámetros del mandato
- nombre-variable-SQL
- Identifica la variable que es el destino de la asignación. Si se
especifica ROW_COUNT o RETURN_STATUS, la variable debe ser un entero.
De lo contrario, la variable debe ser CHAR o VARCHAR. Pueden definirse
variables de SQL en una sentencia compuesta.
- ROW_COUNT
- Identifica el número de filas asociadas con la sentencia de SQL
anterior. Si la sentencia de SQL anterior es DELETE, INSERT o UPDATE,
la cláusula ROW_COUNT identifica el número de filas suprimidas, insertadas o
actualizadas por esa sentencia, de las cuales excluye las filas afectadas por
desencadenantes o restricciones de integridad de referencia. Si la
sentencia anterior es PREPARE, la cláusula ROW_COUNT identifica el número
estimado de filas de resultados en la sentencia preparada.
- RETURN_STATUS
- Identifica el valor de estado devuelto por el procedimiento almacenado que
está asociado con la sentencia de SQL ejecutada anteriormente, siempre y
cuando la sentencia fuera una sentencia CALL invocando un procedimiento que
devuelve un estado. Si la sentencia anterior no es de este tipo, el
valor devuelto no tiene significado y puede ser cualquier entero.
- información-condición
- Especifica que debe devolverse la información de error o de aviso sobre la
sentencia de SQL ejecutada anteriormente. Si es necesaria información
relativa a un error, la sentencia GET DIAGNOSTICS debe ser la primera
sentencia especificada en el manejador que se encargará del error. Si
es necesaria información relativa a un aviso y si el manejador va a obtener el
control de la condición de aviso, la sentencia GET DIAGNOSTICS debe ser la
primera sentencia especificada en ese manejador. Si el manejador
no va a obtener el control de la condición de aviso, la sentencia
GET DIAGNOSTICS debe ser la siguiente sentencia ejecutada.
- MESSAGE_TEXT
- Identifica cualquier texto de mensaje de error o aviso devuelto por la
sentencia de SQL que se ha ejecutado anteriormente. El texto de mensaje
se devuelve en el idioma del servidor de bases de datos donde se ha procesado
la sentencia. Si la sentencia se completa con un SQLCODE de cero, se
devuelven una serie vacía o espacios en blanco.
- DB2_TOKEN_STRING
- Identifica cualquier símbolo de mensaje de error o aviso devuelto por la
sentencia de SQL que se ha ejecutado anteriormente. Si la sentencia se
completa con un SQLCODE de cero, o si el SQLCODE no tiene símbolos, se
devuelven una serie vacía o espacios en blanco.
[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]