Tutorial

Oracle SQL Developer 2.1.1.

Juan Ruiz de Miras

Departamento de Informtica
Universidad de Jan

SQL Developer

ndice
0. Introduccin ............................................................................................................................ 3
1. Conexin y desconexin de la base de datos .......................................................................... 3
2. Ejecucin de sentencias SQL .................................................................................................. 4
3. Creacin de tablas ................................................................................................................... 6
4. Modificacin de la definicin de una tabla................................................................................ 7
5. Insercin de tuplas ................................................................................................................... 7
6. Generacin de Cdigo SQL ..................................................................................................... 8
7. Creacin y edicin de Secuencias ........................................................................................... 9
8. Creacin, compilacin y ejecucin de funciones y procedimientos ........................................ 10
9. Depuracin de Funciones y Procedimientos .......................................................................... 13
10. Creacin y compilacin de disparadores ............................................................................. 15
11. Depuracin de disparadores ................................................................................................ 16
12. Asignacin de Privilegios y Roles ........................................................................................ 17

Juan Ruiz de Miras

Universidad de Jan

SQL Developer

0. Introduccin
Este breve manual describe, a modo de tutorial, la funcionalidad bsica de la herramienta Oracle SQL
Developer, para su versin 2.1 de marzo de 2010. No pretende ser un manual exhaustivo, sino, una
referencia inicial a los principales aspectos que se van a utilizar de la herramienta en las prcticas de la
asignatura Bases de Datos II.
El objetivo fundamental de SQL Developer es proporcionar una interfaz ms amigable para la consulta y
programacin de la base de datos Oracle. La funcionalidad disponible en SQL Developer es slo parte
de la disponible a travs de comandos en SQL*Plus, pero se corresponde con las tareas ms habituales
de interaccin, programacin y depuracin de cdigo sobre la base de datos.
Para obtener informacin ms detallada sobre la herramienta, se puede consultar:
SQL Developer User's Guide
Release 2.1, Febrero 2010
Oracle
http://download.oracle.com/docs/cd/E15846_01/doc.21/e15222.pdf
o utilizar directamente la amplia ayuda que trae incorporada la aplicacin.

1. Conexin y desconexin de la base de datos

En el Navegador de Objetos, en la pestaa Conexsiones pulsar sobre el icono de nueva conexin.

Dar nombre a la conexin e introducir el usuario y el password:

1. Conexin a base de datos local Oracle 10g Express:

Juan Ruiz de Miras

Universidad de Jan

SQL Developer

2. Conexin remota desde el aula de prcticas:

Para desconectar de la base de datos se pulsa con el botn derecho sobre el icono de la conexin que
queremos cerrar y se selecciona Desconectar.

2. Ejecucin de sentencias SQL

Escribir las sentencias SQL en la ventana de edicin SQL (Hoja de Trabajo SQL):

Para ejecutar slo una sentencia, se sita el cursor sobre la sentencia y se pulsa el icono
F9.
Para ejecutar todas las sentencias, se pulsa el icono

Juan Ruiz de Miras

o la tecla

o la tecla F5.

Universidad de Jan

SQL Developer
Los resultados de la ejecucin de las sentencias SQL se muestran en las pestaas Salida de
Sentencia y Salida de Script

permite acceder a un histrico de sentencias SQL ejecutadas. Para cargar una sentencia
El icono
del histrico sobre el editor SQL se hace doble-clik sobre la sentencia.
El icono

borra el contenido del editor SQL o de las pestaas de resultados.

Para ver el nmero de lnea en el editor SQL hay que activar Herramientas Preferencias Editor de
Cdigos Canal de Lnea Mostrar Nmero de Lnea
Para grabar a un fichero .SQL el contenido del editor SQL se utiliza la opcin Archivo Guardar o el
icono
Para abrir un fichero .SQL en el editor SQL se utiliza la opcin Archivo Abrir o el icono

Para abrir un nuevo editor SQL se utiliza la opcin Herramientas Hoja de Trabajo SQL o el icono

Para crear y editar un nuevo fichero SQL se utiliza la opcin Archivo Nuevo Archivo SQL
IMPORTANTE: Las sentencias SQL que modifican la base de datos (INSERT INTO, UPDATE,
DELETE, ...) no se realizan (cometen) en la base de datos hasta que se pulsa el icono
.
Si se quiere que las sentencias SQL se comentan automticamente despus de ejecutarlas hay que
activar la opcin Herramientas Preferencias Base de Datos Hoja de Trabajo Confirmacin
Automtica en la Hoja de Trabajo SQL.
Para que los cambios realizados por sentencias SQL de creacin de objetos (DDL) se reflejen en el
navegador de objetos, es necesario pulsar el icono "Refrescar"

Juan Ruiz de Miras

Universidad de Jan

SQL Developer

3. Creacin de tablas
Pulsar el botn derecho sobre el icono Tablas de la conexin.

Pulsar Nueva Tabla...

