PG/PLSQL. Miguel Ángel Manso ETSI en Topografía, Geodesia y Cartografía - UPM

Transcripción

1 PG/PLSQL Miguel Ángel Manso ETSI en Topografía, Geodesia y Cartografía - UPM Índice Estructura PL/PGSQL Declaraciones, Alias para parámetros en funciones Datos de tipo tabla, Type & RowType Sentencias, estructuras de control Reporte de errores, cursores Triggers 1

2 Estructura PL/PGSQL CREATE OR REPLACE PROCEDURE [esquema].nombre-procedimiento(nombre-parámetro {IN, OUT, IN OUT} tipo de dato,..) {IS, AS} Declaración de variables; Declaración de constantes; Declaración de cursores; Cuerpo del subprograma PL/SQL; EXCEPTION Bloque de excepciones PL/SQL; CREATE OR REPLACE FUNCTION [esquema].nombre-funcion(nombre-parámetro {IN, OUT, IN OUT} tipo-dedato,..) RETURN tipo-de-dato {IS, AS} Declaración de variables; Declaración de constantes; Declaración de cursores; Cuerpo del subprograma PL/SQL; EXCEPTION Bloque de excepciones PL/SQL; Declaraciones Sintaxis general: name [ CONSTANT ] type [ NOT NULL ] [ { DEFAULT := } expression ]; Ejemplos: user_id integer; quantity numeric(5); url varchar; myrow tablename%rowtype; Registro myfield tablename.columnname%type; Tipo col. arow RECORD; Registro quantity INTEGER DEFAULT 32; url varchar := ; user_id CONSTANT INTEGER := 10; 2

3 Alias para parámetros de funciones name ALIAS FOR $n; Ejemplo: CREATE FUNCTION sales_tax(real) RETURNS REAL AS DECLARE subtotal ALIAS FOR $1; return subtotal * 0.06; LANGUAGE plpgsql ; CREATE FUNCTION instr(varchar, INTEGER) RETURNS INTEGER AS DECLARE v_string ALIAS FOR $1; index ALIAS FOR $2; Datos de tipo Tabla name tablename%rowtype; -- Variable de tipo complejo (registro) -- Se usa name.fieldname CREATE FUNCTION use_two_tables(tablename) RETURNS TEXT AS DECLARE in_t ALIAS FOR $1; use_t table2name%rowtype; SELECT * INTO use_t FROM table2name WHERE... ; RETURN in_t.f1 use_t.f3 in_t.f5 use_t.f7; LANGUAGE plpgsql ; 3

4 Type & RowType Conocer el tipo de dato de una variable Type user_id users.user_id%type; Para crear una variable de tipo registro asociado a las columnas de una tabla users_rec users%rowtype; Sentencias Asignación: <Variable> := <valor>; user_id := 20; tax := subtotal * 0.06; SELECT INTO target select_expressions FROM...; SELECT INTO Result * FROM EMP WHERE empname = myname; IF NOT FOUND THEN RAISE EXCEPTION El empleado % no existe, myname; END IF; Ejecución sin resultados: PERFORM query; PERFORM create_mv( cs_session_page_requests_mv, my_query); 4

5 Sentencias No hacer nada: Null; Ejecución dinámica: EXECUTE texto-comando; EXECUTE UPDATE tabla SET quote_ident(nombrecampo) = quote_literal(nuevovalor) WHERE... ; Obtener resultado de la última ejecución: GET DIAGNOSTICS variable = item [,... ] ; Ejemplos: GET DIAGNOSTICS Variable_int = ROW_COUNT; -- Cantidad de filas GET DIAGNOSTICS estado = FOUND; -- True/False último resultado Estructuras de control Retorno de resultados: Return expresión; Condicionales: IF... THEN IF... THEN... ELSE IF... THEN... ELSE IF IF... THEN... ELSIF... THEN... ELSE IF... THEN... ELSEIF... THEN... ELSE 5

6 Bucles Bucles simples: [<<label>>] LOOP sentencias EXIT [ label ] [ WHEN expresion ]; Ejemplos: LOOP -- algunos cálculos IF count > 0 THEN EXIT; -- exit loop END IF; LOOP -- otros cálculos EXIT WHEN count > 0; Bucle While While [<<label>>] WHILE expresión LOOP sentencias Ejemplos WHILE amount_owed > 0 AND gift_certificate_balance > 0 LOOP -- algunos cálculos WHILE NOT expresión_booleana LOOP -- algunos cálculos 6

