Procedimientos Almacenados y Triggers en SQL Server

Procedimientos almacenados y Triggers en SQL Server 6.5 Por Fernando González

Procedimientos almacenados Un procedimiento almacenado es un objeto perteneciente a una base de datos, que contiene un conjunto de instrucciones SQL, tanto de consulta, como de manipulación de datos, como de control de la secuencia del programa, asociados a un nombre, y que son ejecutados en conjunto. Puede contener parámetros tanto de entrada como de salida (parámetros pasados por referencia), así como devolver un valor de retorno. Son precompilados al ejecutarse por primera vez, y no vuelven a ser compilados con las subsiguientes ejecuciones, lo que proporciona una cierta mejora en el rendimiento. No obstante si se desea se puede forzar su recompilación. Una de las principales ventajas de este tipo de objetos, es que al residir en la propia base de datos son compartibles por todos los usuarios, pudiendo de esta manera beneficiarse de los distintos cachés del servidor. Al mismo tiempo al ser código externo a la aplicación puede ser alterado sin que exista siempre la necesidad de modificar el código de la misma. Al ser objetos de la base de datos se hallan sujetos a los esquemas de seguridad determinados por el administrador de la misma: Existen diversas clases de procedimientos almacenados, entre los que se encuentra los procedimientos almacenados del sistema, que sirven de herramientas para la realización de distintas tareas de administración. Un procedimiento almacenado se crea con la sentencia CREATE PROCEDURE, que debe ser la única dentro de un mismo batch. La creación de un procedimiento almacenado puede ser realizada bien desde el ISQL_W, bien desde la opción Manage.Stored Procedures del Enterprise Manager, o bien desde la propia ventana donde se muestran los objetos de la base de datos, en el grupo correspondiente a los procedimientos almacenados, dentro de esta última herramienta. La sintaxis de dicha instrucción es básicamente la siguiente:

CREATE PROCEDURE Nombre_del_procedimiento [Lista_de_parámetros] AS (Sentencias SQL) [RETURN [Valor]] Donde:

Nombre_del_procedimiento

Identificador que determina el nombre asignado al procedimiento y que debe cumplir con la regla de definición de identificadores establecida en MSSQL Server.

Lista_de_parámetros

Parámetros definidos en el procedimiento con la siguiente sintaxis:

@nombre_var

Tipo_var

[OUTPUT]

1 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS

El símbolo @ es necesario no sólo en la declaración sino que forma parte del propio nombre. La claúsula OUPUT determina que dicho parámetro será utilizado para pasar información al código llamador, es decir, viene a ser un parámetro pasado por referencia. Dicha lista puede contener un máximo de 255 parámetros.

Sentencias_SQL

Como se explicó anteriormente, el cuerpo del procedimiento puede estar compuesto de cualquier tipo de instrucción SQL, a excepción de las siguientes:

CREATE VIEW CREATE DEFAULT CREATE RULE CREATE PROCEDURE CREATE TRIGGER Entre las instrucciones que puede contener, está la llamada a otros procedimientos almacenados, los cuales podrán acceder a los objetos pertenecientes al llamador, exceptuando las tablas temporales creadas por el mismo.

RETURN [Valor]

Un procedimiento almacenado puede devolver un valor de retorno de tipo integer, no nulo, que puede ser rescatado por el código llamador para tener conocimiento del resultado del proceso de dicho procedimiento. Los valores -1 al -99 están reservados por el sistema, así como el 0 que se interpreta como “finalizado con éxito”. Si no se proporciona un código definido por el usuario, se utilizan los del sistema. De la misma forma los definidos por el usuario tiene prioridad sobre los definidos por el sistema. En caso de producirse varios errores a lo largo de la ejecución del mismo procedimiento, se devuelve el código cuyo valor absoluto es mayor. Algunos ejemplos de códigos y sus significados son los siguientes:

Código -2 -4 -5 -13

Significado Error de tipo de datos Error de Permisos Error de Sintaxis Base de Datos Corrupta

Llamadas a procedimientos almacenados La sintaxis de la llamada a un procedimiento almacenado, depende de como se halla creado dicho procedimiento, por lo que en cada uno de los ejemplos que siguen, se especifica la llamada al mismo, poniéndose de manifiesto dicha sintaxis en cada caso particular.

Ejemplos Como base de datos de trabajo para los ejemplos se a utilizado SOPORTEDB cuya estructura es accesible por todos, con lo cual no se detalla en este documento ningún elemento referente a dicha estructura.

2 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS

Procedimiento 1 Es un procedimiento simple, sin parámetros que devuelve un conjunto de filas que cumplen siempre la misma condición.

CREATE PROCEDURE prod_1 AS SELECT * FROM CLIENTES

Llamada:

EXECUTE prod_1

Procedimiento 2 Es un procedimiento que recibe dos parámetros de entrada, correspondientes a un rango de códigos de clientes, y devuelve el conjunto de filas de la tabla CLIENTES cuyo código se encuentra en el rango determinado por los parámetros.