Juan Ruiz de Miras

Universidad de Jan

SQL Developer

4. Modificacin de la definicin de una tabla

1. Seleccionar la tabla (doble-click sobre su icono)
2. Elegir la pestaa Columnas
3. Pulsar sobre el icono Editar

Tambin se puede hacer pulsando con el botn derecho sobre el icono de la tabla que se quiere
modificar y eligiendo la opcin Editar...

5. Insercin de tuplas
Para insertar tuplas en una tabla, se selecciona la tabla, y se pulsa la pestaa Datos.

Para introducir una nueva tupla se pulsa sobre el icono

Para grabar la/s tupla/s en la tabla se pulsa el icono

El icono

, y se escriben lo valores de cada atributo.

(Confirmar Cambios).

permite borrar una tupla.

permite fijar la pestaa de la tabla actual de manera que si se selecciona otra tabla en el
El icono
navegador de objetos se abrir otra pestaa nueva y no se reutilizar la pestaa fijada.

Juan Ruiz de Miras

Universidad de Jan

SQL Developer

6. Generacin de Cdigo SQL

Generacin del cdigo SQL de un nico objeto (tabla, secuencia, procedimiento, disparador, ...):
- Pulsar botn derecho sobre el objeto y seleccionar Exportar DDL

Generacin del cdigo de toda una conexin (esquema):

- Ir a Herramientas --> Exportacin de Base de Datos

Juan Ruiz de Miras

Universidad de Jan

SQL Developer

7. Creacin y edicin de Secuencias

Para crear una nueva secuencia se pulsa el botn derecho sobre icono Secuencias de la conexin:

Elegir Nueva secuencia...:

Una vez creada la secuencia, se puede acceder a su definicin y valor actual haciendo doble-click sobre
su icono:

Como cualquier otro objeto, para modificar la definicin de una secuencia se puede optar por:

Juan Ruiz de Miras

Universidad de Jan

SQL Developer
1. Seleccionar la secuencia (doble-click sobre su icono) y elegir la pestaa Detalles y pulsar sobre el
icono Editar
2. Pulsar con el botn derecho sobre el icono de la secuencia que se quiere modificar y elegir la opcin
Editar...

8. Creacin, compilacin
procedimientos

ejecucin

de

funciones

Para crear una funcin o procedimiento se pulsa con botn derecho sobre el icono Funciones o
Procedimientos del navegador de objetos y se elige la opcin Nueva funcin o Nuevo
Procedimiento respectivamente:

Juan Ruiz de Miras

10

Universidad de Jan

SQL Developer
Se introduce el nombre del procedimiento o funcin, los nombres de los parmetros, sus tipos de datos,
el modo del parmetro y los valores por defecto. Para el caso de las funciones tambin hay que
especificar el tipo del resultado de la funcin (parmetro <Return>):

El asistente abre una pestaa de edicin con el cdigo generado para la funcin o el procedimiento con
la cabecera especificada y el cuerpo vaco:

Para compilar se pulsa el icono

. Tambin se compila automticamente cuando se almacena el

). Los errores y warnings aparecen en el panel