7 Bucle For For [<<label>>] FOR nombre IN [ REVERSE ] expresión.. expresión LOOP sentencias Ejemplos FOR i IN LOOP -- algunas expresiones RAISE NOTICE i is %,i; FOR i IN REVERSE LOOP -- algunas expresiones Iterar sobre resultados Iterar sobre resultados [<<etiqueta>>] FOR fila IN consulta LOOP sentencias Ejemplo CREATE FUNCTION cs_refresh_mviews () RETURNS INTEGER AS DECLARE mviews RECORD; PERFORM cs_log( Actualizando las vistas... ); FOR mviews IN SELECT * FROM vista_cs ORDER BY sort_key LOOP -- Ahora "mviews" contiene un registro de vista_cs PERFORM cs_log( Actualizando las vistas quote_ident(mviews.mv_name).. RETURN 1; LANGUAGE plpgsql ; 7

8 Reportar errores RAISE level format [, variable [...]]; Ejemplos: RAISE NOTICE Invocando cs_create_job(%),v_job_id; RAISE EXCEPTION No existe el ID --> %,user_id; Cursores Declaración: nombre CURSOR [ ( argumentos ) ] FOR IS consulta ; Ejemplos: curs1 refcursor; --Es un tipo de dato genérico para cursores curs2 CURSOR FOR SELECT * FROM tenk1; curs3 CURSOR (key integer) IS SELECT * FROM tenk1 WHERE unique1 = key; Abrir cursor para usar: OPEN unbound_cursor FOR SELECT...; OPEN unbound_cursor FOR EXECUTE query_string; Ejemplos: OPEN curs1 FOR SELECT * FROM foo WHERE key = mykey; OPEN curs1 FOR EXECUTE 'SELECT * FROM ' quote_ident($1); 8

9 Cursores Usar cursores: FETCH cursor INTO target; Cerrar cursores: CLOSE cursor; Retornar cursores: CREATE TABLE prueba (columna text); INSERT INTO prueba VALUES ( 123 ); CREATE FUNCTION reffunc(refcursor) RETURNS refcursor AS OPEN $1 FOR SELECT columna FROM prueba; RETURN $1; LANGUAGE plpgsql ; ; SELECT reffunc( funccursor ); FETCH ALL IN funccursor; COMMIT; Triggers CREATE TRIGGER --- argumentos vía TG_ARGV Posibles argumentos: NEW variable con los nuevos datos OLD Variable con el dato antiguo TG_NAME Nombre del trigger TG_WHEN Cuándo se dispara AFTER, BEFORE TG_LEVEL Nivel al que afecta: fila, sentencia TG_OP Operación que dispara (INSERT, UPDATE; DELETE) TG_RELID ID del objecto de la tabla que dispara el trigger TG_RELNAME nombre de la tabla que dispara el trigger TG_NARGS nº de argumentos TG_ARGV[] 9

10 Mas sobre trigger CREATE TRIGGER nombre { BEFORE AFTER } { INSERT UPDATE DELETE [ OR... ] } ON tabla [ FOR [ EACH ] { ROW STATEMENT } ] EXECUTE PROCEDURE nombre_de_función ( argumentos ) Ejemplo trigger 1 CREATE TABLE numeros( numero bigint NOT NULL, cuadrado bigint, cubo bigint, raiz2 real, raiz3 real, PRIMARY KEY (numero) ); 2 CREATE OR REPLACE FUNCTION rellenar_datos() RETURNS TRIGGER AS $rellenar_datos$ DECLARE NEW.cuadrado := power(new.numero,2); NEW.cubo := power(new.numero,3); NEW.raiz2 := sqrt(new.numero); NEW.raiz3 := cbrt(new.numero); RETURN NULL; $rellenar_datos$ LANGUAGE plpgsql; 3 CREATE TRIGGER rellena_datos BEFORE INSERT OR UPDATE ON numeros FOR EACH ROW EXECUTE PROCEDURE rellenar_datos(); 10

11 Ejemplo trigger CREATE TABLE emp ( empname text, salary integer, last_date timestamp, last_user text ); CREATE FUNCTION emp_stamp () RETURNS TRIGGER AS IF NEW.empname ISNULL THEN -- Comprueba que se proporcionan: empname y salary RAISE EXCEPTION empname no puede ser NULL ; END IF; IF NEW.salary ISNULL THEN RAISE EXCEPTION El empleado % no puede tener salario NULL, NEW.empname; END IF; IF NEW.salary < 0 THEN -- El sueldo no puede ser negativo! RAISE EXCEPTION El empleado % no puede tener salario negativo, NEW.empname; END IF; NEW.last_date := now ; -- Se almacena quién y cuándo se cambiaron los datos NEW.last_user := current_user; RETURN NEW; LANGUAGE plpgsql ; CREATE TRIGGER emp_stamp BEFORE INSERT OR UPDATE ON emp FOR EACH ROW EXECUTE PROCEDURE emp_stamp(); Referencias Triggers: 11