CREATE PROCEDURE prod_2 @p_CodIni CHAR (6), @p_CodFin CHAR (6) AS SELECT * FROM CLIENTE WHERE IDCLIENTE BETWEEN @p_CodIni AND @p_CodFin

Llamada:

EXECUTE

prod_2

‘000100’,

‘000500’

Procedimiento 3 Es un procedimiento que recibe un parámetro de entrada y uno de salida. El parámetro de entrada corresponde a un código de tipo de producto y el de salida, el número de productos existentes, que corresponden a dicho tipo.

CREATE PROCEDURE prod_3 @p_CodTipProd CHAR (3), @p_NumProductos SMALLINT OUTPUT AS SELECT @p_NumProductos = COUNT(*)

3 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS

FROM PRODUCTOS WHERE IDTIPROD = @p_CodTipProd

Llamada:

DECLARE @p_parmsal SMALLINT EXECUTE prod_3

‘KBD’, @p_parmsal OUTPUT

Procedimiento 4 Es un procedimiento almacenado que realiza inserciones en una tabla, con los valores devueltos por un subquery realizado sobre otra tabla que tiene la misma estructura. El valor devuelto por el procedimiento almacenado, es el número de filas insertadas.

CREATE PROCEDURE prod_4 AS INSERT TIPSOPPRU SELECT * FROM TIPSOPORTE RETURN @@ROWCOUNT

Llamada:

DECLARE

@p_retorno INTEGER EXECUTE @p_retorno = prod_4

Triggers Un trigger es un tipo especial de procedimiento almacenado que se ejecuta automáticamente al intentarse efectuar una modificación de los datos, en la tabla a la que se encuentran asociados. Las operaciones que pueden “disparar” un trigger son las correspondientes a las instrucciones SQL, INSERT, UPDATE y DELETE. Puede definirse un trigger para cada una de ellas, o bien definir un trigger asociado a una combinación de las mismas. La mayor utilidad que se confiere a un trigger, es la de asegurar la integridad referencial o el cumplimiento de las distintas reglas definidas, si bien estas son operaciones que pueden delegarse en el propio servidor, mediante las instrucciones y cláusulas de especificación de las reglas de integridad, definidas durante la creación de las tablas, o añadidas posteriormente. El hecho de tener algún trigger asociado a una tabla, incide de forma negativa en cuanto al rendimiento se refiere, si bien la mayor parte del tiempo empleado en su ejecución corresponde al acceso a las diferentes tablas implicadas en los chequeos de integridad.

4 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS

En relación a la creación de los triggers, las herramientas disponibles son las mismas que en el caso de los procedimientos almacenados, si bien deberán utilizarse las opciones correspondientes. La instrucción que permite la creación de un trigger es CREATE TRIGGER, y su sintaxis es la siguiente:

CREATE TRIGGER Nombre_del_Trigger ON Nombre_de_la_tabla FOR {INSERT,UPDATE,DELETE} AS (Sentecias_SQL) Donde:

Nombre_del_Trigger:

Identificador que determina el nombre del trigger en la base de datos y que debe cumplir las reglas de construcción de identificadores en SQL Server.

Nombre_de_la_tabla

Nombre de la tabla sobre la que será ejecutado el trigger, en caso de ser ésta alterada, en cuanto a datos se refiere.

INSERT

Instrucción de inserción de filas.

UPDATE

Instrucción de actualización de filas.

DELETE

Instrucción de eliminación de filas.

Sentencias_SQL

Cualquier tipo de sentencia SQL, a excepción de las siguientes: • • • • •

Cualquier instrucción CREATE Cualquier instrucción DROP ALTER TABLE y ALTER DATABASE SELECT INTO GRANT y REVOKE

En el caso en que la instrucción CREATE TRIGGER forme parte de un conjunto de instrucciones (Batch), ésta deberá ser la primera y sólo puede ser aplicada sobre una tabla. Aunque desde el trigger pueden referenciarse objetos de otras bases de datos, éste sólo puede se creado en la base de datos en curso. El intento de crear un trigger sobre un trigger ya existente, provoca la sustitución inmediata y sin aviso, del anterior. Los triggers pueden ser anidados y permiten un nivel máximo de anidamiento de 16. En caso de que un trigger caiga en un bucle infinito, se acabará producción un error de desbordamiento del nivel de anidamiento. Los triggers no son reentrantes lo que quiere decir que en caso de que un trigger en ejecución, realice una actualización que provoque la activación del mismo, tal activación no se producirá. Con relación a las transacciones hay que decir que en el caso de comenzarse una transacción y activarse un trigger que contenga y ejecute el comando ROLLBACK TRANSACTION, éste deshará la transacción completa iniciada antes de su activación.

5 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS

Otra de las mayores utilidades de los triggers es deshacer transacciones iniciadas antes de su activación, como consecuencia de un error detectado durante su ejecución.

Ejemplos Seguidamente se muestran algunos ejemplos de triggers.

Trigger 1 La tabla CPOSTALES no está sometida a ningún control de integridad referencial, con lo cual para evitar eliminar una fila que tenga una referencia en la tabla CLIENTES, se define un trigger que impida tal hecho. Dado que la acción a realizar es deshacer una transacción, suponemos que ésta ha sido previamente iniciada en el procedimiento principal.

