Función SQLSTATE

SQLSTATE es una función de estado de la base de datos que devuelve 5 caracteres de datos de tipo CHARACTER con un valor por omisión '00000' (cinco ceros como serie de caracteres).

Sintaxis

Dentro de un flujo de mensajes, puede acceder y actualizar un recurso de una base de datos externa utilizando las funciones disponibles de base de datos de ESQL en los nodos Filter, Database, y Compute. Cuando efectúe llamadas a una base de datos externa, es posible que aparezcan errores como, por ejemplo, una tabla que no exista, una base de datos que disponible o la inserción de una clave que ya exista.

Cuando se producen esos errores, la acción por omisión del intermediario es generar una excepción. Este comportamiento se determina al definir la propiedad Generar excepción en error de la base de datos. Si selecciona este recuadro de selección, el intermediario detendrá el proceso del nodo, propagará el mensaje al terminal de anomalías (failure terminal) y grabará los detalles del error en la ListaExcepciones. Si desea alterar temporalmente el funcionamiento por omisión y manejar el error de la base de datos en el ESQL del nodo, quite la marca del recuadro de selección Generar excepción en error de la base de datos. El intermediario no generará ninguna excepción y habrá de incluir la sentencia THROW para generar una excepción si no esperaba un determinado código de estado de SQL. Consulte el apartado Sentencia THROW donde encontrará una descripción de THROW.

Si decide manejar los errores de bases de datos en un nodo, puede utilizar la función de estado de la base de datos de SQLSTATE para recibir información sobre el estado de la llamada del DBMS efectuada en ESQL. Puede incluirla en sentencias condicionales en el ESQL del nodo actual para reconocer y gestionar posibles errores.

Conceptos relacionados
Flujos de mensajes
ESQL

Tareas relacionadas
Definición del contenido del flujo de mensajes
Desarrollo de ESQL
Captura del estado de la base de datos

Referencia relacionada
Función SQLCODE
Función SQLERRORTEXT
Función SQLNATIVEERROR