Procedimientos, Funciones, Trigger y Cursores en ORACLE

Transcripción

1 Procedimientos, Funciones, Trigger y Cursores en ORACLE PROCEDIMIENTOS ALMACENADOS Un procedimiento almacenado es un conjunto de instrucciones en PL/SQL, que pueden ser llamados usando el nombre que se le haya asignado. La sintaxis para crear un procedimiento es la siguiente: CREATE [OR REPLACE] PROCEDURE name [(param [IN OUT IN OUT ] datatype)...] [ AS] pl/sql_subprogram El uso de OR REPLACE permite sobreescribir un procedimiento existente. Si se omite, y el procedimiento ya existe, se producirá un error. Los modificadores IN, OUT, IN OUT indican si el parámetro es de entrada, salida o ambos. A continuación se presenta un ejemplo de creación de un procedimiento: SQL> CREATE PROCEDURE credit (acc_no IN NUMBER, amount IN NUMBER) 1> AS 2> UPDATE accounts 3> SET balance = balance + amount 4> WHERE account_id = acc_no; 5> Este procedimiento actualizará la(s) tupla(s) con números de cuenta igual al parámetro acc_no con un incremento de amount en el balance de dicha cuenta. Si se desea eliminar (borrar) un procedimiento almacenado, se usa la instrucción: SQL> DROP PROCEDURE name; FUNCIONES Una función es un conjunto de instrucciones en PL/SQL, que pueden ser llamados usando el nombre con que se le haya creado. Se diferencian de los procedimientos, en que las funciones retornan un valor al ambiende desde donde fueron llamadas. La sintaxis para crear una función es la siguiente: CREATE [OR REPLACE] FUNCTION name [(param [IN] datatype)...] RETURN datatype [ AS] pl/sql_subprogram El uso de OR REPLACE permite sobreescribir una función existente. Si se omite, y la función ya existe, se producirá, un error. El unico modificador permitido para los parámetros es IN, y si se omite, se tomará por defecto. Es decir, solo se permiten parámetros de entrada. A continuación se presenta un ejemplo de creación de una función: SQL> CREATE FUNCTION get_bal (acc_no IN NUMBER) 1> RETURN NUMBER 2> 3> acc_bal NUMBER(11,2); /* declaración de una variable */ 4> 5> SELECT balance 6> INTO acc_bal /* asignación */ 7> FROM accounts 8> WHERE account_id = acc_no; 9> RETURN(acc_bal); 10> END Año: Cátedra: Base de Datos Página: 1