CREATE TRIGGER Trig_1 ON CPOSTAL FOR DELETE AS DECLARE @p_cuenta SMALLINT SELECT @p_cuenta = COUNT(*) FROM CLIENTES CLI WHERE CLI.IDPROVIN = CPOSTAL.IDPROVIN AND CLI.RESTCDPOSTAL = CPOSTAL.RESTCDPOSTAL IF @p_cuenta > 1 BEGIN ROLLBACK TRANSACTION RAISERROR(‘ESTA FILA CONTIENE REFERENCIAS EN TABLA CLIENTES’,16,-1) END

Trigger 2 Partiendo de la tabla del ejemplo 1, estableceremos un trigger que efectúe una actualización en cascada, en el supuesto de intentar modificar un código postal que contenga referencias en la tabla Cliente.

CREATE TRIGGER Trig_2 ON CPOSTAL FOR UPDATE AS DECLARE @p_cuenta SMALLINT SELECT @p_cuenta = COUNT(*) FROM CLIENTES CLI WHERE CLI.IDPROVIN = CPOSTAL.IDPROVIN AND CLI.RESTCDPOSTAL = CPOSTAL.RESTCDPOSTAL IF @p_cuenta > 1 BEGIN UPDATE CLIENTES SET CLIENTES.IDPROVIN = updated.IDPROVIN, CLIENTES.RESTCDPOSTAL = updated.RESTCDPOSTAL WHERE CLIENTES 6 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS

RAISERROR (‘FILAS ACTUALIZADAS EN TABLA CLIENTES’, 16, -1) END

Función RaiseError Esta función es utilizada para comunicar errores al cliente, definidos por el programador. Los mensajes correspondientes a estos errores, pueden residir en una tabla especial de la base de datos, llamada sysmessages, o bien pueden ser creados en tiempo de ejecución. Cada error tiene asociado un código numérico de 5 dígitos, un literal, y otros valores añadidos que se comentarán más adelante. Los errores definidos por el usuario deben tener un código no inferior a 50001, debido a que el resto están reservados por el sistema. Para los errores definidos en tiempo de ejecución, este código es asignado automáticamente por el sistema y es igual a 50000. La cadena que constituye el mensaje propiamente dicho, puede contener argumentos de sustitución, esto es parámetros. La forma en que se especifican éstos y sus tipos, guarda semejanza a la utilizada por la función Printf del lenguaje C. La sintaxis de esta función es la siguiente:

RAISERROR (id_msg|str_msg, gravedad, estado, lista_de_argumentos) Donde:

id_msg Str_msg Gravedad

Estado lista_de_Argumentos

Código identificativo del mensaje. Numérico mayor que 50000. Cadena que constituye el mensaje. La declaración de variables de sustitución se detalla al final del artículo. Entero que indica el nivel de gravedad del error. Esta definido en el rango de 1 a 25, si bien los códigos de gravedad entre 19 y 25, solo pueden ser utilizados por el administrador del sistema, al constituir éstos, errores fatales. Entero en el rango de 1 a 127, para la definición de subestados de error. Si no se utiliza se establece un valor de -1 Lista de valores que se sustituirán en la cadena de mensaje. Han de coincidir en posición y tipo.

Argumentos de sustitución La sintaxis del argumento es la siguiente:

%[[flag][ancho][precision][{h|i}]]Tipo Donde:

flag

Determina el espaciado y el ajuste dentro de ancho. Los valores son:

7 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS

Valores +0 # ‘‘

Menos Signo Cero Blanco

Ajuste a la izquierda Antepone el signo añade ceros Antepone # a valores octales, y hexadecimales Antepone un blanco si con signo y positivo

ancho

Define la anchura mínima.

precision

Especifica el número máximo de caracteres o el mínimo de dígitos.

{h|i}Tipo

Si h precede al tipo se crea un entero corto, si es i quien lo precede, el entero es largo.

Tipo d,i o p s u x,X

Significado Entero con signo Octal sin signo Puntero Cadena Entero sin signo Hexadecimal sin signo

Errores almacenados en sysmessages Para guardar mensaje en sysmessages que puedan ser accedidos posteriormente con RAISERROR, utilizaremos el procedimiento almacenado del sistema sp_addmessage. La sintaxis es la siguiente:

sp_addmessage

id_msg,gravedad,mensaje[,idioma[,true|false[,REPLACE]]]

Donde:

id_msg gravedad mensaje idioma {true|false} REPLACE

Código asignado al mensaje. Nivel de gravedad asignado al mensaje. Texto del mensaje definido como se ha explicado anteriormente. Idioma empleado en la confección del mensaje. Si no se especifica se asume Ingles U.S. Especifica si el mensaje se grabará el LOG de eventos de Windows NT. Si se graba en LOG de eventos de Windows NT también se graba en el LOG de errores de SQL Server. Si existe ya el mensaje en sysmessages, se actualiza con la nueva información.

8 Algoritmo. La revista para el programador de sistemas de bases de datos. http://www.eidos.es - © Grupo EIDOS