SQL SERVER Introducción a los procedimientos almacenados Cuando crea una aplicación con Microsoft SQL Server 200 8, el lenguaje de programación Transact-SQL es la principal interfaz de programación entre las aplicaciones y la base de datos de Microsoft SQL Server. Cuando utiliza programas Transact-SQL, dispone de dos métodos para almacenar y ejecutar los programas. •
•
Puede almacenar los programas localmente y crear aplicaciones que envían los comandos a SQL Server y procesan los resultados. Puede almacenar los programas como procedimientos almacenados en SQL Server y crear aplicaciones que ejecutan los procedimientos almacenados y procesan los resultados.
Los procedimientos almacenados de Microsoft SQL Server son similares a los procedimientos procedimientos de otros lenguajes de programación en el sentido de que pueden:
•
•
•
Aceptar parámetros de entrada y devolver varios valores en forma de parámetros de salida al lote o al procedimiento que realiza la llamada. Contener instrucciones de programación que realicen operaciones en la base de datos, incluidas las llamadas a otros procedimientos. Devolver un valor de estado a un lote o a un procedimiento que realiza una llamada para indicar si la operación se ha realizado correctamente o se han producido errores (y el motivo de éstos).
Puede utilizar la instrucción EXECUTE de Transact-SQL para ejecutar un procedimiento almacenado. Los procedimientos almacenados difieren de las funciones en que no devuelven valores en lugar de sus nombres ni pueden utilizarse directamente en una expresión.
Procedimientos almacenados Teoria
1
Utilizar procedimientos almacenados en SQL Server en vez de programas Transact-SQL almacenados localmente en equipos cliente presenta las siguientes ventajas: •
•
•
•
•
•
Se registran en el servidor. Pueden incluir atributos de seguridad (como permisos) y cadenas de propiedad; además se les pueden asociar certificados. Los usuarios pueden disponer de permiso para ejecutar un procedimiento almacenado sin necesidad de contar con permisos directos en los objetos a los que se hace referencia en el procedimiento. Mejoran la seguridad de la aplicación. Los procedimientos almacenados con parámetros pueden ayudar a proteger la aplicación ante ataques por inyección de código SQL. Permiten una programación modular. Puede crear el procedimiento una vez y llamarlo desde el programa tantas veces como desee. Así, puede mejorar el mantenimiento de la aplicación y permitir que las aplicaciones tengan acceso a la base de datos de manera uniforme. Pueden reducir el tráfico de red. Una operación que necesite centenares de líneas de código Transact-SQL puede realizarse mediante una sola instrucción que ejecute el código en un procedimiento, en vez de enviar cientos de líneas de código por la red.
Crear procedimientos almacenados Puede crear procedimientos almacenados instrucción CREATE PROCEDURE de Transact-SQL.
mediante
la
Antes de crearlos, tenga en cuenta lo siguiente: •
•
•
Las instrucciones CREATE PROCEDURE no se pueden combinar con otras instrucciones SQL en el mismo lote. Para crear procedimientos, debe disponer del permiso CREATE PROCEDURE en la base de datos y del permiso ALTER en el esquema donde se crea el procedimiento. Los procedimientos almacenados son objetos de ámbito de esquema y sus nombres deben ajustarse a las reglas para los identificadores.
Procedimientos almacenados Teoria
2
Sólo puede crear un procedimiento almacenado en la base de datos actual. Cuando cree un procedimiento almacenado, deberá especificar lo siguiente: •
•
•
•
•
Todos los parámetros de entrada y de salida del lote o del procedimiento que realiza la llamada. Las instrucciones de programación que realicen operaciones en la base de datos, incluidas las llamadas a otros procedimientos. El valor de estado devuelto al lote o al procedimiento que realiza la llamada, a fin de indicar que la operación se ha realizado correctamente o que se ha producido un error (y el motivo del mismo). Las instrucciones de control de errores necesarias para detectar y administrar posibles errores. Microsoft SQL Server 2005 presenta nuevas funciones de control de errores como ERROR_LINE y ERROR_PROCEDURE que se pueden especificar en el procedimiento almacenado.
Elementos esenciales del lenguaje Transact-Sql DECLARE @local_variable Las variables se declaran en el cuerpo de un proceso por lotes o procedimiento con la instrucción DECLARE, y se les asignan valores con una instrucción SET o SELECT. SET @local_variable= Establece el valor indicado en la variable local especificada, creada previamente con la instrucción DECLARE @local_variable. SELECT @local_variablel= Establece el valor indicado en la variable local especificada, creada previamente con la instrucción DECLARE @local_variable. GO Indica a las herramientas de Microsoft SQL Server el final de un lote de instrucciones Transact-SQL. No es una instrucción sino un comando que entienden las herramientas. BEGIN .... END Siempre que se necesite que se ejecuten varias instrucciones en conjunto deben ir encerradas entre las palabras claves BEGIN y END. Procedimientos almacenados Teoria
3
PRINT Permite imprimir información. PRINT {‘cualquier texto ASCII’ | @variable_local @@variable_global}
|
IF...ELSE IF expresión_booleana {instrucción_sql | bloque_instrucciones} ELSE [expresión_booleana] {instrucción_sql | bloque_instrucciones} Ejemplo: IF (datename(dw,getdate()) = ‘Viernes’) BEGIN PRINT ‘Informe semanal’ EXEC spInformeSemanal END Se llama al procedimiento spInformeSemanal en caso de que hoy sea viernes. IF [NOT] EXISTS (SELECT instrucción) {instrucción_sql | bloque_instrucciones} [ELSE {instrucción_sql | bloque_instrucciones}] Ejecuta las instrucciones si la instrucción SELECT devuelve alguna fila. CASE Permite que la instrucción devuelva dependiendo del valor de una expresión.
valores
distintos,
CASE expresion WHEN expresion1 THEN expresion1nueva [[WHEN expresion2 THEN expresion2nueva] [...]] [ELSE expresionN] Ejemplo: SELECT title_id, type = CASE type WHEN ‘business’ THEN ‘Libro de negocio’ WHEN ‘psychology’ THEN ‘Libro de psicologia’ WHEN ‘mod_cook’ THEN ‘Libro de cocina moderna’ ELSE ‘no conocido’ END
Procedimientos almacenados Teoria
4
FROM titles WHILE El lenguaje T-SQL tiene una instrucción WHILE que permite la ejecución repetitiva hasta que se cumpla una condición. El uso de esta instrucción está limitado en muchos casos ya que por naturaleza, SQL trabaja con conjuntos de filas. Por ejemplo, no necesita una instrucción WHILE para avanzar a través de cada fila en una tabla; la instrucción SELECT avanza por todas las filas, comprobando sus criterios WHERE en cada fila. WHILE expresion_booleana {instrucción_sql | bloque_instrucciones} Ejemplo: WHILE (SELECT AVG(price) FROM titles) < 20) BEGIN UPDATE titles SET price=price*1.1 END Este ejemplo comprueba repetidamente el precio promedio de todos los libros. Mientras el promedio sea menor que 20, se actualiza el precio de cada libro. La repetición se detendrá cuando el precio promedio sea mayor o igual a 20.
RETURN Sale incondicionalmente de una consulta o procedimiento. RETURN es inmediata y completa, y se puede utilizar en cualquier punto para salir de un procedimiento, lote o bloque de instrucciones. Las instrucciones que siguen a RETURN no se ejecutan. RETURN [ integer_expression ] Programar procedimientos almacenados Parámetros y variables Los parámetros y las variables son una parte fundamental de hacer dinámico a un procedimiento almacenado. Los parámetros de entrada habilitan al usuario que está ejecutando el procedimiento a pasar valores al procedimiento almacenado. Los parámetros de salida amplían la salida de los procedimientos almacenados mas allá del conjunto de resultados retornado por una consulta. Los datos desde Procedimientos almacenados Teoria
5
un parámetro de salida son capturados en memoria cuando el procedimiento se ejecuta. Para retornar un valor desde el parámetro de salida se debe crear una variable para que lo mantenga. Se puede mostrar el valor con los comando SELECT o PRINT, o usar el valor para completar otro comando en el procedimiento. En resumen, un parámetro de entrada se define en el procedimiento almacenado y un valor es provisto cuando el procedimiento se ejecuta. Un parámetro de salida se define usando la palabra clave OUTPUT. Cuando se ejecuta el procedimiento, se guarda en memoria un valor para el parámetro de salida. Para utilizarlo, se declara una variable para mantener al valor. El siguiente procedimiento parámetros, de salida y de entrada:
muestra
el
uso
de
ambos
USE Pubs GO CREATE PROCEDURE dbo.VentasPorTitulo @Titulo varchar(80), --Parámetro de entrada @Ventas int OUTPUT, --Primer parámetro de salida @TextoTitulo varchar(80) OUTPUT –Segundo parámetro de salida AS -- Asigna la columna de datos a los parmetros de salida y -- controla por un título que coincida con el parámetro de entrada SELECT @Ventas = ytd_sales, @TextoTitulo = title FROM titles WHERE title LIKE @Titulo GO El parámetro de entrada es @Titulo, y los de salida son @Ventas y @TextoTitulo. Fíjese que los tres parámetros tienen definidos sus tipos de datos. Los parámetros de salida incluye la palabra clave OUTPUT. Después que se definen los parámetros, el comando SELECT utiliza a los tres parámetros. Primero, a los parámetros de salida se les asigna a las columnas de la consulta. Cuando se ejecuta la consulta, los parámetros de salida contendrán los valores de esas dos columnas. La cláusula WHERE del comando SELECT contiene el parámetro de entrada, @Titulo. Cuando se ejecuta el procedimiento, se debe proveer un valor para el parámetro de entrada o fallará la consulta. El siguiente comando ejecuta el procedimiento almacenado que vimos: -- Declara variables para recibir las salidas del procedimiento DECLARE @y_YtdSales int, @t_TitleText varchar(80) Procedimientos almacenados Teoria
6
EXECUTE SalesForTitle -- configura los valores de variables con los parámetros de salida @Ventas = @y_YtdSales OUTPUT, @TextoTitulo = @t_TitleText OUTPUT, @Titulo =“%Garlic%”–especifica un valor para el parámetro de entrada -- Muestra las variables retornadas por el procedimiento SELECT “Title” = @t_TitleText, “Número de Ventas” = @y_YtdSales GO Se declaran dos variables: @y_YtdSales y @t_TitleText. Estas dos variables recibirán los valores almacenados en los parámetros de salida. Advierta que el tipo de datos de la variables que reciben son los mismos que los tipos de los correspondientes parámetros de salida. Estas dos variables pueden tener el mismo nombre que los parámetros de salida correspondientes dado que las variables en un procedimiento almacenado son locales al batch que las contiene. Por claridad, los nombres de las variables son diferentes a los de los parámetros de salida. Cuando se declara una variable, esta no se asigna con un parámetro de salida. Las variables son asignadas con parámetros de salida después del comando EXECUTE. Fíjese que la palabra OUTPUT se indica cuando el parámetro se asigna a la variable. Si no se especifica OUTPUT, la variable no puede mostrar los valores en el comando SELECT al final del código. Por ‘ultimo, el parámetro de entrada @Titulo es igualado a %Garlic%. Este valor se envía a la cláusula WHERE del comando SELECT del procedimiento almacenado. En la cláusula WHERE se pueden usar caracteres comodines (tal como %) para que que la consulta busque aquellos títulos que contienen la palabra Garlic. A continuación se muestra un modo mas sucinto de ejecutar el procedimiento. Fíjese que no es necesario asignar específicamente las variables desde el procedimiento almacenado al valor del parámetro de salida o a las variables de salida declaradas aquí: DECLARE @y_YtdSales int, @t_TitleText varchar(80) EXECUTE SalesForTitle “%Garlic%”, -- configura el valor del parámetro de entrada @y_YtdSales OUTPUT -- recibe el primer parámetro de salida @t_TitleText OUTPUT -- recibe el segundo parámetro de salida -- muestra las procedimiento
variables
retornadas
por
la
ejecución
del
SELECT “Title” = @t_TitleText, “Número de ventas” = @y_YtdSales Procedimientos almacenados Teoria
7
GO Cuando se ejecuta el procedimiento, este retorna lo siguiente: Title NULL
Number Return of Sales NULL
Un interesante resultado de este procedimiento es que se retorna sólo una fila. Aún cuando el comando SELECT en el procedimiento devuelve múltiples filas, cada variable mantiene sólo un valor (la última fila de datos retornada). FUNCIONES DE SISTEMA Hay funciones de sistema que no tienen parámetros y comienzan con @@. Estas funciones no son variables globales porque no puedes declararlas y asignarles un valor a ellas. Estas funciones son controladas por SQL SERVER. System Function @@CONNECTIONS
Return Value Number of connections to SQL Server since the service was started. @@ERROR Error code of the last statement executed (if it succeeded, it returns 0). @@IDENTITY Last identity value inserted in the current session. @@MAX_CONNECTIONS Maximum number of connections allowed. @@OPTIONS Information about set options in the current session. @@ROWCOUNT Number of rows affected by the last statement executed. @@SERVERNAME Name of the server where SQL Server is installed. @@SPID ID Of the current process. @@VERSION Current version of SQL Server.
Procedimientos almacenados Teoria
8
