GUIA DE PROCEDIMIENTOS Y FUNCIONES ALMACENADOS EN MYSQL Conceptos, historia y contexto http://dev.mysql.com/doc/refman/5.0/es/stored-procedures.html Los procedimientos almacenados y funciones son nuevas funcionalidades de la versión de MySQL 5.0. Un procedimiento almacenado es un conjunto de comandos SQL que pueden almacenarse en el servidor. Una vez que se hace, los clientes no necesitan relanzar los comandos individuales pero pueden en su lugar referirse al procedimiento almacenado. Algunas situaciones en que los procedimientos almacenados pueden ser particularmente útiles: Cuando múltiples aplicaciones cliente se escriben en distintos lenguajes o funcionan en distintas plataformas, pero necesitan realizar la misma operación en la base de datos. Cuando la seguridad es muy importante. Los bancos, por ejemplo, usan procedimientos almacenados para todas las operaciones comunes. Esto proporciona un entorno seguro y consistente, y los procedimientos pueden asegurar que cada operación se loguea apropiadamente. En tal entorno, las aplicaciones y los usuarios no obtendrían ningún acceso directo a las tablas de la base de datos, sólo pueden ejecutar algunos procedimientos almacenados. Los procedimientos almacenados pueden mejorar el rendimiento ya que se necesita enviar menos información entre el servidor y el cliente. El intercambio que hay es que aumenta la carga del servidor de la base de datos ya que la mayoría del trabajo se realiza en la parte del servidor y no en el cliente. Considere esto, si muchas máquinas cliente (como servidores Web) se sirven a sólo uno o pocos servidores de bases de datos. Los procedimientos almacenados le permiten tener bibliotecas o funciones en el servidor de base de datos. Esta característica es compartida por los lenguajes de programación modernos que permiten este diseño interno, por ejemplo, usando clases. Usando estas características del lenguaje de programación cliente es beneficioso para el programador incluso fuera del entorno de la base de datos. Los procedimientos almacenados requieren la tabla proc en la base de datos mysql. Esta tabla se crea durante la instalación de MySQL 5.0. Si está actualizando a MySQL 5.0 desde una versión anterior, asegúrese de actualizar sus tablas de permisos para asegurar que la tabla proc existe. Definición general de procedimientos y funciones en mysql CREATE PROCEDURE sp_name ([parameter[,...]]) [characteristic ...] routine_body CREATE FUNCTION sp_name ([parameter[,...]]) RETURNS type [characteristic ...] routine_body parameter: [ IN | OUT | INOUT ] param_name type type: Any valid MySQL data type characteristic: LANGUAGE SQL | [NOT] DETERMINISTIC | { CONTAINS SQL | NO SQL | READS SQL DATA | MODIFIES SQL DATA } | SQL SECURITY {DEFINER | INVOKER} | COMMENT 'string' routine_body: procedimientos almacenados o comandos SQL válidos La lista de parámetros entre paréntesis debe estar siempre presente. Si no hay parámetros, se debe usar una lista de parámetros vacía () . Cada parámetro es un parámetro IN por defecto. Para especificar otro tipo de parámetro, use la palabra clave OUT o INOUT antes del nombre del parámetro. Especificando IN, OUT, o INOUT sólo es válido para una PROCEDURE. EJEMPLO DE DEFINICIÓN (CREACIÓN, ELIMINACIÓN Y USO) DE UN PROCEDIMIENTO CON PARÁMETROS DE ENTRADA CREACION DE UN PROCEDIMEINTO EN GENERAL CREATE PROCEDURE procedure1 /* nombre */ (IN parameter1 INTEGER) /* parametros */ BEGIN /*inicio del la programación*/ DECLARE variable1 CHAR(10); /* Declarar variables */ IF parameter1 = 17 THEN /* uso del IF */ SET variable1 = 'grande'; /* asignacion */ ELSE SET variable1 = 'pequeño'; /* asignacion */ END IF; /* fin del IF */ INSERT INTO table1 VALUES (variable1); /* sentencia SQL */ END /* fin del la programación */ El anterior procedimiento consiste en guardar en una tabla información dependiendo del valor del parámetro. Adaptaremos el ejemplo: supongamos que en una tabla llamada dimensión que tiene dos atributos, se pretende que dado un atributo, se inserte información en la tabla generando el segundo atributo. Para probar el ejemplo en mysql, debemos crear una base de datos y la tabla de ejemplo dimensión con dos atributos así: Create database prueba; Use prueba; Create table dimension ( Altura int not null, tamano varchar(15) not null ); Creamos el procedimiento así: DELIMITER $$ CREATE PROCEDURE Decidirdimension (IN altura INTEGER) /*Este parámetro es de entrada*/ BEGIN DECLARE variable1 CHAR(15); IF altura >10 THEN SET variable1 = 'grande'; ELSE IF altura >5 THEN SET variable1 = 'mediano'; ELSE SET variable1 = 'pequeno'; END IF; END IF; INSERT INTO dimension VALUES (altura, variable1); END $$ DELIMITER ; Porque es importante el uso del DELIMITER: por defecto mysql usa como ; DELIMITER el punto y coma ( ) , es decir, cada vez que encuentre punto y como(;) ejecuta hasta ahí, debido a que los procedimientos y funciones son varias líneas de códigos y algunas de ellas terminan con este delimiter se ejecutaría solo hasta ahí, lo que ocasionaría un error, es por esto que se hace necesario indicarle a mysql que utilice otro DELIMITER que puede ser cualquiera para el ejemplo usamos $$ y al finalizar la creación del procedimiento o función volvemos a cambiarlo por ; USAR O LLAMAR UN PROCEDIMEINTO Para llamar un procedimiento se utiliza el comando CALL así: CALL nombre_de_procedimiento(parametros); Para el ejemplo seria así: CALL Decidirdimension(5); CALL Decidirdimension(8); CALL Decidirdimension(25); Verificamos si el procedimiento SELECT * FROM dimension; se hizo adecuadamente: ¿Qué está haciendo el procedimiento Decidirdimension? ELIMINAR UN PROCEDIMEINTO DROP PROCEDURE decidirdimension; EJERCICIOS PROPUESTOS DE PROCEDIMEINTOS: Dada la siguiente tabla persona (peso, estado) Realice un procedimiento para determinar si la persona puede donar sangre, si el peso el menor a 50 guarde en estado “no admitido”, en caso contrario seria “admitido”. Dada la siguiente tabla clientes (cedula, nombre, apellido) Cree procedimientos para los siguientes casos 1. Que inserte información en la tabla clientes. Ayuda(recibe tres parámetros de entrada) 2. Que actualice el nombre de un cliente. Ayuda (recibe dos parámetros, numero de cedula de quien se va actualizar y el nuevo nombre) 3. Que elimine un cliente. Ayuda (recibe un parámetro, numero de cedula de quien se va eliminar. 4. Investigar procedimientos con paramentaros de salida. 5. Investigar cómo hacer un ciclo (while). EJEMPLO DE DEFINICIÓN (CREACIÓN, ELIMINACIÓN Y USO) DE UNA FUNCION Ejemplo: se necesita calcular el valor de venta de un producto sabiendo que tiene un costo y porcentaje de ganancia, ejemplo si el costo es 2.000 y el porcentaje de ganancia es 15, el valor venta seria 2.300 Primera pregunta antes de crear una función que paramentaros necesita y que retorna, en este caso se necesita dos valores uno flotante (el costo y otro entero ( el porcentaje de ganancia) y retornara un valor flotante. La función quedaría así: DELIMITER $$ CREATE FUNCTION calcularvalorventa(costo float, porganancia int) RETURNS float DETERMINISTIC BEGIN DECLARE vventa FLOAT default 0; SET vventa = costo +costo*porganancia/100; RETURN vventa; END $$ DELIMITER ; USAR O LLAMAR FUNCION Para llamar una funcion se hece dentro del select asi: SELECT nombre_de_funcion(parametros); Para el ejemplo seria así: select calcularvalorventa(2000,15) as valorventa; Esta función se puede usar de la siguiente manera con una tabla. Cree una tabla llamada productos (código, nombre, costo, porganancia, cantidad) Create table productos ( Codigo int not null primary key, Nombre varchar(30) not null, Costo float not null, Porganancia int not null, Cantidad float not null ); Inserte varios datos. Insert into productos values(1,’arroz libra’,850,15,10); Insert into productos values(2,’gasesosa 350’,800,20,30); Insert into productos values(3,’avena alpina vaso’,1300,10,45); Insert into productos values(4,’menta helada’,25,100,150); Insert into productos values(5,’salsa tomate fruco 1000gr’,5250,30,8); select codigo, nombre, costo, calcularvalorventa(costo, Porganancia) as valorventa from productos; Se puede crear otra función que calcule la ganancia asi: DELIMITER $$ CREATE FUNCTION calcularganancia(costo float, porganancia int) RETURNS float DETERMINISTIC BEGIN DECLARE ganancia FLOAT default 0; SET ganancia = costo*porganancia/100; RETURN ganancia; END $$ DELIMITER ; Y lo podría utilizar así: select codigo, nombre, costo, calcularvalorventa(costo, Porganancia) as valorventa, calcularganancia(costo, Porganancia) as ganancia from productos; ELIMINAR UNA FUNCION PROCEDIMEINTO DROP FUNCTION calcularganancia; EJERCICIO PROPUESTOS: Ejercicio 1: Dada la siguiente tabla EMPLEADO CEDULA NOMBRE SALARIO BASICO Cree una función para cada punto teniendo en cuenta que: El subsidio de transporte equivale al 7% al salario básico La salud que corresponde al 4% al salario básico La pensión que corresponde al 4% al salario básico Un bono que corresponde al 8% al salario básico El salario integral es la suma del salario básico -salud - pension +bono + sub de transporte. Cree un procedimiento que Inserte información a la tabla y pruebe las funciones. Ejercicio 2: Dada la siguiente tabla EMPLEADO CEDULA NOMBRE SALARIO BASICO SUBSIDIO SALUD PENSION BONO SALARIO INTEGRAL Cree una función para cada punto teniendo en cuenta que: El subsidio de transporte equivale al 7% al salario básico La salud que corresponde al 4% al salario básico La pensión que corresponde al 4% al salario básico Un bono que corresponde al 8% al salario básico El salario integral es la suma del salario básico -salud - pension +bono + sub de transporte. Cree un procedimiento que Inserte información a la tabla y pruebe las funciones.