2 La función get_bal retorna el balance de una cuenta dada. Si se desea eliminar (borrar) una función, se usa la instrucción: SQL> DROP FUNCTION name; TRIGGERS Un trigger es un bloque PL/SQL asociado a una tabla, que se ejecuta cuando una determinada instrucción en SQL se va a ejecutar sobre dicha tabla. La sintaxis para crear un trigger es la siguiente: CREATE [OR REPLACE] TRIGGER {BEFORE AFTER} {DELETE INSERT UPDATE [OF col1, col2,..., coln] [OR {DELETE INSERT UPDATE [OF col1, col2,..., coln]...]} ON table [REFERENCING OLD AS oldname, NEW as newname] [FOR EACH ROW [WHEN (condition)]] pl/sql_block El uso de OR REPLACE permite sobreescribir un trigger existente. Si se omite, y el trigger existe, se producirá, un error. El modificador FOR EACH ROW indica que el trigger se disparará cada vez que se desee hacer operaciones sobre una fila de la tabla. Si se acompaña del modificador WHEN, se establece una restricción; el trigger solo actuará, sobre las filas que satisfagan la restricción. A continuación se presenta un ejemplo de creación de un trigger: SQL> CREATE TRIGGER salary_check 1> BEFORE 2> INSERT OR UPDATE OF sal, job 3> ON employee 4> FOR EACH ROW 5> WHEN (new.job <> 'PRESIDENT') 6> 7> minsal NUMBER 8> maxsal NUMBER 9> 10> /* Se obtienen los valores minimo y maximo para el salario de */ 11> /* un cargo determinado, usando la tabla sal_guide */ 12> SELECT minsal, maxsal 13> INTO minsal, maxsal 14> FROM sal_guide 15> WHERE job = :new.job 16> /* Si el salario del empleado a insertar/modificar esta por */ 17> /* debajo del minimo, o por encima del maximo, se genera */ 19> /* un error. */ 20> IF (:new.sal < minsal OR :new.sal > maxsal) 21> THEN raise_application_error(-20601, 'Salary ' :new.sal 22> ' out of range for job ' :new.job ' for employee ' 23> :new.ename); 24> END IF; 25 > Año: Cátedra: Base de Datos Página: 2

3 Este trigger impide que se agregue o modifique un empleado con el sueldo mayor o menor que los valores maximo y minimo respectivamente para su cargo. Se agrega la restricción de que el trigger no se disparará si el cargo es PRESIDENTE. Si se desea eliminar (borrar) un trigger, se usa la instrucción: SQL> DROP TRIGGER name; CURSORES EXPLÍCITOS EN PL/SQL Declaración de cursores explícitos Los cursores explícitos se emplean para realizar consultas SELECT que pueden devolver cero filas, o más de una fila. Para trabajar con un cursor explicito necesitamos realizar las siguientes tareas: Declarar el cursor. Abrir el cursor con la instrucción OPEN. Leer los datos del cursor con la instrucción FETCH. Cerrar el cursor y liberar los recursos con la instrucción CLOSE. Para declarar un cursor debemos emplear la siguiente sintaxis: CURSOR nombre_cursor instrucción_select También debemos declarar los posibles parametros que requiera el cursor: Para abrir el cursor CURSOR nombre_cursor(param1 tipo1,..., paramn tipon) instrucción_select OPEN nombre_cursor; o bien (en el caso de un cursor con parámetros) OPEN nombre_cursor(valor1, valor2,..., valorn); Para recuperar los datos en variables PL/SQL. -- o bien... FETCH nombre_cursor INTO registro_pl/sql; Para cerrar el cursor: CLOSE nombre_cursor; Año: Cátedra: Base de Datos Página: 3

4 El siguiente ejemplo ilustra el trabajo con un cursor explicito. Hay que tener en cuenta que al leer los datos del cursor debemos hacerlo sobre variables del mismo tipo de datos de la tabla (o tablas) que trata el cursor. SELECT CO_PA, DESCRIPCION, CONTINENTE FROM PAES; co_pais VARCHAR2(3); descripcion VARCHAR2(50); continente VARCHAR2(25); Podemos simplificar el ejemplo utilizando el atributo de tipo %ROWTYPE sobre el cursor. SELECT CO_PA, DESCRIPCION, CONTINENTE FROM PAES; registro cpaises%rowtype; FETCH cpaises INTO registro; El mismo ejemplo, pero utilizando parámetros: (p_continente VARCHAR2) SELECT CO_PA, DESCRIPCION, CONTINENTE FROM PAES WHERE CONTINENTE = p_continente; registro cpaises%rowtype; OPEN cpaises('europa'); FETCH cpaises INTO registro; Cuando trabajamos con cursores debemos considerar: Cuando un cursor si está cerrado, no se puede leer. Cuando leemos un cursor debemos comprobar el resultado de la lectura utilizando los atributos de los cursores. Cuando se cierra el cursor, es ilegal tratar de usarlo. Es ilegal tratar de cerrar un cursor que ya está cerrado o no ha sido abierto Año: Cátedra: Base de Datos Página: 4

5 Atributos de cursores Toman los valores TRUE, FALSE o NULL dependiendo de la situación: Atributo Antes de abrir Al abrir Durante la recuperación Al finalizar la recuperación Después de cerrar %NOTFOUND ORA-1001 NULL FALSE TRUE ORA-1001 %FOUND ORA-1001 NULL TRUE FALSE ORA-1001 %OPEN FALSE TRUE TRUE TRUE FALSE %ROWCOUNT ORA * ** ORA-1001 * Número de registros que ha recuperado hasta el momento ** Número de total de registros Manejo del cursor Por medio de ciclo podemos iterar a través del cursor. Debe tenerse cuidado de agregar una condición para salir del bucle: Vamos a ver varias formas de iterar a través de un cursor. La primera es utilizando un bucle con una sentencia EXIT condicionada: OPEN nombre_cursor; EXIT WHEN nombre_cursor%notfound; /* Procesamiento de los registros recuperados */ CLOSE nombre_cursor; Aplicada a nuestro ejemplo anterior: SELECT CO_PA, DESCRIPCION, CONTINENTE FROM PAES; co_pais VARCHAR2(3); descripcion VARCHAR2(50); continente VARCHAR2(25); EXIT WHEN cpaises%notfound; dbms_output.put_line(descripcion); Otra forma es por medio de un bucle WHILE. La instrucción FECTH aparece dos veces. OPEN nombre_cursor; WHILE nombre_cursor%found /* Procesamiento de los registros recuperados */ Año: Cátedra: Base de Datos Página: 5

6 CLOSE nombre_cursor; SELECT CO_PA, DESCRIPCION, CONTINENTE FROM PAES; co_pais VARCHAR2(3); descripcion VARCHAR2(50); continente VARCHAR2(25); WHILE cpaises%found dbms_output.put_line(descripcion); Por último podemos usar un bucle FOR. Es la forma más corta ya que el cursor es implícitamente se ejecutan las instrucciones OPEN, FECTH y CLOSE. FOR variable IN nombre_cursor /* Procesamiento de los registros recuperados */ FOR REG IN (SELECT * FROM PAES) dbms_output.put_line(reg.descripcion); Año: Cátedra: Base de Datos Página: 6

7 EJEMPLO DE CURSOR SQL --Este procedimiento contiene un cursor SQL que recorre y muestra --los números de la tabla NUMEROS que sean menores o iguales al parámetro CREATE OR REPLACE PROCEDURE recorrenumeros1 ( pub IN number DEFAULT 100 ) is vnum number; CURSOR cnumeros SELECT numero FROM NUMEROS WHERE NUMEROS.numero <= pub; OPEN cnumeros; loop FETCH cnumeros INTO vnum; exit when cnumeros%notfound; dbms_output.put_line('número ' vnum); end loop; CLOSE cnumeros; / show errors set serveroutput on; delete from numeros; EXEC insertanumeroslbubstep(1,10); select * from numeros; EXEC recorrenumeros1(5); Otra forma de codificarlo es: --Este procedimiento contiene un cursor SQL que recorre y muestra --los numeros de la tabla NUMEROS que sean menores o iguales al parametro CREATE OR REPLACE PROCEDURE recorrenumeros2 ( pub IN number DEFAULT 100 ) is CURSOR cnumeros SELECT numero, texto FROM NUMEROS WHERE NUMEROS.numero <= pub; regnum cnumeros%rowtype; OPEN cnumeros; loop FETCH cnumeros INTO regnum; exit when cnumeros%notfound; dbms_output.put_line('número ' regnum.numero ' ' regnum.texto); end loop; CLOSE cnumeros; / show errors set serveroutput on; delete from numeros; EXEC insertanumeroslbubstep(1,10); select * from numeros; EXEC recorrenumeros2(5); Año: Cátedra: Base de Datos Página: 7