Oracle PL/SQL                            Autor:                Eduardo Bottini                      ebottini@c-s-i.com.arP...
Oracle PL/SQL – Variables de tipo Cursor.Oracle nos permite utilizar dentro de sus procedimientos almacenadosvariables que...
Oracle PL/SQL – Variables de tipo Cursor.     CREATE TABLE AUTORES (            CODIGO_AUTOR           NUMBER(5) NOT NULL,...
Oracle PL/SQL – Variables de tipo Cursor. Luego de creado, para ejecutarlo desde el SqlPlus de Oracle debe primero declara...
Oracle PL/SQL – Variables de tipo Cursor.                    OPEN res FOR SELECT null FROM DUAL;               END IF;    ...
Oracle PL/SQL – Variables de tipo Cursor.comodines al parámetro recibido.Finalmente veremos cómo ejecutar esta función des...
Oracle PL/SQL – Variables de tipo Cursor.    -- Definición de la variable de tipo cursor        Res PKG_REFCURS.REFCURS;  ...
Oracle PL/SQL – Variables de tipo Cursor.    Open;            // Usamos OPEN en lugar de ExecProc                     // y...
Oracle PL/SQL – programación con Paquetes.Además de brindarnos múltiples elementos que nos permiten desarrollaruna aplicac...
Oracle PL/SQL – programación con Paquetes.utiliza el paquete tal como veremos en el ejemplo final. La sección de inicializ...
Oracle PL/SQL – programación con Paquetes.Alta es la única función pública del paquete.Veamos la definición de la tabla:  ...
Oracle PL/SQL – programación con Paquetes.        FUNCTION ALTA RETURN NUMBER AS        BEGIN           WG_SECUENCIA := WG...
Oracle PL/SQL – Desarrollo de funciones SQL                                         En esta entrega veremos las reglas que...
Oracle PL/SQL – Desarrollo de funciones SQLFigura 1 . Tabla de PersonasCREATE TABLE PERSONAS(   CODIGO    NUMBER(10)      ...
END;/Lo primero que haremos será chequear el correcto funcionamiento de la función de validación que hemoscreado, que nos ...
Oracle PL/SQL – Desarrollo de funciones SQLLa clásula Pragma Restrict_References debe ir en el encabezado del Paquete, y s...
Oracle PL/SQL – Desarrollo de funciones SQLFigura 8 . Ejecución exitosa de la función como función SQL           dentro de...
Oracle PL/SQL – SQL dinámico                                              Una herramienta que nos permite añadir          ...
Oracle PL/SQL – SQL dinámicoCREATE OR REPLACE PROCEDURE DBMS_EJEMPLOAS   ID INTEGER;   TABLA VARCHAR2(20);   CAMPOS VARCHA...
Oracle PL/SQL – SQL dinámico      DESCRIPCION   VARCHAR2(50) NOT NULL,      PRIMARY KEY (CODIGO),      FOREIGN KEY (TIPO) ...
Oracle PL/SQL – SQL dinámico             (CHIP_VALIDO, WNDS, WNPS, RNPS);END;/CREATE OR REPLACE          PACKAGE BODY PKG_...
Oracle PL/SQL – SQL dinámico    -- obtenemos el nombre de la función que    -- debemos invocar a fin de    -- validar el t...
Oracle PL/SQL – SQL dinámicoListado 5 . Función central – Uso de Sql dinámico.Ya tenemos casi todo listo, sólo nos falta e...
Upcoming SlideShare
Loading in …5
×

44777047 oracle

1,077 views

Published on

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,077
On SlideShare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
39
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

44777047 oracle

  1. 1. Oracle PL/SQL Autor: Eduardo Bottini ebottini@c-s-i.com.arProhibida la reproducción total o parcial sin permiso explícito del autor.
  2. 2. Oracle PL/SQL – Variables de tipo Cursor.Oracle nos permite utilizar dentro de sus procedimientos almacenadosvariables que referencian a cursores de datos. Estas variables sonpunteros y llevan el nombre de Ref Cursor. Delphi, por su parte, accede aéstas en forma nativa mediante el tipo de dato ftCursor. A partir de este número de Mundo Delphi comenzamos con una serie de artículos que tratan sobre lascaracterísticas más potentes del lenguaje PL/SQL de Oracle. En esta edición, donde ahondaremos en losdetalles del tema del título principal, veremos también algunos de estos atributos tales como el manejo deexcepciones y la programación utilizando paquetes (packages), temas éstos que profundizaremos enpróximas entregas.El tipo Ref Cursor Las variables de tipo cursor son referencias a cursores, más precisamente son punteros a un área detrabajo donde Oracle almacena los datos que resultan de una selección de múltiples registros.Estos punteros almacenan la dirección de memoria del objeto apuntado (y no el objeto en sí, tal como lohace un cursor explícito) y por lo tanto pueden pasarse como parámetros de entrada/salida entreprocedimientos almacenados o funciones de PL/SQL residentes en el servidor, y programas clientesescritos en otros lenguajes como Delphi, Pro*C, etc.Este pasaje de parámetros puede realizarse en ambos sentidos (Cliente/Servidor/Cliente) a fin de podertrabajar en cualquiera de estos entornos accediendo simultáneamente al mismo área de trabajo donderesiden los datos de la consulta realizada. Esto equivale a decir que podemos compartir entreprocedimientos y funciones escritas en diferentes lenguajes y ejecutándose en diferentes máquinas elresultado de una consulta residente en el servidor, sin importar quién la haya generado.Para crear este tipo de variables debe definirse primero un tipo Ref Cursor y luego declarar la variable deeste tipo. Por ejemplo:TYPE tRc_tipo IS REF CURSOR;Res tRc_tipo;En este pequeño ejemplo hemos declarado Res como una variable de tipo cursor.En PL/SQL, cualquier puntero posee el tipo de dato REF (que es la abreviatura de Reference) y la clasede objeto a la que apunta. De allí que un Ref Cursor sea un puntero a un Cursor.Tipos de Ref Cursor según la clase de resultado al que referencianDependiendo de la especificación o no del formato de datos a los que apunta una variable de tipo cursor,se las puede clasificar en 2 tipos:Tipo restrictivo: Se debe especificar un tipo de resultado asociado al formato del registro que devolveráel Select. En este caso el compilador de PL/SQL controla que el resultado de la consulta coincida con eltipo de dato asociado. Por ejemplo, si asociamos el resultado con un %RowType (tipo de registro querepresenta a una fila de una tabla) sólo podremos utilizar la variable cursor con una consulta que devuelvaun registro exactamente igual a ese %RowType.Tipo no Restrictivo: A partir de la versión 7.3 de Oracle no es necesario especificar un tipo de resultado,pudiéndose de esta manera asociar un puntero a cualquier clase de consulta. Esta forma es mucho másflexible ya que podremos declarar los punteros una vez y utilizarlos en cualquier momento para manipularcualquier consulta. Al tipo de resultado apuntando por un Ref Cursor no restrictivo se lo denomina Variant Record.Ejemplos de definición, declaración y uso de Ref Cursor Para todos los ejemplos que veremos en este artículo utilizaremos un “modelo de datos” de dos tablas:Libros y AutoresVeamos a continuación el esquema de estas tablas en formato de comandos de creación de las mismasjunto con sus índices, llaves primarias y foráneas. 1
  3. 3. Oracle PL/SQL – Variables de tipo Cursor. CREATE TABLE AUTORES ( CODIGO_AUTOR NUMBER(5) NOT NULL, NOMBRE VARCHAR2(100) NOT NULL, FECHA_NACIMIENTO DATE NULL, PRIMARY KEY (CODIGO_AUTOR) ); CREATE INDEX XIE1AUTORES ON AUTORES (NOMBRE); CREATE TABLE LIBROS ( CODIGO NUMBER(5) NOT NULL, NOMBRE VARCHAR2(100) NOT NULL, FECHA_EDICION DATE NOT NULL, PRESTADO VARCHAR2(1) NOT NULL CHECK (PRESTADO IN (S, N)), CANT_PAGINAS NUMBER(5) NULL, CODIGO_AUTOR NUMBER(5) NOT NULL, PRIMARY KEY (CODIGO), FOREIGN KEY (CODIGO_AUTOR) REFERENCES AUTORES ); CREATE INDEX XIE1LIBROS ON LIBROS (FECHA_EDICION); CREATE INDEX XIE2LIBROS ON LIBROS (NOMBRE);En el siguiente ejemplo detallaremos cómo definir las dos clases de Ref Cursor que vimos anteriormente.En el primer caso, REFCURS_AUTORES es de tipo restrictivo ya que las variables declaradas bajo estetipo de dato deberán apuntar obligatoriamente a cursores de un tipo de dato equivalente. En este ocasiónel tipo de dato coincide con el formato de registro de la tabla Autores (RowType). Si se intentara utilizaruna variable de este tipo para apuntar a un cursor no coincidente con la definición de la misma, elcompilador de PL/SQL nos indicará el error.El segundo tipo de Ref Cursor, REFCURS, corresponde a uno no restrictivo y tal como veremos en losejemplos puede utilizarse para apuntar a cualquier tipo de cursor de datos.Para realizar la definición de ambos tipos utilizaremos un encabezado de Paquete. Esto nos permitirá quenuestra definición de tipos sea global y podamos utilizarla en cualquier procedimiento o funciónalmacenada dentro del servidor. CREATE OR REPLACE PACKAGE PKG_REFCURS AS TYPE REFCURS_AUTORES IS REF CURSOR RETURN AUTORES%ROWTYPE; TYPE REFCURS IS REF CURSOR; END; / Una vez definidos los tipos podemos declarar las variables y utilizarlas. En el siguiente ejemplocrearemos una función que utiliza el tipo restrictivo de variable para retornar un puntero que referencia aun cursor cuya fuente de datos es una selección de la tabla Autores. CREATE OR REPLACE FUNCTION FRC_TRAE_AUTORES RETURN PKG_REFCURS.REFCURS_AUTORES AS -- Declaración de la variable de tipo cursor, utilizando el tipo restrictivo res PKG_REFCURS.REFCURS_AUTORES; BEGIN OPEN res FOR SELECT * FROM AUTORES; -- Retorno del puntero al resultado del Select RETURN res; END; / 2
  4. 4. Oracle PL/SQL – Variables de tipo Cursor. Luego de creado, para ejecutarlo desde el SqlPlus de Oracle debe primero declararse dentro de esteentorno una variable de tipo RefCursor que nos servirá como repositorio del puntero devuelto por lafunción.Para declarar la variable, que nos servirá también para el resto de los ejemplos, debe escribirse: VAR R RefCursor;Para ejecutar la función, escribimos: EXEC :R := FRC_TRAE_AUTORES;Para ver el resultado de la consulta debemos mostrar el contenido del puntero R. Para esto se utiliza elcomando PRINT, de la siguiente forma: PRINT R;Otra forma de programar el ejemplo anterior es mediante un procedimiento almacenado en lugar de unafunción. En este caso veremos cómo debe recibirse la variable de tipo cursor en forma de parámetro deentrada/salida (IN OUT) ya que a través de la misma se recibirá/retornará el valor del puntero. Estavariable debe encontrase previamente declarada en el programa llamador (en este caso el SqlPlus, nuestraya declarada variable R). CREATE OR REPLACE PROCEDURE PRC_TRAE_AUTORES (RES IN OUT PKG_REFCURS.REFCURS_AUTORES) AS BEGIN OPEN RES FOR SELECT * FROM AUTORES; RETURN; END; / Para ejecutarlo, se debe llamar al procedimiento almacenado enviando como parámetro la variable R, yluego mostramos el contenido de la misma con el comando PRINT. EXEC PRC_TRAE_AUTORES (:R) ; PRINT R; Ahora mostraremos un ejemplo de uso del tipo no restrictivo. A esta nueva función le pasaremos comoparámetro una señal que indicará sobre cual tabla queremos que realice la consulta: Autores o Libros.Al ser la variable Res del tipo Ref Cursor no restrictivo puede apuntar tanto a uno como a otro cursorindistintamente, dependiendo de la señal A_O_L que le es enviada a la función. CREATE OR REPLACE FUNCTION FRC_TRAE_AUTORES_O_LIBROS (A_O_L IN VARCHAR2) RETURN PKG_REFCURS.REFCURS AS -- Declaración de la variable de tipo cursor, usando el tipo no restrictivo res PKG_REFCURS.REFCURS; BEGIN IF (A_O_L = ‘A’) THEN OPEN res FOR SELECT * FROM AUTORES; ELSIF (A_O_L = ‘L’) THEN OPEN res FOR SELECT * FROM LIBROS; ELSE 3
  5. 5. Oracle PL/SQL – Variables de tipo Cursor. OPEN res FOR SELECT null FROM DUAL; END IF; -- Dependiendo de la señal A_O_L , la variable Res apuntará al query de Autores o Libros. RETURN res; END; /Para ejecutarlo: EXEC :R := FRC_TRAE_AUTORES_O_LIBROS(L); Ó EXEC :R := FRC_TRAE_AUTORES_O_LIBROS(A); Y luego: PRINT R; Dependiendo del parámetro enviado, R nos mostrará el resultado de la selección de la tabla Autores o dela tabla Libros.Conveniencia del uso de variables de tipo cursor Probablemente a esta altura del artículo el lector se esté preguntando cuáles son las ventajas de trabajarcon este esquema de manipulación de datos.Ventajas pueden citarse muchas, como ser más potencia y flexibilidad en la programación, mayorclaridad y calidad del código, etc.Pero sin duda la mayor ventaja es la posibilidad de crear aplicaciones Cliente/Servidor realmente robustasy que puedan obtener el máximo provecho de todas las capacidades que nos ofrece un motor de base dedatos como Oracle a través de su poderoso lenguaje PL/SQL.A fin de ejemplificar el concepto, voy a detallar dos características importantes. Existen más y las iremosviendo en próximas entregas, en la medida que vayamos profundizando en las poderosas herramientasque nos ofrece Oracle.Encapsulamiento: Las consultas quedan centralizadas en los procedimientos y funciones almacenadas enlugar de tenerlas codificadas en la aplicación cliente. La inteligencia, complejidad y métodos para obtenerla información (donden se involucran las “reglas del negocio”) residen de esta manera en el servidor dedatos, ocultando todo detalle de funcionamiento a las aplicaciones clientes.Como ventaja adicional podemos agregar que se reduce sensiblemente el tráfico en la red al recibir elprograma cliente la información completamente elaborada y lista para mostrar o imprimir.Y por supuesto, también se simplifica notablemente la tarea de mantenimiento de las aplicaciones.Seguridad mejorada: Los usuarios sólo necesitan tener permisos de ejecución de los procedimientos yfunciones que realizan las consultas, no siendo necesario que tengan permisos de acceso a las tablas queestos procedimientos consultan. De esta manera se evitan acc esos indebidos o no deseados a lainformación por fuera de las restricciones que imponen nuestras aplicaciones.Un ejemplo completo de función PL/SQL que devuelve un Ref Cursor Como ejemplo final veremos una función que realiza una consulta de libros y autores, con filtrosdeterminados por los parámetros que recibe. Estos parámetros son el nombre del autor, o parte del mismo,y una fecha de edición de libros que será tomada como fecha límite base para seleccionar los datos.Como detalle, y a diferencia de los anteriores ejemplos, podemos ver un manejo básico de errores en elbloque Exception y una sencilla forma de armar en tiempo de ejecución una cláusula Like agregando 4
  6. 6. Oracle PL/SQL – Variables de tipo Cursor.comodines al parámetro recibido.Finalmente veremos cómo ejecutar esta función desde otro procedimiento PL/SQL y desde un programaDelphi. CREATE OR REPLACE FUNCTION FRC_TRAE_LIBROS (AUTOR AUTORES.NOMBRE%TYPE, FECHA_DESDE LIBROS.FECHA_EDICION%TYPE) RETURN PKG_REFCURS.REFCURS AS -- Declaración de variables locales. -- Res es de tipo no restrictivo res PKG_REFCURS.REFCURS; -- Esta variable se utiliza para armar la cláusula Like en tiempo -- de ejecución para buscar por nombre de autor. cadena_auxiliar VARCHAR2(150); BEGIN -- Comienzo del bloque de código cadena_auxiliar := % || RTRIM (LTRIM (AUTOR) ) || %; OPEN res FOR SELECT A.CODIGO AS CODIGO_LIBRO, A.NOMBRE AS NOMBRE_LIBRO, A.FECHA_EDICION, A.PRESTADO, B.NOMBRE AS NOMBRE_AUTOR, B.FECHA_NACIMIENTO FROM LIBROS A, AUTORES B WHERE A.FECHA_EDICION >= fecha_desde AND A.CODIGO_AUTOR = B.CODIGO_AUTOR AND B.NOMBRE LIKE cadena_auxiliar; -- Retorno del puntero al cursor obtenido RETURN res; EXCEPTION – Comienzo del bloque de manejo de excepciones WHEN OTHERS THEN RAISE_APPLICATION_ERROR (-20999, TO_CHAR(SQLCODE) || : Se produjo un error en la búsqueda de libros - || SUBSTR(SQLERRM, 1, 256) ); CLOSE res; RETURN res; -- En caso de que se produzca cualquier excepción -- devolvemos un puntero a un cursor cerrado. END; /Ejecución y acceso desde un bloque PL/SQL El siguiente bloque de código PL/SQL ejecuta la función FRC_TRAE_LIBROS, mostrando el resultadode la consulta generada y devuelta a través del Ref Cursor que retorna esta función.Nuestro criterio de selección será obtener los datos de libros del autor Stephen King (de quien sóloenviaremos la sub-cadena King) y cuya fecha de edición sea posterior al 1-1-1970.Nota: Antes de ser ejecutado este código, en el SqlPlus debe escribirse: SET SERVEROUTPUT ON. Estasentencia activa la funcionalidad del DBMS_OUTPUT.PUT_LINE (que es el equivalente PL/SQL alwriteln de Pascal) DECLARE -- declaración de un tipo de registro donde guardar cada fila de la consulta TYPE tRecRes IS RECORD ( codigo_libro LIBROS.CODIGO%TYPE, nombre_libro LIBROS.NOMBRE%TYPE, fecha_edicion LIBROS.FECHA_EDICION%TYPE, prestado LIBROS.PRESTADO%TYPE, nombre_autor AUTORES.NOMBRE%TYPE, fecha_nacimiento AUTORES.FECHA_NACIMIENTO%TYPE ); 5
  7. 7. Oracle PL/SQL – Variables de tipo Cursor. -- Definición de la variable de tipo cursor Res PKG_REFCURS.REFCURS; -- Definición de la variable de tipo registro RecRes tRecRes;BEGIN -- Llamamos a la función que abre la consulta y nos devuelve un puntero a la misma -- A esta función le enviamos como parámetros parte del nombre del autor y una fecha -- de edición base, con el fin de filtrar la consulta. Res := FRC_TRAE_LIBROS (‘KING’, TO_DATE(‘01011970’, ‘ddmmyyyy’)); -- Recorremos el cursor y mostramos todas sus filas por pantalla LOOP FETCH Res INTO RecRes; EXIT WHEN Res%NOTFOUND; DBMS_OUTPUT.PUT_LINE (‘Nombre Libro: ’ || RecRes.nombre_libro); DBMS_OUTPUT.PUT_LINE (‘Fecha Edición: ’ || TO_CHAR (RecRes.fecha_edicion, ‘dd-mm-yyyy’)); DBMS_OUTPUT.PUT_LINE (‘Código Libro: ’ || TO_CHAR (RecRes.codigo_libro)); DBMS_OUTPUT.PUT_LINE (‘Prestado (s/n): ’ || RecRes.prestado); DBMS_OUTPUT.PUT_LINE (‘Nombre Autor: ’ || RecRes.nombre_autor); DBMS_OUTPUT.PUT_LINE (‘F. Nac. Autor: ’ || TO_CHAR (RecRes.fecha_nacimiento, ‘dd-mm-yyyy’)); DBMS_OUTPUT.PUT_LINE (‘------------------------------------------------------‘); END LOOP; END;/ Ejecución y acceso desde Delphi Desde nuetros programas Delphi podemos ejecutar un procedimiento almacenado o función Oracle de las carácterísticas de FRC_TRAE_LIBROS utilizando el componente TStoredProc. El resultado de la función, un Ref Cursor, será recibido en un parámetro Result del tipo ftCursor. Un importante detalle al que debe prestarse atención es que el TStoredProc debe ser ejecutado utilizando la sentencia Open en lugar de ExecSql debido a que precisamente lo que obtenemos como resultado de la ejecución es un DataSet, tal como si se tratara de la apertura de un TQuery. En los ejemplos que se adjuntan con la revista (el POracle_RC) se incluye tanto el código que sigue a continuación como un ejemplo de uso del componente TstoredProc en tiempo de diseño y con salida de la información a una grilla. El ejemplo está codificado en Delphi 4 C/S y tiene las mismas características de filtrado y presentación de la información que el ejemplo inmediato anterior en PL/SQL. Procedure TFOracle_RC.BtnTestClick(Sender: TObject); Var sp: TStoredProc; Begin Try sp := TStoredProc.Create(nil); With sp do Begin DatabaseName := base.DatabaseName; // base es el nombre de un TDatabase StoredProcName := FRC_TRAE_LIBROS; Params.clear; Params.CreateParam(ftString, AUTOR, ptInput); Params.CreateParam(ftDateTime, FECHA_DESDE, ptInput); Params.CreateParam(ftCursor, Result, ptResult); ParamByName(AUTOR).AsString := KING; ParamByName(FECHA_DESDE).AsDateTime := strtodatetime(01/01/1970); 6
  8. 8. Oracle PL/SQL – Variables de tipo Cursor. Open; // Usamos OPEN en lugar de ExecProc // y luego tomamos los valores con FieldByName. While not EOF do Begin Showmessage( Nombre Libro: + Fieldbyname(NOMBRE_LIBRO).AsString + #10#13 + Fecha Edición: + FormatDateTime(dd/mm/yyyy, Fieldbyname(FECHA_EDICION).AsDateTime) + #10#13 + Código Libro: + Fieldbyname(CODIGO_LIBRO).AsString + #10#13 + Prestado (s/n): + Fieldbyname(PRESTADO).AsString + #10#13 + Nombre Autor: + Fieldbyname(NOMBRE_AUTOR).AsString + #10#13 + F.Nac. Autor: + FormatDateTime(dd/mm/yyyy, Fieldbyname(FECHA_NACIMIENTO).AsDateTime)); Next; End; Close; End; Finally sp.Free; End;End; 7
  9. 9. Oracle PL/SQL – programación con Paquetes.Además de brindarnos múltiples elementos que nos permiten desarrollaruna aplicación robusta, Oracle nos ofrece la posibilidad de programar enforma modular, clara y eficiente. Siguiendo con nuestro tutorial sobre elementos avanzados de programación Oracle PL/Sql, en estaoportunidad veremos cómo embeber procedimientos, funciones, definiciones de tipos de datos ydeclaraciones de variables en una misma estructura que los agrupe y relacione lógicamente. Estaestructura se denomina Package (Paquete) y su uso nos permite no sólo mejorar la calidad de diseño denuestras aplicaciones sino también optimizar el desempeño de las mismas.Packages. Como vimos, un Paquete es un objeto PL/Sql que agrupa lógicamente otros objetos PL/Sql relacionadosentre sí, encapsulándolos y convirtiéndolos en una unidad dentro de la base de datos.Los Paquetes están divididos en 2 partes: especificación (obligatoria) y cuerpo (no obligatoria). Laespecificación o encabezado es la interfaz entre el Paquete y las aplicaciones que lo utilizan y es allídonde se declaran los tipos, variables, constantes, excepciones, cursores, procedimientos y funciones quepodrán ser invocados desde fuera del paquete.En el cuerpo del paquete se implementa la especificación del mismo.Entonces, el formato de un Paquete es el siguiente: CREATE [OR REPLACE] PACKAGE nombre AS -- especificación (parte visible) -- declaración de tipos y variables públicas -- especificación de procedimientos y funciones END [nombre]; CREATE [OR REPLACE] PACKAGE BODY nombre AS -- cuerpo (parte oculta) -- declaración de tipos y variables privadas -- cuerpo de procedimientos y funciones [BEGIN -- rutinas de ejecución inicial] END [nombre];La especificación contiene las declaraciones públicas, o sea, la declaración de elementos que son visiblesa las aplicaciones que tienen acceso a ese mismo esquema dentro de la base de datos.El cuerpo contiene los detalles de implementación y declaraciones privadas, manteniéndose todo éstooculto a las aplicaciones externas, siguiendo el conocido concepto de “caja negra”.Dicho de otra manera, sólo las declaraciones hechas en la especificación del paquete son visibles yaccesibles desde fuera del paquete (por otras aplicaciones o procedimientos almacenados) quedando losdetalles de implementación del cuerpo del paquete totalmente ocultos e inaccesibles para el exterior.Para acceder a los elementos declarados en un paquete basta con anteceder el nombre del objecto areferenciar con el nombre del paquete donde está declarado y un punto, de esta manera:Paquete.Objetodonde Objeto puede ser un tipo, una variable, un cursor, un procedimiento o una función declaradosdentro del paquete. Esta notación es válida tanto para referenciar desde procedimientos o triggers externos al paquete comodesde aplicaciones escritas en otros lenguajes o mismo desde herramientas como el Sql*Plus.Para referenciar objetos desde adentro del mismo paquete donde han sido declarados no es necesarioespecificar el nombre del paquete y pueden (deberían) ser referenciados directamente por su nombre.Finalmente y siguiendo a la parte declarativa del cuerpo de un paquete puede, opcionalmente, incluirse lasección de inicialización del paquete. En esta sección pueden, por ejemplo, inicializarse variables que 8
  10. 10. Oracle PL/SQL – programación con Paquetes.utiliza el paquete tal como veremos en el ejemplo final. La sección de inicialización se ejecuta sólo laprimera vez que una aplicación referencia a un paquete, ésto es, se ejecuta sólo una vez por sesión.Ventajas del uso de Paquetes.Dentro de las ventajas que ofrece el uso de paquetes podemos citar que: Permite modularizar el diseño de nuestra aplicación El uso de Paquetes permite encapsular elementos relacionados entre sí (tipos, variables, procedimientos,funciones) en un único módulo PL/Sql que llevará un nombre que identifique la funcionalidad delconjunto. Otorga flexibilidad al momento de diseñar la aplicación En el momento de diseñar una aplicación todo lo que necesitaremos inicialmente es la información deinterfaz en la especificación del paquete. Puede codificarse y compilarse la especificación sin su cuerpopara posibilitar que otros sub-programas que referencian a estos elementos declarados puedan compilarsesin errores. De esta manera podremos armar un “prototipo” de nuestro sistema antes de codificar el detalledel mismo. Permite ocultar los detalles de implementación Pueden especificarse cuáles tipos, variables y sub-programas dentro del paquete son públicos (visibles yaccesibles por otras aplicaciones y sub-programas fuera del paquete) o privados (ocultos e inaccesiblesfuera del paquete). Por ejemplo, dentro del paquete pueden existir procedimientos y funciones que seráninvocados por otros programas, así como también otras rutinas de uso interno del paquete que no tendránposibilidad de ser accedidas fuera del mismo. Esto asegura que cualquier cambio en la definición de estasrutinas internas afectará sólo al paquete donde se encuentran, simplificando el mantenim iento yprotegiendo la integridad del conjunto. Agrega mayor funcionalidad a nuestro desarrollo Las definiciones públicas de tipos, variables y cursores hechas en la especificación de un paquetepersisten a lo largo de una sesión. Por lo tanto pueden ser compartidas por todos los sub-programas y/opaquetes que se ejecutan en ese entorno durante esa sesión. Por ejemplo, puede utilizarse esta técnica (endónde sólo se define una especificación de paquete y no un cuerpo) para mantener tipos y variablesglobales a todo el sistema. Un ejemplo concreto de ésto fue visto en el número 1 de Mundo Delphi, en el artículo que trata sobre“Ref Cursores”, donde precisamente utilizamos una especificación de paquete para declarar un tipo REFCURSOR global a toda la aplicación. Introduce mejoras al rendimiento En relación a su ejecución, cuando un procedimiento o función que está definido dentro de un paquete esllamado por primera vez, todo el paquete es ingresado a memoria. Por lo tanto, posteriores llamadas almismo u otros sub-programas dentro de ese paquete realizarán un acceso a memoria en lugar de a disco.Esto no sucede con procedimientos y funciones estándares. Permite la “Sobrecarga de funciones” (Overloading). PL/Sql nos permite que varios procedimientos o funciones almacenadas, declaradas dentro de un mismopaquete, tengan el mismo nombre. Esto nos es muy útil cuando necesitamos que los sub-programaspuedan aceptar parámetros que contengan diferentes tipos de datos en diferentes instancias. En este casoOracle ejecutará la “versión” de la función o procedimiento cuyo encabezado se corresponda con la listade parámetros recibidos.Un ejemplo.A continuación veremos un ejemplo de los conceptos explicados anteriormente.El objetivo de esta tabla, Accesos, es llevar un registro por cada acceso inválido que realice un usuario encada sesión, y un histórico total acumulativo a fines de facilitar la lectura de la historia. Supondremos quela función Alta será invocada por una aplicación que supervisa esta tarea de control. 9
  11. 11. Oracle PL/SQL – programación con Paquetes.Alta es la única función pública del paquete.Veamos la definición de la tabla: CREATE TABLE ACCESOS ( USUARIO VARCHAR2(15) NOT NULL, FECHA_HORA_INICIO_SESION DATE NOT NULL, TERMINAL_SESION VARCHAR2(15) NOT NULL, FECHA_HORA_ACCESO DATE NOT NULL, NRO_ACCESO_EN_SESION NUMBER(10) NOT NULL, TOTAL_HISTORICO NUMBER(10) NOT NULL ); -- -- Usuario: Usuario Oracle. -- Fecha_Hora_Inicio_Sesion: Momento en que comienza la sesión actual. -- Terminal_Sesion: Terminal desde donde se encuentra conectado -- el usuario. -- Fecha_Hora_Acceso: Momento en que se produce el acceso inválido. -- Nro_Acceso_En_Sesion: Cuenta el número de acceso inválido -- en la sesión actual. -- Total_Historico: Cuenta el total de accesos inválidos que se -- registran históricamente para este usuario.y ahora el Paquete: -- Especificación del paquete -- Sólo se declara aquí el único elemento que será visible -- a las aplicaciones que invoquen este paquete. CREATE OR REPLACE PACKAGE PKG_ACCESOS AS FUNCTION ALTA RETURN NUMBER; END; / -- Cuerpo del paquete CREATE OR REPLACE PACKAGE BODY PKG_ACCESOS AS -- Variables globales al paquete, pero inaccesibles desde afuera. -- Su valor se asigna en la inicialización del paquete. -- (ver al final del paquete, el último BEGIN/END) WG_FECHA_INICIO_SESION DATE; WG_SECUENCIA NUMBER (10); WG_CANT_HIST NUMBER (10); -- Función Privada dentro del paquete (sólo uso interno) -- Es inaccesible desde afuera porque no está declarada -- en la especificación del paquete. FUNCTION OBTIENE_CANTIDAD_HISTORICA (USER VARCHAR2) RETURN NUMBER AS CANT NUMBER(10); BEGIN SELECT COUNT(*) INTO CANT FROM ACCESOS WHERE USUARIO = USER; RETURN CANT+1; EXCEPTION WHEN OTHERS THEN RAISE; END; -- Implementación de la función Alta -- (Global, visible desde afuera del paquete) 10
  12. 12. Oracle PL/SQL – programación con Paquetes. FUNCTION ALTA RETURN NUMBER AS BEGIN WG_SECUENCIA := WG_SECUENCIA + 1; WG_CANT_HIST := OBTIENE_CANTIDAD_HISTORICA (USER); INSERT INTO ACCESOS (USUARIO, FECHA_HORA_INICIO_SESION, TERMINAL_SESION, FECHA_HORA_ACCESO, NRO_ACCESO_EN_SESION, TOTAL_HISTORICO) VALUES (USER, WG_FECHA_INICIO_SESION, USERENV(TERMINAL), SYSDATE, WG_SECUENCIA, WG_CANT_HIST); RETURN 1; EXCEPTION WHEN OTHERS THEN RETURN 0; -- si se produce algun error -- retorna cero END; -- Rutinas de inicialización, se ejecutan sólo la primera -- vez que la aplicación referencia al paquete BEGIN WG_FECHA_INICIO_SESION := SYSDATE; WG_SECUENCIA := 0; END; /Para ejecutar la función Alta, basta escribir desde el Sql*Plus:SQL > VAR RES NUMBER;SQL > EXECUTE :RES := PKG_ACCESOS.ALTA;SQL> PRINT RES;y para ver el resultado de la inserción en la tabla:SQL> SELECT * FROM ACCESOS;La función devolverá 0 en caso de error o 1 en caso contrario. 11
  13. 13. Oracle PL/SQL – Desarrollo de funciones SQL En esta entrega veremos las reglas que deben seguir las funciones almacenadas para que puedan usarse en una sentencia SQL Una de las caractéristicas que hacen sobresalir a Oracle por sobre otros administradores de bases dedatos relacionales es la enorme cantidad de funciones que vienen “de fábrica” para poder usarsedirectamente dentro de sentencias Sql. Esta funciones son de conversión de tipos, aritméticas, de manejode cadenas de caracteres, de manejo de fechas, etc. No obstante, siempre podremos necesitar desarrollar nuestras propias funciones para casosespecíficos y poder adicionarlas a la librería preexistente.Desarrollo de una Función SQL de usuario. En principio, una Función SQL de usuario es equivalente a una Función Almacenada, en cuanto aque está programada en PL/Sql y puede ser invocada mediante la sentencia Exec. La diferencia fundamental radica en que una Función SQL puede utilizarse en cualquier sentenciaSQL, ya sea en un Select, un Update, un Insert o un Delete, y tanto en la parte enunciativa de camposcomo en la cláusula Where. Entonces, ¿qué es lo que las diferencia? O mejor aún, ¿porqué no podemoshablar sólo de un tipo de función y usarla según nuestra conveniencia?. La respuesta es que existendeterminadas restricciones para poder usar una Función Almacenada en una sentencia Sql, las quedetallaremos a continuación.RestriccionesPara ejecutar una sentencia Sql que invoca a una función almacenada, Oracle debe conoceranticipadamente la posibilidad de que esta función produzca alguna modificación en el estado actual de labase de datos, para evitar así un resultado inesperado en el retorno de la función.Para minimizar esta posibilidad, Oracle inhibe a las funciones SQL de: • Modificar datos en tablas, por lo tanto no puede invocar sentencias Insert, Update ni Delete. • Modificar variables globales dentro de un Paquete. • Contener parámetros OUT o IN OUT. • Ser una función de columna o grupo. Las funciones de columna son aquélas que toman como entrada toda una columna de datos, como por ejemplo SUM(), o AVG(). Por lo tanto nuestras funciones sólo podrán comportarse como funciones de fila.Un ejemploPara nuestro ejemplo desarrollaremos una función que respete las reglas arriba enumeradas. Dentro de unPaquete PL/Sql crearemos una función de validación de CUIT. Para los que no vivan en la RepúblicaArgentina o no estén familiarizados con esta sigla les cuento que CUIT significa Código Unico deIdentificación Tributaria y es utilizado por el organis mo recaudador de impuestos para identificar a lasempresas y profesionales. Este número está compuesto por un prefijo de 2 dígitos, un número de 8posiciones (que en el caso de las personas es el documento nacional de identidad) y un dígito verificador.Este dígito verificador se calcula mediante una fórmula de módulo 11.Adentrémonos ahora en la situación que usaremos en nuestro ejemplo. Tendremos una tabla pecargadacon datos de personas (figura 1), donde consta su CUIT. En dicha carga no se ha utilizado ningunavalidación por lo que deberemos evaluar la validez o no de los datos existentes mediante nuestra función(figura 2). 12
  14. 14. Oracle PL/SQL – Desarrollo de funciones SQLFigura 1 . Tabla de PersonasCREATE TABLE PERSONAS( CODIGO NUMBER(10) NOT NULL, NOMBRES VARCHAR2(50) NOT NULL, APELLIDOS VARCHAR2(50) NOT NULL, CUIT VARCHAR2(11) NOT NULL, PRIMARY KEY (CODIGO));Figura 2 . Paquete con función de validaciónCREATE OR REPLACE PACKAGE Pkg_ValidaAS FUNCTION CUIT_VALIDO (XID VARCHAR2) RETURN NUMBER;END;/CREATE OR REPLACE PACKAGE BODY Pkg_ValidaAS -- Esta función devuelve 1 en caso de que el -- CUIT sea correcto ó 0 en caso contrario FUNCTION CUIT_VALIDO (XID VARCHAR2) RETURN NUMBER AS RES NUMBER; I NUMBER; DIG NUMBER; NUM NUMBER; BEGIN -- Primero comprobamos -- validaciones sencillas IF LENGTH(XID) != 11 OR SUBSTR(XID, 1, 2) = 00 THEN RETURN 0; END IF; -- Ahora comprobamos la validez -- del dígito verificador -- usándo cálculo de módulo 11 RES := 0; FOR I IN 1..10 LOOP NUM := TO_NUMBER(SUBSTR(XID, I, 1)); IF I = 1 OR I = 7 THEN RES := RES + NUM * 5; ELSIF I = 2 OR I = 8 THEN RES := RES + NUM * 4; ELSIF I = 3 OR I = 9 THEN RES := RES + NUM * 3; ELSIF I = 4 OR I = 10 THEN RES := RES + NUM * 2; ELSIF I = 5 THEN RES := RES + NUM * 7; ELSIF I = 6 THEN RES := RES + NUM * 6; END IF; END LOOP; DIG := 11 - MOD(RES, 11); IF DIG = 11 THEN DIG := 0; END IF; -- Ahora retornamos valor según -- validez o no del dígito verificador IF DIG = TO_NUMBER(SUBSTR(XID, 11, 1)) THEN RETURN 1; ELSE RETURN 0; END IF; EXCEPTION -- En caso de error retornamos 0 WHEN OTHERS THEN RETURN 0; END;
  15. 15. END;/Lo primero que haremos será chequear el correcto funcionamiento de la función de validación que hemoscreado, que nos devolverá 1 en caso de recibir un número correcto ó 0 en caso contrario. Para chequearlala ejecutaremos en la forma estándar, es decir, mediante la instrucción Exec. (figura 3)Vemos que funciona correctamente, ya que le hemos enviado un número válido y nos devuelve un 1.Figura 3 . Ejecución de la función mediante ExecSQL> VAR VALIDO NUMBER;SQL> EXEC :VALIDO := Pkg_Valida.cuit_valido(20224367911);PL/SQL PROCEDURE successfully completed.SQL> PRINT VALIDO; VALIDO--------- 1SQL>Ahora la ejecutaremos cómo una Función SQL a través de un Select. (figura 4)Figura 4 . Ejecución de la función como Función SQL dentro de un SelectSQL> SELECT Pkg_Valida.cuit_valido(20224367911)SQL> AS VALIDO FROM DUAL;SQL> ORA-06571: function cuit_valido does not guarantee not to update databaseSQL>En contra de lo esperado, se ha producido un error. El servidor Oracle nos informa que no puede ejecutarla función dentro de un SQL porque la misma no garantiza que la base de datos no será modificada.Pero si analizamos el código de nuestra función, veremos que la misma no viola ninguna de lasrestricciones conocidas. Entonces, ¿qué pasó?La cláusula "Pragma Restrict_References"Oracle chequea el código de la función buscando posibles causas de conflicto. Para funciones queencierran cierta complejidad, el Servidor no consigue tener certeza sobre los potenciales “riesgos” deejecutarla, y por ende nos envía el mensaje de error que acabamos de ver para informarnos de talsituación. Entonces nos vemos obligados a forzar al Compilador PL/Sql a chequear las reglas, a fin de queel Servidor no deba hacerlo al ejecutar la función. En este paso, será el Compilador el que nos acepte orechace la función al momento de compilarla.Pero como ésto sólo puede hacerse dentro del encabezado de un Paquete y no es posible hacerlo parafunciones almacenadas desarrolladas fuera de paquetes, éstas últimas no podrán usarse en sentencias Sqlen caso de que el Servidor no las acepte. Por lo tanto la recomendación es que siempre deberemos usarPaquetes donde incluir este tipo de funciones. 14
  16. 16. Oracle PL/SQL – Desarrollo de funciones SQLLa clásula Pragma Restrict_References debe ir en el encabezado del Paquete, y siguiendo a la definiciónde cada función, siendo la sintaxis la desplegada en la figura 5. En la figura 6 mostramos el significado decada argumento de este Pragma.Figura 5 . Sintaxis de Pragma Restrict_ReferencesPRAGMA RESTRICT_REFERENCES ( Nombre_de_función, WNDS [, WNPS] [, RNDS] [, RNPS]);Figura 6 . Significado de cada argumentoWNDS No modifica tablas en la base de datosWrites no database stateRNDS No lee tablas en la base de datosReads no database stateWNPS No cambia valores de variables globalesWrites no package state de PaquetesRNPS No referencia valores de variablesReads no package state globales de PaquetesEl único argumento obligatorio es WNDS, pero siempre es aconsejable definir el máximo nivel de“pureza” que nuestra función posee, a fin de que el Compilador PL/Sql no rechace innecesariamente anuestra función.Adaptación de nuestro ejemploHabiendo visto lo anterior, sabemos ahora que tenemos que agregar este Pragma a nuestro encabezadode Paquete. Veremos el nuevo encabezado en la figura 7. Introduciremos todos los argumentos, ya quesabemos que nuestra función los cumple, y de esta manera garantizaremos que el Compilador la acepte.Luego de introducidos los cambios deberemos recompilar nuevamente el encabezado y el cuerpo delpaquete.Figura 7 . Nuevo encabezado del PaqueteCREATE OR REPLACE PACKAGE Pkg_ValidaAS FUNCTION CUIT_VALIDO (XID VARCHAR2) RETURN NUMBER; -- Agregamos aquí el PRAGMA PRAGMA RESTRICT_REFERENCES (CUIT_VALIDO, WNDS, WNPS, RNPS);END;/Ejemplos de uso.Finalmente podremos utilizar nuestra Función Almacenada como una Función SQL. En la figura 8volveremos a nuestro ejemplo de ejecución simple mediante un Select, pero esta vez vemos queafortunadamente todo termina bien. 15
  17. 17. Oracle PL/SQL – Desarrollo de funciones SQLFigura 8 . Ejecución exitosa de la función como función SQL dentro de un SelectSQL> SELECT Pkg_Valida.cuit_valido(20224367911)SQL> AS VALIDO FROM DUAL; VALIDO--------- 1SQL>Y por último 2 ejemplos más a fin de ilustrar los posibles usos de nuestra función en un contexto como elplanteado, en donde debemos analizar o mostrar el contenido de una tabla cuyos datos no estánvalidados.Figura 9 . Mostramos Código de persona, CUIT y Estado calculado del CUIT (válido o inválido)SQL> SELECT CODIGO, NOMBRES, CUIT,SQL> DECODE (Pkg_Valida.cuit_valido(CUIT), 1, VALIDO,SQL> 0, INVALIDO)SQL> AS ESTADOSQL> FROM PERSONASSQL> ORDER BY CODIGO; CODIGO NOMBRES CUIT ESTADO--------- ---------- ----------- -------- 1 ADAN 11111111111 INVALIDO 2 EVA 20224367911 VALIDOSQL>Figura 10 . Calculamos cuántos CUIT inválidos existen en la tablaSQL> SELECT COUNT(*) AS INVALIDOS FROM PERSONASSQL> WHERE Pkg_Valida.cuit_valido(CUIT) = 0;INVALIDOS--------- 1SQL> 16
  18. 18. Oracle PL/SQL – SQL dinámico Una herramienta que nos permite añadir potencia y versatilidad a nuestras aplicaciones de bases de datos. De por sí, Oracle no soporta en forma nativa el uso de operaciones dinámicas en un procedimiento ofunción almacenada. Al decir “operaciones dinámicas” me refiero a todo aquéllo que deba ser resueltoen tiempo de ejecución en lugar de en tiempo de compilación. Por ejemplo, si quisiéramos crear una tabladentro de un procedimiento almacenado, no podríamos hacerlo mediante el uso de Pl/Sql estándard.Veamos primero porqué existe esta limitación y luego cómo Oracle nos permite resolver las cosas parapoder llevar a cabo este tipo de tareas.Modelo estático – Eficiencia versus flexibilidadComo ocurre en la mayoría de los lenguajes de programación, en Oracle, antes de que un procedimientoPl/Sql pueda ser ejecutado, debe ser compilado. El compilador resuelve toda referencia a objetos delesquema (tablas, funciones, procedimientos, etc.), buscando sus definiciones en el diccionario de datos dela base, y asignándoles direcciones a fin de que puedan ser referenciados al momento de ejecutarse elprograma.Este esquema de resolución de referencias al momento de la compilación, es conocido como modeloestático y es el que prioriza la eficiencia en la ejecución del programa. Como resultado de la compilación,Oracle genera un código del tipo p-code que es luego directamente procesado por el entorno Pl/Sql.Por otro lado, un modelo dinámico sería aquél en donde se efectuarían las resoluciones en tiempo deejecución, priorizándose de esta manera la flexibilidad de los procesos que pueden desarrollarse dado quelos objetos del esquema pueden no conocerse o no existir hasta el momento de la ejecución de la línea decódigo que los referencia.Dado que el modelo elegido por Oracle es el estático, donde deben existir al momento de la compilacióntodos los objetos que se refencian dentro del programa, es que no podemos, como dijimos, crear una tabladentro de un procedimiento almacenado usando las sentencias estándares. Esto parece limitante, y lo es,pero siempre tenemos una forma de hacer las cosas cuando trabajamos con herramientas que han sidoconcebidas para darnos satisfacciones en lugar de hacernos pasar penurias. (... apostaría a que estamospensando en la misma empresa generadora de penurias ... )El paquete DBMS_SQLLa forma en la que podemos agregar dinamismo a nuestros procedimientos y funciones almacenadas, esmediante el uso del paquete SYS.DBMS_SQL.A través de las funciones implementadas en el mismo podremos realizar operaciones que involucren lareferencia a objetos que no existen o que no podemos determinar al momento de la compilación.El “truco” consiste en que estas instrucciones no las escribamos como código Pl/Sql sino como “cadenasde caracteres”, que podrán ser tanto recibidas como parámetros del procedimiento, o ser definidas oarmadas por el mismo, y posteriormente enviadas a las funciones del paquete Dbms_Sql para su efectivoproceso.Mediante esta técnica podremos implementar el ejemplo del que hablamos al comienzo: Crear una tabladentro de una procedimiento almacenado (“Listado 1”)El procedimiento utilizado no tiene nada de complejo. Usando las funciones definidas dentro del paqueteDbms_Sql creamos y abrimos un cursor especial que se usará en la ejecución, armamos la instrucción y laenviamos para su interpretación y proceso. Luego, cerramos el cursor.Algo muy parecido a lo que hacemos en Delphi cuando utilizamos TQuery.ExecSqlNota: El indicador dbms_sql.v7 es obligatorio y debe usarse en las versiones 7 y 8 de Oracle. 17
  19. 19. Oracle PL/SQL – SQL dinámicoCREATE OR REPLACE PROCEDURE DBMS_EJEMPLOAS ID INTEGER; TABLA VARCHAR2(20); CAMPOS VARCHAR2(100);BEGIN TABLA := ‘PRUEBA ’; CAMPOS := ‘ (C1 NUMBER(10), C2 VARCHAR2(10)) ’; ID := DBMS_SQL.OPEN_CURSOR; DBMS_SQL.PARSE(ID, CREATE TABLE || TABLA || CAMPOS, dbms_sql.v7); DBMS_SQL.CLOSE_CURSOR(ID);END;/Listado 1 . Un ejemplo simple.Un ejemplo un poco más elaboradoEn el ejemplo del Listado 1, vimos de forma simple cómo procesar una instrucción dinámica dentro de labase de datos.Ahora veamos cómo sacarle más provecho a las bondades que nos ofrece esta técnica.Las famosas reglas del negocioComo bien sabemos, en una aplicación Cliente/Servidor una de las características más importantes es laimplementación de todas las definiciones que hagan al negocio (sean las de un banco, una fábrica o unlocal de venta de ropa) dentro de la base de datos y no en la codificación del programa cliente. Estasreglas normalmente se refieren a validaciones y restricciones cuya lógica, al estar centralizada en elservidor de datos, controlará tanto a las transacciones realizadas por nuestras aplicaciones como a lasllevadas a cabo fuera de ellas (por ejemplo mediante herramientas que nos permitan el acceso directo alos datos).Para nuestro ejemplo, nos ubicaremos en el siguiente cuadro de situación:Tenemos una pequeña empresa que se dedica al ensamblado de computadoras (ordenadores, para misamigos españoles). A cada parte que participa en el equipo que finalmente resulta armado la llamaremos“componente”, siendo a la vez cada componente de un “tipo” específico. Es así que podemos tenercomponentes del tipo “teclado”, “monitor”, “chip”, “memoria”, etc.Imaginemos que dependiendo del modelo de computadora, el tipo de componente a utilizar puede variar,por ejemplo habrá modelos con monitores de 14 pulgadas y 32 MB de RAM, otros con monitores de 17pulgadas y 64 MB de memoria, y así.Bien, lo que la empresa ideó a fin de tener un mejor control de su stock, es una codificación de loscomponentes de manera tal que el código del mismo no sea arbitrario sino que esté regido por una regladefinida para el tipo al que pertenece el componente. De esta manera no se podrá codificar erróneamenteun componente, evitándose así errores en su clasificación.Dado que esta definición es una regla del negocio, la implementaremos en la base de datos. En el Listado2 veremos las definiciones de las tablas de Tipos_Componente y Componentes.CREATE TABLE TIPOS_COMPONENTE ( TIPO NUMBER(10) NOT NULL, DESCRIPCION VARCHAR2(50) NOT NULL, FUNCION_VALIDACION VARCHAR2(30), PRIMARY KEY (TIPO));CREATE TABLE COMPONENTES ( CODIGO VARCHAR2(10) NOT NULL, TIPO NUMBER(10) NOT NULL, 18
  20. 20. Oracle PL/SQL – SQL dinámico DESCRIPCION VARCHAR2(50) NOT NULL, PRIMARY KEY (CODIGO), FOREIGN KEY (TIPO) REFERENCES TIPOS_COMPONENTE);Listado 2 . Definiciones de tablas.Como vemos, las tablas están relacionadas por el tipo de componente tal lo esperado. Pero prestemosatención a la tabla Tipos_Componente. En ella encontramos un campo, Funcion_Validacion, que es el queguardará la información acerca de cuál función almacenada validará a los códigos de componentesingresados en la tabla Componentes. Porque, precisamente, nuestra idea es desarrollar una función queimplemente las reglas de validación para uno o más tipos de componentes, de manera que simplementetengamos que relacionar Función de validación con Tipo de Componente a través de este campo de latabla. Y luego, la validación se lanzará automáticamente a través de un Trigger que ejecutará a la funcióncorrespondiente en cada momento que se ingrese o modifique un registro en la tabla Componentes.En el Listado 3 se muestra un ejemplo de datos ingresados en la tabla Tipos_Componente.INSERT INTO TIPOS_COMPONENTE (TIPO, DESCRIPCION, FUNCION_VALIDACION)VALUES (1, MONITOR, MONITOR_VALIDO);INSERT INTO TIPOS_COMPONENTE (TIPO, DESCRIPCION, FUNCION_VALIDACION)VALUES (2, CHIP, CHIP_VALIDO);INSERT INTO TIPOS_COMPONENTE (TIPO, DESCRIPCION, FUNCION_VALIDACION)VALUES (3, OTRO, NULL);COMMIT;Listado 3 . Tipos de componente y funciones asociadas.Ahora necesitaremos programar las funciones que realizarán la validación para cada tipo. Según loespecificado en la tabla, al tipo “monitor” lo validará siempre la función “Monitor_Válido”, al tipo “chip”la función “Chip_Válido” y el tipo “otro” no será validado. En el Listado 4 crearemos un paquete con lasfunciones especificadas. Se han incluído los Pragma necesarios para que estas funciones puedan serinvocadas como Funciones Sql (tal lo explicado en Mundo Delphi Nº 4, Oracle Pl/Sql - Desarrollo defunciones SQL).Para nuestro ejemplo, las funciones de validación serán muy sencillas: verificarán que el tamaño delcódigo de componente ingresado en la tabla Componentes sea igual a 10, que las 3 primeras posicionessean letras (“MON” para el caso de los monitores y “CHI” para el caso de los chips ... bueno, intuyo quenadie va a sorprenderse por lo ingenioso de ésto, ¿verdad?), y que las siguientes 7 posiciones seannuméricas y resulten en un valor superior a cero.Las funciones devolverán 0 en caso de error o 1 en caso contrario.CREATE OR REPLACE PACKAGE PKG_VALIDACIONES_TIPOSAS FUNCTION MONITOR_VALIDO (XCODIGO COMPONENTES.CODIGO%Type) RETURN NUMBER; PRAGMA RESTRICT_REFERENCES (MONITOR_VALIDO, WNDS, WNPS, RNPS); FUNCTION CHIP_VALIDO (XCODIGO COMPONENTES.CODIGO%Type) RETURN NUMBER; PRAGMA RESTRICT_REFERENCES 19
  21. 21. Oracle PL/SQL – SQL dinámico (CHIP_VALIDO, WNDS, WNPS, RNPS);END;/CREATE OR REPLACE PACKAGE BODY PKG_VALIDACIONES_TIPOSASFUNCTION MONITOR_VALIDO (XCODIGO COMPONENTES.CODIGO%Type) RETURN NUMBERASBEGIN IF LENGTH(XCODIGO) != 10 OR SUBSTR(XCODIGO, 1, 3) != MON OR TO_NUMBER(SUBSTR(XCODIGO, 4, 7)) <= 0 THEN RETURN 0; ELSE RETURN 1; END IF;EXCEPTION WHEN OTHERS THEN RETURN 0;END;FUNCTION CHIP_VALIDO (XCODIGO COMPONENTES.CODIGO%Type) RETURN NUMBERASBEGIN IF LENGTH(XCODIGO) != 10 OR SUBSTR(XCODIGO, 1, 3) != CHI OR TO_NUMBER(SUBSTR(XCODIGO, 4, 7)) <= 0 THEN RETURN 0; ELSE RETURN 1; END IF;EXCEPTION WHEN OTHERS THEN RETURN 0;END;END;/Listado 4 . Paquetes con funciones de validación.Antes dijimos que habrá un Trigger que se encargue de la tarea de verificar, por cada registro actualizado,la validez de su código. Ya mismo podríamos implementarlo poniendo una serie de “If Tipo = ... ThenFunción ” dentro del Trigger y asunto terminado. Sí, pero nada elegante, sobre todo si hay cientos detipos diferentes para validar y la cosa iría peor cada vez que agreguemos tipos nuevos, o querramos quesea otra la función que valide a un determinado tipo. Al final de cuentas, ¡ya sabemos que podemosresolverlo con Sql dinámico!.Vayamos al Listado 5. Allí encontraremos e núcleo de todo este asunto. Se trata de una función de lvalidación de tipos de carácter “general”, que dependiendo del tipo de componente recibido comoparámetro ejecutará la función que corresponda según lo definido en la tabla Tipos_Componente. Conesta información, nuestra función central armará dinámicamente el nombre del proceso que debe ejecutar,le agregará como parámetro el código de componente a validar, ejecutará la función, tomará el valorresultante y lo devolverá al proceso llamador.CREATE OR REPLACE FUNCTION ES_COMPONENTE_VALIDO (XTIPO TIPOS_COMPONENTE.TIPO%Type, XCODIGO COMPONENTES.CODIGO%Type) RETURN NUMBERAS C INTEGER; TMP INTEGER; nRES NUMBER; FX TIPOS_COMPONENTE.FUNCION_VALIDACION%Type;BEGIN 20
  22. 22. Oracle PL/SQL – SQL dinámico -- obtenemos el nombre de la función que -- debemos invocar a fin de -- validar el tipo de componente SELECT FUNCION_VALIDACION INTO FX FROM TIPOS_COMPONENTE WHERE TIPO = XTIPO; -- Si no la encontramos o es Null -- entendemos que no está definida -- y salimos IF FX IS NULL THEN RAISE NO_DATA_FOUND; END IF; -- armamos todo el esquema dinámico -- para ejecutar la función -- pretendida a través de un select -- y obtener el resultado de la misma -- Abrimos un cursor y tomamos -- su manejador (número de identificación) C := DBMS_SQL.OPEN_CURSOR; -- Armamos la instrucción dinámica a -- ejecutar, concatenando el nombre -- de, en este caso, la función Sql -- que será ejecutada y declarando el -- parámetro que le enviaremos. -- Y todo ésto se asocia al cursor. DBMS_SQL.PARSE (C, SELECT PKG_VALIDACIONES_TIPOS. || FX || (:VCODIGO) FROM DUAL, DBMS_SQL.V7); -- Llenamos el parámetro que enviamos -- (el código del artículo/componente) DBMS_SQL.BIND_VARIABLE(C, :VCODIGO, XCODIGO); -- Definimos la columna que recibiremos -- del Select. -- Declaramos que el tipo de dato de la -- columna “1” deberá ser del mismo tipo -- de dato que la variable nRes -- (o sea, numérico) DBMS_SQL.DEFINE_COLUMN(C, 1, nRES); -- Ejecutamos el cursor y tomamos -- la fila que recibimos. -- El “TRUE” significa que si se recibe más -- de una fila se dispare una excepción. TMP := DBMS_SQL.EXECUTE_AND_FETCH(C, TRUE); -- Tomamos el valor de la columna “1” -- (el resultado de la función ejecutada) -- y lo metemos en la variable nRes DBMS_SQL.COLUMN_VALUE(C, 1, nRES); -- Cerramos el cursor ya que -- si no lo hacemos no se desasigna la -- memoria utilizada. DBMS_SQL.CLOSE_CURSOR(C); -- Devolvemos el resultado RETURN nRES;EXCEPTION WHEN OTHERS THEN -- si hubo una excepción cerramos -- el cursor antes de salir IF DBMS_SQL.IS_OPEN(C) THEN DBMS_SQL.CLOSE_CURSOR(C); END IF; RETURN 1;END;/ 21
  23. 23. Oracle PL/SQL – SQL dinámicoListado 5 . Función central – Uso de Sql dinámico.Ya tenemos casi todo listo, sólo nos falta el Trigger. (Listado 6) CREATE OR REPLACE TRIGGER TBUI_COMPONENTES BEFORE UPDATE OR INSERT ON COMPONENTES FOR EACH ROW DECLARE eCODIGO_INVALIDO EXCEPTION; BEGIN -- enviamos a validar el código, -- para ésto llamamos a la función -- genérica, enviando los datos del -- registro IF ES_COMPONENTE_VALIDO (:NEW.TIPO,:NEW.CODIGO) = 0 THEN RAISE eCODIGO_INVALIDO; END IF; EXCEPTION WHEN eCODIGO_INVALIDO THEN RAISE_APPLICATION_ERROR(-20999, CODIGO INVALIDO PARA EL TIPO DE COMPONENTE); RETURN; WHEN OTHERS THEN RAISE_APPLICATION_ERROR(-20999, ERROR: || TO_CHAR(SQLCODE) || - || SUBSTR(SQLERRM, 1, 256)); RETURN; END; /Listado 6 . Trigger sobre tabla ComponentesAhora, cada vez que se inserte o actualice un registro de la tabla Componentes se dispararáautomáticamente el Trigger TBUI_Componentes (las siglas “TBUI” las uso por trigger before updateinsert). Luego, el Trigger invocará a la función genérica Es_Componente_Valido, enviándole el tipo ycomponente ingresados sobre la fila tratada. En caso de recibir de la función el valor 0 (error), nos enviaráuna excepción alertándonos sobre tal situación, impidiéndose así que la fila se grabe en la tabla.Finalmente, en la Figura 7 podremos ver un ejemplo de lo que pasaría si intentamos ingresar un código decomponente no válido para el tipo especificado (empieza con “SON” en lugar de “MON”).Utilizaremos para la prueba el SqlPlus. SQL> INSERT INTO COMPONENTES (CODIGO, TIPO, DESCRIPCION) SQL> VALUES (SON0000000, 1, SVGA 17"); ERROR at line 1: ORA-20999: CODIGO INVALIDO PARA EL TIPO DE COMPONENTE ORA-06512: at line 10 ORA-04088: error during execution of trigger ‘TBUI_COMPONENTESFigura 7 . Intento de inserción fallido. 22

×