procedimiento o funcin en la base de datos (icono
Log en la pestaa Compilador. Junto a la palabra error o warning se indica entre parntesis la lnea y
la columna en la que se ha producido el error. Las sentencias errneas aparecen subrayadas en rojo y
los warnings subrayados en amarillo en la ventana de edicin:

Juan Ruiz de Miras

11

Universidad de Jan

SQL Developer

de la ventana de edicin o se elige la

Para ejecutar un procedimiento o funcin se pulsa el icono
opcin Ejecutar... que aparece tras pulsar con el botn derecho sobre el icono de la funcin o
procedimiento en el navegador de objetos:

Juan Ruiz de Miras

12

Universidad de Jan

SQL Developer
Para poder ejecutar una funcin o procedimiento, SQL Developer crea un bloque con las variables
necesarias para pasar los parmetros en la llamada a la funcin o procedimiento, debindose sustituir
los valores por defecto predefinidos, por el valor actual que se le quiere dar al parmetro para la
ejecucin:

Inicialmente:
Se sustituye por:

VARIABLE => VARIABLE

VARIABLE => valor_actual

Tras pulsar el botn Aceptar, el bloque que contiene la llamada a la funcin o el procedimiento se
ejecuta y se muestran los resultados en el panel Log en la pestaa Ejecutando:

9. Depuracin de Funciones y Procedimientos

Para poder depurar es necesario que el usuario tenga los privilegios:
- DEBUG ANY PROCEDURE
- DEBUG CONNECT SESSION
En el aula de prcticas el alumno ya tiene estos privilegios asignados. Para asignarlos en una
instalacin local de Oracle Express debes consultar el apartado Asignacin de Privilegios y Roles ms
abajo.
Para comenzar la depuracin, en la ventana de edicin del procedimiento o funcin (botn derecho
sobre el icono del objeto y elegir Editar...) introducir los puntos de ruptura deseados dentro del cuerpo
del procedimiento o funcin, como mnimo uno para que la ejecucin del depurador se interrumpa y se
pueda avanzar paso a paso viendo los valores de las distintas variables. Los puntos de ruptura se
especifican pulsando con el ratn sobre el nmero de la lnea donde se quiere introducir (el nmero de
lnea se sustituye por un crculo rojo):

Juan Ruiz de Miras

13

Universidad de Jan

SQL Developer

Antes de iniciar la depuracin es necesario compilar el procedimiento o funcin de manera especial para
que pueda ser depurado. Esto se realiza pulsando la flecha del icono
para Depuracin.

y seleccionando Compilar

de la ventana de edicin del procedimiento o

Para iniciar el depurador, se pulsa sobre el icono
funcin. A continuacin se mostrar una ventana similar a la que aparece cuando se ejecuta un
procedimiento o funcin, en la que hay que establecer los valores actuales de los parmetros como se
describi anteriormente. A continuacin el flujo de control (indicado por una flecha roja) se detiene en el
primer punto de ruptura establecido, pudindose ver los valores de las distintas variables en las
pestaas Datos y Observaciones del depurador.

Juan Ruiz de Miras

14

Universidad de Jan

SQL Developer
Las posibles acciones del depurador se ejecutan desde el men Ejecutar o a travs de los iconos de
depuracin de la barra de herramientas (estos iconos slo aparecen cuando se est depurando):

Las acciones ms tpicas son:

- Avanzar sin entrar: F8
- Avanzar entrando: F7
- Avanzar hasta el cursor: F4
- Avanzar hasta el prximo punto de ruptura: F9

10. Creacin y compilacin de disparadores

Para crear un disparador se pulsa con botn derecho sobre el icono Disparador del navegador de
objetos y se elige la opcin Nuevo Disparador...:

Se introduce:
- El nombre del disparador
- El tipo de disparador
- La tabla asociada al disparador
- Si el disparador es de sentencia (Nivel de Sentencia) o de tupla (Nivel de Fila)
- El momento del disparo (Antes de o Despus de)
- Los eventos de disparo (Insertar, Suprimir o Actualizar)
- Para el caso del evento Actualizar se pueden especificar sobre qu columnas debe ser la
actualizacin
- Para el caso de disparadores de tupla, se puede especificar una condicin para la clusula
When (Cundo) y cambiar en Referencia el nombre de las variables de referencia de tupla
por defecto (old y new):

Juan Ruiz de Miras

15

Universidad de Jan

SQL Developer
El asistente abre una pestaa de edicin con el cdigo generado para el disparador con la cabecera
especificada y el cuerpo vaco:

Para compilar se pulsa el icono

. Tambin se compila automticamente cuando se almacena el

). Al igual que para el caso de los procedimientos y las

disparador en la base de datos (icono
funciones, los errores y warnings aparecen en el panel Log en la pestaa Compilador. Junto a la
palabra error o warning se indica entre parntesis la lnea y la columna en la que se ha producido el
error. Las sentencias errneas aparecen subrayadas en rojo y los warnings subrayados en amarillo en
la ventana de edicin del disparador.

11. Depuracin de disparadores

La versin actual de SQL Developer no permite la depuracin mediante traza del cdigo de los
disparadores. La manera tradicional de trazar los disparadores consiste en mostrar mensajes en
pantalla.
Para mostrar un mensaje desde un bloque PL/SQL, por ejemplo desde el cuerpo de un disparador, se
utiliza la funcin:
DBMS_OUTPUT.PUT_LINE(cadena);
Por ejemplo: DBMS_OUTPUT.PUT_LINE('El valor de var es: ' || var);
Para que los mensajes aparezcan por pantalla es necesario activar la salida del servidor
(SERVEROUTPUT). Desde SQL*PLUS se realiza mediante la sentencia:
SQL> SET SERVEROUTPUT ON
En SQL Developer (versin 2.1), la pestaa con la salida del servidor se abre en el men Ver Salida
de DBMS. Despus hay que seleccionar la conexin de la que se quiere ver su salida pulsando en el
icono

de la pestaa "Salida de DBMS".

Juan Ruiz de Miras

16

Universidad de Jan

SQL Developer

12. Asignacin de Privilegios y Roles

Para asignar privilegios hay crear una conexin en SQL Developer para el administrador SYSTEM,
abrir la categora Otros Usuarios en el navegador de objetos y elegir la opcin Editar Usuario al
pulsar con el botn derecho sobre el usuario al que se le quieren dar los privilegios:

En la pestaa Privilegios del Sistema activar la casilla Otorgado para los privilegios que se quieren
conceder al usuario y pulsar aplicar:

Para poder conceder roles, el usuario debe tener previamente concedido por el administrador el
privilegio CREATE ROLE

Juan Ruiz de Miras

17

Universidad de Jan