En este ejercicio, utilizaremos el asistente para crear un procedimiento almacenado SQL de DB2.
Este procedimiento almacenado simple ofrece información de empleados procedente de la tabla EMPLOYEE cuando el ID de departamento del empleado coincide con un valor que el usuario haya entrado. Utilizaremos otro asistente para crear la sentencia SQL, aunque también puede escribir directamente la sentencia en el asistente que crea el procedimiento almacenado.
Cuando se crea una rutina en el entorno de trabajo, se guarda el código fuente en el entorno de trabajo del proyecto. Cuando se despliega una rutina, el entorno de trabajo lleva a cabo las acciones siguientes:
- Para rutinas Java, el código fuente se compila en la estación de trabajo cliente.
- Para rutinas SQL, el código fuente se compila en el servidor.
- El código fuente se copia en el servidor DB2.
- La rutina se registra en la tabla de catálogo.
Para crear y desplegar un procedimiento almacenado SQL:
- En la vista Explorador de proyectos de datos, expanda el proyecto SPDevelopment para buscar la carpeta Procedimientos almacenados.
- Pulse con el botón derecho del ratón sobre la carpeta Procedimientos almacenados y seleccione . Se abrirá el asistente Procedimiento almacenado nuevo.
- En el campo Nombre, escriba SPEmployee.
- Conserve el lenguaje predeterminado, que es SQL.
- Pulse Siguiente.
- En la página Declaraciones SQL, pulse Crear SQL. Esta acción inicia el asistente Nueva sentencia SQL que guiará durante la creación de una sentencia SQL.
- En la primera página Nueva sentencia SQL del asistente, conserve los valores por omisión para crear
una sentencia SELECT utilizando el asistente y, a continuación pulse Siguiente.
- En la lista Tablas disponibles, navegue hasta la tabla schemaname/schemaname.EMPLOYEE.
- Pulse el botón > para desplazar la tabla hasta la lista Tablas seleccionadas.
- Pulse el separador Columnas.
- Expanda el árbol schemaname.EMPLOYEE y seleccione
EMPNO, FIRSTNME, LASTNAME y WORKDEPT.
- Pulse el botón > para desplazar las columnas hasta la lista Columnas seleccionadas.
- Pulse el separador Condiciones.
- Efectúe una doble pulsación en la primera fila de la columna Columna. Aparecerá un recuadro desplegable.
- Pulse la flecha hacia abajo y seleccione EMPLOYEE.WORKDEPT y pulse Intro para confirmar esta selección.
- En la columna Operador, acepte el operador predeterminado, =.
- En la columna Valor, escriba :dept y pulse Intro. Esta acción crear una variable de lenguaje principal denominada dept que se utilizar como parámetro de entrada de usuario para el procedimiento almacenado.
- Pulse Siguiente para ver la sentencia SQL que acaba de crear. La sentencia SQL tiene un aspecto similar al siguiente:
SELECT EMPNO, FIRSTNME, LASTNAME, WORKDEPT FROM SCHEMANAME.EMPLOYEE WHERE WORKDEPT = :dept
- Pulse Finalizar para cerrar el asistente Declaración de SQL nueva y pulse Siguiente en el asistente Procedimiento almacenado nuevo.
- En la página Parámetros, en el campo Código del manejo de errores SQL, seleccione SQLSTATE y SQLCODE.
En la tabla Parámetros, verá el parámetro de entrada, dept, que ha creado y los parámetros de salida para
SQLSTATE y SQLCODE. En esta página, también puede crear otros parámetros de usuario pero la pretensión de esta guía de aprendizaje es dejar los parámetros tal como están.
- Pulse Siguiente.
- En la página Opciones de despliegue del asistente, marque los recuadros de selección Desplegar y Habilitar depurado. En posteriores pasos, vamos a depurar el procedimiento almacenado utilizando el depurador integrado de procedimientos almacenados SQL que se incluye con el entorno de trabajo, por lo que aquí vamos a desplegar el procedimiento y a habilitar la depuración. Si no ha seleccionado la opción de depuración,
puede desplegar y habilitar manualmente el procedimiento almacenado
en la vista Explorador de proyectos de datos y seleccionando
Desplegar en el menú emergente.
- Pulse Siguiente.
En la página Fragmentos de código del asistente, también puede especificar archivos que contengan fragmentos de código para insertarlos en el cuerpo del procedimiento almacenado. En tal caso, no especifique ningún fragmento de código.
- Pulse Siguiente y revise lo que haya seleccionado en la página Resumen del asistente.
- Pulse Finalizar para crear y desplegar el procedimiento almacenado.
El procedimiento almacenado, SPEmployee, aparece en la vista Explorador de proyectos de datos en la carpeta Procedimientos almacenados bajo el proyecto en el que lo ha creado. El procedimiento almacenado también se abre en el editor, donde podrá ver y editar el código fuente. Como ha seleccionado las opciones Desplegar y Habilitar depuración, automáticamente se despliega y se habilita para su depuración el procedimiento almacenado. El icono que hay junto al procedimiento almacenado de la vista Explorador de proyecto de datos tiene una llave inglesa encima que indica que se está desplegando el procedimiento almacenado. Se pueden ver los resultados del despliegue en la vista Salida de datos.
En este momento, opcionalmente puede utilizar el editor para realizar cambios en el procedimiento almacenado dependiendo de sus necesidades empresariales.