Está en la página 1de 259

PL/SQL Developer 9.

0 Gua del usuario


Agosto 2011

Gua del usuario de PL/SQL Developer 9.0

Contenido
1. 2. 2.1 2.2 2.3 2.4 2.5 3. 4. 4.1 4.2 4.3 4.4 4.5 5. 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 5.11 5.12 6. 6.1 6.2 6.3 6.4 7. 7.1 7.2 7.3 7.4 7.5 7.6 7.7 7.8 7.9 7.10 INTRODUCCIN. ............................................................................................................................ 7 INSTALACIN. .............................................................................................................................. 11 REQUISITOS DEL SISTEMA. ....................................................................................................... 11 INSTALAR PL/SQL DEVELOPER EN UNA ESTACIN DE TRABAJO. ........................................ 11 INSTALAR PL/SQL DEVELOPER EN UN SERVIDOR. ................................................................ 11 INSTALACIN DESATENDIDA. .................................................................................................. 11 DESINSTALAR PL/SQL DEVELOPER. ...................................................................................... 12 INICIO DE SESIN CONTRA UNA BASE DE DATOS ORACLE. .................................... 13 ESCRIBIR PROGRAMAS ............................................................................................................ 15 CREAR UN PROGRAMA ............................................................................................................. 15 GUARDAR UN PROGRAMA. ....................................................................................................... 16 MODIFICAR UN PROGRAMA. .................................................................................................... 17 COMPILAR UN PROGRAMA. ...................................................................................................... 17 OPCIONES DEL COMPILADOR. .................................................................................................. 18 PROBAR PROGRAMAS............................................................................................................... 19 CREAR UN ARCHIVO DE PRUEBA.............................................................................................. 19 EJECUTAR UN ARCHIVO DE PRUEBA. ....................................................................................... 20 TIPOS DE VARIABLES. ............................................................................................................... 21 GUARDAR ARCHIVOS DE PRUEBA. ........................................................................................... 22 CAPTURAR ERRORES EN TIEMPO DE EJECUCIN. .................................................................... 22 ESTADO DE LOS PAQUETES Y DE LAS SESIONES JAVA. ........................................................... 23 VER UN CONJUNTO DE RESULTADOS. ...................................................................................... 23 VER LA SALIDA GENERADA POR EL PAQUETE DBMS_OUTPUT. .............................................. 23 VER LA SALIDA HTP. ............................................................................................................... 24 DEPURAR................................................................................................................................... 24 TRAZAR LA EJECUCIN. ........................................................................................................... 27 PRUEBAS DE REGRESIN. ......................................................................................................... 28 OPTIMIZACIN. ........................................................................................................................... 29 UTILIZAR LA VENTANA DEL PLAN DE EJECUCIN. ................................................................. 29 ESTADSTICAS AUTOMTICAS. ................................................................................................ 30 EL PERFILADOR DE PL/SQL. ................................................................................................... 31 TRAZAR INSTRUCCIONES SQL................................................................................................. 32 TRABAJAR CON SQL. ................................................................................................................. 34 UTILIZAR LA VENTANA DE CONSULTA SQL. .......................................................................... 34 MODIFICAR LOS RESULTADOS EN LA REJILLA DE RESULTADOS. ........................................... 36 FILTRAR RESULTADOS DE LA CONSULTA. ............................................................................... 40 CONSULTAS VINCULADAS........................................................................................................ 41 VARIABLES DE SUSTITUCIN. .................................................................................................. 41 ACTUALIZAR LA BASE DE DATOS. ........................................................................................... 42 VER Y EDITAR COLUMNAS DE TIPO XMLTYPE. .................................................................... 44 EXPORTAR CONSULTAS. ........................................................................................................... 44 GUARDAR ARCHIVOS SQL. ...................................................................................................... 44 CREAR CONSULTAS ESTNDAR. .............................................................................................. 45

Gua del usuario de PL/SQL Developer 9.0

8. 8.1 8.2 8.3 9. 9.1 9.2 9.3 9.4 9.5 9.6 9.7 9.8 9.9 9.10 9.11 9.12 10. 10.1 10.2 10.3 10.4 10.5 11. 11.1 11.2 11.3 11.4 11.5 11.6 12. 12.1 12.2 12.3 12.4 12.5 12.6 12.7 13. 14. 14.1 14.2 14.3 14.4 14.5

LA VENTANA DE COMANDOS. ............................................................................................... 46 INTRODUCIR COMANDOS E INSTRUCCIONES SQL. ................................................................. 46 DESARROLLAR ARCHIVOS DE COMANDOS. ............................................................................. 46 COMANDOS SOPORTADOS. ....................................................................................................... 48 CREAR Y MODIFICAR OBJETOS. .......................................................................................... 51 EL EDITOR DE TABLAS. ............................................................................................................. 51 EL EDITOR DE SECUENCIAS. ..................................................................................................... 62 EL EDITOR DE SINNIMOS. ....................................................................................................... 63 EL EDITOR DE LIBRERAS. ........................................................................................................ 63 EL EDITOR DE DIRECTORIOS. ................................................................................................... 64 EL EDITOR DE TRABAJOS DE LA BASE DE DATOS. ................................................................... 64 EL EDITOR DE LISTAS. .............................................................................................................. 64 EL EDITOR DE TABLAS DE LISTAS AVANZADAS. ..................................................................... 65 EL EDITOR DE USUARIOS. ......................................................................................................... 66 EL EDITOR DE ROLES. ............................................................................................................... 68 EL EDITOR DE PERFILES............................................................................................................ 69 EL EDITOR DE VNCULOS DE BASES DE DATOS. ...................................................................... 70 PLANIFICADOR DE TAREAS. .................................................................................................. 71 CREAR OBJETOS. ....................................................................................................................... 75 EDITAR OBJETOS. ...................................................................................................................... 76 BORRAR OBJETOS. .................................................................................................................... 76 VER INFORMACIN SOBRE LOS TRABAJOS FINALIZADOS. ...................................................... 76 VER INFORMACIN SOBRE LOS TRABAJOS EN EJECUCIN. .................................................... 78 DIAGRAMAS. ................................................................................................................................. 79 CREAR UN DIAGRAMA. ............................................................................................................. 79 ZOOM. ....................................................................................................................................... 83 GUARDAR Y ABRIR UN DIAGRAMA. ......................................................................................... 83 ACTUALIZAR UN DIAGRAMA.................................................................................................... 83 IMPRIMIR UN DIAGRAMA. ......................................................................................................... 83 EXPORTAR UN DIAGRAMA. ...................................................................................................... 83 INFORMES. ..................................................................................................................................... 84 INFORMES ESTNDAR............................................................................................................... 84 INFORMES PERSONALIZADOS. .................................................................................................. 85 VARIABLES. .............................................................................................................................. 85 DEFINIR EL DISEO DE LOS INFORMES. ................................................................................... 91 LA LIBRERA DE ESTILOS. ......................................................................................................... 97 OPCIONES. ................................................................................................................................. 98 EL MEN I NFORMES. ................................................................................................................ 99 GRFICOS..................................................................................................................................... 101 PROYECTOS................................................................................................................................. 103 CREAR UN NUEVO PROYECTO. ............................................................................................... 103 GUARDAR UN PROYECTO. ...................................................................................................... 104 AADIR ARCHIVOS A UN PROYECTO. .................................................................................... 104 AADIR OBJETOS DE LA BASE DE DATOS A UN PROYECTO. ................................................. 104 TRABAJAR CON LOS ELEMENTOS DEL PROYECTO................................................................. 104

Gua del usuario de PL/SQL Developer 9.0

14.6 15. 15.1 15.2 15.3 15.4 16. 16.1 16.2 17. 17.1 17.2 17.3 17.4 18. 18.1 18.2 18.3 19. 19.1 19.2 20.

COMPILAR UN PROYECTO. ..................................................................................................... 105 ELEMENTOS PENDIENTES. ................................................................................................... 107 CREAR UN ELEMENTO PENDIENTE. ........................................................................................ 108 EDITAR UN ELEMENTO PENDIENTE. ....................................................................................... 108 CERRAR UN ELEMENTO PENDIENTE....................................................................................... 109 BORRAR UN ELEMENTO PENDIENTE. ..................................................................................... 109 LA LISTA DE CONEXIONES. .................................................................................................. 110 USAR LA LISTA DE CONEXIONES. ........................................................................................... 110 DEFINIR CARPETAS Y CONEXIONES. ...................................................................................... 112 CONEXIONES, VENTANAS, SESIONES Y TRANSACCIONES. ..................................... 115 LA CONEXIN PRINCIPAL ....................................................................................................... 115 CONEXIONES DE LAS VENTANAS ........................................................................................... 115 MODO DE LA SESIN. ............................................................................................................. 116 EJECUTAR PL/SQL DEVELOPER EN MODO MULTISESIN O MODO D UAL. ......................... 116 EXPLORAR OBJETOS DE LA BASE DE DATOS. .............................................................. 117 UTILIZAR EL EXPLORADOR DE OBJETOS. ............................................................................. 117 CONFIGURAR LOS FILTROS DEL EXPLORADOR DE OBJETOS. ............................................... 123 CONFIGURAR LAS CARPETAS DEL EXPLORADOR DE OBJETOS. ........................................... 124 EXPLORADOR ARCHIVOS. .................................................................................................... 127 CONFIGURAR EL EXPLORADOR DE ARCHIVOS. .................................................................... 127 UTILIZAR EL EXPLORADOR DE ARCHIVOS............................................................................ 128 PREFERENCIAS. ......................................................................................................................... 131 ORACLE - CONEXIN.............................................................................................................. 131 ORACLE - OPCIONES............................................................................................................... 133 ORACLE - COMPILADOR. ........................................................................................................ 134 ORACLE - DEPURADOR. ......................................................................................................... 135 ORACLE - SALIDA. .................................................................................................................. 137 ORACLE - TRAZADOR. ............................................................................................................ 137 ORACLE - PERFILADOR. ......................................................................................................... 138 ORACLE - H ISTORIAL DE CONEXIONES. ................................................................................ 138 ORACLE - SUGERENCIAS. ....................................................................................................... 141 INTERFACE DE USUARIO - OPCIONES..................................................................................... 142 INTERFAZ DE USUARIO - BARRA DE HERRAMIENTAS. .......................................................... 144 INTERFAZ DE USUARIO - EXPLORADOR DE OBJETOS. .......................................................... 144 INTERFAZ DE USUARIO - EDITOR. .......................................................................................... 145 INTERFAZ DE USUARIO - FUENTES ......................................................................................... 148 INTERFAZ DE USUARIO - ASISTENTE DE CDIGO. ................................................................. 150 INTERFAZ DE USUARIO - CONFIGURACIN DEL TECLADO. .................................................. 151 INTERFAZ DE USUARIO - APARIENCIA. .................................................................................. 151 INTERFAZ DE USUARIO - NLS. ............................................................................................... 153 TIPOS DE VENTANAS - VENTANA DE PROGRAMA ................................................................ 154 TIPOS DE VENTANAS - VENTANA DE CONSULTA SQL.......................................................... 155 TIPOS DE VENTANA - VENTANA DE PRUEBA. ........................................................................ 158 TIPOS DE VENTANAS - PLAN DE EJECUCIN.......................................................................... 158 HERRAMIENTAS - COMPARACIN. ........................................................................................ 158

20.1 20.2 20.3 20.4 20.5 20.6 20.7 20.8 20.9 20.10 20.11 20.12 20.13 20.14 20.15 20.16 20.17 20.18 20.19 20.20 20.21 20.22 20.23

Gua del usuario de PL/SQL Developer 9.0

20.24 20.25 20.26 20.27 20.28 20.29 20.30 20.31 20.32 20.33 20.34 21.

HERRAMIENTAS - GENERADOR DE DATOS. ........................................................................... 159 HERRAMIENTAS - LISTA DE ELEMENTOS PENDIENTES. ........................................................ 160 HERRAMIENTAS - LISTA DE INSTRUCCIONES EJECUTADAS.................................................. 160 ARCHIVOS - D IRECTORIOS ..................................................................................................... 160 ARCHIVOS - EXTENSIONES..................................................................................................... 162 ARCHIVOS - FORMATOS. ........................................................................................................ 162 ARCHIVOS - COPIA DE SEGURIDAD........................................................................................ 163 ARCHIVOS - HTML/XML. ..................................................................................................... 164 OTROS - IMPRIMIR. ................................................................................................................. 164 OTROS - ACTUALIZACIONES Y NOTICIAS. ............................................................................. 165 ESTABLECER LAS PREFERENCIAS. ......................................................................................... 166

HERRAMIENTAS. ....................................................................................................................... 169 EXPLORADOR DE OBJETOS. ................................................................................................... 169 BUSCAR OBJETOS DE LA BASE DE DATOS. ............................................................................. 169 COMPILAR OBJETOS NO VALIDOS. ......................................................................................... 170 EXPORTAR TABLAS................................................................................................................. 171 IMPORTAR TABLAS. ................................................................................................................ 173 EXPORTAR OBJETOS. .............................................................................................................. 176 IMPORTAR TEXTO. .................................................................................................................. 177 IMPORTAR ODBC. .................................................................................................................. 181 GENERADOR DE DATOS. ......................................................................................................... 183 COMPARAR OBJETOS. ............................................................................................................. 187 COMPARAR DATOS ENTRE TABLAS. ...................................................................................... 190 MONITOR DE EVENTOS. .......................................................................................................... 192 MONITOR DE SESIONES. ......................................................................................................... 193 HERRAMIENTAS DEFINIDAS POR EL USUARIO. ...................................................................... 196 ORGANIZADOR DE CASOS DE PRUEBA. .................................................................................. 200

21.1 21.2 21.3 21.4 21.5 21.6 21.7 21.8 21.9 21.10 21.11 21.12 21.13 21.14 21.15 22.

EL EDITOR. .................................................................................................................................. 205 FUNCIONES DE SELECCIN. .................................................................................................... 205 SELECCIN DE COLUMNAS. .................................................................................................... 205 ASISTENTE DE CDIGO. .......................................................................................................... 205 HISTORIAL DE INSTRUCCIONES.............................................................................................. 207 FORMATO ESPECIAL. .............................................................................................................. 207 AYUDA SENSIBLE AL CONTEXTO. .......................................................................................... 209 MEN CONTEXTUAL DE LOS OBJETOS DE LA BASE DE DATOS. ............................................ 209 PLAN DE EJECUCIN. .............................................................................................................. 209 MACROS. ................................................................................................................................. 209 MARCADORES. ........................................................................................................................ 210 MARCADOR DE COLOR. .......................................................................................................... 211 CONTENIDO DEL CDIGO. ...................................................................................................... 211 JERARQUA DEL CDIGO. ....................................................................................................... 212 MOSTRAR / OCULTAR CDIGO. ............................................................................................. 213 DIVISIN DEL EDITOR DE CDIGO. ........................................................................................ 214 NAVEGACIN MEDIANTE VNCULOS. .................................................................................... 214 BOTONES DE NAVEGACIN. ................................................................................................... 215 REFACTORIZACIN. ................................................................................................................ 215 BARRA DE BSQUEDA. ........................................................................................................... 216

22.1 22.2 22.3 22.4 22.5 22.6 22.7 22.8 22.9 22.10 22.11 22.12 22.13 22.14 22.15 22.16 22.17 22.18 22.19 23. 23.1

EL EDITOR DE DATOS. ............................................................................................................ 218 EDITAR ARCHIVOS DE TEXTO................................................................................................. 219

Gua del usuario de PL/SQL Developer 9.0

23.2 23.3 23.4 23.5 23.6 23.7 24. 24.1 24.2 24.3 24.4 24.5 25. 25.1 25.2 25.3 25.4 26. 26.1 26.2 26.3 27. 28. 29. 29.1 29.2 29.3 30. 30.1 30.2 31. 31.1 31.2 32. 32.1 32.2 32.3 32.4 32.5 32.6

EDITAR DATOS EN FORMATO RTF. ........................................................................................ 219 EDITAR DATOS EN FORMATO XML. ...................................................................................... 219 EDITAR HTML ....................................................................................................................... 220 EDITAR IMGENES. ................................................................................................................. 221 EDITAR DATOS EN FORMATO HEXADECIMAL. ...................................................................... 221 CARGAR UN VISOR O UN EDITOR EXTERNO........................................................................... 222 CONSTRUCTOR DE CONSULTAS. ........................................................................................ 224 CREAR UNA NUEVA CONSULTA DE SELECCIN. ................................................................... 224 MODIFICAR UNA CONSULTA DE SELECCIN EXISTENTE. ..................................................... 227 MANIPULAR LA DEFINICIN DE LA CONSULTA. .................................................................... 227 OPCIONES DEL CONSTRUCTOR DE CONSULTAS..................................................................... 228 COMPLEMENTOS DEL CONSTRUCTOR DE CONSULTAS. ....................................................... 229 PL/SQL BEAUTIFIER. ................................................................................................................ 231 CONFIGURAR PL/SQL BEAUTIFIER....................................................................................... 231 DEFINIR LAS REGLAS DE PL/SQL BEAUTIFIER..................................................................... 231 UTILIZANDO PL/SQL BEAUTIFIER. ....................................................................................... 233 ELIMINANDO EL FORMATO APLICADO POR PL/SQL BEAUTIFIER. ...................................... 233 PLANTILLAS. ............................................................................................................................... 234 LA VENTANA DE PLANTILLAS. ............................................................................................... 234 UTILIZAR LAS PLANTILLAS. ................................................................................................... 235 CREAR Y MODIFICAR PLANTILLAS......................................................................................... 236 LISTA DE VENTANAS. .............................................................................................................. 240 BARRAS DE HERRAMIENTAS. .............................................................................................. 241 AUTORIZACIONES. ................................................................................................................... 243 HABILITAR EL SISTEMA DE AUTORIZACIONES. ..................................................................... 243 DEFINIR AUTORIZACIONES..................................................................................................... 243 DESHABILITAR EL SISTEMA DE AUTORIZACIONES. ............................................................... 245 SISTEMA DE ARCHIVOS DE ORACLE. ............................................................................... 246 ORGANIZADOR OFS. .............................................................................................................. 246 UTILIZAR OFS. ....................................................................................................................... 248 SISTEMA DE AYUDA. ................................................................................................................ 250 ARCHIVOS DE AYUDA MS HELP. ........................................................................................... 250 MANUALES HTML. ................................................................................................................ 250 PERSONALIZAR PL/SQL DEVELOPER............................................................................... 254 PREFERENCIAS. ....................................................................................................................... 254 DISPOSICIN DE LAS VENTANAS............................................................................................ 254 DOCUMENTACIN EN LNEA. ................................................................................................. 254 PARMETROS DE LA LNEA DE COMANDOS. ......................................................................... 256 SQL, PL/SQL Y PALABRAS RESERVADAS Y COMANDOS. .................................................... 259 COMPLEMENTOS. .................................................................................................................... 259

Gua del usuario de PL/SQL Developer 9.0

1. Introduccin.
PL/SQL Developer es un entorno integrado de desarrollo (IDE) que le permite desarrollar unidades de programa almacenadas en un servidor de bases de datos Oracle. Utilizando PL/SQL Developer puede crear la parte servidor de sus aplicaciones cliente/servidor. En el mejor de los casos, hasta ahora, ha trabajado de esta forma: Utilizando un editor de texto para escribir las unidades de programa (procedimientos, funciones, disparadores, etc.). Utilizando Oracle SQL*Plus para compilar su cdigo fuente. En caso de producirse un error durante el proceso de compilacin, tiene que localizar en que parte del cdigo fuente se ha producido el error, corregirlo y volver a SQL*Plus para compilar el cdigo de nuevo. Teniendo que seguir todos estos pasos nicamente para corregir un error y repetir el proceso por cada nuevo error que se encuentre durante el proceso de compilacin.

Utilizar SQL*Plus o la parte cliente de su aplicacin para probar las unidades de programa. En caso de que se produzca un error en tiempo de ejecucin, tiene que localizar la causa del problema y corregirlo. Utilizando la herramienta Explain Plan o tkprof para optimizar sus instrucciones SQL. Para ver o modificar otros objetos y datos en su base de datos, utiliza SQL*Plus u otra herramienta. Estas tareas editar, compilar, corregir, probar, depurar, optimizar y consultar pueden realizarse sin abandonar el entorno de desarrollo de PL/SQL Developer. Adems, PL/SQL Developer le proporciona otras herramientas que le pueden resultar tiles durante su trabajo diario.

Gua del usuario de PL/SQL Developer 9.0

Edicin.
PL/SQL Developer, al igual que otros entornos de desarrollo, asume que almacena su cdigo fuente en una unidad de disco. Otras herramientas de desarrollo solo le permiten editar el cdigo directamente de su base de datos, sin permitir la utilizacin de ningn sistema de control de versiones. El cdigo fuente generado puede ejecutarse mediante la herramienta SQL*Plus de Oracle, con lo que puede ejecutarlo en otra plataforma sin necesidad de emplear PL/SQL Developer. Puede editar todos los archivos que quiera gracias a la interfaz MDI (Multiple Document Interface) de PL/SQL Developer. El editor le ofrece un amplio abanico de ayuda al programador. Existe ayuda sensible al contexto para las instrucciones de SQL y PL/SQL. A todos nos ha ocurrido alguna vez: empieza a teclear substr, pero ha olvidado el significado exacto de los parmetros. Simplemente con pulsar la F1, aparecer el tema exacto del manual SQL Reference de Oracle. Las tablas, vistas y unidades de programa pueden describirse mediante una ventana desplegable desde el editor. El asistente de cdigo integrado en el editor, le muestra automticamente la informacin de los objetos de la base de datos a medida que va tecleando sus nombres, permitindole explorar y seleccionar los elementos desde su descripcin. Si dispone de paquetes de cdigo y tipos muy grandes, el editor de programas le proporciona un rbol de navegacin donde se muestra el contenido del cdigo para una navegacin ms rpida, permitindole el uso de botones para moverse hacia delante y hacia atrs, mostrar u ocultar cdigo y la navegacin mediante vnculos. El constructor de consultas le permite crear consultas de seleccin de forma grafica. Las plantillas extensibles de PL/SQL Developer le permiten insertar cdigo SQL y PL/SQL en sus programas. Todos los editores resaltan de forma apropiada la sintaxis del cdigo SQL, PL/SQL y SQL*Plus, para hacer la lectura del cdigo ms legible.

Compilar y corregir errores.


Desde el editor puede compilar un archivo de cdigo. En caso de que se produzca un error de compilacin el programa le llevar automticamente a la lnea de cdigo adecuada. Todos los errores de compilacin se muestran en una lista situada en la parte inferior del editor. Esta lista puede incluir sugerencias para la codificacin de cdigo PL/SQL que pueden ayudarle a localizar errores comunes de programacin o violaciones en la nomenclatura empleada. Puede compilar un archivo sin guardarlo, con lo que puede explorar formas alternativas de resolver un problema. El editor mantiene el control sobre todos los cambios que ha realizado en el archivo sin guardarlo o compilarlo.

Probar unidades de programa.


Para probar sus unidades de programa, puede escribir archivos de prueba. El cuerpo del archivo de prueba contiene bloques de cdigo PL/SQL en los cuales puede programar el cdigo que desea probar. Cualquier variable que quiera utilizar en el boque puede ser declarada, asignada a un valor de entrada y vista despus de la ejecucin. Cuando ejecute un archivo de prueba, puede ocurrir que se produzca un error en tiempo de ejecucin. En este caso, PL/SQL Developer le permite ver el contenido de la pila errores. Cada lnea de cdigo de la pila de errores que este relacionada con un error en tiempo de ejecucin se resaltar, con lo que puede volver fcilmente al error causante del problema. Si utiliza la versin 7.3.4 de Oracle o una versin posterior puede utilizar el depurador integrado de PL/SQL Developer. Puede ejecutar paso a paso el cdigo, establecer puntos de interrupcin, ver/establecer variables, ver la pila de llamadas, etc. En la versin 8i de Oracle (y superiores) puede utilizar de forma adicional el paquete dbms_trace para controlar los eventos seleccionados de una ejecucin de un programa. Esto le ayudar a analizar el flujo del programa y las excepciones. Los resultados de las llamadas a los paquetes dbms_output y PL/SQL Web Toolkit se muestran de forma automtica en la correspondiente pestaa de la ventana de pruebas.

Gua del usuario de PL/SQL Developer 9.0

Para realizar pruebas de regresin puede utilizar el Organizador de casos de pruebas para ejecutar y verificar rpidamente un conjunto de archivos de prueba.

Optimizar el cdigo.
Para optimizar las instrucciones de cdigo SQL en sus unidades de programa, la herramienta Explain Plan de Oracle puede serle de gran ayuda. Adems se encuentra integrada en PL/SQL Developer. Simplemente con seleccionar la instruccin deseada y presionar F5, PL/SQL Developer le presenta el plan de ejecucin de la consulta en una ventana separada Explain Plan. Puede modificar la instruccin para optimizar su plan de ejecucin y copiarlo nuevamente. Tambin puede ver las estadsticas sobre las instrucciones SQL y las unidades de programa PL/SQL. Esas estadsticas pueden incluir el tiempo transcurrido, tiempo de procesador consumido, nmero de lecturas lgicas, nmero de lecturas fsicas, nmero fsico de escrituras, etc. Oracle8i introduce un perfilador de cdigo PL/SQL que le permite optimizar la cantidad de recursos que consume su cdigo PL/SQL. Por cada lnea de cdigo PL/SQL ejecutada puede determinar el tiempo de ejecucin y cuantas veces se ha ejecutado dicha lnea.

Consultar datos.
Para consultar los datos en la base de datos, puede utilizar la ventana de consulta SQL para ejecutar cualquier instruccin SQL. El historial de todas las instrucciones ejecutadas se mantienen en memoria. Los resultados de cualquier consulta se muestran de forma conveniente en una rejilla separada en la que acto seguido podr insertar, actualizar o borrar registros. La rejilla de resultados puede ser utilizada adicionalmente para filtrar consultas, con lo que puede filtrar fcilmente la informacin que necesite. Para consultar los objetos de la base de datos puede utilizar el Explorador de Objetos. Todas las propiedades relevantes de los objetos de la base de datos como tablas, vistas, secuencias, procedimientos, funciones, paquetes, tipos, triggers y dependencias entre objetos. El Explorador de Objetos utiliza una vista en modo rbol, similar a la utilizada en el explorador de Windows, para una exploracin ms sencilla.

Ejecutar archivos SQL.


PL/SQL Developer incluye una ventana de comandos que puede ser utilizada para ejecutar archivos SQL o ejecutar instrucciones. Adicionalmente puede ejecutar comandos similares a los comandos empleados en la herramienta SQL*Plus de Oracle.

Crear y modificar la definicin de las tablas.


Puede crear y modificar fcilmente la definicin de las tablas sin utilizar ninguna instruccin SQL. Simplemente rellenando la informacin de definicin en un cuadro de dilogo puede modificar columnas, restricciones, ndices, privilegios, informacin sobre almacenamiento, comentarios, etc. Puede aplicar esta definicin en la base de datos o ver, modificar y guardar la instruccin SQL resultante.

Diagramas.
Para visualizar los objetos de la base de datos de su aplicacin o proyecto y sus relaciones, puede crear diagramas. Un diagrama puede utilizarse con el propsito de documentar, pero tambin como un espacio de trabajo para utilizar con objetos relacionados entre s.

Informes.
PL/SQL Developer viene con conjunto predefinido de informes estndar, basados en el estndar HTML. Puede ver, imprimir o guardar esos informes como archivos HTML desde el propio PL/SQL Developer.

Gua del usuario de PL/SQL Developer 9.0

10

Tambin puede crear sus propios informes y acceder a ellos fcilmente desde el men informes de la ventana principal de PL/SQL Developer.

Grficos.
La Ventana de Grficos puede ejecutarse desde una Ventana de Consulta o desde una Ventana de Informes para obtener una representacin grafica de los datos consultados.

Proyectos.
Para organizar su trabajo puede utilizar el administrador de proyectos de PL/SQL Developer. Un proyecto consiste en un conjunto de archivos y objetos de base de datos. Puede acceder fcilmente a esos objetos a travs de la ventana de elementos del proyecto y compilarlos mediante un simple clic.

Herramientas.
PL/SQL Developer le proporciona diversas herramientas que pueden resultarle tiles durante el proceso de desarrollo. Entre ellas se incluyen por ejemplo, herramientas para la bsqueda de objetos dentro la base de datos, permitindole buscar un texto concreto dentro del cdigo de los objetos de la base de datos. PL/SQL Developer tambin le proporciona herramientas para compilar objetos que han sido marcados como no validos durante el proceso de desarrollo, as como herramientas para importar, exportar y generar datos, que le permitirn crear conjuntos de datos para utilizar en futuras pruebas. Tambin contiene herramientas para comparar las definiciones de los objetos de dos usuarios, un monitor de sesiones, un monitor de eventos y un planificador de tareas DBMS que le permitir gestionar los distintos trabajos y objetos del planificador de Oracle. De forma adicional a estas herramientas, PL/SQL Developer le permite definir sus propias herramientas e incluirlas en el men herramientas de PL/SQL Developer.

Gua del usuario de PL/SQL Developer 9.0

11

2. Instalacin.
Existen dos formas de instalar PL/SQL Developer: Instalacin en modo cliente. En este caso usted instala el software localmente en cada una de las estaciones de trabajo en las que va a utilizar el programa. Instalacin en modo servidor. En este caso usted instala el software en el servidor, en un directorio que sea accesible a cada estacin de trabajo en la que se utilizar el programa. Los dos tipos de instalacin se explican en este captulo:

2.1

Requisitos del sistema.

PL/SQL Developer es una aplicacin diseada para ejecutarse sobre la plataforma Windows, a partir de Windows 2000 o una versin superior, y es compatible con Oracle Server 7.0 o una versin superior. Para poder conectar con una base de datos Oracle, PL/SQL Developer requiere la versin de 32-bits de Oracle Client 7.0. Si usted utiliza la versin de 64-bits de Oracle Client u Oracle Server, necesitar instalar adicionalmente la versin de 32-bits de Oracle Client.

2.2

Instalar PL/SQL Developer en una estacin de trabajo.

Para instalar PL/SQL Developer localmente en una estacin de trabajo, ejecute el programa de instalacin desde el soporte entregado. Tras hacerlo, aparecer el siguiente cuadro de dilogo;

Puede seleccionar el directorio de destino para los archivos de programa, la carpeta de inicio, la situacin del acceso directo de PL/SQL Developer. Despus de presionar el botn Finalizar en la ltima pgina del asistente de instalacin, se copiarn los archivos de programa y se crearn los accesos directos.

2.3

Instalar PL/SQL Developer en un servidor.

Para una licencia multiusuario puede crear un slo archivo de instalacin de PL/SQL Developer en el servidor y permitir el acceso a todos los usuarios con licencia. Para hacer esto debe ejecutar el programa en el servidor de la misma forma descrita en la seccin anterior. Debe seleccionar un directorio compartido con todos los usuarios que utilizarn el software. Cuando PL/SQL Developer se ejecuta por primera vez en una estacin de trabajo, este tipo de instalacin se detecta automticamente, y la instalacin local se completa por si misma sin que el usuario reciba ningn tipo de notificacin: PL/SQL Developer puede instalarse en un directorio donde los usuarios slo tengan permisos de lectura.

2.4

Instalacin desatendida.

De forma adicional al proceso de instalacin descrito anteriormente, puede crear un archivo para realizar una instalacin desatendida. Lea el archivo install.txt para obtener informacin ms detallada sobre este proceso.

Gua del usuario de PL/SQL Developer 9.0

12

2.5

Desinstalar PL/SQL Developer.

Si por cualquier motivo desea desinstalar PL/SQL Developer, puede hacerlo directamente desde el mdulo Aadir/Quitar Programas del Panel de control.

Gua del usuario de PL/SQL Developer 9.0

13

3. Inicio de sesin contra una base de datos Oracle.


Despus de iniciar PL/SQL Developer por primera vez, se le pedir que inicie una sesin contra una base de datos Oracle:

Si cancela este cuadro de dilogo de inicio de sesin podr continuar sin establecer una conexin contra una base de datos de Oracle. Al hacer esto se desactivarn todas las funciones de PL/SQL Developer que requieran una conexin contra una base de datos, tales como las funciones de compilacin o las de consulta de datos, etc. Posteriormente, podr conectar el entorno de desarrollo de PL/SQL Developer para poder utilizar estas funciones. Despus de introducir su nombre de usuario, su contrasea y la base de datos a la que desea conectar haca clic en el botn Aceptar o pulse la tecla <Intro>, se conectar a la base de datos y se mostrar el entorno de desarrollo de PL/SQL Developer. Desde este momento, podr escribir programas en lenguaje PL/SQL, realizar diferentes pruebas de estos programas, realizar consultas contra la base de datos, etc... tal y como se describe en captulos posteriores. Si tiene mltiples bases de datos o varias cuentas en sus bases de datos, puede crear conexiones adicionales si utiliza el elemento de men Inicio de sesin desde el men Sesiones, o mediante el botn de Inicio de sesin que se encuentra la barra de herramientas principal de PL/SQL Developer. Cada conexin adicional se aadir a la lista de conexiones (ver captulo 16), para que posteriormente, pueda para ver y administrar todas sus conexiones. La prxima vez que inicie PL/SQL Developer puede iniciar la sesin seleccionando la conexin desde la lista de conexiones.

Posibles problemas durante la utilizacin del cuadro de dilogo de inicio de sesin


El cuadro de dilogo de inicio de sesin puede fallar por las siguientes razones: 1. Por no tener el software cliente de Oracle instalado. Este es un requisito necesario para que PL/SQL Developer funcione correctamente. Por favor, instale el software cliente de Oracle y vuelva a intentar la conexin contra sus bases de datos. 2. Es probable que tenga ms de una instalacin del software cliente de Oracle. En este caso, es probable que PL/SQL Developer haya elegido un cliente de Oracle que no sea apropiado. Cierre el cuadro de dilogo de inicio de sesin y dirjase al men Herramientas y seleccione el elemento del men Preferencias, una vez que se encuentre en la ventana de Preferencias dirjase a la seccin Oracle/Conexin, seleccione el archivo correcto de inicio de Oracle en la lista de seleccin, reinicie PL/SQL Developer y vuelva a intentar la conexin contra sus bases de datos. 3. Es probable que utilice un cliente de Oracle Instant, pero que no haya establecido todas las variables de entorno necesarias: PATH - Esta variable debe incluir el directorio del de Oracle Instant (el directorio donde se encuentra el archivo oci.dll). TNS_ADMIN - Esta variable debe apuntar obligatoriamente al directorio donde se encuentra el archivo tnsnames.ora.

Gua del usuario de PL/SQL Developer 9.0

14

NLS_LANG - Esta variable define el idioma, ubicacin y conjunto de caracteres para el cliente.

Gua del usuario de PL/SQL Developer 9.0

15

4. Escribir programas
En una base de datos de Oracle, puede distinguir 5 tipos distintos de unidades de programa almacenadas, funciones, procedimientos, paquetes, tipos y disparadores. El editor de programas le permite crear y modificar estos cinco tipos de unidades de programa de una manera uniforme.

4.1

Crear un programa

Para crear un nuevo programa, presione el botn Nuevo situado en la barra de herramientas y seleccione el elemento Ventana de programa y, por ejemplo, el sub elemento Function. Acto seguido se nos preguntar por distintas variables que son importantes para este tipo de programa. En nuestro caso, estamos creando una funcin, y necesita introducir el nombre de la misma, sus parmetros y el tipo de datos que devuelve:

Como indica el ttulo del cuadro de dilogo, esta informacin proviene de una plantilla. PL/SQL Developer proporciona diversas plantillas estndar, que puede modificar para adaptarlas a sus necesidades. Tambin puede definir nuevas plantillas. Podr encontrar informacin importante sobre la definicin de plantillas en el captulo 26. Despus de introducir las variables necesarias y presionar el botn Aceptar la ventana del editor de programas aparecer con la plantilla de la funcin en ella. Cada programa que cree en el editor de programas, debe comenzar con la ya familiar sintaxis del lenguaje SQL create or replace. En este caso estamos creando la funcin even y el cdigo fuente podra parecerse al que se muestra a continuacin:

En la parte izquierda de la pantalla puede ver la herramienta de contenido del cdigo, que muestra la estructura de la unidad de programa. Este sistema resulta de utilidad, cuando navega por grandes unidades de programa como el cuerpo de un paquete o el cuerpo de los distintos tipos. Esta caracterstica se describe con ms detalle en el captulo 22.12. En la parte superior del editor puede ver la jerarqua del cdigo, que muestra la jerarqua desde la posicin del cursor. En este caso le informa de que se encuentra situado en una Instruccin dentro de la Secuencia de instrucciones de la Funcin. Para programas complejos, esto puede resultarle de utilidad

Gua del usuario de PL/SQL Developer 9.0

16

para ver exactamente, donde se encuentra situado, y puede ayudarle a seleccionar ciertas porciones de cdigo PL/SQL. Esta caracterstica se describe con ms detalle en el captulo 22.13. Un programa puede contener ms de una unidad de programa. Si hace clic con el botn derecho del ratn sobre la ventana del editor de programas, aparecer un men contextual, que le permite aadir o eliminar una unidad de programa. Puede cambiar entre las unidades de programa seleccionando la pestaa apropiada en la parte superior de la ventana. De esta forma puede mantener juntas las unidades de programa en un slo archivo de cdigo. Las especificaciones y cuerpos de los paquetes de la base de datos son un buen ejemplo de esta caracterstica. Una unidad de programa debera colocarse despus de cualquier otra unidad de programa en el archivo de cdigo a la que haga referencia. Si crea una funcin llamada odd que hace referencia a una funcin creada con anterioridad llamada even, el editor de programa debera parecerse a:

4.2

Guardar un programa.
Extensin .fnc .prc .pck .spc .bdy .typ .tps .tpb .trg .jsp

Puede guardar un programa si presiona el botn Guardar situado en la barra de herramientas. Aparecer un cuadro de dilogo donde podr ver las extensiones estndar para los programas. Tipo de programa Funcin. Procedimiento. Especificacin y cuerpo de un paquete. Especificacin de un paquete. Cuerpo de un paquete. Especificacin y cuerpo de un tipo. Especificacin de un tipo. Cuerpo de un tipo. Disparador. Cdigo fuente Java.

Puede cambiar estas extensiones a travs de las opciones que se describen en el captulo 20.28. Si slo existe una funcin, procedimiento, paquete, tipo, disparador o fuente java en el programa, el nombre del archivo se hereda automticamente del nombre y tipo de la unidad de programa. Despus de guardar el archivo, su nombre se mostrar en la ventana de ttulo. El programa almacenado tiene un formato compatible con Oracle SQL*Plus. Como ejemplo, el archivo de cdigo que contiene las funciones odd y even debe parecerse al siguiente:

Gua del usuario de PL/SQL Developer 9.0

17

create or replace function Even(Value in integer) return boolean is Result boolean; begin -- Check if there is a remainder after dividing by 2 Result := (Value mod 2 = 0); return(Result); end Even; / create or replace function Odd(Value in integer) return boolean is Result boolean; begin Result := not Even(Value); return(Result); end Odd; /

Cuando ejecute este archivo mediante la herramienta SQL*Plus de Oracle, se crearn ambas funciones.

4.3

Modificar un programa.

Puede abrir un archivo guardado previamente si presiona el botn Abrir situado en la barra de herramientas y presionando posteriormente el elemento Programa. Si el archivo se ha utilizado recientemente, puede abrirlo si selecciona el elemento Archivos recientes desde el men Archivo o si hace clic con el botn izquierdo del ratn en la flecha cercana al botn Abrir situado en la barra de herramientas. Cuando comience a editar el documento, se activar un indicador de color azul en la parte inferior de la ventana. Esto indica que el archivo se ha modificado, pero que no se ha guardado todava. Si el indicador es de color amarillo, indica que el archivo se ha modificado pero todava no se ha realizado el proceso de compilacin.

4.4

Compilar un programa.

Puede compilar un programa si presiona el botn Ejecutar situado en la barra de herramientas. Todas las unidades del programa se compilan, empezando por la primera, independientemente de la unidad de programa que se encuentra actualmente seleccionada. Cuando ocurre un error de compilacin finaliza el proceso y el editor se posiciona en la lnea de cdigo que ha provocado el error:

Si hay ms de un error y desea corregirlos, puede hacer clic en el siguiente mensaje de error en la parte inferior del editor de programas para ir a la posicin del error. Si ha configurado PL/SQL Developer para utilizar los manuales HTML descritos en el captulo 31.2, puede hacer doble clic sobre un error de compilacin para mostrar el prrafo correspondiente del manual Oracle Error Messages. La lista de errores de compilacin puede contener sugerencias del compilador. Las sugerencias del compilador no provocan que el proceso de compilacin falle, pero indican un problema que podra causar un error en tiempo de ejecucin (como el realizar una comparacin con un valor nulo, una

Gua del usuario de PL/SQL Developer 9.0

18

funcin que no devuelva ningn valor o un parmetro sin utilizar). Para ms informacin acerca de las sugerencias del compilador, vea el captulo 20.19. Si se muestra un mensaje de error en una ventana emergente despus del proceso de compilacin, significa que la instruccin ha fallado sin compilar el cdigo. El mensaje de error debera explicar la causa del mismo. S por ejemplo, obtiene un error de sintaxis en una instruccin de tipo create o replace, se mostrar el siguiente mensaje "ORA-00900: Invalid SQL statement". Nota: Si est utilizando Oracle 7.2 o una versin anterior, los errores de compilacin en los disparadores de la base de datos (triggers) siempre se mostrarn en un mensaje emergente. Slo a partir de la versin 7.3 de Oracle, los errores de compilacin en los disparadores de la base de datos (triggers) se notifican de la misma forma que los procedimientos, funciones, paquetes y tipos.

4.5

Opciones del compilador.

Para establecer las diferentes opciones del compilador puede presionar el botn Opciones del compilador, situado en la barra de estado de PL/SQL Developer. Al presionar dicho botn PL/SQL Developer abrir la ventana de Opciones del compilador, donde podr establecer las diferentes opcin que PL/SQL Developer le ofrece (vea el captulo 20.3).

Gua del usuario de PL/SQL Developer 9.0

19

5. Probar programas.
Despus de compilar correctamente un programa, necesitar probarlo. Para hacer esto puede utilizar los archivos de prueba de PL/SQL Developer. Un archivo de prueba le permite ejecutar una o ms unidades de programa, definir variables de tipo IN, OUT o IN OUT as como ver y asignar valores a las variables. Si ocurre un error durante la ejecucin de un archivo de prueba, puede ver el cdigo de las unidades de programa que estn involucradas en el error. Si utiliza Oracle 7.3.4 o una versin posterior puede utilizar el depurador de PL/SQL Developer. Puede recorrer el cdigo, crear puntos de interrupcin, ver y establecer variables, ver la pila de llamadas, etc.

5.1

Crear un archivo de prueba.

Existen dos formas de crear un archivo de prueba. Puede hacer clic con el botn derecho del ratn sobre una unidad de programa (una funcin de la base de datos, un procedimiento, una funcin empaquetada o un procedimiento) en el Explorador de Objetos y seleccionar el elemento Probar. Esto crear un nuevo archivo de prueba con variables para los parmetros y para el resultado. Para el objetivo de este manual, vamos a crear un archivo de prueba de forma manual desde el principio. Para crear un nuevo archivo de prueba, presione el botn Nuevo situado en la barra de herramientas y seleccione el elemento Ventana de prueba. Ahora puede teclear un bloque de cdigo PL/SQL con el texto declarebegin end en el cuerpo del archivo de prueba. Como ejemplo vamos a probar el paquete employee, en el que crearemos algunas funciones de las tablas de demostracin employee/departament. La funcin deptname devuelve el nombre del departamento de un empleado, y puede probarse utilizando el siguiente bloque de cdigo PL/SQL:

El bloque de cdigo PL/SQL contiene una sencilla llamada a la funcin que queremos probar, y utiliza las variables deptname y empno. Vamos a asignar un valor a la variable empno, y despus de la ejecucin, comprobar el valor de la variable deptname, para comprobar si la funcin devuelve el valor correcto. Si coloca dos puntos como prefijo de las variables, pueden declararse en la parte inferior de la ventana de prueba:

Gua del usuario de PL/SQL Developer 9.0

20

El botn Escanear variables en el cdigo situado en la parte superior izquierda de la lista de variables puede utilizarse para copiar rpidamente las variables desde el cdigo. Despus de esto, el tipo de datos integer y el valor 7369 se asigna a la variable empno. Ahora esta preparado para ejecutar el archivo. Puede declarar las variables localmente en la parte declarativa de un bloque PL/SQL, pero no podr modificar o ver los valores de esas variables. Una ventaja de las variables locales es que puede utilizar tipos de registros, tablas PL/SQL, tipos, etc.

5.2

Ejecutar un archivo de prueba.

Para ejecutar un archivo de prueba, presione el botn Ejecutar situado en la barra de herramientas. Despus de la ejecucin, se actualizan los valores de las variables. Cualquier variable cuyo valor haya cambiado se muestra con el color de fondo de la celda en amarillo:

El resultado de la ejecucin es RESEARCH, con lo que es evidente que la funcin devuelve el resultado correcto. En la parte inferior de la ventana, se muestra el tiempo de ejecucin. Esta informacin puede utilizarse para optimizar el rendimiento de su cdigo. Con el objetivo de optimizar su cdigo puede utilizar las estadsticas de ejecucin del bloque de cdigo PL/SQL seleccionando la pestaa estadsticas. Puede crear un informe del perfilador por cada lnea de cdigo PL/SQL ejecutado si presiona el botn Crear informe del perfilador antes de ejecutar el archivo. Despus de la ejecucin puede cambiar a la pestaa Perfilador para ver el resultado del informe. Las estadsticas y los informes del perfilador se explican en los captulos 6.2 y 6.3 respectivamente. Puede detener la ejecucin de un archivo de prueba si presiona el botn Cancelar, accin que resulta especialmente til cuando un programa entra en un bucle infinito, o la ejecucin del archivo de prueba consume ms tiempo de lo esperado. Observe que el hecho de presionar el botn Cancelar no siempre ser efectivo. Si por ejemplo, un programa se encuentra esperando por un registro o tabla bloqueada, no responder a la seal del botn Cancelar.

Gua del usuario de PL/SQL Developer 9.0

21

Despus de ejecutar un archivo de prueba, alguna de las unidades de programa ejecutadas podra haber iniciado una transaccin. Los botones Commit y Rollback situados en la barra de herramientas se encontrarn habilitados si este es el caso. Para ms informacin acerca de las transacciones, vea el captulo 17.

5.3

Tipos de variables.

La lista de tipos en la seccin de variables de la ventana de prueba contiene todos los tipos que pueden utilizarse. Las caractersticas de cada uno de esos tipos se explican en este captulo. Tipo de dato Integer Flota String Descripcin Puede utilizarse para almacenar valores numricos comprendidos entre -2^32 y 2^32 - 1. Puede utilizarse para almacenar otros valores numricos. Equivale a un tipo de datos varchar2 en una tabla. Puede contener 2000 caracteres (Oracle7) o 4000 caracteres (Oracle8). El valor de la celda de este tipo de datos, posee un botn situado dentro de la misma, que llama al editor de datos de forma que pueda ver y modificar cadenas de texto multi-lnea fcilmente. Tipo de datos para almacenar fechas y horas. Este tipo de datos no representan ningn valor en la rejilla, simplemente muestra el texto <Long>.Presione el botn situado dentro de la celda para llamar al editor de texto. Si presiona el botn situado dentro de la celda de un valor Long Raw llamar a la herramienta de importacin/exportacin de datos, permitindole cargar o guardar los contenidos de esta variable. Ese tipo de datos puede utilizarse cuando necesite una variable de tipo cursor en cdigo PL/SQL. Despus de ejecutar un archivo de prueba, puede presionar el botn situado dentro de la celda para ver el conjunto de resultados en una ventana de consulta SQL. Este tipo de variables deben inicializarse en el servidor antes de que pueda ver sus datos. El tipo de datos CLOB llamar al editor de texto, y los tipos de dato BLOB y BFILE llamarn a la herramienta de importacin/exportacin. Utilice este tipo de datos para valores varchar2 de hasta 32000 caracteres. Cadena de longitud fija (Se rellena con espacios en blanco). Las variables de sustitucin pueden utilizarse sin la restriccin de las variables de acoplamiento. El nombre de la variable en el bloque de cdigo PL/SQL se sustituye por su valor en el texto del cdigo antes de que sea enviado al servidor. Pueden contener datos antes de que se pasen a travs de un archivo de prueba.

Date Long

Long Raw

Cursor

CLOB, BLOB & BFile PL/SQL String Char Substitution

Temporary CLOB & BLOB

Variables de tipo Boolean.


Cuando seleccione un tipo de datos en la lista de tipos, ver que falta el tipo de datos Boolean. Esto se debe a que SQL*Net no soporta este tipo de datos. Para utilizar una variable de tipo Boolean, puede declararla como integer y utilizar las funciones sys.diutil.bool_to_int y sys.diutil.int_to_bool que le

Gua del usuario de PL/SQL Developer 9.0

22

proporciona Oracle. Estas funciones convierten null/true/false y null/0/1. Si usa la funcin Probar en el Explorador de Objetos, esta conversin se generar de forma automtica.

5.4

Guardar archivos de prueba.

Para guardar un archivo de prueba, presione el botn Guardar situado en la barra de herramientas. El cuadro de dilogo utiliza la extensin .tst como extensin por defecto para los archivos de prueba, aunque puede cambiar la extensin por defecto mediante una opcin que se describe en el captulo 20.28. El bloque de cdigo PL/SQL, todas las variables (nombre, tipo y valor), as como inspecciones de depuracin se guardarn (vea el captulo 5.10). Si guarda un archivo de prueba, podr volver a probar fcilmente una unidad de programa si la modifica posteriormente. Puede abrir un archivo de prueba guardado con anterioridad si presiona el botn Abrir situado en la barra de herramientas y selecciona el elemento Archivo de prueba, crendose de esta forma una nueva ventana de prueba. De forma alternativa puede hacer clic con el botn derecho del ratn sobre una ventana de prueba creada anteriormente y seleccionar el elemento Cargar, abrindose un archivo de prueba en la ventana existente.

Guardar como archivo de SQL*Plus.


De forma alternativa puede guardar un archivo de prueba en un formato compatible con SQL*Plus. Esto le permitir ejecutar el archivo en un entorno donde PL/SQL Developer no se encuentre disponible (ejemplo Servidor Unix). Para hacer esto, seleccione Archivo SQL*Plus (*.SQL) como tipo de archivo en el cuadro de dilogo. El siguiente cdigo fuente generado en el captulo previo se guardar de la siguiente forma:
rem PL/SQL Developer Test Script set feedback off set autoprint off rem Declare variables variable result varchar2(2000) variable p_empno number rem Set variables begin :result := null; :p_empno := 7369; end; / rem Execute PL/SQL Block begin :result := employee.deptname(:p_empno); end; / rem Print variables print result print p_empno

Nota: No puede volver a abrir un archivo SQL*Plus como archivo de prueba. Si quiere utilizarlo de nuevo en una ventana de pruebas asegrese de guardarlo como un archivo de prueba.

5.5

Capturar errores en tiempo de ejecucin.

Cuando una unidad de programa causa un error en tiempo de ejecucin, PL/SQL Developer le preguntar si desea ver la pila de errores. De esta forma puede encontrar rpidamente la causa del

Gua del usuario de PL/SQL Developer 9.0

23

mismo. Si hubiese un error en nuestra funcin deptname, la ventana de la pila de errores se mostrara de la siguiente forma:

En la parte superior puede ver una pestaa por cada unidad de programa involucrada en un error en tiempo de ejecucin. Las unidades de programa se han llamado siguiendo un orden de derecha a izquierda. Puede buscar a travs de las pestaas para encontrar fcilmente el flujo de programa que ha llevado al error. En este caso se muestra que el archivo de prueba ha realizado una llamada a la funcin employee.deptname. Es obvio que puede ser ms complicado, incluso a travs de disparadores. Nota: Si est utilizando Oracle Server 7.2 o una versin inferior, el cdigo del disparador no se mostrar en la ventana de la pila de errores. La pila de errores resalta cada lnea que se encuentra involucrada en un error en color rojo. Para la ltima unidad de programa en la pila esta es la lnea que ha causado el error. Para todas las dems unidades de programa esta lnea es la lnea desde donde se realiz la llamada a la siguiente unidad de programa.

5.6

Estado de los paquetes y de las sesiones Java.

Cuando est editando, compilando y probando paquetes, el estado de los paquetes ser descartado por Oracle despus de cada proceso de compilacin. Todas las variables globales en un paquete sern reseteadas y el bloque de inicio se ejecutar otra vez. Esto puede llevar a errores inesperados. Cuando PL/SQL Developer detecta esta situacin, un mensaje de error aparece en la barra de estado de la ventana de prueba: "Warning: ORA-04068: Existing state of packages has been discarded". De forma idntica, si edita o compila un cdigo fuente Java, cualquier estado de sesin se borrar. PL/SQL Developer tambin detectar esta situacin y mostrar un mensaje en la barra de estado: Warning: ORA-29549: class <class name> has changed, Java session state cleared.

5.7

Ver un conjunto de resultados.

En un archivo de prueba usted no se encuentra limitado solamente a bloques PL/SQL. Puede ejecutar instrucciones SQL, incluyendo consultas de seleccin. Si ejecuta una consulta se mostrar una pestaa adicional llamada Resultados, que le mostrar todos los resultados seleccionados.

5.8

Ver la salida generada por el paquete dbms_output.

Durante el proceso de depuracin puede ser necesario mostrar cierta informacin en la pantalla desde una unidad de programa. Con este fin Oracle creo el paquete dbms_output. Si llama al procedimiento dbms_output.put_line, la informacin se coloca en el buffer de salida. Despus de la ejecucin de un archivo de prueba puede seleccionar la pestaa Output en la parte superior de la ventana de prueba para ver el contenido del buffer de salida. En esta pestaa puede establecer el tamao del buffer (0 para un

Gua del usuario de PL/SQL Developer 9.0

24

tamao ilimitado), habilitarlo y deshabilitarlo. Las opciones de configuracin por defecto de la pestaa Output se controlan en las preferencias del programa, descritas en el captulo 20.5.

5.9

Ver la salida HTP.

Si quiere probar una unidad de programa que haga uso de PL/SQL Web Toolkit, la pestaa Salida HTP se mostrar si se ha generado una salida HTP:

Si no existe ninguna salida HTP, esta pestaa no ser visible.

5.10

Depurar.

Para aquellos errores de programacin que son realmente difciles de seguir, la ventana de prueba contiene un depurador integrado. En la parte superior de la ventana encontrar una barra de herramientas con las funciones relacionadas con el depurador. Para iniciar una sesin de depuracin presione el botn Iniciar en la parte izquierda de la barra de depuracin en lugar del botn Ejecutar situado en la barra de herramientas principal. Los otros botones de la barra de depuracin se habilitarn y podr comenzar a depurar su cdigo.

Controlar la ejecucin.
Despus de iniciar el depurador, la ejecucin se detendr en la primera instruccin del archivo de prueba. Tras esto, puede controlar la ejecucin mediante los botones de la barra de herramientas: Ejecuta el archivo hasta que finalice la ejecucin. Entra en un procedimiento, funcin o llamada en la siguiente lnea. Si la siguiente lnea contiene una instruccin insert, delete o update provocar que se active el disparador (trigger), en este caso puede entrar en el cdigo del disparador (trigger). Salta a la siguiente lnea. Se ejecutar pero no entrar en el cdigo. Sale de la unidad de programa actual. Ejecuta el programa hasta que ocurra una excepcin. La ejecucin se detendr en la lnea que cause esa excepcin. Despus del siguiente paso se disparar la misma. Cada vez que entra en una unidad de programa, su cdigo se cargar de forma automtica en la ventana de prueba. En la parte inferior del editor aparecer una pestaa por cada unidad de programa con lo que podr cambiar entre ellas para ver el cdigo, establecer o quitar un punto de interrupcin, etc. Si hace clic con el botn derecho del ratn en el editor puede eliminar la unidad de programa de la ventana de prueba si ya no se encuentra interesado en ella:

Gua del usuario de PL/SQL Developer 9.0

25

Ver y establecer los valores de las variables.


Para ver el valor de una variable durante una sesin de depuracin simplemente mueva el cursor del ratn sobre la variable en el cdigo. Despus de segundo, su valor se mostrar a modo de sugerencia. Las variables de un bloque de cdigo PL/SQL de un archivo de prueba no pueden mostrarse. Las variables complejas como registros y tipos de objetos todava no pueden mostrarse aunque puede ver campos individuales. En futuras versiones, Oracle podra resolver esas limitaciones. Para establecer el valor de una variable, haga clic con el botn derecho del ratn encima de su nombre en el cdigo de programa y seleccione el elemento Establecer variable desde el men contextual. Aparecer un cuadro de texto con el valor de la variable donde podr introducir un nuevo valor y presionar el botn Enter para aplicar los cambios o Esc para cancelar la operacin:

Desde el mismo men contextual puede aadir una variable a la lista de inspecciones, lo que significa que despus de cada paso de depuracin el valor de la variable se mostrar y actualizar de forma automtica en la lista de inspecciones en la parte inferior izquierda de la ventana de prueba. Si una variable es una coleccin (tabla PL/SQL, varray, tablas anidadas) de tipos de datos escalares, puede ver la coleccin completa si hace clic con el botn derecho del ratn en ella y selecciona el elemento Ver coleccin de variables desde el men contextual. Nota: Todos los valores de las variables pueden verse si las unidades de programa se compilan con la informacin sobre depuracin. Existe una opcin que causar que cada vez que se compile se incluya la informacin de depuracin, pudiendo aadir de forma manual la informacin de depuracin si hace clic con el botn derecho sobre una unidad de programa en el Explorador de Objetos y selecciona el elemento del men contextual Aadir informacin de depuracin.

Gua del usuario de PL/SQL Developer 9.0

26

Utilizar puntos de interrupcin.


Los puntos de interrupcin pueden utilizarse para detener la ejecucin de un programa en una lnea de cdigo PL/SQL determinada. Cuando la ejecucin se detiene, puede ver y establecer variables, ejecutar el cdigo paso a paso, etc. Puede definir una condicin para un punto de interrupcin, en cuyo caso la ejecucin del programa slo se detendr si se cumple esa condicin. Por cada punto de interrupcin que defina, aparecer un mensaje en la pestaa de salida cuando se encuentre un punto de interrupcin.

Establecer puntos de interrupcin.


Existen dos formas de establecer puntos de interrupcin: en una ventana de programa o en una ventana de prueba. En ambos casos simplemente necesita hacer clic con el botn izquierdo del ratn en la lnea de cdigo apropiada en el margen del editor. Una marca aparecer, indicando que existe un punto de interrupcin en esa lnea. Cuando ejecute una ventana de prueba en modo de depuracin la ejecucin se detendr si se encuentra uno de esos puntos de interrupcin. Si establece un punto de interrupcin en una ventana de programa, puede que ese programa en particular, no se haya compilado todava en la base de datos. Adems, dicho punto de interrupcin todava no puede ser aplicado a la base de datos. En este caso la marca del punto de interrupcin tendr una apariencia distinta. Cuando compile la unidad de programa, el punto de interrupcin podr aplicarse y la correspondiente marca reflejar este cambio. Mientras la unidad de programa no se haya compilado ninguno de los puntos de interrupcin establecidos en esta unidad de programa sern efectivos. No puede establecer puntos de interrupcin en un bloque de cdigo PL/SQL de un archivo de prueba. Para borrar un punto de interrupcin, simplemente haga clic sobre el icono del punto de interrupcin.

Condiciones de los puntos de interrupcin.


Algunas veces puede definir un punto de interrupcin en una lnea que se ejecuta a menudo, aunque slo le interese el estado del programa bajo ciertas circunstancias. En este caso puede definir una condicin para el punto de interrupcin. La ejecucin slo se detendr si se cumple la condicin. Para definir una condicin para un punto de interrupcin, haga clic con el botn derecho del ratn sobre la marca y seleccione el elemento Modificar punto de interrupcin en el men contextual. Aparecer el siguiente cuadro de dilogo:

En este cuadro de dilogo puede ver todas las unidades de dilogo que tienen puntos de interrupcin, con sus puntos de interrupcin listados en la parte inferior. Cada punto de interrupcin tiene una casilla de comprobacin que le permite habilitarlos o deshabilitarlos. La seccin inferior muestra los siguientes campos:

Gua del usuario de PL/SQL Developer 9.0

27

Utilizar condicin - La casilla de comprobacin habilita o deshabilita la condicin. La propia condicin debe ser una expresin de tipo boolean. Cuando se alcanza un punto de interrupcin, la ejecucin slo se detendr si la condicin se evala como verdadera (true/false). Puede utilizar cualquier expresin SQL en la condicin, y puede utilizar cualquier variable que se conozca hasta la localizacin del punto de interrupcin. Son las mismas variables que puede ver o establecer durante un proceso de depuracin. Las variables deben precederse del carcter dos puntos :. Por ejemplo upper(:ename)=`SMITH es una condicin valida si la variable ename es valida en la localizacin del punto de interrupcin Utilizar mensaje La casilla de comprobacin habilita o deshabilita el mensaje. Cuando se alcanza un punto de interrupcin, y se cumplen todas las condiciones, se mostrar un mensaje en la pestaa de salida. No detener la ejecucin Esta opcin es til si se ha definido un mensaje. Cuando se encuentra marcada, la ejecucin del programa no se detiene en el punto de interrupcin de la lnea. De esta forma puede definir puntos de interrupcin que simplemente generen mensajes en la pestaa de salida. Utilizar contador Esta casilla de comprobacin habilita o deshabilita el contador de pasadas, l que define cuantas veces se debe pasar por la lnea que contiene el punto de interrupcin antes de que se pare la ejecucin. Si, por ejemplo, define un contador de pasadas de 10, la ejecucin se detendr la dcima vez que se alcance el punto de interrupcin.

Ver la pila de llamadas.


Puede ver la pila de llamadas en la parte inferior derecha de la ventana de prueba. La pila de llamadas se actualiza automticamente despus de cada paso de depuracin.

Preferencias del depurador.


En el elemento Preferencias en el men Herramientas puede encontrar un grupo de opciones relacionadas con el depurador. Estas preferencias se describen con ms detalle en el captulo 20.4.

5.11

Trazar la ejecucin.

Si utiliza Oracle8i o una versin superior, puede utilizar la herramienta de trazado en la Ventana de Prueba, para trazar la ejecucin de su cdigo PL/SQL. Puede configurar que eventos desea trazar: Llamadas a instrucciones, excepciones, SQL o cdigo PL/SQL. Presione el botn Select Trace Levels cercano al botn Create Trace Report para mostrar la siguiente pantalla de configuracin:

Gua del usuario de PL/SQL Developer 9.0

28

Puede controlar si desea trazar eventos especficos en cada unidad de programa (All), slo en las unidades de programa que son compiladas con informacin de depuracin (Enabled), o nunca (None). Para crear un informe de trazado, presione simplemente el botn Create Trace Report en la barra de herramientas de la ventana de prueba y ejecute el archivo de prueba. Despus de la ejecucin puede cambiar a la pestaa Trazado para ver el informe, y para ver informes anteriores de trazado.

En este sencillo informe puede ver una consulta en la lnea 15 de la function employee.depname que ha lanzado la excepcin 1403 (No data found), que se ha tratado en la lnea 28 de la misma unidad de programa. Por cada evento trazado, puede incluir informacin en el informe como la descripcin del evento, duracin, unidad de programa, nmero de lnea, excepcin, etc. Para configurar esto, presione el botn Preferencias en la parte superior izquierda de la barra de herramientas de trazado. Esto le mostrar las preferencias del trazado como se describe en el captulo 20.6. Para ver los informes antiguos de trazado, seleccione una ejecucin de la lista de seleccin. Presione el botn Delete para borrar la ejecucin seleccionada. Para ms informacin sobre la utilidad de trazado de Oracle, vea el captulo DBMS_TRACE del manual Oracle Supplied Packages Reference.

5.12

Pruebas de regresin.

Puede utilizar los archivos de prueba para realizar pruebas de regresin, utilizando la herramienta Organizador de Casos de Prueba (vea el captulo 21.15) para definir y ejecutar conjuntos de pruebas basados en archivos de prueba.

Gua del usuario de PL/SQL Developer 9.0

29

6. Optimizacin.
Para optimizar las instrucciones SQL de sus unidades de programa, la utilidad Explain plan puede serle de gran utilidad mostrndole el plan de ejecucin de una instruccin. Adems dicha herramienta se encuentra integrada dentro del entorno de desarrollo de PL/SQL Developer. Para ver el consumo de recursos de una instruccin SQL o de una unidad de programa PL/SQL, PL/SQL Developer puede mostrarle las estadsticas acerca de su ejecucin. Puede configurar que estadsticas desea visualizar, incluir el tiempo transcurrido, el tiempo de procesador, el nmero de lecturas lgicas, el nmero de lecturas fsicas, el nmero de escrituras fsicas, etc. Finalmente puede utilizar la herramienta tkprof de Oracle para obtener informacin sobre los recursos consumidos por todas las instrucciones ejecutadas en una unidad de programa si habilita el trazado de las instrucciones SQL.

6.1

Utilizar la ventana del plan de ejecucin.

Para utilizar la utilidad de Oracle Explain Plan, presione el botn Nuevo situado en la barra de herramientas y seleccione el elemento Explain Plan. Aparecer una ventana vaca que le permitir visualizar el plan de ejecucin. En la mitad superior de la ventana, puede escribir la consulta que desea analizar. Despus presione el botn Ejecutar situado en la barra de herramientas. El plan de ejecucin se mostrar en la mitad inferior de la ventana:

Una vez mostrado el plan de ejecucin puede cambiar la consulta SQL y pulsar sobre el botn Ejecutar para ver el impacto de los cambios. Para ms informacin sobre los planes de ejecucin, puede leer el manual Oracle Server Tuning. Para ver el efecto de utilizar distintos objetivos del optimizador en el plan de la consulta, seleccione la correspondiente entrada de la lista Objetivos del optimizador. El plan de ejecucin se actualizar de forma inmediata para reflejar los cambios. Utilice los botones Primera operacin, Operacin anterior, Operacin siguiente y ltima operacin para navegar a travs del plan de ejecucin siguiendo el orden de las operaciones. Despus de que se haya determinado el plan de ejecucin, PL/SQL Developer resaltar la primera operacin. La herramienta Explain Plan utiliza una tabla llamada plan table para almacenar los planes de ejecucin. Si dicha tabla no se encuentra disponible para el usuario conectado a la base de datos, PL/SQL Developer le preguntar si desea crearla en el esquema de dicho usuario. Para definir que columnas de la tabla plan table desea ver, y en que orden, presione el botn Preferencias. Esto le mostrar la pgina de preferencias correspondiente (vea el captulo 20.22). Nota: Si esta utilizando el servidor Oracle 7.2 o una versin anterior, el coste y la cardinalidad no estn disponibles en la tabla. Si se encuentra utilizando la versin 7.3 o una versin posterior y el coste o la cardinalidad no se encuentran disponibles, probablemente necesite actualizar la tabla. Si hace clic con el botn derecho del ratn sobre la columna Object name, aparecer el men contextual para el objeto seleccionado.

Gua del usuario de PL/SQL Developer 9.0

30

Analizar las instrucciones SQL en una unidad de programa.


La mayora de las veces, las consultas SQL que desea analizar se encuentran almacenadas en el cdigo de una unidad de programa. Para analizar las instrucciones SQL de una unidad de programa seleccione la consulta en el editor de programas, haga clic con el botn derecho del ratn sobre el texto seleccionado y presione el elemento Explain Plan del men contextual (o presione la tecla F5). Aparecer una nueva ventana de tipo Explain Plan con la consulta seleccionada y todas las variables PL/SQL son reemplazadas por variables de sustitucin. Cuando una consulta contiene variables propias del lenguaje PL/SQL y ejecuta la ventana del plan de ejecucin, recibir un mensaje de error ORA-00904:Invalid column name. Por error la herramienta Explain Plan asume que todas las variables son columnas. Cada variable debe prefijarse con el carcter :. Si queremos analizar la consulta en la funcin employee.deptname, la variables result y p_empno deben modificarse de la siguiente forma:

Ahora la utilidad Explain Plan conoce que identificador es una columna, y que identificador es una variable de cdigo PL/SQL.

6.2

Estadsticas automticas.

Cada vez que ejecute una instruccin en una ventana de consulta SQL o en una ventana de prueba, PL/SQL Developer generar automticamente un informe con las estadsticas de la ejecucin de la consulta. Una condicin que necesita cumplirse es que tenga privilegios de seleccin en las tablas de rendimiento dinmico v$session, v$statname, v$sesstat (desde el rol estndar plustrace). Puede ver el informe de estadsticas si cambia a la pestaa Estadsticas situada en la parte superior de la ventana de consulta SQL o de la ventana de prueba. Las estadsticas para la ejecucin de la funcin employee.deptname, podran parecerse a las siguientes:

Para cada estadstica del informe puede ver el valor de la ltima ejecucin y el valor total para la sesin actual. Puede configurar si se muestran las estadsticas si establece una las opciones en la ventana de preferencias, como se explica en el captulo 20.2. El conjunto de estadsticas es importante para el ajuste del cdigo SQL y PL/SQL, como se describe aqu:

Gua del usuario de PL/SQL Developer 9.0

31

Estadstica CPU used by this session Physical reads Physical writes Session logical reads sorts (disk) sorts (memory) sorts (rows) table fetch by rowid table scan blocks gotten table scan rows gotten table scans (long tables) table scans (short tables)

Significado Procesador utilizado en centsimas de segundo. Nmero de bloques ledos desde el disco. Nmero de bloques escritos en el disco. Nmero de bloques ledos desde la memoria o desde el disco. Nmero de ordenaciones realizadas en un segmento temporal. Nmero de ordenaciones realizadas en memoria. Nmero de filas que se han ordenado. Nmero de filas localizadas mediante rowid, acceso por ndices. El nmero de bloques ledos mediante full table scans. El nmero de filas ledas mediante full table scans. Nmero de full table scans sobre tablas grandes. Nmero de full table scans sobre tablas pequeas.

El nmero de estadsticas que puede incluir en el informe depende de la versin del servidor de Oracle y no se describen en este manual. Si desea obtener informacin de las mismas, existen una gran cantidad de libros disponibles que cubren este tema. El libro Oracle Server Referente describe brevemente esas estadsticas. Las estadsticas puede exportase a un archivo CSV (Valores separados por comas), que puede abrirse en una hoja de clculo posteriormente. Haga clic con el botn derecho del ratn en las estadsticas y seleccione el elemento Exportar y elija Archivo CSV. De forma alternativa puede elegir otro formato como TSV, XML o HTML, o copiar las estadistas al portapapeles.

6.3

El perfilador de PL/SQL.

El perfilador de cdigo PL/SQL es una potente herramienta que le ayuda a optimizar su cdigo PL/SQL. Por cada lnea de cdigo ejecutada, muestra el tiempo total, el tiempo mximo, el tiempo mnimo, la media y el nmero de veces que se ha ejecutado dicha lnea. Puede acceder fcilmente al perfilador desde la ventana de prueba. Antes de ejecutar un archivo de prueba, presione el botn Crear informe del perfilador situado en la barra de herramientas de la ventana de prueba. Si ejecuta el archivo puede cambiar a la pestaa de Perfilador para ver el informe.

Gua del usuario de PL/SQL Developer 9.0

32

El siguiente informe de ejemplo muestra que en la function employee.deptname, la consulta de seleccin ha tardado 94 milisegundos, y que las 3 llamadas al paquete dbms_output han tardado 29 milisegundos:

Por defecto la solapa Perfilador mostrar el informe de la ltima ejecucin. Puede seleccionar informes anteriores si los selecciona de la lista Ejecuciones. La lista Unidades le permite centrarse en la ejecucin de una unidad de programa especfica dentro del informe. La columna Tiempo total muestra la representacin grafica del tiempo transcurrido de una lnea de cdigo, comparado con la lnea que ms tiempo ha consumido al ejecutarse. Esto le permite identificar cuales son las lneas de cdigo que consumen ms tiempo. Puede ordenar el informe si presiona los botones de ordenacin situados en la cabecera de las columnas. Si una lnea de cdigo se muestra en color rojo, significa que la unidad de programa se ha modificado desde que se creo el informe. Es posible que la lnea mostrada difiera de la lnea existente cuando se cre el informe. Puede cambiar varios aspectos del informe del perfilador si presiona el botn Preferencias situado en la barra de herramientas de la pestaa Perfilador. Esto le mostrar la pgina de preferencias correspondiente, como se describe en el captulo 20.7. Para ms informacin acerca del perfilador vea el captulo dbms_profiler en la gua Oracle8i Supplied Packages Reference.

6.4

Trazar instrucciones SQL.

Puede habilitar el trazado de instrucciones SQL presionando el botn SQL Trace situado en la barra de herramientas. Despus de esto, todo el proceso que se realice en el servidor mediante una ventana de consulta SQL o en una ventana de prueba ser registrado en una archivo de trazado en el servidor de la base de datos. Para esto es necesario que el parmetro de la instancia de la base de datos timed statistics se establezca a true. Puede deshabilitar el trazador de SQL si presiona el botn de SQL trace otra vez. Puede ver la informacin del archivo de trazado si utiliza la utilidad de oracle tkprof en el servidor de la base de datos. Esto generar un informe acerca del tiempo consumido, tiempo de procesador, I/O, por cada instruccin de SQL. Adems de darle un informe acerca de que instrucciones son las ms costosas en una unidad de programa. Para aprender ms acerca de la utilidad tkprof de Oracle lea el manual Oracle 7 Server Tuning . El informe generado por tkprof para la ejecucin de la funcin employee.deptname podra parecerse al siguiente informe:

Gua del usuario de PL/SQL Developer 9.0

33

TKPROF: Release 7.2.2.3.1 - Production on Fri Sep 26 14:59:08 1997 Copyright (c) Oracle Corporation 1979, 1994. Trace file: ora07087.trc Sort options: default ******************************************************************************** count = number of times OCI procedure was executed cpu = cpu time in seconds executing elapsed = elapsed time in seconds executing disk = number of physical reads of buffers from disk query = number of buffers gotten for consistent read current = number of buffers gotten in current mode (usually for update) rows = number of rows processed by the fetch or execute call ******************************************************************************** begin :deptname := employee.deptname(:empno); end; call count ------- -----Parse 1 Execute 1 Fetch 0 ------- -----total 2 cpu elapsed disk query current -------- ---------- ---------- ---------- ---------0.00 0.00 0 0 0 0.01 0.01 0 0 0 0.00 0.00 0 0 0 -------- ---------- ---------- ---------- ---------0.01 0.01 0 0 0 rows ---------0 1 0 ---------1 All rights reserved.

Misses in library cache during parse: 0 Optimizer hint: CHOOSE Parsing user id: 16 ******************************************************************************** SELECT DEPT.DNAME FROM DEPT,EMP WHERE EMP.EMPNO = :b1

AND DEPT.DEPTNO = EMP.DEPTNO

call count ------- -----Parse 1 Execute 1 Fetch 1 ------- -----total 3

cpu elapsed disk query current -------- ---------- ---------- ---------- ---------0.00 0.00 0 0 0 0.00 0.00 0 0 0 0.06 0.06 4 4 0 -------- ---------- ---------- ---------- ---------0.06 0.06 4 4 0

rows ---------0 5 1 ---------6

Misses in library cache during parse: 0 Optimizer hint: CHOOSE Parsing user id: 16 (recursive depth: 1) ********************************************************************************

Gua del usuario de PL/SQL Developer 9.0

34

7. Trabajar con SQL.


A menudo durante el desarrollo de un programa necesita ejecutar alguna instruccin SQL. Ya sea para probar una instruccin, para ver los datos de una tabla o para actualizar los datos. Puede realizar estas operaciones desde el propio PL/SQL Developer, utilizando la ventana de consulta SQL.

7.1

Utilizar la ventana de consulta SQL.

Para crear una nueva ventana de consulta SQL, presione el botn Nuevo situado en la barra de herramientas y seleccione el elemento Ventana de consulta SQL. Aparecer una ventana de consulta SQL vaca en la que puede escribir una instruccin SQL. Si ha escrito una consulta de seleccin la ventana se dividir en dos partes y mostrar los resultados de la misma en una rejilla situada en la mitad inferior de la pantalla. Por ejemplo, si queremos ver todos los empleados de la tabla employee, la ventana de consulta SQL podra parecerse a la siguiente:

La instruccin SQL es ejecutada y recupera 10 filas. El resultado de la consulta es superior a 10 filas, lo que nos indica el hecho de que los botones de Siguiente pgina y ltima pgina, situados en el centro de la barra de herramientas de resultados, estn habilitados y tambin porque en la barra de estado se muestra el mensaje (more). Inicialmente slo se han recuperado 10 registros, debido a que es el nmero de registros que se pueden mostrar en la rejilla. Si presionamos el botn Pgina siguiente se recuperarn los 10 registros siguientes. Presionando el botn de ltima pgina se recuperarn todos los registros. Si tiene varias instrucciones SQL en el editor y presiona el botn Ejecutar, se ejecutarn todas las instrucciones y se mostrarn los resultados en distintas pestaas:

Gua del usuario de PL/SQL Developer 9.0

35

Las instrucciones SQL deben finalizarse con un punto y coma (;) o con una barra invertida (\), los bloques de cdigo PL/SQL deben finalizarse con una barra invertida (\), de igual forma que en SQL*Plus. Si selecciona una pestaa de resultado, se resaltar el texto correspondiente en el editor. Si selecciona una parte del texto de una consulta en el Editor de SQL, slo se ejecutar el texto seleccionado. De esta forma puede tener ms de una instruccin en el editor y ejecutarlas de una en una. Si ejecuta un instruccin SQL que tarda mucho tiempo en finalizar puede presionar el botn Cancelar para pararla. Observe que el hecho de presionar el botn Cancelar no funcionar siempre. Si por ejemplo la consulta est esperando por un bloqueo, no responder al mensaje de cancelar. Si ha presionado el botn Cancelar cuando la ventana de consulta SQL est recuperando filas, simplemente terminar y mostrar las filas que ya han sido recuperadas. Puede continuar recuperando registros con Pgina siguiente y Ultima pgina. Observe que las preferencias de la ventana de consulta SQL le permiten determinar el nmero de filas que se devuelven inicialmente por consulta. Esto se describe en el captulo 20.20. En la parte derecha de la ventana puede ver dos botones que le permiten navegar a travs de todas las instrucciones o consultas que ha introducido en la ventana de consulta SQL. De esta forma puede volver a ejecutar instrucciones introducidas previamente. Por motivos de optimizacin puede ver las estadsticas de ejecucin de las consultas seleccionando la pestaa estadsticas. Las estadsticas se explican en el captulo 6.2. Cuando imprima una ventana de consulta SQL, la instruccin SQL y la rejilla con los resultados se imprimirn. Si selecciona filas en la rejilla de resultados, puede limitar la cantidad de registros que se imprimirn. Por defecto los ttulos de las pestaas se obtienen de las sentencias SQL ejecutadas. Para modificar este comportamiento puede utilizar un comentario que contenga la expresin tab = <title> antes de la sentencia SQL. Por ejemplo:
-- tab=Department 10 select * from emp where deptno = 10;

En este ejemplo, el ttulo de la pestaa es Departamento 10, en lugar del nombre por defecto Select emp.

Gua del usuario de PL/SQL Developer 9.0

36

7.2

Modificar los resultados en la rejilla de resultados.

La rejilla de resultados de la ventana de consulta de SQL puede modificarse de varias formas. Algunos tipos de celdas tienen un comportamiento especial, se pueden seleccionar e imprimir filas, columnas y rangos de celdas, puede mover columnas, ordenar filas o cambiar al tipo de vista simple.

Alinear las celdas de la rejilla de resultados.


Puede alinear rpidamente las celdas de la rejilla de resultados, utilizando el botn Alinear.

Si presiona este botn, el ancho de cada celda vendr determinado por el ancho de la cabecera de la columna y su contenido. Si despliega el men que se encuentra a continuacin del botn Alinear, puede seleccionar los distintos tipos de alineaciones que le ofrece PL/SQL Developer en el men desplegado. Desde aqu puede limitar el ancho de las celdas de la rejilla de resultados o a su contenido, desde aqu tambin podr alinear las celdas en funcin de su altura. Puede utilizar una plantilla personalizada para alinear los datos de la rejilla de resultados.. Una vez haya establecido la configuracin de las celdas puede seleccionar la opcin Guardar como plantilla para guardas estos cambios en una plantilla. Si ejecuta la misma plantilla posteriormente, puede aplicar esta configuracin si selecciona la opcin Alinear desde plantilla o si habilita la opcin Alinear automticamente desde plantilla. Observe que la plantilla adems de guardar el ancho de las celdas tambin guarda el orden de las columnas.

Reconocer valores nulos.


Los valores nulos se muestran en una celda con el fondo amarillo claro, esto hace ms fcil que pueda distinguirlos de un valor con todos los caracteres en blanco. Esto facilita el reconocer valores nulos de celdas que no muestran directamente ningn valor en la rejilla, como es el caso de tipos de datos LONG o LOB. Puede cambiar el color de fondo de la celda para los valores nulos mediante la opcin correspondiente (vea el captulo 20.20).

Ver grandes columnas de datos


Los valores de las columnas de tipo Long, Long Raw, CLOB, BLOBL y BFILE no se muestran en la rejilla de resultados. En su lugar se muestra el texto <Long>, <Long Raw>, <CLOB>, <BLOB> y <BFILE>.

Cuando hace clic en el botn de una celda en una columna, se llama al editor de datos, que le permite ver o editar datos en varios formatos. Vea el captulo 23 para ms detalles. Puede hacer clic en el botn de una celda de una columna de caracteres para llamar al editor de datos. El botn de la celda slo se muestra si el tamao es mayor de 20 caracteres.

Gua del usuario de PL/SQL Developer 9.0

37

Ver columnas de tipo fecha.


Una columna de tipo fecha tiene un botn en la celda que muestra un calendario con la fecha almacenada resaltada. Si la fecha tiene adems tiene hora, puede ver su valor en el calendario:

Viendo columnas de tipo timestamp.


Las columnas de tipo Timestamp se muestran en el formato indicado en la configuracin del registro NLS_TIMESTAMP_FORMAT y _NLS_TIMESTAMP_TZ_FORMAT de su Oracle Home.

Ver datos en formato XML.


Existen varias formas de almacenar datos en formato XML en la base de datos: como CLOBs (Oracle 8i), como XMLTYPE (Oracle 9i), como Varchar2 o como columnas de tipo Long. En cualquier caso, el editor de datos reconocer el formato XML si este comienza por una cabecera estndar XML, y cambiara al formato XML. Para ms detalles vea el captulo 23.

Ver columnas de cursores anidados.


Si incluye un cursor anidado en la lista de campos de una columna de seleccin, el valor de la columna se mostrar inicialmente como <Cursor>. Si presiona el botn situado dentro de la celda, abrir una nueva ventana de consulta SQL con la rejilla mostrando el conjunto de resultados del cursor. Nota: Cada valor del cursor anidado implicar abrir un cursor, con lo cual puede superar fcilmente el valor del parmetro OPEN_CURSORS y obtener el error ORA-01000: maximum open cursors exceeded

Seleccionar columnas, filas y celdas.


Para seleccionar filas o columnas en la rejilla de resultados, simplemente haga clic en la cabecera de la fila o de la columna y arrastre el puntero del ratn para resaltar la seleccin.

Puede mover una seleccin de columnas, seleccionando una de esas columnas y arrastrndola a una nueva ubicacin.

Gua del usuario de PL/SQL Developer 9.0

38

Para seleccionar un rango de celdas, mueva el puntero del ratn sobre el borde izquierdo de una celda hasta que la forma del puntero cambie, presione el botn izquierdo del ratn y arrastre para resaltar la seleccin:

Para seleccionar todas las filas y columnas, presione el botn que se encuentra en la parte superior izquierda de la rejilla, o haga clic con el botn derecho del ratn en la rejilla y seleccione el elemento Seleccionar Todos desde el men contextual. Puede copiar o imprimir la seleccin como lo hace habitualmente.

Bloquear el desplazamiento
Es muy probable que a veces, desee evitar que se desplacen los datos fuera de la pantalla. En el ejemplo anterior, es posible que desee evitar que la columna empno se desplace fuera de la pantalla cuando desplace el contenido de la rejilla de datos hacia la izquierda. Para ello, haga clic con el botn derecho del ratn sobre la columna empno y seleccione la opcin Bloquear filas del men emergente Bloquear desplazamiento. Para bloquear ms de una columna bloquee la columna que se encuentre situada ms a la derecha. Puede bloquear las filas de la rejilla de datos de forma similar: haga clic con el botn derecho del ratn sobre una fila y seleccione la opcin Bloquear filas del men emergente de Bloquear desplazamiento.

Ordenar las filas de la rejilla.


Para ordenar las filas de la rejilla de resultados, presione el botn de la cabecera de la columna en la que quiera ordenar las filas.

Las filas se ordenarn en orden ascendente, como muestra el botn de la cabecera. Presionando el botn de la cabecera otra vez, ordenar las filas en orden descendente. Si lo presiona una tercera vez permanecer sin ningn orden. Si presiona el botn de otra columna ordenar las filas por esta columna, pero tambin utilizar la columna previa como columna de orden secundario (indicado por el punto en el botn de la cabecera). En el ejemplo anterior, la columna Job es la columna primaria, y la columna hiredate es la secundaria. Por defecto PL/SQL Developer ordenar el conjunto de registros sin tener en cuenta si estn en maysculas o minsculas. Puede hacer clic con el botn derecho del ratn sobre Coincidir maysculas y minsculas para cambiar el comportamiento del proceso de ordenacin de los resultados Observe que el proceso de ordenacin de los resultados se realiza de forma local, y slo para las columnas que ya se han recuperado. Si obtiene informacin adicional despus de ordenar los resultados, las nuevas filas se aadirn el final de la rejilla de resultados sin ningn orden. Para grandes conjuntos de registros el orden en modo local puede tardar mucho tiempo, en este caso podra ser mejor utilizar

Gua del usuario de PL/SQL Developer 9.0

39

una clusula order by en la consulta y dejar que sea Oracle Server el encargado de realizar el proceso de ordenacin de los registros.

Vista sencilla.
Si el conjunto de resultados contiene muchas columnas, podra ser un inconveniente que cada registro se muestre en una sola lnea. Puede moverse hacia adelante o hacia atrs para ver las columnas relacionadas (aunque pueda mover las columnas), y no puede visualizar todas las columnas del registro de una vez. Si presiona el botn Vista sencilla en la barra de herramientas de la rejilla, puede ver slo un registro de una vez:

Ahora cada fila se muestra en una columna con el nombre y el valor. Los botones Siguiente registro y Registro anterior en la barra de herramientas de la rejilla pueden utilizarse para navegar a travs del conjunto de resultados. Para volver a la vista en modo multi registro, presione el botn Vista sencilla otra vez.

Exportar datos.
Existen varias formas de exportar los datos de un conjunto de resultados de la rejilla de datos. Despus de ejecutar una instruccin de tipo select, seleccione el rango de celdas que desee exportar tal y como se describi anteriormente, y haga clic con el botn derecho del ratn y seleccione el elemento de men Exportar Resultados desde el men contextual. Al hacer esto se mostrar un submen desde donde podr elegir exportar los datos en diferentes formatos CSV, TSV, HTML, XML o SQL. Si selecciona el formato SQL, PL/SQL Developer crear un archivo con todas las instrucciones insert necesarias para recrear los resultados de la consulta. Despus de seleccionar el formato puede indicar el nombre y la ubicacin del archivo generado. De forma alternativa. Tambin puede copiar la seleccin al portapapeles presionando Ctrl-C, o haciendo clic en la seleccin y seleccionando Copiar o Copiar con cabecera desde el men contextual. Pudiendo pegar posteriormente estos datos en otra aplicacin. Para modificar rpidamente el conjunto de resultados generados en Microsoft Excel, seleccione el elemento Copiar a Excel. Esta accin exportar los datos seleccionados a un archivo temporal y lo

Gua del usuario de PL/SQL Developer 9.0

40

abrir con Microsoft Excel. Si el nmero de registros seleccionados es superior a 65535, PL/SQL Developer dividir los registros en diferentes hojas de Excel. Si mltiples conjuntos de registros como resultado de la ejecucin de mltiples consultas SQL, puede seleccionar el elemento Copiar todo a Excel, en lugar de Copiar a Excel. Esta opcin crear una hoja de Excel por cada conjunto de registros.

7.3

Filtrar resultados de la consulta.

Despus de ejecutar una consulta, puede presionar el botn Filtrar resultados sobre la rejilla de resultados si desea buscar un registro concreto. Al presionar este botn PL/SQL Developer limpiar la rejilla de resultados, y dejar un registro vaco donde puede introducir los valores de la consulta. Si, por ejemplo, quiere buscar todos los empleados que comiencen con la letra A en el departamento 20, introduzca el valor A% en la columna ename y el valor 20 en la columna deptno:

Presionando otra vez el botn Filtrar consulta, o presionando el botn Ejecutar, ejecutar la consulta modificada y mostrar los resultados. Presione el botn Limpiar registro para limpiar los valores de la consulta. Los valores de la consulta no se encuentran restringidos a valores con caracteres comodines. Puede utilizar las expresiones siguientes (las expresiones alternativas entre corchetes):

valor [= valor]

valor con comodn [like valor con comodn] > valor < valor != valor [<> valor] in (valor1, valor2, ...) between valor1 and valor2 null [is null] not null [is not null] Observe que si emplea un valor literal, puede omitir las comillas para los valores de texto (ejemplo SMITH se convertir automticamente en SMITH en el texto SQL). Para todas las dems expresiones debe proporcionar un valor literal que el servidor Oracle comprenda (ejemplo !=SMITH). Esto es as en el caso de nmeros y fechas. Si utiliza una expresin, utilice un formato que pueda ser comprendido por Oracle.

Gua del usuario de PL/SQL Developer 9.0

41

Existen diversas opciones que le permiten controlar el funcionamiento del filtrado de resultados. El captulo 20.20 describe esas opciones.

7.4

Consultas vinculadas.

Cuando est viendo un conjunto de resultados, con frecuencia necesitar consultar una tabla relacionada. Por ejemplo cuando est viendo la tabla dept, puede necesitar consultar todos los empleados de un departamento, o viceversa cuando se encuentre viendo la tabla emp, puede necesitar consultar el departamento de un empleado. La mayor parte de las veces tendr una clave fornea entre las tablas padre y las tablas hijas, en cuyo caso la ventana de consulta SQL puede generar y ejecutar esas consultas por usted. Si se encuentra en un determinado registro en el conjunto de resultados, presione el botn Consulta vinculada en la barra de herramientas que se encuentra en la parte superior de la rejilla. Esto le mostrar un men contextual con las tablas padre e hijas de la tabla del elemento seleccionado. Si por ejemplo se encuentra consultando la tabla emp, se le mostrar el siguiente men desplegable:

La foto superior muestra las tablas padre (y los nombres de sus claves forneas) y en la parte inferior muestra las tablas hijas. El elemento dept generar una consulta para el departamento de este empleado (30). El primer elemento emp (padre) generar una consulta para el manager de este empleado (7839). El segundo elemento de la tabla emp (hija), generar una consulta para todos los empleados que dirige este empleado. La consulta vinculada se ejecutar en la misma ventana de consulta SQL a menos que habilite la opcin Linked query in new window (vea el captulo 20.20). Si presiona la tecla Ctrl mientras presiona el botn consulta vinculada, ocurrir lo contrario a esta opcin.

7.5

Variables de sustitucin.

Gua del usuario de PL/SQL Developer 9.0

42

Puede utilizar variables de sustitucin en el texto SQL para permitir que un usuario pueda introducir datos cuando la consulta se ejecute. La forma ms simple de hacerlo es mediante el uso de una variable de sustitucin:

Si especifica &depno en el texto SQL se le preguntar por el valor de esta variable. La variable a la que hace referencia en el texto SQL se sustituir por su valor antes de la ejecucin. Puede especificar ms de una variable de sustitucin y puede especificar cada variable ms de una vez. Adems puede definir el tipo de datos, el valor por defecto, listas de seleccin, lista de consultas, casillas de comprobacin y otras opciones avanzadas. Esas caractersticas son empleadas en el visor de informes, y se describen con ms detalle en el captulo 12.

7.6

Actualizar la base de datos.

Gua del usuario de PL/SQL Developer 9.0

43

Para actualizar, insertar o borrar registros en la base de datos, puede ejecutar las instrucciones apropiadas de tipo DML en una ventana de consulta SQL. Probablemente sea mucho ms adecuado para hacer los resultados de la rejilla actualizables, el incluir el campo rowid en la lista de campos de la consulta o utilizar la instruccin selectfor update:

Debe saber que la instruccin selectfor update bloquear todos los registros seleccionados, con lo que incluir el campo rowid ser la mejor forma de hacer que los resultados de la consulta sean actualizables. Si la instruccin es una unin de varias tablas (join), slo las columnas de la primera tabla pueden actualizarse. Todas las dems columnas sern slo de lectura y tampoco podr actualizar columnas con alias. Si el resultado es actualizable, puede presionar el botn Editar datos situado en la parte derecha de la rejilla y editar los registros. Puede insertar o borrar registros de la rejilla si presiona el botn Insertar Registro o Borrar registro. Si ha seleccionados varios registros, se borrarn. Cuando se encuentre modificando campos de tipo texto o de tipo numrico, PL/SQL Developer cambiar el color del texto introducido al rojo en caso de que los datos introducidos superen el tamao, la precisin o la escala del tipo de datos definido. Despus de editar el valor de una columna que aparece en la expresin de una columna virtual, el correspondiente valor de la columna virtual tambin ser actualizado. El hecho de modificar los resultados de la rejilla no significa que se realice ningn cambio en la base de datos. Puede realizar un post de los datos actualizados, borrados o insertados en la base de datos si presiona el botn Post. Cualquier cambio realizado sobre el valor de una columna, que se lleve a cabo a travs de la lgica del servidor (por ejemplo, antes de que se ejecuten los disparadores de insercin o actualizacin de datos, o se utilicen los valores de una instruccin de insercin de datos), se vern reflejados inmediatamente en la rejilla de datos. Una vez que ha realizado un post de los datos (y si tiene la opcin AutoCommit SQL Window desmarcada) los botones Commit y Rollback de la barra de herramientas se habilitarn si se ha iniciado una transaccin. Para ms informacin sobre las transacciones, vea el captulo 17.

Editar grandes columnas de datos.


Como se explic en captulos anteriores, puede hacer clic en el botn situado dentro de la celda de una columna de tipo Long, Long Raw, CLOB, BLOB y BFILE para ver los valores en varios formatos.

Gua del usuario de PL/SQL Developer 9.0

44

Cuando la rejilla de resultados es actualizable puede utilizar el editor de datos para cambiar el valor de una columna.

7.7

Ver y editar columnas de tipo XMLTYPE.

La versin 9.0 y las versiones anteriores de Oracle Net no soportan directamente el tipo SYS.XMLTYPE, con lo que no podr acceder directamente a los datos en formato XML que se encuentren almacenados en una columna. Si, por ejemplo, xml_test es una columna de tipo SYS.XMLTYPE, la siguiente consulta no devolver el resultado esperado:
select id, xml_text from xml_table

Slo la columna id se mostrar en el conjunto de resultados. Para ver los datos XML, utilice la funcin getclobval():
select id, t.xml_text.getclobval() from xml_table t

De esta forma la columna de tipo CLOB puede visualizarse en el editor de texto, y el resalte de la sintaxis se aplicar de forma automtica. Para editar los datos XML, haga que los resultados sean actualizables de la forma habitual, incluyendo el campo rowid:
select id, t.xml_text.getclobval(), rowid from xml_table t

Ahora puede editar el tipo de datos CLOB y ejecutar una instruccin post sobre los mismos en la base de datos. Observe que las funciones Ver datos y Editar datos para tablas y vistas aplicarn esas reglas, con lo que la forma ms fcil para ver o editar columnas de tipo XMLTYPE se consigue haciendo clic con el botn derecho del ratn sobre la tabla o vista y seleccionando los elementos correspondientes desde el men contextual.

7.8

Exportar consultas.

Para consultas que devuelven un gran nmero de resultados (diez millones de registros o ms) podra ser problemtico consultar primero los datos, mostrarlos en la rejilla y exportarlos posteriormente a un archivo. Esto podra consumir demasiados recursos de memoria. En este caso es ms practico presionar el botn Exportar resultados de la consulta situado en la barra de herramientas de resultados del editor de SQL, en lugar del botn Ejecutar situado en la barra de herramientas principal . Esto le mostrar un men desplegable donde puede seleccionar el formato en el que exportar los datos, formato CSV (Comma Separated Values), formato TSV (Tab Separated Values), formato HTML, o formato XML. Despus de seleccionar el formato, puede especificar el archivo al que desea exportar los datos, tras lo que se ejecutar la consulta. PL/SQL Developer no mostrar los resultados de la consulta, slo escribir el conjunto de resultados al archivo de exportacin.

7.9

Guardar archivos SQL.

Si ha creado una instruccin SQL que desee utilizar posteriormente, puede guardarla como un archivo SQL. Para ello, presione el botn Guardar situado en la barra de herramientas e introduzca el nombre apropiado en el cuadro de dilogo. La extensin por defecto para este tipo de archivos es .SQL, aunque puede cambiarla estableciendo o modificando una de las opciones descritas en el captulo 20.28. Observe que slo se guarda en el fichero la instruccin SQL, no todo el historial de instrucciones. Para incluir el historial en el archivo, haga clic con el botn derecho del ratn en la ventana de consulta SQL y seleccione el elemento Guardar Historial en el men contextual. En este caso se guardarn todas las instrucciones con una barra inversa entre ellas.

Gua del usuario de PL/SQL Developer 9.0

45

Puede abrir un archivo guardado previamente si presiona el botn Abrir situado en la barra de herramientas y selecciona el elemento Archivo SQL, lo que crear una nueva ventana de consulta SQL. Puede de forma alternativa hacer clic con el botn derecho del ratn en una ventana y seleccionar el elemento Cargar del men contextual, lo que abrir un archivo SQL.

7.10

Crear consultas estndar.

Para la mayora de las tablas y de las vistas, tendr varias consultas estndar que ejecutar con mayor o menor frecuencia. Por ejemplo Muestra todos los empleados que son managers, o Muestra la suma del sueldo de todos los empleados, ordenados por el nmero de departamento. Puede guardar dichas consultas como Consultas estndar, a las que puede recurrir ms tarde utilizando el men contextual de la tabla o vista correspondiente. Este men aparecer cuando haga clic con el botn derecho del ratn sobre la tabla o vista en el Explorador de Objetos o en una ventana de edicin de cdigo PL/SQL o SQL. Despus de crear una consulta estndar en la ventana de consulta de SQL, puede presionar el botn Guardar como consulta estndar en la barra de tareas de la rejilla. Aparecer el siguiente cuadro de dilogo:

Puede introducir el nombre de la consulta, que se mostrar en el men desplegable. Puede cambiar el propietario y el nombre de la tabla o vista, al que se le mostrar la consulta estndar. Presione el botn Preferencias para cambiar el directorio donde se almacenarn las consultas estndar. La siguiente informacin se guardar con la consulta estndar: El texto de la consulta SQL. El tamao de la ventana de consulta SQL. El modo de la rejilla: Modo multi registro o Modo simple Observe que puede utilizar variables de sustitucin (vea captulo 7.5) para hacer las consultas estndar ms flexibles.

Gua del usuario de PL/SQL Developer 9.0

46

8. La ventana de comandos.
La ventana de comandos le permite ejecutar archivos SQL de una forma idntica a la del programa SQL*Plus de Oracle. Para abrir la ventana de comandos presione el botn Nuevo situado en la barra de herramientas o seleccione el elemento Nuevo en el men Archivo. Se abrir una ventana de comandos en la que podr escribir comandos de SQL y SQL*Plus de la misma forma que si estuviese ejecutando SQL*Plus, pero sin abandonar el entorno de desarrollo de PL/SQL Developer

8.1

Introducir comandos e instrucciones SQL.

Al igual que en SQL*Plus, puede escribir instrucciones de SQL en mltiples lneas y finalizar la instruccin con punto y coma (;) o barra invertida (\). Puede utilizar las teclas de izquierda y derecha para editar la lnea de comandos, y tambin las de arriba y abajo para volver a utilizar lneas introducidas anteriormente. Si introduce el comando edit, puede utilizar un editor de texto para editar todo el contenido del buffer. Despus de editarlo, puede ejecutarlo introduciendo una barra invertida (\) en la lnea de comandos. El editor almacena un histrico con todos los comandos ejecutados anteriormente, con lo podr ejecutar rpidamente un comando modificado. La barra de estado de la ventana de comandos muestra el estado de las opciones Echo, Termout, Feedback, Verify, Autoprint, Heading y Timing. Puede cambiar su estado haciendo doble clic con el botn izquierdo del ratn sobre ellas.

8.2

Desarrollar archivos de comandos.

Para escribir un archivo de comandos con mltiples declaraciones y comandos, a menudo necesita editar el archivo, ejecutarlo, editarlo otra vez, ejecutarlo otra vez, etc. Para hacer este proceso un poco

Gua del usuario de PL/SQL Developer 9.0

47

ms cmodo, la ventana de comandos posee un editor incorporado que resalta la sintaxis de SQL, PL/SQL y SQL*Plus.

Abrir, Ejecutar y Guardar un archivo de comandos.


Para crear un archivo de comandos, sitese en la pestaa Editor e introduzca los comandos. Para ejecutar los comandos en el editor, presione el botn Ejecutar o la tecla F8. La ventana de comandos volver a la pestaa de Dilogo y ejecutar todos los comandos. Para editar un archivo de comandos existente, presione el botn Abrir situado en la barra de herramientas y seleccione el elemento Archivo de comando. Al hacerlo, cargar el archivo de comandos en el editor. De forma alternativa puede abrir un archivo de comandos haciendo clic con el botn derecho del ratn en el editor y seleccionando la opcin Cargar del men contextual. Para guardar un archivo de comandos modificado, presione el botn Guardar situado en la barra de herramientas.

Desplazarse a travs del cdigo.


Si presiona el botn Pausar ejecucin situado en la barra de estado, antes o durante la ejecucin del archivo, podr moverse por el archivo de comandos de una forma controlada. El siguiente comando se resaltar en el editor y ser ejecutado cuando presione de nuevo el botn Ejecutar siguiente comando situado en la barra de estado. Si presiona de nuevo el botn Pausar ejecucin, la ejecucin continuar con normalidad. Puede simular el botn Pausar ejecucin desde un archivo utilizando el comando SET EXECPAUSE.

Gua del usuario de PL/SQL Developer 9.0

48

8.3

Comandos soportados.

Aparte de soportar todas las declaraciones del lenguaje SQL, la ventana de comandos tambin soporta los siguientes comandos de SQL*Plus:
Comando / ? [Keyword] @[@] [Filename] [Parameter list] ACC[EPT] Variable [DEF[AULT] Value] [PROMPT Text | NOPR[OMPT]] CL[EAR] [SCR[EEN]] CL[EAR] SQL COL[UMN] [Column] [Format] [New Value variable] CON[NECT] [username/password@database] DEF[INE] [Variable] [ = Text] DESC[RIBE] Object DISC[CONNECT] EDIT EXEC[UTE] Procedure EXIT [APPLICATION] Significado Ejecuta las instrucciones SQL almacenadas en el buffer. Muestra la ayuda para la instruccin indicada. Ejecuta el archivo de comandos indicado, pasndole los parmetros especificados. Permite al usuario introducir el valor de una variable de sustitucin. Limpia la pantalla. Limpia el contenido del buffer. Define el formato de una columna o muestra los formatos de todas las columnas. Conecta a la base de datos con el usuario especificado. Define una variable de sustitucin, muestra una o todas las variables de sustitucin. Muestra una descripcin del objeto indicado. Desconecta la sesin actual de la base de datos. Carga el editor de texto con las instrucciones SQL almacenadas en el buffer. Ejecuta el procedimiento indicado. Termina la ejecucin de un archivo de comandos o cierra la ventana de comandos. Si aade el parmetro Aplicacin cerrar PL/SQL Developer. Carga un archivo de comandos en el editor. Ejecuta un comando externo. Muestra informacin sobre la palabra reservada. Muestra un mensaje y detiene la ejecucin hasta que el usuario presione Ok o Cancel. Muestra el valor de una o todas las variables de acoplamiento. Muestra el texto indicado. Termina la ejecucin de un archivo de comandos o cierra la ventana de comandos. Si aade el parmetro Aplicacin cerrar PL/SQL Developer. Ejecuta las instrucciones almacenadas en el buffer. Comenta una lnea. Determina si las variables se muestran automticamente despus de ejecutar una sentencia SQL o un bloque de cdigo PL/SQL. Determina el separador de las columnas (por defecto = ) Determina el carcter que termina la referencia a una variable de sustitucin (por defecto =). Determina el carcter que inicia una referencia a una variable de sustitucin (por defecto =&). Determina si se muestran los comandos ejecutados en un archivo de comandos Determina el carcter que evita el carcter de inicio de una referencia a una variable de sustitucin (por defecto = \) Determina si se muestra el nmero de columnas afectadas por una instruccin SQL. Determina si las cabeceras se muestran sobre las columnas de un conjunto de resultados. Determina el ancho mximo a mostrar para una columna de

GET [Filename] HOST [Command] HELP [Keyword] PAUSE [Message] PRI[NT] [Variable] PROMPT [Text] QUIT [APPLICATION]

R[UN] REM[ARK] [Text] SET AUTOP[RINT] [ON | OFF]

SET COLSEP [Separator | OFF] SET CON[CAT] [Character | ON | OFF] SET DEF[INE] [Character | ON | OFF] SET ECHO [ON | OFF] SET ESC[APE] [Character | ON | OFF] SET FEED[BACK] [ON | OFF] SET HEA[DING] [ON | OFF] SET LONG [Width]

Gua del usuario de PL/SQL Developer 9.0

49

Comando SET NUM[WIDTH] [Width] SET PAGES[IZE] [Size]

SET PROMPT [Prompt]

SET SCAN [ON | OFF] SET SERVEROUT[PUT] [ON | OFF] [SIZE n]

SET SPOOL*DIRECTORY [Directory]

SET TERM[OUT] [ON | OFF] SET TIMI[NG] [ON | OFF] SET VER[IFY] [ON | OFF]

SHO[W] ERR[ORS] [Type Name] SHO[W] REL[EASE] SHO[W] SQLCODE SHO[W] USER SPO[OL] [Filename | APPEND | OFF | OUT]

STA[RT] [Filename] [Parameter list] STORE SET [Filename]

UNDEF[INE] Variable VAR[IABLE] [Variable] [Datatype] WHENEVER [OSERROR | SQLERROR] [Action]

Significado tipo long. Determina el ancho mximo a mostrar para una columna de tipo long sin precisin. Determina el nmero de lneas que se muestran de un conjunto de resultados, antes de que se repitan los encabezados del mismo. Reemplaza al indicador (prompt) estndar SQL>. En vez de utilizar texto puede tambin utilizar las variables [user], [db] o [connection].Adems puede incluir variables de acoplamiento (set prompt: bind_var_name). Determina si las variables de sustitucin deben escanearse. Determina si se muestran los resultados de las llamadas a dbms_output.put_line, y cual es el tamao del buffer de salida. El valor n puede ser UNLIMITED para un tamao de buffer ilimitado. Determina en que directorio se almacenarn los archivos, si el usuario no especifica una ruta al ejecutar el comando SPOOL. Determina si se muestran los resultados de las instrucciones SQL ejecutadas. Determina si se muestra la duracin de ejecucin de las instrucciones SQL. Determina si se muestran las variables de sustitucin cuando se usan en una instruccin SQL o en un bloque de cdigo PL/SQL. Muestra los errores previos de compilacin o los errores de un objeto especfico. Muestra la informacin de la versin de Oracle para la conexin actual. Muestra el cdigo SQL de la instruccin SQL ejecutada. Muestra el usuario conectado actualmente. Inicia, detiene o imprime[OUT] el volcado de datos. Si el valor Filename contiene la extensin .zip, los datos volcados a travs de la salida de datos ser comprimida en un archivo con dicha extensin. Ejecuta el archivo de comandos especificado, pasndole los parmetros especificados. Almacena los valores de todas las opciones en un archivo. Puede ejecutar ese archivo posteriormente para restablecer esas opciones. Borra la variable de sustitucin indicada. Define una variable de acoplamiento, muestra una o todas las variables de acoplamiento. Especifica que accin se debe realizar siempre que se produzca un error del sistema operativo o de SQL. Las acciones pueden ser EXIT o CONTINUE, seguidas opcionalmente de COMMIT o ROLLBACK.

Los comandos de la lista mostrados anteriormente son los mismos comandos soportados en SQL*Plus. La lista de comandos que se muestra a continuacin es especfica de PL/SQL Developer:
Comando BEAUT[IFY] Archivo | Objeto Funcin Formatea el objeto de base de datos o el archivo especificado, empleando las reglas actuales o las reglas especificadas mediante el comando SET BEAUTIFIER. Selecciona el objeto en el Explorador de Objetos.

BROWSE Objeto

Gua del usuario de PL/SQL Developer 9.0

50

EDIT Objeto EDITD[ATA] Tabla | Vista EXPORT[DATA] Tabla INFO PROP[ERTIES] Objeto QUERY[DATA] Tabla | Vista REC[OMPILE] Objeto RUNTEST[SET] TestSetFile [LogFile] SET BEAUT[IFIERRULES] [Archivo] SET COL[WIDTH] [Ancho]

SET EXEC[PAUSE] [ON | OFF] SHOW CONN[ECTION] SQLPLUS TEST Unidad de programa VIEW Objeto ZIP Archive [File | Directory]

Abre una ventana editable que le muestra la definicin del objeto. Abre una ventana de consulta SQL para la tabla o vista especificada permitindole editar los resultados. Abre la herramienta de exportacin para la tabla especificada. Muestra la ventana de informacin de la conexin. Muestra la ventana de propiedades para el objeto especificado. Abre una ventana de consulta SQL para la tabla o vista especificada mostrando los resultados de slo lectura. Vuelve a compilar el objeto especificado. Ejecuta el conjunto de pruebas especificado y guarda el resultado del mismo en un archive de log. Utiliza de forma temporal las reglas del BEAUTIFIER. Puede ser utilizado con el comando BEAUTY. Determina el ancho mximo de una columna en un conjunto de resultados. Si el valor es igual a = 0, el ancho de la columna es ilimitado. Por defecto el valor es 80. Pausa la ejecucin en el siguiente comando (ON), o contina la ejecucin del siguiente comando (OFF). Muestra informacin sobre todas las conexiones de PL/SQL Developer. Abre SQL*Plus con el archivo actual. Abre una ventana de prueba con un archivo de prueba estndar para la unidad de programa especificada. Abre una ventana de slo lectura con la definicin del objeto. Aade el archivo o directorio al archivo comprimido. Si el se omite el parmetro File o Directory, se mostrar el contenido del archivo comprimido.

Gua del usuario de PL/SQL Developer 9.0

51

9. Crear y modificar objetos.


Durante el proceso de desarrollo de cdigo PL/SQL normalmente necesitar crear una tabla, modificar una restriccin o un ndice, reiniciar una secuencia, etc. PL/SQL Developer posee diversas funciones que le permiten crear y modificar tablas (y sus elementos relacionados), secuencias, sinnimos, libreras, directorios, usuarios y roles. Este captulo no explica la funcionalidad de esos objetos, simplemente explica como crearlos, modificarlos y ver sus propiedades. Para ms informacin acerca de la funcionalidad de cada objeto, vea la documentacin de Oracle. Para crear un objeto, puede presionar el botn Nuevo situado en la barra de herramientas y seleccionar el tipo de objeto correspondiente, o seleccionar el elemento Nuevo en el men Archivo. De forma alternativa tambin puede hacer clic con el botn derecho del ratn sobre la carpeta principal del tipo de objeto que desea crear y seleccionar el elemento Nuevo desde el men contextual. Para modificar un objeto, seleccinelo en el Explorador de Objetos, haga clic con el botn derecho del ratn sobre l, y seleccione el elemento Editar desde el men contextual. No puede cambiar el nombre de un objeto de esta forma, debe utilizar la funcin Renombrar desde el Explorador de Objetos siempre y cuando el tipo de objetos soporte esta funcin. Si quiere ver el objeto, seleccione el elemento Ver desde el men contextual. De forma adicional puede duplicar un objeto si selecciona el elemento Duplicar desde el men contextual del Explorador de Objetos. Aparecer la ventana del editor de objetos con todas las propiedades rellenas, excepto la propiedad Owner (si es aplicable) y la propiedad Name. De esta forma puede crear rpidamente un objeto similar para realizar pruebas sobre el.

9.1

El editor de tablas.

El editor de la definicin de tablas tiene siete pestaas para varios aspectos de una tabla:

En la parte inferior del editor, puede ver los siguientes botones: Aplicar Aplicar todas las modificaciones que haya realizado en el editor a la base de datos.

Gua del usuario de PL/SQL Developer 9.0

52

Refrescar Recupera la informacin de la base de datos, descartando cualquier cambio que haya realizado. Cerrar Cierra la ventana del editor. Ayuda Muestra la ayuda en lnea. Consultar Llama a la ventana de consulta SQL con una consulta que le permite ver y editar los datos de la tabla. Ver SQL Muestra un editor de texto con las instrucciones SQL resultantes de los cambios realizados en el editor. Si no ha realizado ningn cambio en el objeto, mostrar la sentencia SQL completa de creacin de la tabla. Los siguientes captulos describen las diferentes pestaas del editor de definicin de la tabla.

Pestaa General.
La pestaa General que se muestra en la imagen, contiene el propietario de la tabla y el nombre, informacin de almacenamiento, clster y comentarios. Para una nueva tabla puede dejar todas las propiedades en blanco, excepto el nombre. El resto de las propiedades tendrn un valor por defecto. Owner El usuario conectado a la base de datos. Tablespace El tablespace por defecto del usuario actual. %Free 10 %Used 40 Initial transaction entries 1 Maximum transaction entries 255 Los valores por defecto de las propiedades de los segmentos (initial extent, next extent, %increase, minimum extents and maximum extents) dependen de los valores por defecto correspondientes del tablespace seleccionado. La informacin del clster, de almacenamiento y las propiedades de duracin de la tabla son mutuamente excluyentes, debido a que un clster define de forma implcita las caractersticas de almacenamiento de una tabla, y las tablas temporales no pueden agruparse en modo clster y tambin tienen implcitas las caractersticas de almacenamiento. Si selecciona External como forma de organizacin de la tabla. PL/SQL Developer deshabilitar las propiedades de almacenamiento y har visible una nueva pestaa llamada External donde podr definir el directorio externo y las propiedades de los archivos. Si introduce o selecciona el nombre de un clster, las propiedades de almacenamiento y duracin se volvern de slo lectura y podr introducir las columnas del clster. Si borra el nombre del clster obtendr el efecto contrario. Si define una tabla como temporal, el clster y la informacin de almacenamiento se volvern de slo lectura y puede definir si las filas se guardan despus de ejecutar una instruccin commit. Si define una tabla organizada mediante ndices, debe definir una clave primaria. Para las tablas que no estn organizadas mediante ndices no es un requisito. Si esta modificando una tabla existente, no puede cambiar todas las propiedades. Los valores del tablespace, initial extent, minimum extents, clster information, las propiedades de almacenamiento y de clster no pueden modificarse para una tabla existente. Si desea cambiar cualquiera de esas propiedades debe marcar la opcin Recreate table en la parte superior de la pestaa General. Todos los datos, disparadores y claves forneas se borrarn con lo que debe tener cuidado cuando utilice esta opcin.

Gua del usuario de PL/SQL Developer 9.0

53

Pestaa Columnas.
En la pestaa Columnas puede ver, aadir, borrar, mover y modificar las columnas de una tabla. Si est creando una tabla basada en un objeto, puede seleccionar el tipo de objeto en esta pestaa:

Para aadir una columna puede presionar el botn Insert columna, o puede comenzar a teclear la informacin de una nueva columna en la ultima fila (lo que crear una nueva fila vaca). La columna Tipo contiene una lista de sugerencias con los tipos de datos ms comunes, pudiendo utilizar cualquier otro tipo de datos que no se encuentren en la lista. La columna Valor por defecto requiere que introduzca un valor en el formato apropiado, por ejemplo las cadenas de texto deben ir entre comas simples. Para borrar una columna, presione el botn Eliminar columna. Esto borrar la columna que tiene el foco de la aplicacin o todas las columnas seleccionadas. Puede seleccionar todas las columnas si presiona en la cabecera de la fila. Si pulsa con el botn izquierdo del ratn y lo arrastra seleccionar un rango de filas. Si presiona la tecla Control mientras hace clic en la cabecera de una fila podr seleccionar de forma individual mltiples columnas. Para mover una o ms columnas, seleccinelas como se describe en el prrafo anterior. Ahora puede hacer clic con el botn izquierdo del ratn en una de las cabeceras de las filas y mover las filas seleccionadas a la posicin deseada. Para una columna virtual (por ejemplo, la columna email en el ejemplo anterior) puede introducir la expresin en el campo Defecto/Expr. Para columnas reales este campo contiene el valor por defecto. No puede cambiar el nombre de las columnas de tablas existentes a no ser que se encuentre utilizando Oracle 9.2 o posterior. Tampoco puede borrar dicha columna a no ser que se encuentre utilizando Oracle 8i o una versin superior. Para superar estas limitaciones puede marcar la opcin Recreate table situada en la pestaa General. Las consecuencias del uso de esta opcin se describieron en el captulo anterior. Observe que si cambia el nombre de una columna se propagarn los cambios a las restricciones de las columnas, ndices y columnas de tipo clster. Si selecciona el propietario del tipo y el nombre del tipo en la parte superior de la pestaa, crear una tabla basada en ese tipo de objeto. Los nombres de las columnas y sus tipos se encuentran definidos y restringidos a los atributos del tipo de objeto. Puede definir si una columna puede ser nula, su valor por

Gua del usuario de PL/SQL Developer 9.0

54

defecto, sus propiedades de almacenamiento y sus comentarios. Si desea cambiar el tipo de objeto posteriormente, debe seleccionar la opcin Recreate table en la pestaa General.

Pestaa Claves.
En la pestaa Claves puede ver, aadir, borrar y modificar las claves primarias, nicas y forneas de la tabla:

Puede manipular la rejilla de la misma forma que la rejilla de la pestaa Columnas. Puede aadir, borrar y modificar las restricciones comprobacin (check constraints). Puede mover las restricciones pero no tendr ningn efecto, ya que no estn realmente ordenadas. Observe que la informacin de almacenamiento del ndice subyacente utilizado para forzar que se cumpla una clave primaria o una clave nica no est definida en esta pestaa. Si la restriccin est habilitada, existir el correspondiente ndice en la pestaa ndices con el mismo nombre. Para este ndice puede definir la informacin de almacenamiento. Deshabilitando o borrando una clave de tipo primario o nico borrar de forma implcita el ndice subyacente. La columna Tipo tiene una lista que le permite seleccionar el tipo de la clave Primary, Unique o Foreign key. De forma rpida puede seleccionar el tipo correcto si selecciona el primer carcter (P, U o F). Observe que slo puede tener una clave primaria, y que el valor por defecto de esta columna (Primary o Unique) depende de esto. Si cambia el tipo de la clave afectar a las columnas Tabla referenciada, Columnas referenciadas y Borrado ya que slo son validas para restricciones de tipo forneo. Si cambia el tipo de la clave a Foreign, borrar de forma implcita el ndice. Para definir las columnas que se aplican a la clave, teclee los nombres de las columnas en la celda apropiada (separando los valores mediante comas), o presione el botn que se encuentra dentro de la celda. Esto las cargar en la pantalla de seleccin de columnas donde puede fcilmente aadir, borrar o mover las columnas que formarn la clave:

Gua del usuario de PL/SQL Developer 9.0

55

Para las claves forneas puede teclear o seleccionar la tabla a la cual referencia seleccionando la columna Tabla referenciada. Automticamente PL/SQL Developer seleccionar las columnas por defecto, basndose en las claves primaria o nica de la tabla. La lista de seleccin para estas columnas muestra todos los conjuntos de columnas que forman las claves primaria o nica para la tabla referenciada, y son adems los nicos candidatos aqu. En la lista Borrado puede definir que accin debe realizarse para los registros de las tablas hijas cuando el registro padre se borra. La accin Set null esta soportada en Oracle8i y versiones posteriores. Si esta utilizando Oracle8 o una versin posterior, puede de forma adicional definir si la restriccin es Diferible y su estado inicial. Esas dos opciones estn obviamente relacionadas: no puede tener una restriccin de tipo No diferible en una restriccin que inicialmente es Diferible.

Gua del usuario de PL/SQL Developer 9.0

56

Pestaa Comprobaciones.
En la pestaa Comprobaciones puede ver, aadir, borrar y modificar las restricciones de la tabla:

Puede manipular la rejilla de la misma forma que la rejilla de la pestaa Columnas. Puede aadir, borrar y modificar las restricciones de comprobacin (check constraints). La columna Condicin debe contener una expresin de tipo boolean que debe establecerse a verdadero/falso para todas las filas de la tabla. No puede aplicar una restriccin de comprobacin si una o ms filas de una tabla vulneran esta condicin a no ser que desmarque la opcin Habilitada. Puede habilitar la restriccin de comprobacin despus de corregir las filas que vulneran dicha restriccin. Si esta utilizando Oracle8 o una versin posterior, puede de forma adicional definir si la constante es Diferible y su estado inicial. Esas dos opciones estn obviamente relacionadas: no puede tener una restriccin de tipo No diferible en una restriccin que inicialmente es Diferible.

Gua del usuario de PL/SQL Developer 9.0

57

Pestaa ndices.
En la pestaa ndices puede ver, aadir, borrar o modificar los ndices de la tabla:

Puede manipular la rejilla de la misma forma que la rejilla de la pestaa Columnas. Puede aadir, borrar y modificar los ndices. La propiedad Propietario del ndice puede dejarse en blanco, el propietario por defecto ser el usuario que se encuentre conectado a la base de datos. Si desea utilizar un propietario diferente para el ndice, seleccinelo de la lista. El tipo de ndice puede ser Normal, Unique, o Bitmap. Este ltimo slo se encuentra disponible en servidores Oracle7.3 o en versiones posteriores. Observe que slo puede crear un ndice nico si las columnas de cada fila de la base de datos son nicas. Como este no es nuestro caso no podemos aplicar este ndice a la base de datos. Para definir las columnas de la tabla que desea indexar, simplemente teclee los nombres de las columnas en la celda apropiada (separadas mediante comas), o presione el botn situado dentro de la celda. Esto llamar a una pantalla de seleccin de columnas donde podr fcilmente aadir, borrar u ordenar las columnas del ndice. Para los ndices basados en funciones, puede especificar las funciones, separadas mediante comas. Para ndices descendentes, coloque el texto DESC despus del nombre de la columna. Adicionalmente puede habilitar la compresin para el ndice, incluyendo el nmero de columnas prefijadas y definir el ndice como ndice inverso. Si el ndice es para una clave primaria o nica entonces el usuario, el tipo y las columnas no pueden modificarse. Esas propiedades derivan de la restriccin. Si cambia el nombre de una clave cambiar automticamente el nombre del ndice correspondiente, si cambia las columnas de una restriccin cambiar las columnas del ndice correspondiente. El propietario del ndice ser el mismo propietario que el de la tabla y el tipo del ndice siempre ser nico. Puede ver o modificar los parmetros de almacenamiento si presiona el botn situado dentro de la celda. Esto llamar al editor de almacenamiento:

Gua del usuario de PL/SQL Developer 9.0

58

Para ndices nuevos no necesita introducir ningn tipo de informacin, cada propiedad tiene su valor por defecto: Tablespace El tablespace por defecto del usuario actual. %Free 10 Initial transaction entries 2 Maximum transaction entries 255 Los valores por defecto de las propiedades de los segmentos (initial extent, next extent, %increase, minimum extents and maximum extents) dependen de los correspondientes valores por defecto del tablespace. La propiedad %Used no puede utilizarse con los ndices. Observe que, si modifica las propiedades %free, initial extent, and minimum extents de un ndice existente, implicar que el ndice y las restricciones se borren y se vuelvan a crear para aplicar los cambios. Para ndices largos este proceso puede emplear mucho tiempo.

Gua del usuario de PL/SQL Developer 9.0

59

Pestaa Privilegios.

En la pestaa Privilegios, puede asignar o revocar privilegios sobre una tabla a los usuarios y roles:

Puede manipular esta rejilla de la misma forma que la rejilla situada en la pestaa Columnas. Puede aadir, borrar o modificar un usuario o rol asignado. Borrar un usuario o rol equivale a revocar todos sus privilegios individuales. Usuario/Rol es el usuario o rol al que quiere asignar determinados privilegios. Observe que los privilegios asignados a un rol no sern suficientes para el desarrollo de unidades de programa almacenadas. Si a un usuario le asigna el privilegio de select sobre una tabla a travs de un rol y existen referencias a esta tabla en unidades de programa almacenadas, la compilacin fallar debido a que se desconoce la tabla. Debe asignarse el privilegio de select directamente si el objeto se utiliza en una unidad de programa que pertenezca al usuario. Las columnas de los privilegios pueden almacenar 3 valores: (Blank) El usuario o rol no tiene privilegios. Yes El usuario o rol tiene privilegios. Grantable El usuario tiene privilegios y puede asignarlo a otros roles. Los privilegios Select, Insert, Update y Delete permiten realizar estas acciones en los registros de las tablas. El privilegio References permite crear claves forneas a esta tabla. El privilegio Alter permite modificar la definicin de la tabla mediante el comando alter table. El privilegio Index permite crear un ndice en la tabla.

Gua del usuario de PL/SQL Developer 9.0

60

Pestaa Particiones.
La pestaa Particiones slo es visible cuando crea una tabla o cuando edita una tabla particionada existente:

En la parte superior de la pestaa puede seleccionar el tipo de particin, Range, Hash o List as como las columnas de la particin. En la rejilla puede definir el nombre, los valores de la columna y las opciones de almacenamiento de cada particin. Si ha definido ms de una columna, debe separar los valores mediante comas. Si selecciona el tipo de la particin como Range, PL/SQL Developer habilitar una nueva pestaa llamada Subpartition en la que podr definir sub particiones de manera adicional.

Gua del usuario de PL/SQL Developer 9.0

61

Pestaa Externa
Si el tipo de organizacin de la tabla ha sido definida como externa en la pestaa General, esta pestaa se volver visible.

Desde aqu tiene acceso al tipo de driver utilizado y a los datos de las propiedades que definen esta tabla como externa

Gua del usuario de PL/SQL Developer 9.0

62

Ver y modificar la definicin de la tabla mediante SQL.


Despus de crear una tabla, o modificar una tabla existente, puede ver el texto SQL resultante si presiona el botn Ver SQL. Despus de aadir un comentario a la tabla y modificar las columnas ename y job de opcionales a obligatorias, el texto de la instruccin SQL se parecer al siguiente:

Puede guardar el texto SQL a un archivo, copiarlo al portapapeles o abrirlo en una nueva Ventana de Comando utilizando los botones situados en la parte derecha de la ventana. El botn Imprimir situado en la barra de herramientas le permitir imprimir el texto SQL. Puede hacer cambios en el texto SQL y aplicarlos posteriormente. Despus de aplicar esos cambios, la ventana volver al modo formulario y refrescar la definicin de la tabla. Los cambios realizados en el texto SQL se reflejarn inmediatamente en los formularios. Si presiona otra vez el botn Ver SQL, la ventana volver al modo formulario, descartando los cambios sin aplicar que haya realizado al texto SQL. Si presiona la opcin Ver en el Explorador de Objetos para ver la definicin de la tabla, el botn Ver SQL mostrar el texto SQL de creacin de la tabla sin mostrar el comando drop. De esta forma puede guardar el texto de definicin de la tabla en un archivo o copiar su definicin a otra base de datos o a otro usuario.

9.2

El editor de secuencias.

El editor de secuencias le permite crear o modificar fcilmente una secuencia:

Gua del usuario de PL/SQL Developer 9.0

63

La mayora de las propiedades del editor de secuencias tienen un valor por defecto, con lo que necesitar introducir un nombre cuando cree una nueva secuencia: Owner El propietario conectado a la base de datos. Minimum value 1 Maximum value Unlimited Initial value 1 Increment by 1 Cache size 20 Cycle Off Order Off

9.3

El editor de sinnimos.

El editor de sinnimos le permite crear y modificar fcilmente un sinnimo:

El valor por defecto del campo Owner ser el usuario conectado a la base de datos. Marcando la opcin Public se crear un sinnimo pblico y el estado de la propiedad Owner pasar a ser de slo lectura. Los campos Object Owner y Object Name tienen una lista de sugerencias para seleccionar fcilmente una traduccin para el objeto del sinnimo. Si el campo Object owner est vaco, la lista del campo Object name mostrar todos los objetos.

9.4

El editor de libreras.

El editor de libreras le permite fcilmente crear o modificar una librera:

El valor por defecto para la propiedad Owner ser el usuario conectado a la base de datos, pudiendo utilizar la lista de sugerencias para crear una librera con un propietario diferente. La propiedad Filespec almacena la ruta completa de la librera 3GL que desee utilizar. Si se encuentra desarrollando en el servidor de la base de datos, entonces puede utilizar el botn Select DLL file para seleccionar la librera de vnculos dinmicos. De otra forma, tiene que teclear la ruta completa y el nombre de la DLL (Windows) o del objeto compartido (Unix). PL/SQL Developer no comprueba la validez de la propiedad Filespec.

Gua del usuario de PL/SQL Developer 9.0

64

9.5

El editor de directorios.

El editor de directorios le permite crear o modificar un directorio fcilmente, que podr ser utilizado para almacenar archivos de tipo BFILE:

Si se encuentra desarrollando en el servidor, puede utilizar el botn Select directory para seleccionar la ruta del directorio. PL/SQL Developer no comprueba si la ruta del directorio es correcta.

9.6

El editor de trabajos de la base de datos.

El editor de trabajos le permite crear y modificar trabajos de la base de datos:

Crear un nuevo trabajo equivale a realizar una llamada a dbms_job.submit. Modificar un trabajo existente equivale a realizar una llamada a dbms_job.change. Para ms informacin acerca de los trabajos, vea el captulo DBMS_JOB en el manual Oracle Supplied Packages Reference. El botn Abrir PL/SQL Editor situado al lado del campo What abre el editor de PL/SQL con resalto de sintaxis, asistente de cdigo, etc.

9.7

El editor de listas.

Gua del usuario de PL/SQL Developer 9.0

65

El editor de listas le permite crear o modificar listas :

Para el nombre de la tabla puede seleccionar un tabla existente o puede presionar el botn Crear para crear una nueva tabla (vea el captulo 9.8). Para ms informacin consulte los siguientes manuales de Oracle: Application Developer's Guide - Advanced Queuing Supplied PL/SQL Packages and Types Reference

9.8

El editor de tablas de listas avanzadas.

El editor de tablas de listas le permite crear o modificar una tabla de listas avanzada:

En la pestaa General puede definir el nombre, los parmetros de almacenamiento y los comentarios para la tabla. En la pestaa Privilegios puede asignar privilegios sobre la tabla a usuarios y roles. Para ms informacin vea el captulo 9.1. En la pestaa Queue puede introducir la informacin de definicin de la tabla. Para el campo payload type puede seleccionar un tipo de objeto existente o RAW para crear una cola de tipo RAW. Para ms informacin consulte los siguientes manuales de Oracle: Application Developer's Guide - Advanced Queuing Supplied PL/SQL Packages and Types Reference

Gua del usuario de PL/SQL Developer 9.0

66

9.9

El editor de usuarios.

El editor de usuarios le permite crear o modificar un usuario, sus privilegios y las cuotas de los tablespaces:

Observe que necesita privilegios del sistema (como los que provee el rol DBA) para ver y modificar la informacin del usuario.

Pestaa General.
En la pestaa general slo necesita introducir el nombre del usuario y la contrasea. Todas las dems propiedades tienen un valor por defecto: Default tablespace SYSTEM Temporary tablespace SYSTEM Profile DEFAULT Password expire Off Account Locked Off Si modifica un usuario existente, el campo password de dicho usuario no se mostrar. Introduzca una nueva contrasea para cambiarlo o djelo en blanco para mantener el valor del password actual. Si el usuario se identifica de forma externa, usted no puede introducir un password.

Gua del usuario de PL/SQL Developer 9.0

67

Privilegios sobre objetos.

Esta pestaa le permite ver y modificar los privilegios sobre objetos asignados al usuario. Aqu no se incluyen los privilegios que se han autorizado indirectamente a travs de un rol. En la primera columna puede ver el objeto en el cual se asignan los privilegios al usuario. El resto de las columnas representan un privilegio especfico. Cada privilegio puede tener los siguientes valores: (Blank) El usuario no tiene privilegios. Yes El usuario tiene privilegios. Grantable El usuario tiene privilegios y puede asignarlo a otros usuarios o roles.

Privilegios sobre roles.

Esta pestaa muestra los roles asignados a un usuario. Cada rol sobre un privilegio puede ser Autorizable, con lo que el usuario puede asignarlo a otros usuarios y roles. Si un privilegio sobre rol esta establecido como Defecto, el rol se habilitar por defecto cuando el usuario se conecte al sistema. Si no es el rol por defecto, el privilegio sobre el rol debe ser activado para la sesin actual mediante el comando set role despus de que el usuario se haya conectado.

Gua del usuario de PL/SQL Developer 9.0

68

Privilegios del sistema.

Esta pestaa muestra los privilegios del sistema asignados al usuario. Cada privilegio puede ser Autorizable, con lo que el usuario puede asignarlo a otros usuarios y roles.

Pestaa Cuotas.

Esta pestaa muestra las cuotas de los tablespaces para el usuario. Puede introducir el nmero mximo de bites, kilo bites o mega bites que se le asignarn al usuario, o puede especificar que la cuota para el usuario es ilimitada.

9.10

El editor de roles.

Gua del usuario de PL/SQL Developer 9.0

69

El editor de roles le permite crear o modificar un rol y sus privilegios:

Por defecto un rol no necesita identificarse. Puede definir el tipo de identificacin, mediante contrasea o mediante identificacin externa para un rol. La identificacin mediante contrasea requiere que introduzca una contrasea, y es til si el rol no esta asignado por defecto a los usuarios. Dicho rol necesita establecerse despus de que el usuario se conecte al sistema, lo que requiere una password. Las otras tres pestaas (Privilegios sobre objetos, Privilegios sobre roles y Privilegios del sistema) funcionan de la misma forma que las pestaas correspondientes en la definicin de los usuarios.

9.11

El editor de perfiles.

El editor de perfiles (profiles) le permite editar las restricciones de los recursos, de las contraseas y los usuarios que pertenecen a un determinado perfil:

Cada uno de los lmites del editor puede establecerse al valor Default, en cuyo caso el valor se heredar del perfil estndar DEFAULT, a Unlimited, o a un valor concreto. En la pestaa Usuarios puede definir a que usuarios se le aplica el perfil. Observe que si elimina un usuario de un perfil determinado, este se asignar al perfil Default.

Gua del usuario de PL/SQL Developer 9.0

70

9.12

El editor de vnculos de bases de datos.

El editor de vnculos le permite crear y editar vnculos de la base de datos (database links).

Observe que el editor de vnculos de bases de datos no mostrar las propiedades Password y Authenticated By cuando edite un vnculo de bases de datos. Tendr que introducir esta informacin cada vez que necesite editar un vnculo.

Gua del usuario de PL/SQL Developer 9.0

71

10. Planificador de tareas.


Puede utilizar la herramienta DBMS Scheduler para acceder al planificador de tareas de Oracle (DBMS_SSCHEDULER) incluido a partir de la versin 10G de Oracle Server. Para utilizarlo seleccione el elemento Planificador de tareas desde el men Herramientas o haga clic con el botn derecho del ratn sobre el objeto Scheduler y seleccione la opcin Editar o Ver desde el men contextual. Observe que para obtener informacin ms detallada sobre la funcionalidad DBMS_SCHEDULER puede dirigirse a la documentacin de Oracle, ms concretamente a la gua Oracle Database Concepts para ver los conceptos del planificador de tareas de Oracle y a la gua de referencia Oracle Database PL/SQL packages and Types, para informacin sobre la interfaz de programacin. Una vez ejecutado el Planificador de tareas, podr ver una ventana como la que se muestra a continuacin:

En la parte izquierda de la pantalla, puede ver las carpetas para los distintos objetos que puede utilizar el Planificador de tareas as como carpetas para los trabajos en ejecucin. Las carpetas Windows Groups, Jobs y Job classes son de sistema y se muestran inmediatamente en la raz de la carpeta correspondiente. Schedules, Programs y Jobs son propiedad de usuarios especficos por lo que cada carpeta contiene subcarpetas para los propietarios. En la parte superior derecha de la pantalla, puede ver las propiedades de los objetos seleccionados, en la parte inferior, justo debajo de las propiedades se muestran detalles adicionales de los objetos seleccionados. Cuando est creando o editando objetos, puede introducir la informacin desde aqu.

Gua del usuario de PL/SQL Developer 9.0

72

Horarios.

Un horario especifica cuando y cuantas veces se ejecuta una tarea. Los horarias pueden compartirse entre mltiples trabajos. Por ejemplo, el fin de un trimestre, laboralmente hablando, es un marco de tiempo comn para muchos trabajos. En vez de tener que definir un horario para cada uno de los diferentes trabajos que se definen, puede indicar un horario comn para todos ellos.

Ventanas.

Gua del usuario de PL/SQL Developer 9.0

73

Puede utilizar una ventana para ejecutar automticamente un trabajo o para cambiar la localizacin de los recursos de los trabajos utilizando diferentes periodos de tiempo al da, semana, etc. Una ventana est representada por un intervalo de tiempo con una hora de inicio y de fin bien definida. Por ejemplo, entre las 12 Am y 6 Pm. Puede especificar de forma individual las propiedades del horario para la ventana definida. Tambin puede, de forma alternativa, seleccionar un horario existente para la ventana que acaba de crear. Todas las propiedades del horario se muestran en letra cursiva, indicando que se refieren al horario seleccionado. Si omite una o mas propiedades de un horario, el horario se borrara indicndole que tiene un horario personalizado. Esta capacidad de PL/SQL Developer le permite utilizar un calendario ya existente como si fuese una plantilla. En la parte inferior de la ventana puede aadir o eliminar la pertenencia a un grupo de ventanas para la ventana de tiempo actual, activando o desactivando la opcin correspondiente.

Grupos de ventanas.

Los grupos de ventanas pueden crearse para facilitar su uso cuando se encuentre planificando diferentes trabajos. Si un trabajo debe ejecutarse durante diferentes periodos de tiempo a lo largo del da, de la semana, del mes, etc. puede crear una ventana de tiempo por cada periodo y luego aadir esas ventanas a un grupo de ventanas. Despus puede establecer el horario de ese trabajo a ese grupo de ventanas y el trabajo se ejecutara durante todos los periodos de tiempo definidos en el grupo de ventanas.

Gua del usuario de PL/SQL Developer 9.0

74

Clases de trabajos.

Las clases de trabajos le proporcionan una forma de asignar el mismo conjunto de atributos a los diferentes trabajos. Puede conceder privilegios de ejecucin a otros usuarios o roles que necesiten utilizar las clases de trabajos definidas. Para revocar estos privilegios, haga clic con el botn derecho del ratn sobre una clase y seleccione el elemento Eliminar desde el men contextual.

Programas.

Un programa define la accin o acciones que vamos a ejecutar mediante el Planificador de Tareas. Un programa incluye una accin, como la llamada a un procedimiento almacenado, el nombre de un archivo ejecutable que se encuentre dentro del sistema de ficheros del sistema operativo o el texto del cdigo dentro de un bloque de PL/SQL. Un programa es una entidad dentro de un trabajo. Un trabajo se ejecuta cada cierto tiempo o porque se ha disparado un evento determinado invocando un programa. Los trabajos son creados de manera que apunten a un programa, lo que significa que diferentes trabajos pueden usar el mismo programa y ejecutar el programa a diferentes horas y con configuraciones diferentes. Con los privilegios adecuados, diferentes usuarios pueden utilizar el mismo programa sin tener que redefinirlo ni cambiarlo. Esto le permite crear libreras de programas, donde los usuarios pueden seleccionar los programas que necesiten ejecutar.

Gua del usuario de PL/SQL Developer 9.0

75

Trabajos.

Los trabajos asocian un programa con un horario y son el principal objeto con el que se trabaja dentro del Planificador de Tareas. Puede crear varios trabajos que apunten al mismo programa pero que se ejecutan en tramos horarios diferentes. Puede omitir los valores por defecto de los argumentos del programa, por lo que varios pueden apuntar al mismo programa pero proporcionar diferentes argumentos. Puede introducir de manera individual las propiedades para un trabajo, horario personalizado, o puede seleccionar un horario ya existente para un trabajo. Todas las propiedades de un horario se mostrarn en cursiva, indicando que se refieren al horario seleccionado. Si omite una o mas propiedades de un horario, el horario se borrara indicndole que tiene un horario personalizado. Esto capacidad de PL/SQL Developer le permite utilizar un calendario ya existente como si fuese una plantilla. Para autorizar Alter privileges a otros usuarios y roles, vaya a la pestaa Privilegios. Para revocar un privilegio, haga clic con el botn derecho del ratn y seleccione el elemento Eliminar desde el men contextual. Puede ver los detalles y los logs de los trabajos finalizados en la pestaa correspondiente en la parte inferior de la ventana.

10.1

Crear objetos.

Gua del usuario de PL/SQL Developer 9.0

76

Para crear un nuevo objeto, haga clic con el botn derecho del ratn sobre la carpeta correspondiente y seleccione el elemento Nuevo desde el men contextual. Podr introducir las propiedades e informacin detallada sobre el nuevo objeto en la parte derecha de la pantalla. Cuando haya finalizado, presione el botn Aplicar para crear los objetos en la base de datos. Para ver el cdigo SQL del objeto creado, presione el botn Ver SQL. Si desea cancelar la creacin de un nuevo objeto simplemente presione el botn Cancelar.

10.2

Editar objetos.

Para editar un objeto ya existente, seleccione el objeto en la carpeta correspondiente, en la parte izquierda de la pantalla y edite las propiedades y la informacin detallada en la parte derecha de la pantalla. Cuando haya finalizado, presione el botn Aplicar para modificar el objeto en la base de datos. Para ver el cdigo SQL del objeto editado, presione el botn Ver SQL. Si desea cancelar la edicin de un objeto simplemente presione el botn Cancelar.

10.3

Borrar objetos.

Para borrar un objeto existente, seleccione el objeto en la carpeta correspondiente, en la parte izquierda de la pantalla y seleccione el elemento Eliminar desde el men contextual. PL/SQL Developer le pedir que confirme la eliminacin del objeto seleccionado y posteriormente lo borrara permanentemente de la base de datos.

10.4

Ver informacin sobre los trabajos finalizados.

Para ver informacin relativa a los trabajos que han finalizado su ejecucin puede abrir la carpeta Trabajos finalizados. Desde aqu podr ver una serie de informes predeterminados, como Todos, Fallidos, etc. Haga clic sobre un informe para ver los detalles del trabajo finalizado:

Los trabajos pueden ser ordenados si hace clic sobre el botn ordenar que se encuentra en la cabecera de las diferentes columnas. Recuerde que puede organizar las diferentes columnas del informe arrastrando y soltando la cabecera de las mismas. Para copiar la informacin sobre los diferentes trabajos, seleccione la fila, la columna o las celdas que le interesen, haga clic con el botn derecho del ratn y seleccione el elemento Copiar valore separados por comas o Copiar valores separados por tabulados desde el men contextual. Si no selecciona ningn rango de columnas o celdas, PL/SQL Developer copiar el informe entero. Puede refrescar la informacin del informe si presiona el botn Refrescar situado en la parte inferior de la pantalla.

Gua del usuario de PL/SQL Developer 9.0

77

Crear informes personalizados.


Para crear un informe personalizado, haga clic con el botn derecho del ratn sobre la carpeta Trabajos finalizados y seleccione el elemento Nuevo desde el men contextual. PL/SQL Developer le mostrar la siguiente ventana:

En la parte superior puede introducir un nombre para el nuevo informe. En la seccin inferior de la ventana, puede definir como se van a consultar los datos de la vista sys.all_scheduler_job_run_details para el informe. Para ms informacin sobre esta vista puede consultar el manual Oracle Database Reference Guide. La lista de seleccin situada en la parte derecha de la pantalla le permite seleccionar de una forma rpida y clara los campos que formarn parte del informe. La pestaa Lista de campos le permite definir los campos que se mostrarn en el informe. Puede utilizar el carcter * para indicar que desea incluir todos los campos en el informe. La pestaa Clausula Where le permite definir que trabajos se mostrarn en el informe. Por ejemplo para crear un informe que muestre todos los trabajos que se han ejecutado correctamente desde la fecha actual, utilice una clausula where como la que se muestra a continuacin: log_date >= trunc(sysdate) and status = 'SUCCEEDED' La pestaa Clausula Order by le permite definir la lista de campos mediantes los cuales se ordenar el informe. La pestaa Condiciones le permite definir el color con el que se mostrar el trabajo una vez finalizado, si cumple una determinada condicin:

La condicin puede ser cualquier expresin SQL valida. Puede seleccionar tanto el color del texto como el color de fondo.

Gua del usuario de PL/SQL Developer 9.0

78

Para borrar o editar un informe, haga clic con el botn derecho del ratn sobre el informe deseado y seleccione el elemento correspondiente desde el men contextual.

10.5

Ver informacin sobre los trabajos en ejecucin.

Para ver informacin relativa a los trabajos que se encuentran en ejecucin, haga clic sobre la carpeta Trabajos en ejecucin. PL/SQL Developer le mostrar toda la informacin relativa a los trabajos que actualmente se encuentran en ejecucin en la parte derecha de la pantalla.

Gua del usuario de PL/SQL Developer 9.0

79

11. Diagramas.
La ventana de diagramas le permite crear una representacin grfica de una seleccin de objetos. De esta forma puede visualizar fcilmente todos los objetos de la base de datos, o una parte, utilizados en su aplicacin o proyecto y sus relaciones:

Puede aadir automticamente todos los tipos de objetos relevantes de su aplicacin a un diagrama, e incluir las relaciones entre ellos. Las claves forneas y las dependencias entre tablas se incluyen de forma automtica. Para grandes diagramas puede aadir estructuras adicionales mediante grupos de objetos. Puede utilizar los diagramas con motivo de documentacin, pero tambin pueden servir como un espacio de trabajo. Si hace clic con el botn derecho del ratn sobre un objeto aparecer un men contextual que le permitir acceder a todas las funciones de dicho objeto, y si hace doble clic sobre un objeto se ejecutar la accin por defecto para el tipo de objeto.

11.1

Crear un diagrama.

Para crear un nuevo diagrama, seleccione Ventana de Diagrama desde el submen Nuevo en el men Archivo. Aparecer una ventana vaca de diagrama. Para aadir un objeto de la base de datos al diagrama, arrstrelo desde el Explorador de Objetos a la ventana de diagramas. Puede arrastrar y soltar varios objetos a la vez. Para mover un objeto del diagrama, haga clic sobre la barra de ttulo y arrstrelo a una nueva posicin, para ampliar o disminuir el tamao arrastre el borde o una esquina del objeto. Para borrar un objeto del diagrama, presione la X situada en la parte superior derecha del objeto. Esto slo afectar al diagrama; los objetos de la base de datos no sern eliminados.

Mostrar y ocultar elementos en un diagrama.


Para mostrar u ocultar un objeto concreto del diagrama, haga clic con el botn derecho del ratn en l y vaya al submen Elementos. Aqu podr ver un nuevo submen con todos los elementos del objeto seleccionados. Para una tabla puede seleccionar que elementos de una columna, clave o ndice desea mostrar. Tambin puede ocultar la clave o el ndice completamente.

Gua del usuario de PL/SQL Developer 9.0

80

Tambin puede hacer clic con el botn derecho del ratn sobre un grupo de objetos o sobre el diagrama para mostrar u ocultar los elementos de los objetos dentro de un grupo de objetos o todos los objetos en el diagrama. Por defecto, se mostrarn todos los elementos, pero si hace clic con el botn derecho del ratn y selecciona Establecer por defecto todos los elementos visibles, se mostraran la prxima vez que arrastre el objeto a un diagrama. Puede hacer esto para todos los tipos de objetos.

Ordenar elementos.
Puede ordenar todos los elementos de un grupo del diagrama si hace clic con el botn derecho del ratn sobre el grupo y selecciona los elementos de men Ordenar por orden de creacin o Ordenar alfabticamente desde el submen Elementos. Tambin puede arrastrar y soltar un elemento para ubicarlo en una posicin diferente.

Aadir relaciones.
Para aadir una relacin entre dos objetos, haga clic sobre el icono de un elemento del objeto y arrstrelo hacia el elemento que desea relacionar. PL/SQL Developer dibujar una lnea entre los elementos de los objetos. Puede mover la lnea hacia otro elemento si la selecciona y mueve la seleccin hacia arriba o hacia abajo. Para eliminar una lnea, seleccinela y presione la tecla Supr. Si aade una tabla al diagrama, las claves forneas con las otras tablas del diagrama se incluirn de manera automtica. Esas relaciones pueden borrarse si fuese necesario. Si un objeto referencia a otro objeto o es referenciado por otros objetos, puede hacer clic con el botn derecho sobre el objeto References Link desde el men contextual. Aqu podr seleccionar que referencias desea incluir en el diagrama. Por ejemplo, si hace clic con el botn derecho sobre el paquete employee y selecciona References Link, podr ver que referencia a las tablas DEPT y EMP:

Por defecto las relaciones se dibujarn mediante lneas rectas. Puede aadir puntos de unin adicionales si hace clic con el botn derecho del ratn en una lnea y selecciona Insertar unin desde el men contextual. Otra forma, puede ser presionando la tecla Ctrl mientras hace clic en una lnea. Como resultado de esta accin se aadir un nuevo punto de seleccin. Para crear una relacin de uno a muchos, haga clic con el botn derecho del ratn y seleccione el elemento Cambiar final de la lnea desde el men contextual. Desde aqu podr crear relaciones de uno a muchos, relaciones opcionales, etc. Para cambiar el color, el tamao y la etiqueta de una lnea, haga clic con el botn derecho sobre la lnea deseada y selecciona el elemento Propiedades del men contextual:

Gua del usuario de PL/SQL Developer 9.0

81

Si desplaza los objetos contenidos dentro del diagrama, las etiquetas asociadas a las diferentes lneas tambin se desplazarn.

Aadir grupos.
Para organizar un diagrama grande, puede crear grupos de objetos. Los grupos de objetos pueden tener colores distintos y un titulo situado en la parte superior o inferior, en la izquierda o derecha:

Para aadir un grupo, haga clic con el botn derecho del ratn en una zona vaca del diagrama y seleccione Nuevo grupo en el men contextual. Aparecer un nuevo grupo en dicha zona, en el cual podr ajustar el tamao a las dimensiones apropiadas. Todos los objetos que queden cubiertos completamente por el grupo formaran parte del mismo, si mueve el grupo tambin mover los objetos que agrupa. Si presiona la tecla Ctrl. mientas mueve un grupo, los objetos agrupados no se movern.

Gua del usuario de PL/SQL Developer 9.0

82

Para cambiar la apariencia de un grupo, haga clic con el botn derecho del ratn y seleccione el elemento Propiedades del men contextual. Tambin puede hacer doble clic sobre el grupo. Aparecer la siguiente pantalla:

Puede cambiar la fuente, el color de relleno, el color y el tamao de la lnea, hacer el grupo transparente y hacer que el grupo se redimensione automticamente en funcin del tamao del texto. Puede, de manera opcional, introducir el ttulo del grupo y la situacin del mismo. Si los grupos creados se solapan , puede hacer clic con el botn derecho del ratn sobre el grupo y seleccionar Enviar al frente o Enviar atrs desde el men contextual. Para crear una apariencia por defecto para el grupo, haga clic con el botn derecho del ratn y seleccione Establecer por defecto. Esto se aplicar a los grupos que se aadan al diagrama en el futuro.

Aadir notas.
Para aadir notas de texto a un diagrama, haciendo clic con el botn derecho del ratn en la ubicacin deseada y seleccionando la opcin Nueva nota del men contextual:

Como puede comprobar las propiedades de una nota son las mismas que las propiedades de un grupo pero con diferentes valores. Puede crear una estilo predeterminada para las notas si hace clic con el botn derecho del ratn y selecciona la opcin Establecer por defecto del men contextual. De esta forma se aplicar por defecto el estilo seleccionado a las nuevas notas que cree en el diagrama. Alinear elementos. Puede alinear rpidamente un elemento de un diagrama si hace clic con el botn derecho del ratn y selecciona la opcin Alinear a la rejilla desde el men contextual. De esta forma colocar el elemento seleccionado en una rejilla de 8 pxeles. Para alinear todos los elementos de un diagrama puede hace

Gua del usuario de PL/SQL Developer 9.0

83

clic con el botn derecho del ratn y selecciona la opcin Alinear todos a la rejilla desde el men contextual o presionar el botn correspondiente en la barra de herramientas de la Ventana de Diagramas.

11.2

Zoom.

Para hacer zoom sobre un diagrama, haga clic con el botn derecho del ratn y seleccione la opcin Zoom desde el men contextual o presione el botn correspondiente en la barra de herramientas de la Ventana de Diagramas. Puede hacer aumentar el diagrama un 150% o un 200% y reducirlo desde un 90% a un 10%.

11.3

Guardar y abrir un diagrama.

Para guardar un diagrama en un archivo, seleccione el elemento Guardar desde el men Archivo. El diagrama se guardara con la extensin .pdd, que podr volver abrir ms tarde. Para definir una localizacin estndar para los diagramas, vaya a la pgina Directorios de las preferencias del programa y establezca la opcin correspondiente.

11.4

Actualizar un diagrama.

Un diagrama es una representacin esttica de la base de datos. Si los objetos de la base de datos cambian a lo largo del tiempo, tendr que actualizar el diagrama para reflejar esos cambios. Para hacerlo, haga clic con el botn derecho del ratn sobre el diagrama y seleccione Actualizar desde la base de datos en el men contextual. Para actualizar todos los objetos de un diagrama, haga clic con el botn derecho del ratn y seleccione Actualizar todo desde la base de datos o presione el botn correspondiente en la barra de herramientas de la Ventana de Diagramas. Si borra un objeto de la base de datos, debe borrarlo tambin del diagrama. Si cambia el nombre de un objeto de la base de datos, tendr que borrar el objeto del diagrama y aadirlo con el nuevo nombre.

11.5

Imprimir un diagrama.

Para imprimir un diagrama haga clic sobre el botn Imprimir situado en la barra de herramientas principal. Para imprimir la vista actual puede presionar el botn Vista de impresin en la barra de herramientas de la Ventana de Diagramas. La PL/SQL Developer determinar automticamente la orientacin de la pagina cuando imprima la vista actual. Puede controlar el tamao de la pgina utilizando el botn Tamao de Pgina en la barra de herramientas de la ventana de Diagrama. Establezca el tamao a Automtico para determinar automticamente el tamao apropiado. Establezca esta opcin a Manual para controlar el tamao de la pagina. Si utiliza grandes diagramas, puede disminuir el zoom y mover los diagramas a una ubicacin ms apropiada o mover los objetos que forman el diagrama de manera que no ocupen varias pginas.

11.6

Exportar un diagrama.

Puede exportar un diagrama a un imagen si hace clic con el botn derecho del ratn sobre el y selecciona Guardar como imagen desde el men contextual. Seguidamente puede seleccionar el formato (bmp, jpg, wmf o emf). Tambin puede copiar el diagrama a una imagen si hace clic con el botn derecho y selecciona Copiar como imagen desde el men contextual.

Gua del usuario de PL/SQL Developer 9.0

84

12. Informes.
Para ejecutar informes sobre los datos de su aplicacin o sobre el diccionario de datos de Oracle, puede utilizar las funciones de PL/SQL Developer. Existen un nmero de informes estndar, y puede crear sus propios informes fcilmente. Puede guardar los informes personalizados en un archivo, que puede incluir en el men Reports. De esta forma le ser ms fcil ejecutar los informes que utilice frecuentemente.

12.1

Informes estndar.

Puede acceder fcilmente a los informes estndar a travs del men Informes. Si, por ejemplo, selecciona el informe Errores de compilacin, PL/SQL Developer le preguntar antes de ejecutar el informe por el tipo de objeto, el propietario y el nombre del objeto para el cual quiere mostrar los errores generados durante el proceso de compilacin.

Despus de introducir los valores adecuados y presionar el botn Aceptar, se mostrar el informe:

El resultado es un documento HTML que se muestra mediante el visor interno de PL/SQL Developer, o mediante el control ActiveX de Microsoft Internet Explorer, dependiendo de como se encuentre configurada la opcin correspondiente en la ventana de preferencias. Posteriormente puede imprimir el informe si presiona el botn Imprimir situado en la barra de herramientas, o guardar el informe en formato HTML presionando el botn Guardar resultados, que se encuentra situado en la parte derecha de la Ventana de informes. El botn Copiar como HTML copia el resultado del informe al portapapeles. El botn Exportar resultados le permite exportar los resultados en formato CSV, TSV o XML, o exportarlos directamente a Excel. El botn Editar informe le permite acceder a la definicin del informe, si este no esta bloqueado. Puede hacer clic con el botn derecho del ratn para opciones adicionales.

Gua del usuario de PL/SQL Developer 9.0

85

12.2

Informes personalizados.

Los informes personalizados son fciles de crear. Primero cree un nuevo informe en blanco, presionando el botn Nuevo, situado en la barra de herramientas y seleccione el elemento Ventana de informes en el men contextual. Aparecer una ventana vaca del editor de informes.

En el editor puede teclear la consulta SQL que desee utilizar en su informe. Para un informe de tipo maestro/detalle puede utilizar una consulta de unin (se explicar ms adelante). Comencemos con la simple, pero bien conocida, tabla emp tecleando la consulta y presionando el botn Ejecutar situado en la barra de herramientas:

Este es un informe muy bsico, que slo utiliza las propiedades por defecto. Los siguientes captulos describen como puede mejorar la funcionalidad de los informes.

12.3

Variables.

Gua del usuario de PL/SQL Developer 9.0

86

A menudo sus informes necesitarn algn tipo de informacin adicional para poder ejecutarse. Supongamos que necesita restringir el informe anterior a los empleados de un departamento. En este caso necesitar una variable de sustitucin en el texto de la consulta:
select * from emp where deptno = &department order by ename

Cuando ejecute el informe, se le preguntar al usuario el departamento antes de ejecutar la consulta. Esto, por supuesto, no est exento de errores. Que ocurre si el usuario no introduce ningn valor? La consulta lanzar la excepcin ORA-00936: missing expresin. Para prevenir este tipo de situaciones, puede utilizar las opciones que se describen en las secciones siguientes. Dichas opciones deben especificarse entre corchetes, de la misma forma que los atributos que forman un documento HTML o XML.

La opcin Name.
El nombre de una variable se utiliza a modo indicacin en el formulario de entrada de las variables. Por lo tanto debe asegurarse de que el nombre que utilice para las variables describe el significado de la variable. La opcin name es la nica que no necesita especificar entre corchetes. Si el nombre contiene espacios u otros caracteres especiales, debe ir encerrado entre comillas dobles. Los dos ejemplos siguientes son iguales:
select * from emp where deptno = &Department number order by ename

y
select * from emp where deptno = &<name=Department number> order by ename

La opcin Hint.
Adems de la opcin name, puede especificar de manera adicional un texto como sugerencia. El valor almacenado se mostrar en la barra de estado del formulario de entrada de las variables cuando la variable tenga el foco de la aplicacin en ese momento:
select * from emp where deptno = &<name=Department number hint=Only employees from this department will be listed> order by ename

La opcin Type.
La opcin type restringe la informacin que puede introducir el usuario, y controla como se deben introducir los valores en el texto SQL resultante:
select * from emp where deptno = &<name=Department number type=integer> order by ename

Gua del usuario de PL/SQL Developer 9.0

87

En esta situacin el usuario slo puede introducir valores de tipo integer que sean validos. El valor introducido se reemplazar en el texto de la consulta. Adems para cadenas de texto, requiere que el valor se encierre entre comillas. Considere la siguiente consulta de seleccin:
select * from emp where ename = &<name=Employee name type=string>

Si introduce el texto SCOTT (sin comillas) en el formulario de entrada de variables, el texto SQL resultante ser:
select * from emp where ename = SCOTT

Los tipos de datos validos son: none, string, integer, float y date. PL/SQL Developer no realizar ningn tipo de validacin sobre los valores de tipo date, con lo que de forma adicional puede proporcionar expresiones como sysdate, trunc (sysdate, MM), etc.

La opcin Required.
Si necesita un valor para una determinada variable, establezca la opcin required a yes o true:
select * from emp where deptno = &<name=Department number required=yes> order by ename

Ahora slo podr ejecutar el informe si ha especificado un valor para el nmero de departamento.

La opcin Default.
Para presentar un valor por defecto a una variable, especifique la opcin default:
select * from emp where deptno = &<name=Department number default=10> order by ename

El valor por defecto puede ser una consulta de seleccin. Esta consulta debe devolver slo un valor con una columna. Por ejemplo:
select * from emp where deptno = &<name=Department number default=select min(deptno) from dept> order by ename

En este caso el valor por defecto ser el nmero de departamento ms bajo.

La opcin Ifempty.
Como alternativa a especificar una variable como required o a establecer un valor por defecto para la misma, puede especificar el valor ifempty en caso de que el usuario no especifique ningn valor:

Gua del usuario de PL/SQL Developer 9.0

88

select * from emp where ename like &<name=Employee name type=string ifempty=%>

Si el usuario no especifica un valor, el smbolo del porcentaje ser utilizado, y todos los empleados sern recuperados. Esta opcin no puede especificarse con la opcin required.

La opcin Uppercase.
Si tiene una variable de tipo string y desea convertir de forma implcita su valor a maysculas, establezca la opcin uppercase a yes o true:
select * from emp where ename = &<name=Employee name type=string uppercase=yes>

El valor se mostrar tal cual lo ha tecleado pero convertido a maysculas en el texto SQL resultante.

La opcin Readonly.
Una variable puede definirse como slo lectura si especifica la opcin readonly a yes. El usuario puede ver la variable y su valor pero no puede modificarlo.

La opcin Hidden.
Puede ocultar una variable si especifica la opcin hidden =yes.

La opcin List.
La opcin list le proporciona al usuario una lista con posibles valores. Puede especificar la lista de elementos separndolos mediante comas:
select * from emp where deptno = &<name=Department number list=10, 20, 30, 40> order by ename

Esto le permite al usuario seleccionar uno de los cuatro elementos de la lista, o teclear un valor diferente. En este caso es mejor utilizar una consulta de seleccin:
select * from emp where deptno = &<name=Department number list=select deptno from dept order by deptno> order by ename

De forma adicional puede proveer una descripcin para cada elemento:

Gua del usuario de PL/SQL Developer 9.0

89

select * from emp where deptno = &<name=Department number list=10, ACCOUNTING, 20, RESEARCH, 30, SALES, 40, OPERATIONS description=yes> order by ename

A cada elemento le sigue ahora su descripcin, y se aade la opcin description. La lista slo mostrar las descripciones, pero el valor del elemento seleccionado ser el utilizado en el texto SQL resultante: Tambin puede conseguir el mismo efecto con una consulta de seleccin de 2 campos:
select * from emp where deptno = &<name=Department number list=select deptno, dname from dept order by dname description=yes> order by ename

Para restringir al usuario a que slo pueda seleccionar los elementos de la lista, especifique la opcin restricted:
select * from emp where deptno = &<name=Department number list=select deptno, dname from dept order by dname description=yes restricted=yes> order by ename

Ahora el usuario slo puede seleccionar los valores de la lista y no puede introducir ningn otro valor manualmente. Los elementos de una lista pueden depender en ocasiones de los valores de otras variables. Imagine que quiere crear un informe que muestre todas las columnas para una tabla especfica. La tabla se identifica mediante el propietario y el nombre. Para el propietario puede utilizar una lista con todos los usuarios de la base de datos. Para el nombre de la tabla puede consultar la vista all_tables para el usuario seleccionado:
select * from all_tab_columns where owner = &<name="Owner" type="string" list="select username from all_users order by username"> and table_name = &<name="Table" type="string" list="select table_name from all_tables where owner = :owner order by table_name"> order by column_id

Como puede ver, la consulta de seleccin para la segunda lista (table), se refiere a la primera variable a travs de la variable de acoplamiento :owner. Cada vez que el valor de la variable owner cambie, se rellenarn los elementos de la lista de las tablas.

Gua del usuario de PL/SQL Developer 9.0

90

Observe que el nombre de una variable de acoplamiento no puede superar 30 caracteres y no puede contener espacios en blanco ni otros caracteres especiales. Los espacios en blanco en una variable se convertirn en guiones de subrayado. Si el nombre de la variable hubiese sido Owner of the table, entonces el nombre de la variable de acoplamiento hubiese sido: owner_of_the_table. Observe tambin que si el valor de una variable est en blanco, la lista dependiente tambin estar en blanco. No se ejecutar ninguna consulta en esta situacin.

La opcin Checkbox.
Si un usuario quiere seleccionar una de dos posibilidades distintas, puede utilizar la opcin checkbox. Esta opcin necesita ser seguida de valores para las opciones checked y unchecked.
select * from emp order by hiredate &<name=Descending sort order checkbox=desc, asc>

Aunque siempre necesita especificar 2 valores, uno de ellos puede estar vaco:
select * from emp order by hiredate &<name=Descending sort order checkbox=desc,>

Ya que el orden por defecto es ascendente, estos 2 ejemplos son equivalentes.

Opciones de prefijo y sufijo.


Si el valor de la variable est vaco, puede implicar que se omitan ciertas porciones del texto SQL. Considere el ejemplo en que quiere proveer una columna opcional de ordenacin. Si no especifica una columna, la clusula order by debera omitirse. En este caso puede especificar este texto como prefix o suffix de la variable. Si el valor de la variable este vaco, el prefijo y el sufijo de la variable se omitirn:
select * from emp &<name=Descending sort column list=empno, ename, hiredate prefix=order by " suffix= desc>

Si no especifica ningn valor para esta variable, el resultado tambin estar vaco:
select * from emp

Si especifica una columna, el resultado ser:


select * from emp order by empno desc

Observe los espacios despus del prefijo y antes del sufijo. Son importantes, porque el prefijo, el valor de la variable y el sufijo se concatenan exactamente como se ha especificado.

Gua del usuario de PL/SQL Developer 9.0

91

Caracteres de escape.
Si desea utilizar el carcter ampersand (&) en un texto SQL y este no debe interpretarse como una variable de sustitucin, utilice un doble ampersand (&&) en su lugar. El siguiente ejemplo recuperar todos los empleados del departamento R&D:
select * from emp where emp.deptno in (select dept.deptno from dept where dname = 'R&&D') order by empno desc

Si hubiese utilizado el texto R&D, se le habra preguntado por el valor de la variable D.

12.4

Definir el diseo de los informes.

Gua del usuario de PL/SQL Developer 9.0

92

Despus de abrir una nueva ventana de informes, de teclear una instruccin de seleccin y ejecutar el informe, el diseo utilizar las propiedades de estilo por defecto. Tendr un diseo tabulado, con las propiedades estndar de las fuentes, los estilos de las tablas, colores, etc. Para redefinir el diseo estndar cambie a la pestaa Diseo. Para el nuevo informe la pestaa se parecer a la que se muestra a continuacin:

Como puede ver, puede definir varias propiedades para todos los elementos del diseo (el ttulo del informe, las variables, las tablas y los campos). Si quiere definir las propiedades para un campo, debe presionar el botn Refrescar lista de campos en la barra de herramientas:

Ahora todos los campos del conjunto de resultados de la consulta de seleccin sern incluidos en la rejilla de diseo. Si deja las propiedades Estilo, Cabecera o Alineacin de un campo en blanco, se utilizarn las propiedades correspondientes de Default Field. Despus de cambiar las propiedades del diseo, puede ejecutar el informe otra vez para ver el efecto que han tenido los cambios sobre los resultados. Puede, de forma alternativa, habilitar la opcin Actualizar automticamente en la barra de herramientas para refrescar los cambios inmediatamente en los resultados.

Gua del usuario de PL/SQL Developer 9.0

93

Los siguientes captulos describen varias propiedades del diseo con detalle.

Visualizacin.
Esta casilla de comprobacin situada ms a la izquierda en la rejilla de diseo indica si el elemento se mostrar o no. Esto le permite suprimir el ttulo del informe o de las variables y le permite controlar si un campo especifico debe mostrarse o no.

Descripcin.
La descripcin del Report Title se mostrar en la parte superior del informe y despus de cada salto de pgina. La descripcin de las Variables se mostrar encima de las variables. Para campos individuales puede definir una descripcin para sobrescribir el nombre del campo estndar. Esta descripcin ser utilizada para la cabecera de las columnas.

Estilo.
El estilo controla la apariencia de los elementos del diseo. Presione el botn situado dentro de la celda () para abrir el editor de estilos: En la lista situada en la parte superior del editor de estilos puede ver todos los estilos estndar y un estilo personalizado. Puede seleccionar un estilo estndar desde la librera de estilos (vea el captulo 12.5), o puede seleccionar un estilo personalizado desde donde podr cambiar varias propiedades para el diseo del elemento seleccionado. Observe que el sistema de estilos se basa en el estndar de las Hojas de estilo (CSS). Las propiedades que puede ver en el editor de estilo son las ms utilizadas, pero puede aadir otras propiedades y valores debajo de las propiedades estndar. Puede aadir, por ejemplo, una propiedad Height con un valor de 20pt para establecer el alto de la celda a 20 puntos. Visite http://www.w3.org/TR/RECCSS2 para ms informacin acerca de las Hojas de estilo (CSS). Los botones Copiar y Pegar le permiten copiar las propiedades de un estilo, con lo que rpidamente puede derivar un nuevo estilo desde un estilo existente. Si no define nada para el estilo de los campos, el estilo Default Field de la librera estndar ser el utilizado. Puede sobrescribir esto definiendo el estilo. Puede sobrescribir el estilo por defecto a nivel de campo si especifica el estilo correspondiente. Observe que cada cabecera del campo hereda las propiedades del estilo Default Header, con lo que slo necesita sobrescribir las propiedades que desea cambiar. Si, por ejemplo, define el estilo Default Field, como Verdana, 14 puntos, azul y quiere mostrar la columna EMPNO en Verdana, 14 puntos, rojo, slo necesita definir el color a nivel del campo EMPNO. El tipo de letra y el tamao de la letra se heredarn automticamente del nivel Default Field. Los estilos por defecto de varios elementos de diseo se describen en el captulo 12.5.

Gua del usuario de PL/SQL Developer 9.0

94

Cabecera.
De la misma forma que puede establecer el estilo para los datos de contenidos en campos individuales, tambin puede establecer el estilo para sus cabeceras. Si no define ningn estilo, se utilizar el estilo Default Field Header de la librera de estilos. Puede sobrescribirlo definiendo el estilo del elemento de diseo Default Header. Puede sobrescribir este estilo por defecto a nivel de campo si especifica el correspondiente estilo de la cabecera. Observe que cada cabecera hereda las propiedades del estilo Default Header, con lo que slo necesitar sobrescribir las propiedades que desee cambiar.

Alineacin.
Puede definir la alineacin de los elementos del diseo de las siguientes formas: Left El elemento se alinear a la izquierda dentro de su celda. Right El elemento se alinear a la derecha dentro de su celda. Center El elemento se centrar dentro de su celda. Default Los nmeros se alinearn a la derecha y todos los dems elementos se alinearn a la izquierda. None Ningn tipo de alineacin Observe que cuando establece la propiedad Text Alignment para un elemento del diseo. Esta definicin tiene preferencia sobre la opcin de alineacin que ha especificado en la rejilla de diseo. Observe tambin que el efecto de la alineacin de los datos contenidos depende de la propiedad Width del elemento de diseo.

Formato.
Por defecto el formato de un campo se controla por su tipo de datos, la escala y la precisin. Muy a menudo utilizar los campos calculados o agregados, en los cuales la escala y la precisin se desconocen, en este caso puede especificar un formato. La propiedad formato slo tiene efecto para los campos de tipo numrico y fechas. Para campos numricos necesita utilizar el 9 para suprimir los ceros, el 0 para los dgitos normales, la G para el separador de miles, la D para el separador decimal y la E para la notacin cientfica. A continuacin se muestran algunos ejemplos: Formato 999G990D00 9G990 0000 0% 0D000e+00 0D000e-0 Valor = 1234 1,234.00 1,234 1234 1234% 1.234e+03 1.234e3 Valor = 5 5.00 5 0005 5% 5.000e+00 5.000e0 Valor = 0.1 0.10 0 0000 0% 1.000e-01 1.000e-1

Para campos de tipo fecha puede utilizar los formatos de fecha y hora estndar de Windows.

Gua del usuario de PL/SQL Developer 9.0

95

Salto.
La propiedad de diseo Salto le permite estructurar los resultados de sus informes. Supongamos que desea mostrar los departamentos y sus empleados. Puede especificar una consulta como la que se muestra a continuacin:
select d.*, e.* from emp e, dept d where e.deptno = d.deptno order by d.deptno, e.empno

Esto crear un simple informe tabular:

Si especifica la propiedad Salto en la columna LOC, tendr su informe ms estructurado:

Los valores repetidos para los campos hasta LOC (incluido) se borrarn. Resumiendo: cada registro dept slo se mostrar una vez. En este caso es necesario que los registros sean ordenados por

Gua del usuario de PL/SQL Developer 9.0

96

departamento (la columna DEPTNO). Si quiere repetir la cabecera despus de cada salto utilice la opcin Break + Header. Puede seleccionar de forma alternativa un diseo Maestro/Detalle:

Puede tener mltiples saltos en un informe. La clusula order by de la consulta le asegura que el conjunto de resultados est ordenado en todas las rupturas de las columnas.

Suma.
La propiedad Suma le permite incluir una suma para un campo:

Puede especificar que la suma se calcule cuando rompa a nivel grupo, a nivel de informe, o ambos.

Gua del usuario de PL/SQL Developer 9.0

97

Encabezados.
Para definir un encabezado de pgina, primero necesita establecer el tamao de la pgina (vea el captulo 12.6). El ttulo del informe se repetir despus de cada salto de pgina y puede incluir las siguientes variables: OSUser El usuario del sistema operativo. DBUser El usuario conectado a la base de datos. Database La base de datos a la que esta conectado el usuario. Date La fecha actual. Time La hora actual. Page La pgina actual. Para incluir dichas variables en el encabezado de la pgina, preceda el nombre de la variable con el carcter ampersand (&). Por ejemplo:
All employees (&dbuser@&database)

Si ejecuta el informe conectado como el usuario scott a la base de datos Chicago, el encabezado del informe se parecer al siguiente:
All employees (scott@chicago)

Puesto que el informe se formatea como un documento HTML, puede incluir cdigo HTML adicional. Para incluir una imagen podra introducir una etiqueta <img>:
All employees <img src=logo.gif>

Para incluir informacin alineada a la izquierda, centrada o a la derecha puede utilizar una tabla con 3 celdas e incluir la informacin en la celda correspondiente:
<table width="100%"> <tr> <td>&dbuser</td> <td align="center">All Employees</td> <td align="right">&page</td> </tr> </table>

El ejemplo anterior se mostrar de la siguiente forma:


Scout All Employees 1

Observe que puede utilizar las variables y el cdigo HTML en la descripcin de todos los elementos del diseo, pero son ms tiles en el ttulo del informe.

12.5

La librera de estilos.

En lugar de definir y redefinir los mismos estilos una y otra vez puede presionar el botn Librera de estilos para crear y modificar los estilos estndar de los informes. Si, por ejemplo, le gusta que todos los campos que contengan expresiones SQL se muestren con un tipo de letra Courier New de 12 puntos y en color azul, simplemente defina un estilo para esas propiedades en la librera y aplquelo cuando sea necesario. Hay un nmero de nombres de estilo que tienen un significado especial: Nombre Default Report Default Variables Descripcin Description Se aplicar a la cabecera del informe. Se aplicar a todas las variables.

Gua del usuario de PL/SQL Developer 9.0

98

Default Tabular Default Form Default Field Default Field Header

Se aplicar a todas las tablas tabuladas (ej. Registros detalle). Se aplicar a todas los formularios (ej. Registros maestros). Se aplicar a todos los campos que no tengan un estilo definido. Se aplicar a todos los encabezados de los campos que no tengan un estilo definido.

Estos son los estilos por defectos, puede sobrescribirlos en un informe definiendo el estilo para el correspondiente diseo del elemento. Observe que todos los estilos utilizados (estndar y personalizados) se almacenan en el informe. Cuando se ejecuta un informe y este necesita aplicar un estilo, PL/SQL Developer intentar localizarlo en la librera de estilos, si no se encuentra disponible, se emplear el estilo definido en el informe. Esto le asegurar que su informe siempre se mostrar correctamente.

12.6

Opciones.

Puede especificar varias opciones para sus informes:

Parmetros de conexin.
Los parmetros de conexin determinan como se ejecutar la consulta del informe. Si, por ejemplo, es necesario que el informe se ejecute bajo la cuenta SYS, puede introducir el nombre en el campo Usuario. Adicionalmente puede introducir la Contrasea, o dejarla en blanco. Si deja la contrasea en blanco se le preguntar por ella cuando ejecute el informe. Tambin puede especificar la Base de datos en caso de que el informe deba ejecutarse siempre en la misma instancia de la base de datos. De forma alternativa puede introducir el carcter * en el campo Base de datos para indicar que el informe debera ejecutarse en la base de datos actual. La opcin Utilizar esta conexin le permite habilitar o deshabilitar los parmetros de conexin para el informe. Si esta opcin se encuentra deshabilitada, se utilizar la conexin actual de PL/SQL Developer.

Seguridad.
Las opciones de Seguridad le permiten bloquear la definicin del informe (la consulta SQL, el diseo y las opciones) de forma que el usuario no pueda ver o modificar las mismas. Esto puede resultar til si en los parmetros de conexin especifica una cuenta con privilegios de sistema (como SYS) con su

Gua del usuario de PL/SQL Developer 9.0

99

contrasea correspondiente. Si un usuario puede cambiar la consulta SQL, podra ejecutar cualquier instruccin bajo la cuenta SYS si el informe no est bloqueado. Puede establecer la opcin Seguridad a uno de los siguientes valores: Desbloqueado Cualquier usuario puede cambiar la definicin del informe. Bloqueado para otros usuarios Slo puede modificar la definicin del informe si conoce la contrasea del informe, o si se encuentra conectado en PL/SQL Developer con la cuenta que se encuentra especificada en los parmetros de conexin del informe. Bloqueado para todos los usuarios. Al usuario siempre se le preguntar por la contrasea del informe antes de que pueda modificar la definicin del mismo, independientemente de que se encuentre conectado en PL/SQL Developer. Si el informe est bloqueado, el informe (.rep) es encriptado para que no pueda visualizarse o modificarse desde un editor de texto.

Opciones de diseo.
Diseo tipo formulario - Por defecto, todos los registros se muestran mediante un diseo tabular, excepto los informes de tipo maestro-detalle que se muestra con un diseo de tipo formulario. Habilitando esta opcin, todos los registros se mostrarn mediante un diseo tipo formulario. Esto puede ser til si cada registro posee valores muy anchos que no pueden mostrarse en una sola lnea. Margen izquierdo El nmero de pxeles para el margen izquierdo del informe. Esta opcin slo funciona si utiliza Internet Explorer como visor de documentos HTML Margen superior El nmero de pxeles para el margen superior del informe. Esta opcin slo funciona si utiliza Internet Explorer como visor de documentos HTML. Salto de pgina El nmero de lneas necesarias para forzar un salto de pgina. La cabecera del informe se repetir despus de cada salto de pgina. Slo NBSP Cuando esta opcin se encuentra habilitada, todos los espacios en los datos sern convertidos a NBSP (non-breaking spaces) en el documento HTML. Cuando est deshabilitada, se usarn espacios normales. Esto puede afectar el diseo, porque los visores HTML muestran los espacios en blanco consecutivos como un nico espacio en blanco. Incluir SQL Cuando se encuentra habilitada, la consulta SQL se incluye en el archivo HTML generado.

Otras opciones.
Imagen de fondo. La imagen (.jpg o .gif) que debera mostrarse como imagen de fondo de este informe. Puede utilizar el botn de Select file para encontrar la imagen que desee utilizar. Color de fondo Puede especificar el color de fondo que utilizar en el informe.

12.7

El men Informes.

Gua del usuario de PL/SQL Developer 9.0

100

Por defecto el men de Informes se encuentra localizado en el men principal de la aplicacin y contiene slo los informes estndar que se distribuyen como parte de PL/SQL Developer. Dichos informes se encuentran en el subdirectorio Reports, en el directorio de instalacin de PL/SQL Developer. Este men slo es la representacin de la estructura de este directorio. Si selecciona un elemento del men de informes ejecutar dicho informe. Puede aadir o eliminar informes en este directorio, puede tambin configurar el men de informes mediante el elemento Configurar informes situado en el men Herramientas. Si hace clic sobre el se mostrar el siguiente cuadro de dilogo:

La opcin Directorio por defecto de los informes indica si el men de informes debe incluir los informes que se encuentran en el subdirectorio Reports en el directorio de instalacin de PL/SQL Developer. Este directorio contiene los informes estndar. Bajo esta opcin se encuentra la lista de directorios que deben incluirse. Puede introducir los directorios de forma manual o seleccionar los directorios presionando el botn Aadir directorio a la lista que se encuentra en la parte derecha de la ventana. Nota: Los informes y los subdirectorios se combinarn en el men Reports. Debe evitar tener subdirectorios e informes duplicados en la lista de directorios, sino obtendr nombres de men ambiguos en el men Informes La librera de estilo tambin es accesible desde el cuadro de dilogo de configuracin de los informes (vea el captulo 12.5).

Gua del usuario de PL/SQL Developer 9.0

101

13. Grficos.
Para mostrar de forma rpida una representacin grfica de los datos de una consulta o de un informe, puede utilizar la ventana de grficos. Considere la siguiente consulta:

Para ver un grfico de los salarios de cada departamento puede presionar el botn Grfico: El mismo botn se encuentra disponible en la ventana de Informes. Se ejecutar el Asistente de Grficos como se describe ms abajo, o podr seleccionar un estilo predefinido o una plantilla, y las columnas apropiadas sern seleccionadas para el eje X y el eje Y. El Asistente de Grficos le permitir inicialmente seleccionar los datos para el eje X:

Esta ventana muestra todas las columnas y un elemento [Index] , el cual es til si no tiene un valor para el eje X pero desea mostrar datos en el eje Y. En este caso queremos mostrar el campo salario por nmero de departamento, seleccionamos el campo DEPTNO y presionamos el botn Siguiente para seleccionar los datos para el eje Y:

Despus de seleccionar el campo SALARY para el eje Y, puede presionar el botn Siguiente para seleccionar varios estilos para el grfico:

Gua del usuario de PL/SQL Developer 9.0

102

Despus de presionar el botn Finalizar, se mostrara el resultado del grfico creado:

La barra de herramientas de la ventana de grficos, proporciona las siguientes funciones: Rotar Presione el botn izquierdo del ratn y muvalo para rotar el grfico alrededor del eje X y del eje Y. Mover presione el botn izquierdo del ratn y muvalo para mover el grfico a travs de la ventana. Esta funcin est siempre disponible, presionando el botn derecho del ratn, independientemente del estado del botn de la barra de herramientas. Zoom Presione el botn izquierdo del ratn para aumentar o disminuir el zoom del grfico. Profundidad Presione el botn izquierdo del ratn para aumentar o disminuir la profundidad del grfico. 3D Cambia la vista entre el modo 2D y 3D Editar Edita los datos y el diseo del grfico. Guardar como plantilla Guarda el diseo del grafico como una plantilla para futuros grficos basados en los mismos nombres de columnas. Si crea un grfico posteriormente y seleccin Desde plantilla del men contextual del botn Grficos, PL/SQL Developer utilizar la informacin de diseo de esa plantilla. Puede, de manera adicional imprimir un grfico o copiarlo al portapapeles, presionando en botn correspondiente en la barra de herramientas principal.

Gua del usuario de PL/SQL Developer 9.0

103

14. Proyectos.
Para organizar su trabajo de una forma ms eficiente puede utilizar el organizador de proyectos que incluye PLSQL Developer. Un proyecto consiste en un conjunto de archivos de cdigo, objetos de base de datos, notas y opciones. Esto le permite trabajar dentro del alcance de un determinado grupo de objetos en lugar de una base de datos completa o de un determinado esquema. Haciendo ms fcil la bsqueda de los elementos del proyecto que necesite, la compilacin de todos los elementos de proyecto o el mover un proyecto de una base de datos a otra. El proyecto mantiene su configuracin de escritorio. Si vuelve a abrir un proyecto, todos los elementos se abren en la misma posicin en la que estaban cuando se cerr el proyecto. Para que esto ocurra debe habilitar la opcin Guardar la configuracin del escritorio en la ventana de Preferencias .La informacin de la configuracin no se almacena en el archivo de definicin del proyecto ( Project.prj), se almacena el archivo ( Project.dsk). Nota: Para trabajar con proyectos, la opcin Mostrar men de proyectos debe estar habilitada. De no ser as el men principal de la aplicacin no contemplar el elemento Proyecto. Para todos los elementos del men Proyecto existe su correspondiente botn en la barra de herramientas, que pueden aadirse mediante la configuracin de la barra de herramientas en la ventana de Preferencias. (Vea el captulo 20.11).

14.1

Crear un nuevo proyecto.

Para crear un nuevo proyecto, seleccione el elemento Nuevo del men de Proyectos. A continuacin se mostrar el cuadro de dilogo de las opciones de proyecto:

En la pestaa General puede definir la forma en la que desee conectarse al proyecto cuando lo abra. Desde aqu tambin puede definir si desea continuar con el proceso de compilacin de un proyecto si se produce un error durante el mismo. La pestaa Elementos le permite ver los elementos del proyecto. Estos elementos pueden ser archivos de cdigo de las unidades de programa escritos en lenguaje PL/SQL, archivos de prueba, informes, etc. Tambin puede ser un elemento de proyecto un objeto almacenado en la base de datos y que no tenga representacin mediante un archivo. Los elementos del proyecto pueden incluir documentos de Word, HTML, archivos PDF, etc. Cuando crea un proyecto, la lista de elementos, se encuentra vaca. La pestaa Notas le permite mantener notas sobre el proyecto. Esas notas pueden contener cualquier dato, por ejemplo una lista de elementos pendientes, decisiones sobre el proyecto, diseo, etc. La pestaa Elementos pendientes muestra los elementos pendientes para todos los archivos del proyecto. Para ms informacin vea el captulo 15.

Gua del usuario de PL/SQL Developer 9.0

104

14.2

Guardar un proyecto.

Despus de configurar las opciones, puede guardar el proyecto seleccionando el elemento Guardar del men de Proyectos. Esto crear un archivo de proyecto con la extensin .prj. El archivo de proyecto contiene las especificaciones de los elementos, las opciones y las notas. Por lo tanto necesita guardar el proyecto cuando cambie una opcin o cuando modifique las notas. El hecho de guardar un proyecto no implica que se guarden los archivos incluidos en el proyecto.

14.3

Aadir archivos a un proyecto.

Para aadir archivos a un proyecto, primero debe abrir el archivo en el entorno de desarrollo de PL/SQL Developer. Despus de abrir el archivo, simplemente debe presionar el elemento Aadir al proyecto del men Proyectos. Observe que la ruta del archivo se almacena, si es posible, de forma relativa al archivo del proyecto. Por ejemplo, si el archivo de cdigo se encuentra localizado en el mismo directorio que el archivo del proyecto no se guardar la ruta del mismo. Si el archivo se encuentra en un subdirectorio del archivo de proyecto, slo se guardar la ruta del subdirectorio. Si el archivo se encuentra localizado en cualquier otro sitio, se guardar la ruta completa. Esto hace que pueda mover fcilmente el proyecto de un directorio a otro.

14.4

Aadir objetos de la base de datos a un proyecto.

Para aadir objetos de la base de datos a un proyecto, haga doble clic sobre el elemento en el Explorador de Objetos y seleccione el elemento Aadir al proyecto del men contextual. Al igual que los archivos de programa, una unidad de programa en PL/SQL ser habilitada para compilar de forma implcita. Otros objetos, como tablas y secuencias no pueden compilarse De forma alternativa puede arrastrar y soltar un objeto de la base de datos a la ventana de Elementos del proyecto (vea ms abajo). Si el usuario actual es el propietario del objeto de la base de datos, no se guardar la informacin del usuario en el archivo de proyecto. Si por el contrario es otro el usuario que es propietario del objeto, el propietario del objeto se guardar como parte de la especificacin del objeto. Esto hace que pueda mover fcilmente el proyecto de un usuario a otro.

14.5

Trabajar con los elementos del proyecto.

Gua del usuario de PL/SQL Developer 9.0

105

Despus de aadir los elementos al proyecto, puede seleccionar Elementos del proyecto del men Proyectos para trabajar con los elementos del proyecto. La ventana de elementos del proyecto podra ser como la que se muestra a continuacin:

Los primeros cuatro archivos de programa estn habilitados para compilacin. Los dos archivos de prueba, el archivo SQL, las tablas y las secuencias no estn habilitados para la compilacin. Puede mantener la ventana de elementos del proyecto abierta para tener un acceso rpido y fcil a todos los elementos del proyecto. Esta ventana es parte del escritorio, y se abrir automticamente cuando vuelva a abrir el proyecto. Para editar un elemento, simplemente haga doble-clic en l. Si el elemento es un archivo fuente, se abrir en la ventana correspondiente (Ventana de programa, Ventana de prueba, etc.). Si el elemento es un objeto de la base de datos, se abrir el editor apropiado con la definicin del objeto. Si el elemento del proyecto es un archivo externo, se ejecutar la aplicacin correspondiente (ejemplo: Acrobat Reader para un archivo con la extensin .pdf) De manera alternativa puede hacer clic con el botn derecho del ratn en un elemento para abrir el men contextual que se muestra en la foto superior. Aqu puede habilitar o deshabilitar un elemento para compilar o eliminar un elemento del proyecto. Si el elemento es un objeto de la base de datos, podr tener acceso al men contextual de dicho objeto de la misma forma que si hiciese clic con el botn derecho del ratn sobre ese objeto en el Explorador de Objetos.

14.6

Compilar un proyecto.

Para compilar un proyecto, puede seleccionar el elemento Compilar todos o Compilar slo los modificados del men Proyecto. La opcin Compilar todos compilar todos los objetos que se encuentran habilitados para compilar. Los elementos sern compilados en el orden en el que aparecen el la lista de elementos. Si la compilacin de un elemento falla, la opcin de proyecto Parar despus del primer error determinar si se contina o no la compilacin del proyecto:

Gua del usuario de PL/SQL Developer 9.0

106

La funcin Compilar slo los modificados, compilar solamente los elementos que han cambiado desde el ultimo proceso de compilacin. Si una unidad de programa se incluye como objeto de la base de datos y es marcada como objeto no vlido por la base de datos, se volver a compilar. La fecha y hora de la compilacin se almacenar en el archivo de proyecto. Si los elementos habilitados para ser compilados estn actualizados, se marcarn como omitidos en la ventana de progreso de la compilacin.

Gua del usuario de PL/SQL Developer 9.0

107

15. Elementos pendientes.


Puede utilizar los elementos pendientes en cualquier archivo para hacer anotaciones breves sobre algo que necesite hacer en el cdigo, y acceder posteriormente a esa informacin desde la lista de elementos pendientes. Los elementos pendientes se colocan dentro del cdigo del programa o consulta a modo de comentario con un formato especfico y en una localizacin apropiada:

En este ejemplo puede ver el comentario en programa (comienza con el texto TODO:) y el editor de elementos pendientes donde puede introducir el texto, la prioridad, la categora, la fecha de creacin y la fecha de cierre. Los contenidos de la lista de seleccin para los campos prioridad, categora y el usuario pueden ser definidos en la ventana de Preferencias (vea el captulo 20.25). Puede acceder a los elementos pendientes mediante el editor de elementos pendientes, que seria la forma ms correcta para crear, editar, ver o borrar un elemento pendiente. Aunque tambin puede editarlos directamente en el archivo siempre y cuando no modifique el formato. Debido a que los elementos pendientes se almacenan como comentarios dentro del cdigo, siempre se correspondern con el estado actual del cdigo, independientemente de que procedan de la base de datos, del sistema de ficheros o de una versin antigua del sistema de control de versiones. Para acceder a la lista de elementos pendientes de un archivo de cdigo puede cargar lista de elementos pendientes.

Gua del usuario de PL/SQL Developer 9.0

108

Desde aqu podr encontrar rpidamente un elemento pendiente y localizar el archivo haciendo doble clic en el o presionando el botn Ir a. Puede ordenar la lista de elementos pendientes haciendo clic en la cabecera de la columna sobre la que desee ordenar la lista. Haga clic con el botn derecho en la lista para copiar, pegar o exportar.

15.1

Crear un elemento pendiente.

Para crear un elemento pendiente, primero deber colocar el cursor en la posicin adecuada dentro del archivo de cdigo. Aqu ser donde se insertar el comentario. Con lo cual es importante que la posicin del cursor sea cercana a la posicin donde se necesita hacer el trabajo. Despus haga clic con el botn derecho del ratn en esa posicin y seleccione el elemento Aadir elemento del submen Elementos pendientes del men contextual:

Aparecer el editor de elementos pendientes mencionado anteriormente y podr introducir la informacin del nuevo elemento pendiente. Despus de presionar el botn Aceptar el comentario se insertar en la posicin del cursor.

15.2

Editar un elemento pendiente.

Para editar un elemento pendiente, puede hacer clic con el botn derecho del ratn sobre el comentario correspondiente en el archivo y seleccione la opcin Editar elemento del submen Elementos Pendientes o seleccionar el elemento Mostrar lista si no est cerca del elemento pendiente que desea editar. En este caso puede seleccionar el elemento pendiente de la lista y presionar el botn Editar. Ahora puede cambiar las propiedades del elemento pendiente y presionar el botn Aceptar para actualizar el comentario en el cdigo.

Gua del usuario de PL/SQL Developer 9.0

109

15.3

Cerrar un elemento pendiente.

Puede cerrar un elemento pendiente haciendo clic con el botn derecho del ratn sobre el comentario en el cdigo fuente y seleccionando el elemento Cerrar elemento del submen Elementos Pendientes. De forma alternativa puede cargar el editor de elementos pendientes, seleccionar el elemento que desea cerrar y presionar el botn Cerrar.

15.4

Borrar un elemento pendiente.

Puede borrar un elemento pendiente haciendo clic con el botn derecho del ratn en el comentario del cdigo y seleccionar Borrar elemento desde el submen de Elementos pendientes. De forma alternativa puede cargar el editor de elementos pendientes, seleccionar el elemento que desea cerrar y presionar el botn Borrar o simplemente borrar el comentario del cdigo.

Gua del usuario de PL/SQL Developer 9.0

110

16. La lista de conexiones.


La lista de conexiones muestra una lista de conexiones que se han definido con anterioridad o se han utilizado recientemente. Desde esta lista puede establecer la conexin principal, abrir nuevas ventanas para nuevas conexiones, o ver las ventanas que est utilizando una conexin. Puede crear carpetas y subcarpetas para organizar las conexiones en diferentes grupos jerrquicos.

16.1

Usar la lista de conexiones.

Por defecto la lista de conexiones se encuentra anclada en la parte izquierda de la pantalla:

En la parte superior de la ventana puede ver un botn para refrescar la lista de conexiones, para expandir y colapsar el rbol de conexiones, y un botn que le permite definir carpetas y conexiones (para ms informacin puedes ver el captulo 16.2). Los primeros elementos que se ven en la lista de conexiones son las carpetas definidas por el usuario. Estas carpetas pueden contener conexiones que se han definido de forma explicita en la carpeta, y/o conexiones que se han aadido de forma implcita como resultado del criterio utilizado en la carpeta. La carpeta Recientes muestra todas las conexiones que has utilizado recientemente. Cada conexin puede ser de color gris si se agrega implcitamente, o ser de un color definido por el usuario, si se ha definido de forma explcita. Bajo de cada conexin puedes ver y manipular las ventanas que tienen se corresponden con la sesin de base de datos de esa conexin. El icono con forma de llave al lado de cada conexin muestra el estado de la misma:: PL/SQL Developer tiene almacenada la contrasea para esta conexin, y hay una o ms sesiones abiertas con esa conexin. PL/SQL Developer tiene almacenada la contrasea para esta conexin, pero no hay ninguna sesin abierta con esa conexin. PL/SQL Developer no tiene almacenada la contrasea para esta conexin. Cuando intente conectarse, PL SQL Developer le pedir que introduzca la contrasea.

Gua del usuario de PL/SQL Developer 9.0

111

Funciones de conexin
Si hace clic con el botn derecho del ratn sobre una conexin se mostrar el siguiente men contextual:

Los primeros 5 elementos del men le permiten abrir ventanas para la conexin seleccionada. Por ejemplo, si necesita ejecutar un informe utilizando una conexin especfica, haga clic con el botn derecho del ratn, seleccione el elemento de men Informes, y seleccione el informe deseado desde el submen. El elemento de men Mostrar todas las ventanas le mostrar todas las ventanas que pertenecen a la conexin seleccionada, y minimizar todas las ventanas que pertenezcan a otras conexiones. El elemento de men Cerrar todas las ventanas cerrars todas las ventanas que pertenezcan a la conexin seleccionada. El elemento de men Conectar conectar contra la base de datos seleccionada. PL/SQL Developer le pedir la contrasea para poder conectarse contra la base de datos en caso de no tener almacenada la contrasea.. El elemento de men Conectar como principal har que la conexin seleccionada sea la conexin principal. Tambin puede hacer doble-clic sobre una conexin para hacer que dicha conexin sea la conexin principal. El elemento de men Desconectar desconectar todas las sesiones asociadas con la conexin seleccionada. Esto incluye todas las ventanas relacionadas con esa conexin. El elemento de men Eliminar solo est habilitado para las conexiones aadidas de forma implcita. Permite limpiar la carpeta Recientes de conexiones que no utilice frecuentemente.

Funciones de las carpetas


Si hace clic con el botn derecho del ratn sobre una carpeta se mostrar el siguiente men contextual:

El elemento de men Mostrar todas las ventanas mostrar las ventanas que pertenezcan a las conexiones de la carpeta seleccionada y minimizar todas las ventanas que pertenezcan a otras conexiones. El elemento de men Cerrar todas las ventanas cerrar todas las ventanas que pertenezcan a las conexiones de la carpeta seleccionada.

Gua del usuario de PL/SQL Developer 9.0

112

Funciones de las ventanas


Si hace clic con el botn derecho del ratn sobre una ventana se mostrar el siguiente men contextual:

Desde este men contextual puede activar, cerrar y redimensionar la ventana a su estado normal o minimizarla. Puede cambiar la conexin de una ventana seleccionando dicha ventana desde el submen Cambiar conexin. Adems tambin puede cambiar el nombre a una ventana. Esto puede resultar especialmente til si ha creado una nueva ventana y quiere darle un nombre que tenga ms significado, que por ejemplo, el valor por defecto Ventana SQL Nueva. El elemento de men Acortar texto har que se muestren las descripciones de forma acortada. Por ejemplo, la descripcin Programa Window - employee.pck se acortar a P - employee.pck. Para ejecutar una ventana, puede seleccionar el elemento de men Ejecutar.

16.2

Definir carpetas y conexiones.

Gua del usuario de PL/SQL Developer 9.0

113

Para definir sus propias carpetas y conexiones, puede presionar el botn Definir Conexiones situado en la parte superior de la lista de conexiones. PL/SQL Developer le mostrar el siguiente cuadro de dialogo:

En la parte derecha podrs ver los botones para crear una nueva conexin, para crear una nueva carpeta, para borrar la carpeta o conexin seleccionada o para cambiar su ubicacin movindola hacia arriba o hacia abajo. Tambin puede cambiar la ubicacin de un elemento arrastrando y soltando el elemento.

Definir una carpeta


Para definir una carpeta, presione el botn Nueva Carpeta e introduzca la informacin requerida en la seccin Definicin. Por ejemplo:

Los campos Nombre a mostrar e Imagen se mostrarn en la lista de conexiones. Los campos Nombre de usuario, Base de datos, y Conectar como as pueden utilizarse para aadir implcitamente conexiones a la carpeta. En el ejemplo anterior, todas las conexiones hechas a la base de datos chicago se aadirn implcitamente a la carpeta Chicago. Puedes utilizar los caracteres * y ? para los campos Nombre de usuario y Base de datos. Especificando sys* para el Nombre de usuario aadir

Gua del usuario de PL/SQL Developer 9.0

114

implcitamente todas las conexiones con los nombres de usuario que comiencen por sys. Si dejas estos campos vacos, las conexiones se aadirn explcitamente a la carpeta.

Definir una conexin


Para definir una conexin, presione el botn Nueva carpeta e introduzca la informacin necesaria en la seccin Definicin. Por ejemplo:

El Nombre de la conexin y la imagen se mostrarn en la lista de conexiones. Los campos Nombre de usuario, Base de Datos, Contrasea, Conectar como e Identificar externamente se utilizan para definir la informacin de inicio de session para la conexin. Si deja el campo Contrasea vaco, PL/SQL Developer le pedir que introduzca la contrasea cada vez que vaya a utilizar la conexin por primera vez.

Gua del usuario de PL/SQL Developer 9.0

115

17. Conexiones, ventanas, sesiones y transacciones.


PL/SQL Developer proporciona un entorno de desarrollo multisesin, multiconexin y multihilo. Multisesin significa que incluso para la misma conexin, se utilizan sesiones distintas para las ventanas de prueba, de consulta SQL y la ventana de comandos. Por otra parte la compilacin de las unidades de programa se realizar en sesiones distintas. Despus de todo la compilacin es una instruccin DDL y esto conlleva el realizar un commit de la transaccin actual. Esto podra conducir a efectos indeseados si ha compartido la misma sesin con otras ventanas. Multiconexin significa que puede conectar con diferentes cuentas a diferentes bases de datos desde la misma instancia del entorno de desarrollo de PL/SQL Developer. Todas las ventanas pueden ser utilizadas para diferentes conexiones, PL/SQL Developer mostrar la conexin activa en la parte inferior izquierda de la barra de estado. Puede cambiar la conexin de una ventana si hace clic sobre ella y selecciona una conexin diferente desde la lista. Multihilo significa que la ejecucin de las ventanas de prueba, las ventanas de consulta SQL y la ventana de comandos puede correr de forma simultnea, sin bloquearse entre ellas. La ventaja de este sistema es que puede continuar realizando otro trabajo mientras se estn ejecutando otros trabajos, parar una consulta, terminar una sesin, comprobar el comportamiento de los bloqueos de sus unidades de programas, etc.

17.1

La conexin principal

La conexin principal se utiliza para todas las funciones en PL/SQL Developer donde no se ha seleccionado explcitamente una conexin. Por ejemplo, cuando se abre una nueva ventana SQL para ejecutar una consulta, se crear implcitamente una sesin de base de datos para la conexin principal. El explorador de objetos de PL/SQL Developer tambin utiliza la conexin principal. Despus de iniciar una sesin en PL/SQL Developer, ha establecido implcitamente la conexin principal. Posteriormente puede cambiar la conexin principal utilizando de nuevo la funcin Sesin > Conectar, o haciendo doble clic sobre una conexin en la lista de conexiones. En la lista de conexiones la conexin principal se muestra resaltada con el texto en negrita.

17.2

Conexiones de las ventanas

Todas las ventanas pueden tener diferentes conexiones, puede comprobar la conexin de la ventana en la parte inferior izquierda de la barra de estado. Puede cambiar la conexin de una ventana si hace clic en ella y selecciona una conexin diferente desde la lista:

Gua del usuario de PL/SQL Developer 9.0

116

17.3

Modo de la sesin.

Multihilo implica que necesita un entorno multisesin. Despus de todo, el servidor Oracle slo puede ejecutar una instruccin al mismo tiempo por sesin. Las instrucciones slo pueden ejecutarse simultneamente si se ejecutan en sesiones diferentes. No todos los entornos de desarrollo permiten una cantidad ilimitada de sesiones, con lo cual necesita establecer una opcin en la ventana de preferencias que le permita controlar la cantidad de sesiones que puede utilizar PL/SQL Developer. Esta preferencia se llama modo de sesin y puede tener uno de los siguientes valores. Multisesin Cada ventana de prueba, de consulta SQL y ventana de comandos tendr su propia sesin y se utilizar otra sesin para realizar la compilacin. Esta es la configuracin ms flexible y conllevar obviamente a una cantidad de sesiones de base de datos ms grande. Otra posible desventaja es que las actualizaciones que realiza en la ventana X slo sern visibles en la ventana Y despus de que se hallan confirmado (commit). Dual Las ventanas de prueba, de consulta SQL y la ventana de comandos que pertenezcan a la misma conexin compartirn una sola sesin y se utilizar otra sesin para la compilacin. La desventaja de este modo es que slo se puede ejecutar una ventana al mismo tiempo para una conexin. Simple Todas las ventanas y los procesos de compilacin para la misma conexin emplean la misma sesin , haciendo que el control de transacciones sea ms difcil. El depurador est deshabilitado en este modo. Slo emplee este modo si tiene la limitacin de utilizar una sola sesin.

17.4

Ejecutar PL/SQL Developer en modo Multisesin o modo Dual.

Cuando ejecute una ventana de prueba, una ventana de consulta SQL o una ventana de comandos en modo Multisesin o Dual, el botn Cancelar de la barra de herramientas se habilitar para que puede parar la ejecucin en cualquier momento. Esta accin puede que no se complete bien en algunos casos, como pueda ser una situacin de bloqueo. En este caso puede recurrir a terminar la sesin mediante el elemento Terminar del men Sesin, si tiene privilegios para ello. Si mueve el cursor del ratn en una ventana que se est ejecutando actualmente, la forma del cursor cambiar para indicarle que se est ejecutando un proceso y que no puede hacer ningn tipo de modificacin al contenido de la ventana. Una vez finalizada la ejecucin, los botones de Commit y Rollback se habilitan si la transaccin se ha iniciado. En el modo multisesin, cada ventana tiene su propia sesin y por tanto tiene su propia transaccin. Los botones Commit y Rollback reflejan el estado de la transaccin de la ventana activa.

Gua del usuario de PL/SQL Developer 9.0

117

18. Explorar objetos de la base de datos.


Cuando est desarrollando una unidad de programa en una base de datos de Oracle, esta siempre acceder a otros objetos de la base de datos, de otra forma no tendra sentido que estuviese en la base de datos. Para escribir una unidad de programa, necesita conocer exactamente como estn definidos esos objetos. Adems, como programador de Oracle, puede que las siguientes preguntas le resulten familiares: Cual es el tipo de datos de esta columna? Cual es la clave primaria de esta tabla? Cual es el nombre exacto de una funcin empaquetada (packaged function)? Cual es el valor por defecto para este parmetro? Cuales son las causas que activan este disparador (trigger)? Que objetos llaman a esta funcin en la que estoy trabajando? Etctera... Toda esta informacin se encuentra disponible en el diccionario de datos de Oracle y es accesible mediante el Explorador de Objetos de PL/SQL Developer

18.1

Utilizar el Explorador de Objetos.

Puede habilitar el Explorador de Objetos seleccionando el elemento Explorador de Objetos del men Herramientas. El Explorador de Objetos mostrar todos los objetos de la base de datos para la conexin principal que son importantes en el desarrollo de unidades de programa. Puede navegar a travs del Explorador de Objetos de la misma forma que navega por las carpetas del explorador de Windows. Si abre la carpeta Tables, le mostrar todas las tablas que puede ver en la sesin en la que se encuentra conectado. Si abre una tabla especfica se le mostrar todas las propiedades importantes de esa tabla. Si abre la carpeta Foreign Keys debajo de la tabla ver todas las claves forneas de esa tabla, etc. La carpeta Objetos recientes contiene todos los objetos que se han utilizado recientemente en PL/SQL Developer.

Gua del usuario de PL/SQL Developer 9.0

118

Cada vez que abre una carpeta, la informacin de los objetos contenidos en la misma se consulta en el diccionario de datos de Oracle y se almacena en memoria para hacer los siguientes accesos a los datos lo ms rpido posible. Para forzar que el Explorador de Objetos vuelva a consultar esa informacin despus de que algn objeto haya cambiado, necesita seleccionar el objeto modificado y presionar el botn Refrescar en la parte superior izquierda de la ventana. Para refrescar el contenido del Explorador de Objetos presione el botn Refrescar mientras mantiene pulsada la tecla Ctrl. Puede arrastrar y soltar objetos desde el Explorador de Objetos al rea de trabajo. Esto abrir un editor con la definicin del objeto. Puede establecer una preferencia para controlar exactamente que funcin debera realizarse (vea el captulo 20.12). Puede arrastrar y soltar un objeto desde el Explorador de Objetos al editor. Al hacerlo aparecer un men contextual, cuyo contenido depende del tipo de objeto seleccionado. En l puede seleccionar copiar el nombre, las propiedades, la descripcin y cualquier otro tipo de texto importante en el editor, en la posicin en la que lo ha soltado. Si arrastra una carpeta al editor, todos los nombres de los objetos contenidos en esa carpeta se copiarn en el editor. Los nombres los objetos se copiarn separados por comas en una lnea o en mltiples lneas (vea el captulo 20.13). Si presiona con el botn derecho del ratn sobre un objeto aparecer un men contextual que le permitir realizar operaciones sobre el objeto. Las opciones de este men contextual se describen en los prrafos siguientes.

Gua del usuario de PL/SQL Developer 9.0

119

Puede seleccionar varios objetos si utiliza las teclas Control o Shift durante la seleccin. Si selecciona varios objetos, el men contextual slo mostrar los elementos que sean comunes a todos los objetos seleccionados, la funcin de arrastrar y soltar funcionar con todos los objetos simultneamente. Puede presionar Ctrl - y Ctrl + para alinear rpidamente el ancho del Explorador de Objetos con su contenido. Las preferencias del Explorador de Objetos (vea el captulo 20.12), le permiten definir que carpetas son visibles, y en que orden se muestran. Le permite definir tambin el nmero mximo de objetos que se almacenan en la carpeta Objetos recientes. Adems puede definir la accin a realizar cuando haga doble clic con el botn izquierdo del ratn sobre un objeto del Explorador de Objetos. Por defecto esta accin expandir el nodo correspondiente, pero puede definir que le muestre el editor de definicin del objeto o la ventana de propiedades.

Filtrar y buscar objetos.


Para limitar el nmero de objetos en el Explorador de Objetos, puede utilizar el selector de usuario y el selector de filtros situados en la parte superior del Explorador de Objetos. Tambin puede buscar objetos por su nombre. Cuando seleccione un usuario, el Explorador de Objetos de PL/SQL Developer solo le mostrar los objetos que son propiedad del usuario seleccionado. Puede seleccionar <USUARIO ACTUAL> para ver nicamente los objetos que son propiedad del usuario conectado actualmente . Puede seleccionar el elemento <TODOS LOS USUARIOS> para ver todos los objetos de todos los usuarios de la base de datos. Observe que esta ultima opcin puede degradar el rendimiento de PL/SQL Developer cuando abra una carpeta en el Explorador de Objetos. Seleccione un filtro para limitar los objetos del explorador a los que nicamente cumplan ese criterio especfico. En el filtro tambin se define el orden en el que aparecen los objetos dentro de una carpeta en el explorador. Vea el captulo 18.2 para ver como puede crear sus propios filtros. Para buscar un objeto por su nombre, introduzca parte de su nombre en el campo de texto y presione la tecla Enter. PL/SQL Developer solo realizar la bsqueda por nombre en las carpetas que se encuentren abierta.

Crear un nuevo objeto.


Para crear una nueva unidad de programa, tabla, vista, secuencia o sinnimo haga clic con el botn derecho del ratn sobre un objeto de ese tipo en la carpeta principal y seleccione el elemento Nuevo desde el men contextual. Si utiliza la opcin Nuevo para una unidad de programa se crear una nueva ventana de programa. El contenido inicial de esa ventana se leer de una plantilla especfica, tal como se describe en el captulo 26. Las vistas se pueden crear en una ventana de consulta SQL. El contenido inicial se leer de una plantilla especfica, de la misma forma que las unidades de programa. Las tablas, secuencias y sinnimos se mostrarn en una ventana especfica del editor. La creacin de tablas, secuencias y sinnimos se describe con detalle en el captulo 9.

Duplicar un nuevo objeto.


Puede duplicar una tabla, una secuencia o un sinnimo seleccionando el elemento Duplicar del men contextual. Esta accin mostrar la ventana del editor con todas las propiedades del objeto seleccionado, a excepcin del nombre. Esto puede ser til para crear un objeto idntico en el que poder realizar algunas pruebas.

Gua del usuario de PL/SQL Developer 9.0

120

Copiar un elemento o carpeta.


Para copiar el nombre de un objeto o los nombres de los objetos en una carpeta, haga clic con el botn derecho del ratn y seleccione el elemento Copiar valores separados por comas. Esta accin colocar el nombre o los nombres de los objetos seleccionados en el portapapeles. Puede establecer una preferencia del programa para controlar si los nombres de objetos se colocan en una sola lnea o en varias (vea el captulo 20.13). Ver las propiedades de un objeto. Para ver las propiedades de un objeto concreto, seleccione el elemento Propiedades desde el men contextual. Las propiedades que pueda visualizar dependern del tipo de objeto y de la versin del servidor de Oracle. Las propiedades se muestran en una ventana modal que puede situar en cualquier parte de la pantalla. Puede mantener la ventana de propiedades visible (permaneciendo por encima de las otras ventanas) y continuar trabajando en otra ventana. Puede tambin recoger y desplegar la ventana presionando el botn que se encuentra en la parte derecha de la ventana. De esta forma ahorra espacio en la pantalla y mantiene la ventana de propiedades visible en cualquier momento.

Ver la descripcin de los objetos.


Las tablas, vistas, funciones, procedimientos, paquetes, tipos y mtodos pueden describirse de la misma forma que en SQL*Plus, si selecciona el elemento Describir desde el men contextual. La descripcin de los objetos se mostrar en una ventana modal como la que se mencion previamente para las propiedades de los objetos. Para las tablas y las vistas se muestran todas las columnas y sus respectivas propiedades en la ventana de propiedades. Para las funciones, procedimientos y miembros, se muestran los parmetros y sus propiedades. Para los paquetes se muestran las funciones, procedimientos, variables, tipos y constantes. Para los tipos se muestran los mtodos y los atributos.

Puede seleccionar las filas, columnas o rangos de celdas en una ventana de descripcin. Para seleccionar las filas o las columnas, haga clic en la cabecera de una celda o de una columna y arrastre el puntero del ratn para resaltar la seleccin. Para seleccionar un rango especfico de celdas presione el botn del ratn y arrastre el mismo para resaltar la seleccin. La seleccin puede copiarse o imprimirse. Para hacer una copia de los valores seleccionados separados por comas, haga clic con el botn derecho del ratn sobre la ventana y seleccione el elemento correspondiente del men contextual. Para exportar la descripcin a un archivo CSV, TSV, HTML o XML, seleccione el elemento correspondiente desde el submen Exportar. Para imprimir el contenido de la ventana de descripcin, seleccione el elemento Imprimir. Si hace doble clic en una celda de la ventana de descripcin, el contenido de la celda se copiar en la ventana que se encuentre visible en el escritorio. Para ordenar las filas de la ventana de descripcin, presione el botn de la columna sobre la que quiera ordenar las filas.

Gua del usuario de PL/SQL Developer 9.0

121

Ver la definicin de un objeto.


Todos los tipos de objetos tienen algn tipo de definicin. Para ver esta definicin, puede seleccionar el elemento Ver del men contextual. Este elemento esta disponible para todas las unidades de programa, vistas, tablas, secuencias y sinnimos. Si selecciona el elemento Ver para un elemento de una tabla como una columna o un ndice, le mostrar la definicin de la tabla e ir al elemento seleccionado. Las unidades de programa se mostrarn en la ventana de programa, las vistas se mostrarn en la ventana de consulta SQL, las tablas, secuencias y sinnimos se mostrarn en editores especficos. Las tablas, secuencias y sinnimos se describen con ms detalle en el captulo 9.

Editar la definicin de un objeto.


Puede editar la definicin de un objeto directamente desde la base de datos seleccionando el elemento Editar desde el men contextual de dicho objeto. Puede deshabilitar esta caracterstica mediante una opcin, como se describe en el captulo 20.2.

Renombrar un objeto.
Puede renombrar las tablas, vistas, secuencias y sinnimos directamente seleccionando el elemento Renombrar desde el men contextual de dicho objeto. Si utiliza la versin de Oracle 9.2 o una superior puede tambin renombrar las columnas. Aparecer un cuadro de dilogo con el nombre antiguo en donde puede modificar y aplicar los cambios.

Eliminar un objeto.
A veces es necesario eliminar un objeto. Puede que se haya quedado obsoleto o que haya cambiado de un tipo de objeto a otro (ejemplo de una funcin a un procedimiento). Para realizar esta tarea, seleccione el elemento Eliminar desde el men contextual de dicho objeto.

Explorar objetos relacionados.


La mayora de los objetos tienen o hacen referencia a otros objetos. Seleccionando el elemento Explorar puede localizar rpidamente los elementos relacionados en el Explorador de Objetos.

Compilar un objeto.
A menudo los objetos de la base de datos hacen referencia a otros objetos de la misma. Cuando esos objetos referenciados cambian, los objetos pueden volverse no validos. En este caso una marca roja se muestra en el icono de ese objeto. Para volver a compilar los objetos no validos, seleccione el elemento Compilar desde el men contextual. Si el proceso de compilacin termina correctamente, la marca desaparecer. Si el proceso falla, puede ver los errores si selecciona el elemento Ver del men contextual.

Aadir el cdigo de un objeto al editor.


El cdigo de una unidad de programa puede aadirse a una ventana de programa o de prueba si selecciona el elemento Aadir cdigo al editor. Para una ventana de programa, el cdigo se aadir en una nueva pgina despus de la unidad de programa actual. De esta forma podr crear un archivo de programa que contenga varias unidades de programa que ya existan en la base de datos. Para una ventana de prueba, el cdigo se aadir despus del cdigo seleccionado durante una sesin de depuracin. De esta forma puede incluir el cdigo de la ventana de prueba y acto seguido establecer o borrar puntos de interrupcin antes de entrar en la unidad de programa.

Gua del usuario de PL/SQL Developer 9.0

122

Aadir la informacin de depuracin a un objeto.


Si quiere ver o establecer variables durante una sesin de depuracin, el objeto que contiene esas variables necesita contener informacin de depuracin. Puede aadirla de forma manual si selecciona el elemento Aadir informacin de depuracin. Este elemento de men tiene una marca para comprobar si el objeto ya contiene informacin de depuracin. La seccin de preferencias del depurador tiene una opcin que le permite aadir de forma automtica la informacin de depuracin cuando se compila una unidad de programa, en cuyo caso slo necesita utilizar este elemento para las unidades de programa que no lo tengan en desarrollo.

Ver y establecer los indicadores de compilacin condicional.


Utilice el elemento de men PL/SQL CCFlags para ver o establecer los indicadores compilacin condicional para una unidad de programa:

En esta pantalla puede ver los indicadores de compilacin para una unidad de programa. Desde aqu tambin puede cambiar sus valores, renombrarlos, aadir nuevos indicadores o borrar alguno de los indicadores existentes. Una vez haya realizado los cambios presione el botn Aplicar para aplicar los cambios a los objetos de la base de datos. Observe que, realizar cambios en los indicadores de compilacin causar que las unidades de programa se vuelvan a compilar, esto puede provocar que se conviertan en unidades de programa no vlidas.

Compilar objetos referenciados.


Cuando modifica un objeto que es referenciado por otras unidades de programas o vistas, los objetos referenciados se convierten en no validos. Al volver a compilarlos los convertir en validos o se mostrarn todas las incompatibilidades. Puede hacerlo si selecciona el elemento Compilar objetos referenciados. Esto mostrar la ventana de Compilar objetos no validos, que se ejecutar automticamente. Para ms informacin sobre esta herramienta vea el captulo 21.3.

Probar las unidades de programa.


Para probar una unidad de programa (una funcin o procedimiento) puede utilizar los archivos de prueba, que se describen con ms detalle en el captulo 5. Un archivo de prueba contiene una llamada a una funcin o a un procedimiento. Necesita establecer los parmetros de entrada y ver los parmetros de salida y los resultados de la funcin despus de la ejecucin del archivo de prueba. Desde el Explorador de Objetos puede seleccionar el elemento Probar para crear un archivo de prueba.

Gua del usuario de PL/SQL Developer 9.0

123

Consultar tablas y vistas.


Para ver los datos en una tabla o vista, seleccione el elemento Consultar datos desde el men contextual. Una ventana de consulta SQL se crear con una consulta de seleccin para la tabla o vista seleccionada en el Explorador de Objetos. Si tiene la opcin Ejecutar consultas automticamente habilitada, la consulta de seleccin se ejecutar inmediatamente.

Editar los datos de las tablas.


Si quiere editar los datos de una tabla, puede seleccionar el elemento Editar datos si hace clic con el botn derecho del ratn sobre ella en el Explorador de Objetos. Se crear una ventana de consulta SQL que incluye el campo rowid. Si tiene la opcin Ejecutar consultas automticamente habilitada, la consulta se ejecutar inmediatamente. La ventana de consulta SQL se pone en modo de edicin despus de que se hayan buscado los registros.

Exportar tablas.
Para exportar la definicin y los datos de una tabla, seleccione el elemento Exportar datos. Esto cargar la herramienta Exportar tablas para la tabla seleccionada. Para ms detalles vea el captulo 21.4.

Habilitar y deshabilitar restricciones y disparadores.


Los disparadores y las restricciones (triggers y constraints) pueden habilitarse o deshabilitarse desde el Explorador de Objetos si selecciona el elemento Habilitar o Deshabilitar desde el men contextual. Los disparadores y las restricciones deshabilitados se muestran en color gris.

Ejecutar un trabajo de la base de datos.


Los trabajos enviados a la base de datos a travs del paquete dbms_job, pueden ejecutarse explcitamente si selecciona el elemento Ejecutar desde el men contextual.

Habilitar y deshabilitar operaciones de encolado y desencolado.


Para las listas puede habilitar y deshabilitar operaciones de encolado (aadir) y desencolado (eliminar) seleccionando el elemento correspondiente desde el men contextual. Una marca de comprobacin antes del elemento del men indica si la operacin esta habilitada.

Aadir un objeto a una carpeta definida por el usuario.


Para aadir un objeto a una carpeta definida por el usuario (vea el captulo 18.3), seleccione el elemento Aadir a la carpeta y despus seleccione la carpeta desde el submen.

Recuperar o eliminar un objeto.


Si esta utilizando Oracle10g o una versin posterior, puede restaurar o purgar las tablas que ha eliminado con anterioridad, si esta caracterstica se encuentra habilitada en la base de datos. Desde un objeto situado en la carpeta Papelera de reciclaje puede seleccionar Purgar para eliminar la tabla y sus datos de forma permanente o puede seleccionar Restaurar para restaurar el objeto con el nombre original o con un nuevo nombre.

18.2

Configurar los filtros del Explorador de Objetos.

Gua del usuario de PL/SQL Developer 9.0

124

Puede definir los filtros que determinan que objetos son visibles en las carpetas del sistema del Explorador de Objetos, y en que orden se muestran esos objetos. La lista de seleccin que se encuentra situada en la parte superior del Explorador de Objetos le permite cambiar rpidamente entre los distintos tipos de filtros. Los filtros del Explorador de datos pueden definirse seleccionando el elemento Configurar filtros del explorador en el men Herramientas o presionando el botn filtros en la parte superior del Explorador de Objetos .Puede modificar, crear y borrar los filtros en este dilogo:

Un filtro se constituye con las siguientes propiedades: Descripcin - El valor de esta propiedad es el que se muestra en la lista de seleccin situada en la parte superior del Explorador de Objetos. Usuario Define para que usuario de Oracle es valido el filtro. Si deja este campo en blanco, el filtro ser valido para todos los usuarios de Oracle. Si especifica un usuario y una base de datos (por ejemplo scott@chicago), el filtro slo ser visible si se ha conectado con este usuario y base de datos. Defecto - Si selecciona esta opcin, el filtro seleccionado se activar cuando inicie PL/SQL Developer. Puede definir un filtro por defecto para cada usuario. Los filtros por defecto se muestran resaltados en negrita. Clusula Where - Un filtro define una consulta sobre la vista all_objects (o dba_objects). La clusula where de la consulta puede utilizarse para restringir el conjunto de resultados de la misma. Puede utilizar las siguientes columnas: Owner El propietario del objeto. Object_name El nombre del objeto. Objet_type El tipo del objeto (table, view, package, etc.). Status El estado del objeto (VALID / INVALID). Created Fecha/hora de creacin del objeto. Last_ddl_time Fecha/hora del ltimo objeto compilado. Clusula Order by Use las columnas de la vista all_objects para ordenar los objetos en el Explorador de Objetos.

18.3

Configurar las carpetas del Explorador de Objetos.

Gua del usuario de PL/SQL Developer 9.0

125

Las carpetas del Explorador de Objetos pueden personalizarse de varias formas. Puede cambiar el orden de las carpetas en el Explorador de Objetos , el color de cada carpeta, la jerarqua de la carpeta o puede ocultar carpetas basndose en la conexin actual contra la base de datos. Puede definir tambin sus propias carpetas y rellenarlas con objetos. Puede aadir tambin de forma especifica objetos a una carpeta, definir una consulta para rellenarlas, o una combinacin de ambos. La consulta ser ejecutada cuando abra la carpeta en el Explorador de Objetos. Los carpetas del Explorador de Objetos pueden definirse si selecciona el elemento Configurar carpetas del explorador en el men Herramientas o si presiona el botn Carpetas situado en la parte superior del Explorador de Objetos. Puede modificar, crear y eliminar carpetas en este cuadro de dilogo:

En la parte superior del cuadro de dilogo puede ver todas las carpetas y su jerarqua. El color rojo indica que es una carpeta del sistema mientras que el color negro indica que es una carpeta definida por el usuario. Existen algunas restricciones que se aplican a las carpetas del sistema. En la parte derecha de la lista de carpetas hay 4 botones disponibles, para aadir una carpeta en la posicin de la carpeta seleccionada, para borrar una carpeta, o para moverla hacia arriba o hacia abajo en la lista. El orden en el que se visualizarn las carpetas en el Explorador de Objetos es el mismo orden que se muestra en la lista. En la parte inferior del cuadro de dilogo puede cambiar la definicin de la carpeta seleccionada: Tipo Muestra el tipo de carpeta: Definida por el usuario o del sistema (User Defined or System). Color Selecciona el color de la carpeta. Las subcarpetas heredarn el mismo color. Visible Deshabilite esta opcin para hacer la carpeta invisible en el Explorador de Objetos. Puede usarse para ocultar carpetas especficas del sistema. Esta opcin sobrescribe la opcin Conexin. Descripcin La descripcin de la carpeta que se mostrar en el Explorador de Objetos. Esta descripcin no puede cambiarse en el caso de las carpetas del sistema.

Gua del usuario de PL/SQL Developer 9.0

126

Conexin Define que usuarios de Oracle podrn ver esta carpeta. Si deja esta opcin en blanco, la carpeta se mostrar para todos los usuarios. Si especifica un usuario y una base de datos (scott@chicago), la carpeta slo ser visible si se ha conectado con este usuario y esta conexin. Puede utilizar caracteres comodn ? y *. Por ejemplo *@prd para todos los usuarios de la base de datos prd. Crear en Para colocar de forma jerrquica una carpeta dentro de otra, puede seleccionar la carpeta de nivel superior donde se crear. Para limpiar la seleccin, presione el botn Limpiar. Eliminar propietario El Explorador de objetos no mostrar el propietario de los objetos en esta carpeta. Esta opcin es especialmente til para las carpetas donde se conoce al propietario de los objetos (por ejemplo: Tablas y vistas de Scott). Clusula Where La clusula where puede usarse con carpetas basadas en consultas para restringir la seleccin de objetos. En el ejemplo superior, la clusula where esta establecida con el campo status = INVALID para rellenar el contenido de la carpeta con todos los objetos marcados como no validos por el servidor Oracle. Clusula Order By - La clusula order by puede utilizarse para las carpetas basadas en consultas para definir el orden de los objetos seleccionados. Objetos Para carpetas manuales puede definir la lista de objetos. Puede colocar un objeto en cada lnea con un formato owner.name. Por ejemplo: SCOTT.EMP. Normalmente es ms conveniente aadir un objeto individual desde el Explorador de Objetos haciendo clic con el botn derecho del ratn sobre un objeto y seleccionando Aadir a la carpeta desde el men contextual. La clusula where y la clusula order by pueden incluir cualquier expresin SQL y cualquier columna de la vista all_objects. Esto funciona de la misma forma para los filtros del Explorador de Objetos. Vea el captulo 18.2 para ms detalles. Observe que los filtros no afectan a los objetos contenidos en las carpetas definidas por el usuario.

Gua del usuario de PL/SQL Developer 9.0

127

19. Explorador archivos.


Si accede con frecuencia a sus archivos y scripts desde una ubicacin determinada(como por ejemplo, directorios de proyecto o de herramientas, etc.), puede utilizar el Explorador de Archivos para acceder a los mismos de una forma fcil y rpida. En lugar de utilizar un cuadro de dialogo de seleccin de archivos para abrir y guardar los archivos puede utilizar el Explorador de Archivos de PL/SQL Developer para abrirlos directamente desde su rea de trabajo:

Desde el Explorador de Archivos puede acceder a los archivos y directorios a travs de ubicaciones definidas por el usuario en su estacin de trabajo como desde la red de su empresa. Desde aqu puede abrir, guardar, renombrar y borrar archivos. Puede utilizar el Explorador de Archivos, como una ventana flotante o utilizar anclada a uno de los laterales de PL/SQL Developer. Vea el captulo 28 para ms informacin sobre como anclar las diferentes herramientas en su entorno de desarrollo. Por defecto, el Explorador de Archivos, se encuentra situado en la segunda pestaa, justo despus de la pestaa del Explorador de Objetos.

19.1

Configurar el Explorador de Archivos.

Cuando PL/SQL Developer muestra el Explorador de Archivos por primera vez, este aparecer vaco. Para rellenar el Explorador de Archivos, debe definir primero una o ms ubicaciones. Para ello, seleccione la opcin Ubicaciones desde el men Herramientas o presione el botn Ubicaciones situado en la parte superior del Explorador de Archivos.PL/SQL Developer le mostrar la siguiente pantalla:

Gua del usuario de PL/SQL Developer 9.0

128

Cada ubicacin que defina en esta pantalla, aparecer en la raz del rbol de directorios del Explorador de Archivos. Para cada ubicacin puede definir las siguientes propiedades: Path - La ruta local o de red donde se encuentran ubicados los archivos y directorios. El Explorador de Archivos mostrar los archivos y directorios a partir de la ruta definida.

Incluir subdirectorios Cuando esta opcin se encuentre habilitada PL/SQL Developer mostrar los subdirectorios en el Explorador de Archivos. Incluir las siguientes extensiones Aqu puede indicar uno o ms filtros para las extensiones de los archivos para obligar a PL/SQL Developer a incluir nicamente estos archivos en el Explorador de Archivos. Puede utilizar uno o ms filtros si los separa mediante un punto y coma (ejemplo: *.sql;*.cmd) . Si omite estos filtros PL/SQL Developer le mostrar todos los archivos. Excluir las siguientes extensiones - Aqu puede indicar uno o ms filtros para las extensiones de los archivos para obligar a PL/SQL Developer a excluir estos archivos en el Explorador de Archivos. Puede utilizar uno o ms filtros si los separa mediante un punto y coma (ejemplo: *.tmp;*.dat) . Si omite estos filtros PL/SQL Developer no excluir ningn archivo . Por defecto PL/SQL Developer excluir los archivos *.info y *.~*. El primer filtro excluye los archivos de sistema de PL/SQL Developer, que contienen informacin sobre el estado de la aplicacin y el segundo filtro excluye las copias de seguridad de PL/SQL Developer. Descripcin Descripcin de la ubicacin que se muestra en el Explorador de Archivos. Color Color de los iconos de la ubicacin y sus subdirectorios. Padre La ubicacin superior de la ubicacin que esta creando. Cuando seleccione esta opcin, PL/SQL Developer no mostrar la ubicacin en la raz del Explorador de Archivos, sino que la crear como una ubicacin dentro de la ubicacin padre. Puede crear, borrar y ordenar las ubicaciones utilizando los botones correspondientes situados en la parte derecha de la lista de ubicaciones.

19.2

Utilizar el Explorador de Archivos.

Gua del usuario de PL/SQL Developer 9.0

129

Despus de que haya definido todas las ubicaciones, el Explorador de Archivos le mostrar todos los archivos, directorios, subdirectorios y ubicaciones. Si hace doble clic en un archivo, este se abrir en una nueva ventana en su rea de trabajo en modo de edicin. Si hace clic con el botn derecho sobre un archivo se mostrar el siguiente men contextual:

Abrir Si el elemento seleccionado es un archivo, PL/SQL Developer lo abrir en modo de edicin. Si por el contrario es un directorio, subdirectorio o una ubicacin PL/SQL Developer expandir el nodo correspondiente en el rbol de directorios del Explorador de Archivos. Abrir como Muestra un submen donde puede seleccionar como abrir el archivo, como una Ventana de programa, una Ventana de SQL o una Ventana de comando. Abrir con Abre el archivo con cualquier programa. Abrir en el explorador Abre el Explorador de Windows para el archivo o directorio seleccionado. Renombrar Este elemento le permite cambiar el nombre al elemento seleccionado. Nuevo archivo Este elemento le permite crear un nuevo archivo en la ubicacin o directorio seleccionado. Nuevo directorio Este elemento le permite crear un nuevo directorio en la ubicacin o directorio seleccionado. Eliminar Elimina el archivo o directorio seleccionado. Guardar ventana en nombre Guarda el contenido de la ventana actual (la que se encuentra visible en el momento de la seleccin de este elemento) en la ubicacin o directorio seleccionado. Esto le permite guardar rpidamente el contenido de la ventana sin preocuparse del origen del contenido. Guardar ventana como nombre de archivo - Guarda el contenido de la ventana actual (la que se encuentra visible en el momento de la seleccin de este elemento) como el archivo seleccionado. Observe que esta accin sobrescribir el contenido del archivo seleccionado. Info Este submen le muestra informacin relativa al elemento seleccionado, como la ruta completa, la fecha de creacin y el tamao.

Gua del usuario de PL/SQL Developer 9.0

130

Propiedades Muestra las propiedades del archivo o directorio. Adicionalmente el cuadro de dialogo le permitir establecer los diferentes atributos y permisos. Los archivos que sean de solo lectura tendrn una marca en rojo en el icono del archivo mostrado en el explorador (Puede ver los ejemplos para los archivos Department.spc y Employees.spc en el ejemplo anterior). Si los archivos definidos dentro de las diferentes ubicaciones son creados, borrados o renombrados con otras herramientas, PL/SQL Developer actualizara automticamente su contenido.

Gua del usuario de PL/SQL Developer 9.0

131

20. Preferencias.
La herramienta Preferencias le permite establecer varias opciones de PL/SQL Developer. Cuando seleccione este elemento, aparecer el siguiente cuadro de dilogo:

A la izquierda puede seleccionar una pgina de preferencias entre las 6 categoras disponibles (Oracle, Interfaz de usuario, Tipo de ventanas, Herramientas, Archivos y Otros). En la cabecera puede seleccionar un conjunto de preferencias, que define las prioridades establecidas a un cierto nivel. Por defecto, definir sus preferencias personales para su usuario de Windows (en la captura de pantalla superior para el usuario Mark), pero tambin puede definir sus preferencias personales para una conexin especfica de Oracle. Cada vez que utilice dicha conexin al iniciar la sesin con la base de datos, el conjunto de preferencias correspondiente ser utilizado. Adems el administrador del sistema puede definir las preferencias por defecto a un nivel global y a los niveles de conexin de Oracle. Para una informacin ms detallada acerca del ajuste de prioridades, vea el captulo 20.34. Debajo del conjunto de preferencias puede ver las opciones para la pgina de preferencias seleccionada (en la captura de pantalla superior para Oracle Conexin). Para cada una de las opciones puede ver su valor actual. Un indicador de color verde situado en la parte izquierda de la preferencia indica que el valor esta establecido en el conjunto de preferencias actual. Si el indicador es de color negro, el valor se hereda de un conjunto de preferencias distinto (site el cursor del ratn sobre el indicador para ver el nombre del conjunto de preferencias). Para deshacer los cambios realizados en el valor heredado (en otras palabras: eliminarlo del conjunto de preferencias actual), puede hacer clic en el indicador de color verde. Los siguientes captulos describen cada una de las pginas de la ventana preferencias con detalle.

20.1

Oracle - Conexin

Gua del usuario de PL/SQL Developer 9.0

132

Modo de sesin - Controla el nmero de sesiones distintas de la base de datos que puede utilizar PL/SQL Developer simultneamente. Esta opcin se describe con ms detalle en el captulo 17. Al desconectar la transaccin actual - Cuando se desconecta una sesin que tiene una transaccin activa, la accin por defecto es la de ejecutar la instruccin commit sobre dicha transaccin. Mediante esta opcin puede definir si a una transaccin activa se le ejecuta una instruccin rollback o si PL/SQL Developer debe preguntarle por una confirmacin. Comprobar conexin - Cuando esta opcin se encuentra habilitada, PL/SQL Developer comprobar cada 60 segundos si permanece activa la conexin con la base de datos. Si su sesin ha terminado o el servidor se ha apagado, PL/SQL Developer desconectar automticamente la sesin. Oracle Home - Por defecto PL/SQL Developer utilizar el directorio principal Oracle Home de su PC. Puede definir cual es su directorio Oracle Home por defecto mediante la herramienta Oracle Home Selector (una utilidad estndar de Oracle). Puede forzar a PL/SQL Developer a utilizar un directorio Oracle Home concreto si selecciona uno de la lista. Versin OCI - PL/SQL Developer utilizar la versin ms reciente de SQL*Net o Net8 que se encuentre instalada en su sistema. Si esta versin de SQL*Net causa problemas, puede forzar a PL/SQL Developer a utilizar otra versin. El nombre de la DLL ser parecido a ora72.dll (para SQL*Net 2.2), ora73.dll (para SQL*Net 2.3), oci.dll (para Net8 8.1.x), etc. Estas DLL se encuentran en el directorio Bin de Oracle. Forzar compatibilidad OCI7 - Algunas versiones de Net8 (8.0.3 y 8.0.4) poseen algunos fallos que podran causar problemas a PL/SQL Developer. Establecer esta opcin provocar que se utilicen en su lugar las funciones ms slidas de SQL*Net 2 de Net8. Un ejemplo de un fallo de programacin en Net8 es que devuelve incorrectamente los modos de los parmetros cuando describe procedimientos y funciones. Una desventaja de esta opcin es que no puede consultar columnas de tipo BLOB, CLOB y BFILE y que PL/SQL Developer no puede mostrar informacin sobre los paquetes encriptados mediante la funcin Describe. Permitir mltiples conexiones - Cuando esta opcin est habilitada, PL/SQL Developer le permitir utilizar mltiples conexiones desde la misma instancia. Cuando esta opcin est

Gua del usuario de PL/SQL Developer 9.0

133

deshabilitada, al cambiar de conexin se desconectarn todas las dems conexiones y se establecer la conexin seleccionada como conexin principal. Almacenar historial reciente - Cuando esta opcin est habilitada, las conexiones utilizadas recientemente que se encuentran en la carpeta Recientes en la lista de conexiones sern almacenadas en PL/SQL Developer, y sern restauradas cuando se vuelva a ejecutar la aplicacin. Cuando esta opcin este deshabilitada, la carpeta Recientes estar vaca cuando ejecute PL/SQL Developer de nuevo. Almacenar con contrasea - Cuando esta opcin est habilitada, el historial de conexiones recientes estar protegido mediante una contrasea.

20.2

Oracle - Opciones

Permitir la edicin del cdigo directamente desde la base de datos - Esta opcin controla si el cdigo de una unidad de programa o de una vista puede editarse directamente desde el Explorador de Objetos, o requiere que se abra desde el sistema de archivos. Guardar el cdigo editado en la base de datos a un archivo - Si edita una unidad de programa desde el cdigo almacenado en el diccionario de datos de la base de datos (haciendo clic con el botn derecho del ratn en la unidad de programa y seleccionando el elemento Editar desde el men contextual), puede evitar que se le pregunte si desea guardar las modificaciones en un archivo si deshabilita esta opcin. Si ha editado la unidad de programa desde el sistema de archivos, siempre se le preguntar si desea guardar los cambios. Compilar archivos de slo lectura - Si el cdigo es de slo lectura, no puede compilarse cuando se cargue en una ventana de una unidad de programa. Esta opcin es til cuando est utilizando un sistema de control de versiones, el cual deja a menudo una copia de slo lectura de un archivo de cdigo en el directorio de trabajo. Dicha copia no puede ser compilada, ya que podra interferir en el trabajo de otros miembros del proyecto. Confirmar instrucciones de commit y rollback - Cada vez que ejecute una instruccin commit o rollback sobre una transaccin presionando los botones correspondientes, se le pedir la confirmacin para dichas operaciones. Deshabilitando esta opcin ejecutar las instrucciones commit o rollback sin que se le pida ningn tipo de confirmacin. Utilizar vistas de tipo DBA - Si establece esta opcin PL/SQ Developer intentar utilizar vistas de tipo DBA (dba_objects, dba_triggers, etc.), en lugar de utilizar vistas de tipo ALL (all_objects, all_triggers, etc.). Las vistas de tipo DBA muestran ms informacin que las vistas de tipo ALL si un desarrollador tiene ciertos privilegios del sistema. Obtener estadsticas automticamente - Esta opcin controla si el informe de estadsticas se genera por cada instruccin SQL y archivo de prueba ejecutado. Si deshabilita esta opcin, el

Gua del usuario de PL/SQL Developer 9.0

134

informe de estadsticas estar vaco. Si presiona el botn Seleccionar se mostrar una lista con todas las estadsticas disponibles en la base de datos a la que se encuentra conectado. Puede seleccionar que estadsticas desea incluir en el informe. Si no tiene acceso a las tablas de rendimiento dinmico, el botn Seleccionar estar deshabilitado. Habilitar Unicode - Cuando esta opcin se encuentre seleccionada, los datos que consulte y que se encuentren en formato Unicode sern mostrados de la misma forma en PL/SQL Developer. Si deshabilita esta opcin PL/SQL Developer convertir los datos al juego de caracteres de Oracle Client, de acuerdo con el valor de la clave del registro NLS_LANG.

20.3

Oracle - Compilador.

Esta pgina de configuracin le permite controlar diferentes opciones para el compilador de PL/SQL de la ventana de programa. Nivel de optimizacin. Especifica el nivel de optimizacin que se utilizar para elaborar las unidades de programa de PL/SQL. Cuanto mayor sea el valor de este parmetro, ms esfuerzo realizar el compilador para optimizar el cdigo PL/SQL de sus unidades de programa. Tipo de cdigo. Cuando esta opcin se establece a Interpretado, las unidades de programa PL/SQL se compilarn en formato de cdigo de bytes. Estos mdulos son ejecutados por el motor intrprete de PL/SQL. Cuando esta opcin se establece a Nativo, las unidades de programa de PL/SQL se compilaran

Gua del usuario de PL/SQL Developer 9.0

135

como cdigo nativo (mquina). Estos mdulos se ejecutarn de forma nativa sin incurrir en la sobrecarga del intrprete. Alcance de los identificadores de PL/SQL. Esta opcin controla la recogida y almacenamiento en tiempo de compilacin, de las referencias cruzadas, y los identificadores de origen de datos de cdigo PL/SQL. Cuando esta opcin se establece en Ninguno, se desactiva la recogida de los datos de identificacin. Cuando se establece a Todos, permite la recogida de todos los datos de identificacin del cdigo fuente. Indicadores de compilacin condicional de PL/SQL. Esta opcin le permite definir el valor predeterminado de los flags compilacin condicional para cada compilacin que realice. Puede utilizar cualquier nombre, un valor entero, un booleano, o nulo. Para obtener ms informacin acerca de la compilacin condicional, vea PL/SQL Language Reference Guide. Si deja esta opcin en blanco, se utilizarn los flags por defecto para la instancia de base de datos que est utilizando. Pulse el botn Restablecer los valores por defecto de los flags para obtener los flags por defecto, de la base de datos. Advertencias PL/SQL. En esta seccin puede definir como tratara el compilador las excepciones de alerta especficas o categoras de gravedad especfica. Para cada nmero de excepcin o categora puede definir si estn Deshabilitadas (ningn mensaje de advertencia), si sern tratadas como una advertencia (compilacin correcta con un mensaje de advertencia) o si se consideran como un error (compilacin fallida con un mensaje de error). Puede especificar varios nmeros de excepcin, si los separa mediante comas. Tenga en cuenta que el orden de las advertencias es relevante: los artculos situados en la parte inferior de la lista tienen prioridad sobre los artculos situados en la parte superior. Por lo tanto, primero debe especificar las acciones para las categoras y, a continuacin, las acciones para las excepciones especficas. Variables de sustitucin PL/SQL. Si sus archivos de programa incluyen variables de sustitucin como las que se utiliza en SQL*Plus (con el prefijo $), puede definir aqu los valores de estas variables. Tenga en cuenta que las variables de sustitucin slo son tiles cuando se trabaja con archivos de programa, ya que el cdigo fuente resultante en la base de datos slo contendr los valores sustituidos despus de realizar la compilacin.

20.4

Oracle - Depurador.

Gua del usuario de PL/SQL Developer 9.0

136

Mostrar sugerencias con el valor de las variables - Si deshabilita esta opcin, los valores de las variables no se mostrarn automticamente en una sugerencia (tooltip) cuando mueva el cursor del ratn sobre su nombre en la ventana de prueba. En vez de esto, debe seleccionar el elemento Establecer variable desde el men contextual despus de hacer clic con el botn derecho del ratn sobre el nombre de la variable. Omitir objetos del usuario SYS - Si tiene privilegios para ver el cdigo de los objetos del usuario SYS, el depurador puede entrar en esas unidades de programa si deshabilita esta opcin. Por lo general no desear hacerlo, adems esta opcin se encuentra deshabilitada por defecto. Actualizar inspecciones despus de cada paso - Si deshabilita esta opcin, puede refrescar manualmente las inspecciones si presiona el botn Actualizar inspecciones en la barra de herramientas de depuracin de la ventana de prueba. Haciendo esto acelerar el rendimiento del proceso de depuracin en maquinas con una configuracin lenta. Actualizar la pila de llamadas despus de cada paso - Si deshabilita esta opcin, puede refrescar manualmente la pila de llamadas si presiona el botn Actualizar la pila de llamadas en la barra de herramientas de depuracin de la ventana de prueba. Haciendo esto puede mejorar el rendimiento del proceso de depuracin en maquinas con una configuracin lenta. Aadir informacin de depuracin al compilar - Cuando esta opcin esta habilitada, cada vez que realice un proceso de compilacin con PL/SQL Developer, este aadir automticamente la informacin de depuracin, con lo que los valores de las variables pueden verse y establecerse durante una sesin de depuracin. Si deshabilita esta opcin, puede aadir de forma manual la informacin de depuracin desde el Explorador de Objetos.

Gua del usuario de PL/SQL Developer 9.0

137

No aadir nunca la informacin de depuracin para las siguientes conexiones - PL/SQL Developer no aadir de forma automtica informacin sobre depuracin, independientemente de la opcin Aadir informacin de depuracin al compilar. Esto puede ser til si quiere estar seguro que nunca aadir informacin de depuracin a las bases de datos de produccin, o para determinados usuarios. Puede utilizar la sintaxis user@database, donde puede utilizar los caracteres comodn * y ? (ejemplo sys@* para el usuario sys en cualquier de base de datos). Aadir siempre la informacin de depuracin para las conexiones - PL/SQL Developer aadir de forma automtica informacin sobre depuracin, independientemente del valor de la opcin Aadir informacin de depuracin al compilar. Esto puede ser til si quiere estar seguro de que siempre aadir la informacin de depuracin en las bases de datos de desarrollo, o para ciertos usuarios. Puede utilizar la sintaxis user@database, donde puede utilizar los caracteres comodn * y ? (ejemplo sys@* para el usuario sys en cualquier tipo de base de datos). No aadir nunca la informacin de depuracin a los objetos - PL/SQL Developer no aadir informacin de depuracin para los objetos de la lista. Algunas versiones de Oracle pueden causar errores cuando se aade la informacin de depuracin en situaciones concretas. Podr ver los tpicos errores ORA-00600, ORA-03113 o PLS-00801 durante el proceso de compilacin. Si este problema ocurre, puede aadir el objeto a la lista (propietario.nombre) hasta que Oracle desarrolle un parche para este error.

20.5

Oracle - Salida.

Habilitado - En las ventanas de consulta SQL y en las ventanas de prueba, las llamadas a dbms_output.put_line sern almacenadas y mostradas despus de la ejecucin del archivo. Puede anular esta opcin en la pestaa Salida de las ventanas de consulta SQL y de las ventanas de prueba. Borrar antes de ejecutar - Antes de ejecutar el contenido de una ventana de consulta SQL o de una ventana de prueba, PL/SQL Developer borrar de forma automtica la pestaa Salida. De esta forma la pestaa Salida siempre contendr la salida de la ltima unidad de programa o consulta ejecutada. Tamao del buffer - El tamao en bites del buffer del paquete dbms_output. Si el nmero de bites de la salida durante la ejecucin de un programa es mayor que el indicado, se lanzar una excepcin. Establece el valor a 0 para que el tamao del buffer del paquete dbms_ouput sea ilimitado.

20.6

Oracle - Trazador.

Gua del usuario de PL/SQL Developer 9.0

138

Estas preferencias controlan la pestaa Trazador de la ventana de prueba (vea el captulo 5.11). Puede controlar que columnas de la tabla de trazado desea mostrar y en que orden.

20.7

Oracle - Perfilador.

Estas preferencias controlan la pestaa Perfilador de la ventana de prueba (vea el captulo 6.3). Columnas - Controla que columnas de la tabla de perfilado deben mostrarse y en que orden. Unidad de tiempo - Define la unidad de tiempo de las columnas Total time , Maximum time, Minimum time y Average time. Mostrar lneas de cdigo no ejecutadas - Determina si se muestran las lneas de cdigo que no se han ejecutado. Mostrar tiempo grficamente - La columna Tiempo total mostrar la representacin grafica del tiempo. Puede controlar el brillo del color de esta barra, o hacerlo invisible.

20.8

Oracle - Historial de conexiones.

Gua del usuario de PL/SQL Developer 9.0

139

Si habilita la opcin Almacenar historial, PLSQL Developer almacenar el usuario, la contrasea y la base de datos en el historial de conexiones. Cuando inicie de nuevo PL/SQL Developer, el cuadro de dilogo de inicio de sesin le permitir seleccionar rpidamente una cuenta utilizada con anterioridad.

Por razones de seguridad puede que no desee almacenar las contraseas en el historial, aunque PL/SQL Developer los encripta. Esto implica que cualquiera puede conectarse a la base de datos si tiene acceso a PL/SQL Developer en su PC. En dicho caso debera deshabilitar la opcin Almacenar contraseas. Las opciones Tamao del historial y Cantidad a mostrar controlan el nmero de conexiones que se almacenarn (las conexiones ms antiguas se borrarn del histrico) y cuantas se mostrarn en pantalla. La opcin Ordenar por controla como se ordenarn las conexiones en la lista de seleccin. Observe que si ha seleccionado la opcin Almacenar contraseas en el historial de conexiones, puede evitar que esto ocurra si presiona la tecla Control mientras presiona la tecla Return o el botn Aceptar durante el inicio de sesin. De esta forma puede evitar que reutilicen las contraseas de las cuentas con privilegios importantes (por ejemplo SYS o SYSTEM). Puede definir adicionalmente un nmero de conexiones fija en la seccin Usuarios, con o sin contrasea. Esas cuentas de usuario fijas siempre se mostrarn y nunca se borrarn de forma automtica. Puede definir adicionalmente submens para esas cuentas si aadiendo >nombre_de_men. En el ejemplo anterior, se ha creado un submen para Chicago y Detroit:
>chicago scott/tiger@chicago

Gua del usuario de PL/SQL Developer 9.0

140

sys@chicago as sysdba >detroit scott/tiger@detroit sys@detroit as sysdba larry@detroit

En este caso se ha creado un submen para una base de datos, pero puede crear cualquier categora que desee. Por ejemplo Desarrollo, Pruebas, Produccin. Si la opcin Mantener los usuarios agrupados y desordenado esta habilitada, los usuarios fijos se muestran en una seccin separada del historial, y no sern ordenados. Si la opcin Mantener los usuarios agrupados y desordenado se encuentra habilitada, al seleccionar un usuario fijo durante el inicio de sesin tambin lo aadir al historial. En la seccin Historial puede ver que usuarios se han aadido al historial como resultado de una sesin en PL/SQL Developer. Para eliminar un elemento especfico, seleccinelo de la lista y presione el botn Borrar elemento situado en la parte derecha de la lista.

Gua del usuario de PL/SQL Developer 9.0

141

20.9

Oracle - Sugerencias.

Sugerencias del compilador.


Puede habilitar o deshabilitar individualmente cada sugerencia y controlar otras propiedades cuando sea necesario. Se muestra una breve descripcin de cada una de las sugerencias debajo de la lista de sugerencias.

Nomenclatura.
En esta lista puede definir la nomenclatura que ser comprobada cuando se compile una unidad de programa o cuando se utilice la function Mostrar sugerencias del compilador .Se mostrar una sugerencia por cada elemento en el cdigo de la unidad de programa que no cumpla la nomenclatura indicada. Para cada convencin utilizada, puede definir el tipo de elemento (parmetro, variable, etc.), el prefijo requerido por cada tipo de elemento, los valores posibles para el primer carcter y los siguientes (despus del prefijo), el sufijo requerido y una descripcin para la sugerencia que se mostrar cuando la convencin utilizada no se cumpla. La descripcin debera estar en la forma que se muestra en el ejemplo anterior. El mensaje con la sugerencia ser <Elemento> <Nombre> <Descripcin>. Por ejemplo: El parmetro StartDate debe comenzar por p . Si un elemento debe cumplir una o varias convenciones, puede aadir varias lneas para el mismo tipo de elemento. Se mostrarn las descripciones de todos los elementos separadas entre s. Por ejemplo, el mensaje para los parmetros ser: El parmetro StartDate debe comenzar por p_ o debe ser Self.

Gua del usuario de PL/SQL Developer 9.0

142

20.10 Interface de usuario - Opciones.

Guardar usuario - Puede marcar esta opcin para guardar automticamente el usuario de cada sesin de PL/SQL Developer. Cuando vuelva a iniciar PL/SQL Developer posteriormente, el ltimo usuario que haya iniciado la sesin ser el usuario por defecto en el cuadro de dilogo de inicio de sesin. Guardar automticamente la configuracin del escritorio - Cuando esta opcin est habilitada, todos los archivos que se encuentren abiertos cuando cierre PL/SQL Developer se abrirn de manera automtica cuando vuelva a iniciar la aplicacin. Las ventanas de comandos o Explain Plan que no estn asociadas con ningn archivo, tambin sern restauradas. Tambin se restaurarn las dimensiones de la ventana principal y del Explorador de Objetos. Utilizar visor interno de HTML - Por defecto PL/SQL Developer utilizar un visor interno de documentos HTML para mostrar la documentacin de ayuda en formato HTML. Si tiene instalado Microsoft Internet Explorer 4 o una versin posterior, puede deshabilitar esta opcin y utilizar los componentes HTML de Microsoft en su lugar. Esto le proporcionar algunas caractersticas extras como el men contextual, y heredar as preferencias establecidas en el programa Internet Explorer. Ventana de ayuda HTML siempre visible - Si esta opcin esta habilitada, la ventana de ayuda HTML permanecer visible por encima de las dems ventanas hasta que la cierre o la minimice. Si esta opcin esta deshabilitada, la ventana de ayuda HTML aparecer como una tarea separada y con su propio botn en la ventana de tareas de Windows. De esta forma puede traer hacia delante la ventana principal de PL/SQL Developer o la ventana de ayuda cada vez que las necesite.

Gua del usuario de PL/SQL Developer 9.0

143

Mostrar pestaas en varias lneas - Si una ventana contiene mltiples pestaas, esta opcin controla si dichas pestaas pueden dividirse en caso de desbordamiento. Si esta opcin esta deshabilitada, 2 botones de desplazamiento aparecern en caso de que ocurra un desbordamiento de las pestaas. Esto slo se aplica a la ventana de programa. Mostrar la ruta completa del archivo en la barra de ttulo - Por defecto, PL/SQL Developer muestra nicamente el nombre del archivo en la ventana de ttulo. Si esta opcin se encuentra habilitada, se mostrar la ruta completa del mismo. Mostrar el men de proyectos - El elemento del men principal Proyectos slo ser visible si esta opcin se encuentra habilitada. Deshabiltela si no va a utilizar los proyectos, con lo que no ocupar ningn espacio en el men principal. Para ms detalles sobre los proyectos, vea el captulo 14. Colocar los mensajes de alerta cerca del puntero del ratn - Cuando seleccione esta opcin PL/SQL Developer posicionar los mensajes de alerta cerca del puntero del ratn. De esta forma podr alcanzar fcilmente el botn o los botones de esa alerta. Si esta opcin se encuentra desactiva, los mensajes de alerta, se mostrarn centrados en la pantalla. Mostrar la vista de detalle en los cuadros de dialogo - Si esta opcin se encuentra habilitada, PL/SQL Developer le mostrar los cuadros de dialogo para abrir y guardar archivo con una vista detallada. Si opcin est deshabilitada, se mostraran los cuadros de dialogo con la configuracin por defecto. Notificar finalizacin para grandes consultas - Cuando esta opcin se encuentre seleccionada, PL/SQL Developer le informar de que ha terminado de ejecutar una gran consulta. Puede controlar el tiempo con el que se le informar de la finalizacin de la consulta, pudiendo tambin, seleccionar un sonido para reproducir al finalizar la consulta. Si la consulta dura menos tiempo del establecido PL/SQL Developer no reproducir ningn sonido. Dilogos DSA - Cuando seleccione la opcin No mostrar este mensaje otra vez en un cuadro de dialogo, se aadir una entrada a esta seccin en las preferencias personales del usuario. Si despus desea volver a habilitar este mensaje, presione el botn Dilogos DSA para editar esta seccin. Esto le muestra un editor que le permite eliminar la lnea correspondiente.

Gua del usuario de PL/SQL Developer 9.0

144

20.11 Interfaz de usuario - Barra de herramientas.

Puede controlar que botones deben visualizarse y en que orden. Utilice el elemento Separador, para separar los grupos de botones relacionados. Puede utilizar el elemento New Bar para crear una nueva barra de herramientas debajo de la barra de herramientas previa. El botn Restablecer valores por defecto reinicia la barra de herramientas a su estado por defecto. El botn Restablecer valores clsicos reinicia la barra de herramientas al diseo de PL/SQL Developer 3. Utilice el botn Espacio entre botones para controlar el espacio entre cada botn de la barra de herramientas.

20.12 Interfaz de usuario - Explorador de Objetos.

Gua del usuario de PL/SQL Developer 9.0

145

Estas preferencias controlan la apariencia y el comportamiento del Explorador de Objetos (vea el captulo 18). Nmero mximo de objetos recientes - Controla el nmero mximo de objetos que sern visibles en la carpeta Objetos Recientes. Los objetos recientes menos utilizados se borrarn cuando se sobrepase el nmero mximo de elementos que deben mostrarse. Doble clic en un elemento del explorador - Controla que accin se ejecutar cuando haga doble clic en un objeto del Explorador de Objetos, o cuando lo arrastre y lo suelte desde el Explorador de Objetos al entorno de trabajo. Puede especificar una opcin por defecto y sobrescribir o heredar esta accin por defecto para cada tipo de objeto de la lista. Seleccin de usuarios por defecto - Controla si la seleccin de usuario por defecto es el <usuario actual> o <todos los usuarios>. Clausula where del selector de usuarios Permite definir una clusula where para la consulta que rellena los datos del selector de usuarios. Esta consulta se ejecuta contra la vista all_users, por lo que puede utilizar cualquier columna de esta vista. Mostrar tipos de datos - Cuando esta opcin esta habilitada, el tipo de datos de las columnas (vistas y tablas), los atributos (objetos) y los parmetros (funciones y procedimientos) se muestran en el Explorador de Objetos. Suavizar refresco - En algunos sistemas esta opcin podra ralentizar la operacin de refresco del Explorador de Objetos (ejemplo al cambiar un filtro, o al iniciar una sesin con un usuario diferente, etc.). En este caso debera deshabilitarla ya que podra conllevar que la pantalla parpadee cuando se refresque el Explorador de Objetos. Confirmar compilacin - Cuando esta opcin se encuentra habilitada, si compila una unidad de programa desde el Explorador de Objetos se le mostrar un mensaje de error o de operacin completada con xito. Cuando est deshabilitada slo ver un mensaje cuando el proceso de compilacin falle. Los botones Filtros (vea el captulo 18.2) y Carpetas (vea el captulo 18.3) llamarn al cuadro de dilogo correspondiente.

20.13 Interfaz de usuario - Editor.

Gua del usuario de PL/SQL Developer 9.0

146

Sangra
Ninguna - El editor no aplicara ninguna sangra al texto cuando presione la tecla de Tabulado, y siempre se situara en el primer carcter de la siguiente lnea. Automtica. - El editor aplicar la sangra al texto automticamente despus de presionar la tecla Enter, situando el cursor en la misma posicin que la lnea anterior.

Gua del usuario de PL/SQL Developer 9.0

147

Utilizar la tecla de retroceso para deshacer la sangra. - Si esta opcin esta habilitada, volver a la sangra anterior, Cuando est deshabilitada la tecla de Retroceso volver a su funcin normal. Caracteres - El nmero de caracteres que el editor utilizar cuando aumente o reduzca la sangra del texto seleccionado.

Tabulados y ajustes de lnea


Ajustar el tabulado a la lnea anterior - Esta opcin har que el editor ajuste la lnea a la posicin de la lnea anterior. Tamao del tabulado - Determina el nmero de caracteres que se utilizarn con un tabulado. Reemplazar espacios en blanco por tabulados - El editor reemplazar los espacios por tabulados si es posible. Utilizar tabulado - Cuando este deshabilitada, se utilizarn espacios en blanco para los tabulados y las sangras. Ajustar lneas - Las lneas que sean ms largas que el ancho de la ventana se continuarn en la lnea siguiente. Permitir colocar el cursor despus del final de una lnea -Cuando este habilitada, puede colocar el cursor despus del fin de una lnea. Cuando inserte texto aqu, la lnea se rellenar con espacios primero. Margen visible - Mostrar una lnea vertical en la posicin indicada. 0 = deshabilitado. Mostrar caracteres especiales por defecto - Cuando est habilitada, PL/SQL Developer mostrar los caracteres especiales como los espacios, tabulados y retornos de carro. Cuando esta opcin se encuentre deshabilitada, tendr que habilitarla directamente desde el men Edicin.

Resaltar sintaxis.
Este grupo de preferencias controla el resalte de la sintaxis que se utilizar en los distintos editores. Puede habilitar o deshabilitar el resalte de la sintaxis, y definir el color y el estilo de las palabras reservadas, comentarios, cadenas de texto, nmeros y smbolos (:=, =>, ||, etc.). Puede definir que palabras reservadas y como se deben escribir, en maysculas, minsculas o slo con la primera letra en maysculas. Puede definir tambin un resalte de sintaxis personalizado y que palabras deben resaltarse. Presionando el botn Personalizar palabras reservadas abrir un editor desde el que podr definir dichas palabras reservadas.

Reemplazar automticamente.
PL/SQL Developer le permite definir las palabra que reemplazar automticamente en los diferentes editores del programa. Por ejemplo, si define la palabra wo como reemplazo para when others then, simplemente teclee la palabra wo para insertar este texto. El botn Editar le permite editar el archivo con la definicin de las palabras y sus remplazos. En cada lnea de este archivo puede introducir la especificacin palabra=texto a reemplazar. Por ejemplo: Wo=when others then rs=rollback to save point Tambin puede hacer referencia a una plantilla, como texto de reemplazo. Por ejemplo: Wh=Loops\While loop.tpl En este caso, PL/SQ Developer utilizar el archivo Whileloop.tpl que se encuentra definido en el directorio Loops, permitindole utilizar las variables y las diferentes definiciones como texto de reemplazo. El campo Archivo de definicin le permite indicar que archivo que contiene las definiciones para la funcin reemplazar automticamente de PL/SQL Developer.

Gua del usuario de PL/SQL Developer 9.0

148

Otros.
Permitir mostrar / ocultar cdigo - Cuando esta opcin est habilitada, PL/SQL Developer le permitir mostrar y ocultar cdigo tal y como se describe en la seccin Mostrar / Ocultar cdigo del captulo. Mostrar nmeros de lnea - Marque esta opcin si desea ver los nmeros de lnea en el margen izquierdo. Mostrar estado de las lneas de cdigo - Cuando est habilitada, PL/SQL Developer le mostrar una marca de color amarillo en el margen del editor a lado de las lneas que hayan sufrido algn cambio, y una marca de color verde al lado de las nuevas lneas de cdigo que haya insertado. Resaltar lnea actual - Controla si se resalta la lnea de texto donde se encuentra situado el cursor. Comenzar la bsqueda desde el principio del archivo - Cuando utilice las funciones de bsqueda de PL/SQL Developer, estas continuarn al comienzo del archivo (cuando busque hacia delante), o al final del mismo (cuando busque hacia atrs), si no pueden localizar el texto buscado. Resaltar parntesis - Cuando esta opcin est habilitada, el editor resalta las parejas de parntesis cuando el cursor se encuentre situado entre el parntesis de apertura y de cierre. Permitir ancho variable para los tipos de letra con ancho fijo - Esta opcin le permite visualizar correctamente tipos de caracteres con ancho fijo, como por ejemplo caracteres japoneses. Tambin puede utilizar esta opcin para tipos de letra con ancho fijo que son ms anchas visualizadas en negrita, por ejemplo, que visualizadas de forma normal. Utilice esta opcin si PL/SQL Developer est truncando los caracteres a la hora de visualizarlos. Color del marcador - Determina el color de todos los marcadores como parntesis, variables, etc. Color del marcador de bsquedas - Determina el color de las coincidencias encontradas por la barra de bsqueda. Pegar valores separados por comas - Controla si los elementos seccionados en el Explorador de Objetos o en la ventana de descripcin de objetos se pegan en el editor en una o en varias lneas.

20.14 Interfaz de usuario - Fuentes

Gua del usuario de PL/SQL Developer 9.0

149

Las preferencias de las Fuentes controlan el tipo de fuente del Explorador de Objetos, del editor de SQL y la fuente utilizada en las diversas rejillas como en la ventana de consulta SQL, de propiedades, etc. Si presiona el botn Seleccionar puede cambiar el nombre, el estilo y el color de la fuente. Adicionalmente puede establecer el color de fondo (Bkg) para cada fuente. Para la rejilla de resultados y el editor de SQL puede especificar si PL/SQL Developer incluir el tipo de fuente utilizada cuando copie texto al portapapeles de Windows. Cuando esta opcin este deshabilitada el contenido ser copiado al portapapeles de Windows como texto plano. Desde esta pantalla tambin puede establecer la fuente por defecto para todos los cuadros de dialogo de PL/SQL Developer.

Gua del usuario de PL/SQL Developer 9.0

150

20.15 Interfaz de usuario - Asistente de cdigo.

El asistente de cdigo muestra automticamente la informacin de los objetos de la base de datos a medida que teclea su nombre (vea el captulo 22.3). Esta pgina de preferencias le permite definir el comportamiento de esta herramienta. Activar automticamente - El asistente de cdigo puede activarse automticamente despus de un determinado retraso (vea ms abajo). Tambin puede definir si desea activar el asistente de cdigo de forma manual mediante el uso de una tecla de funcin. Retraso - El nmero de milisegundos que el editor esperar hasta mostrar el asistente de cdigo. Estilo de codificacin - Controla como los elementos seleccionados se insertan en el editor cuando los seleccione: Smart El asistente de cdigo buscar el objeto descrito para determinar su estilo. Init Caps El primer carcter de cada palabra (separado por un guin de subrayado) se escribe en maysculas. Lowercase Todos los caracteres se convierten a letra minscula. Uppercase Todos los caracteres se convierten a mayscula. Utilizar formato original - Cuando esta opcin se encuentra habilitada el asistente de cdigo determina, si es posible, el estilo del identificador desde el cdigo almacenado en el diccionario de datos de Oracle. Esto se aplica a todas las unidades de programa y sus elementos (parmetros, tipos, etc.) y a las columnas de las vistas, sobrescribiendo la opcin Estilo de codificacin descrita arriba. Si no puede determinarse el estilo original (maysculas/minsculas) se aplicar el descrito en la opcin Estilo de codificacin. Puede que le interese deshabilitar esta caracterstica por motivos de rendimiento. Describir usuarios - Determina que objetos propiedad del usuario se muestran cuando teclea un nombre de usuario seguido de un periodo. Si esta opcin est habilitada puede de forma adicional definir los tipos de objetos que desea incluir en la lista. Describir contexto - Determina si el asistente de cdigo debera describir el contexto del usuario, editor y unidad de programa. Nmero mnimo de caracteres - Determina el nmero de caracteres que necesita teclear de una palabra antes de que la descripcin del contenido pueda activarse automticamente. Observe que siempre puede llamar al asistente de cdigo manualmente, incluso si no ha tecleado el nmero de caracteres definido.

Gua del usuario de PL/SQL Developer 9.0

151

Describir funciones estndar - Por defecto el asistente de cdigo describir las funciones estndar como to_char, add_months, etc. Si se encuentra familiarizado con esas funciones, puede deshabilitar esta opcin. Mostrar las variables y la declaracin de tipos en una ventana emergente - Cuando se encuentra habilitada, si mantiene el puntero del ratn sobre una variable o un tipo de datos en la ventana de programa de PL/SQL Developer, se mostrar su declaracin en una ventana emergente.

20.16 Interfaz de usuario - Configuracin del teclado.

En esta pgina puede definir su propia combinacin de teclas para todas las funciones de PL/SQL Developer. Simplemente seleccione la funcin en la lista y presione la combinacin de teclas que desea utilizar para dicha funcin. Para borrar la combinacin de teclas asignadas a una funcin determinada seleccione dicha funcin de la lista y presione la tecla Esc.

20.17 Interfaz de usuario - Apariencia.

Gua del usuario de PL/SQL Developer 9.0

152

Lenguaje - Si tiene una versin multi-lenguaje de PL/SQL Developer, puede seleccionar el lenguaje que desee utilizar aqu. Todas las etiquetas y mensajes se mostrarn en el lenguaje seleccionado. Color de fondo - Le permite definir el color y el degradado del espacio de trabajo de PL/SQL Developer. Si no quiere utilizar un degradado pero si un color, establezca el Color 1 y el Color 2 al mismo valor. Indicadores de conexin - Esas opciones le permiten mostrar una indicacin visual cuando PL/SQL Developer utilice una conexin especfica. Puede definir un nmero de conexiones que coincidan con el formato usuario@basededatos, y asociar un color con ellas. Esto color puede asociarse con un indicador alineado a la izquierda o a la derecha de la barra de herramientas, un indicador en la ventana y en la lista de ventanas, o con el color de fondo de la aplicacin (sobrescribiendo el degradado de fondo). La conexin puede contener los comodines * y ?. En el ejemplo anterior, el color de fondo del editor y el indicador de la barra de herramientas alineado a la derecha sern de color rojo cuando este conectado a la base de datos PRODDB con cualquier usuario. Ser de color amarillo cuando se conecte como SYS a cualquier base de datos. El primer elemento de la lista tiene preferencia, con lo que el indicador ser de color rojo cuando se conecte como SYS a la base de datos PRODDB. Sombrear botones deshabilitados - Cuando esta opcin se encuentra habilitada, los botones deshabilitados se muestran descoloridos. Cuando esta deshabilitada se utiliza la apariencia

Gua del usuario de PL/SQL Developer 9.0

153

estndar de color gris para los botones deshabilitados. Para sistemas con calidad de color mnima habilitada (256 colores), los botones deshabilitados siempre se muestran en color gris. Almacenar elementos de pantalla en memoria - La pantalla parpadear menos cuando mueva o redimensione las ventanas, pero el rendimiento del sistema podra ser inferior. Completar automticamente las listas de seleccin - Cuando esta opcin se encuentre habilitada, los campos de las ventanas de PL/SQL Developer sern completados automticamente con el elemento que corresponda en la lista desplegable. Deshabilitar estilos y temas XP - Este botn le permite deshabilitar los estilos y temas XP, tal y como se define en las Opciones de Pantalla de sistema operativo Microsoft Windows. Restablecer las opciones de anclado de las ventanas - Esta opcin restaura los valores por defecto para el anclaje de las ventanas de PL/SQL Developer.

20.18 Interfaz de usuario - NLS.

En esta pgina puede definir los formatos para la fecha, la hora y los nmeros que se utilizarn en PL/SQL Developer.

Fecha.
Definido por el usuario - Formato definido explcitamente para las fechas, siguiendo las mismas reglas que se emplean en la configuracin regional de Windows. Formato de Windows - El formato tal y como se encuentra definido en la configuracin regional de Windows. Formato de Oracle - El formato tal y como se encuentra definido en las variables de entorno de Oracle (NLS_DATE_FORMAT).

Hora.
Definido por el usuario - Formato definido explcitamente para las horas, siguiendo las mismas reglas que se emplean en la configuracin regional de Windows. Formato de Windows - El formato tal y como se encuentra definido en la configuracin regional de Windows.

Gua del usuario de PL/SQL Developer 9.0

154

Nmeros.
Definido por el usuario - Formato definido explcitamente para los nmeros por el usuario, aqu podr definir los smbolos a utilizar tanto para los decimales como para los grupos de decimales. Formato de Windows - El formato tal y como se encuentra definido en la configuracin regional de Windows. Formato de Oracle - El formato tal y como se encuentra definido en las variables de entorno de Oracle (NLS_NUMERIC_CHARACTERS).

20.19 Tipos de Ventanas - Ventana de Programa

Estas preferencias afectan al comportamiento de la ventana de programa (vea el captulo 4). Permitir compilar los programas mientras se ejecutan - En un modo de sesin Multisesin o Dual tcnicamente puede compilar unidades de programa mientras se est ejecutando un archivo de prueba o un archivo SQL. Esto podra ocasionar bloqueos, los cuales pueden evitarse con esta opcin. Compilacin segura (utilizando un objeto de compilacin temporal) - Cuando esta opcin se encuentra habilitada, cada proceso de compilacin se prueba primero utilizando un objeto

Gua del usuario de PL/SQL Developer 9.0

155

temporal. Cuando esta prueba finalice correctamente, el objeto se compila. Esto puede resultar til si esta compilando objetos en un entorno en el que los objetos de la base de datos marcados como no validos pueden causar problemas. Compilar en segundo plano - Cuando esta opcin se encuentra habilitada, el proceso de compilacin se ejecuta en un hilo en modo background, en una sesin separada. De esta forma puede continuar trabajando mientras se realiza el proceso. Esto conlleva una sesin extra de la base de datos por cada ventana de programa. Observe que esta preferencia slo es efectiva si la opcin modo de sesin esta establecida a Multisesin. Guardar antes de compilar - Si quiere asegurarse de que los objetos de la base de datos y los archivos de cdigo se encuentran sincronizados, puede habilitar esta opcin. Ignorar cdigo PL/SQL no reconocido - Cuando este opcin est habilitada, la ventana de programa ignorar todo el cdigo SQL que no empieza con create or replace <program unit type>. Otros comandos de SQL o SQL*Plus en el archivo de programa ser ignorados. Mostrar el panel de contenido del cdigo - Esta opcin controla si se muestra el panel de contenido del cdigo. Vea el captulo 22.12 para ms detalles. Resaltar el cdigo PL/SQL automticamente en el panel de contenido del cdigo - Controla si el cdigo PL/SQL en el editor se resaltar automticamente cuando el cursor del ratn se mueva sobre un elemento en el panel de contenido del cdigo. Mostrar la jerarqua del cdigo - Esta preferencia controla si muestra el panel de jerarqua del cdigo. Vea el captulo 22.13 para ms detalles. Resaltar variables - Cuando el cursor se encuentra situado encima de una variable, todas las coincidencias de dicha variable se resaltan. Esta opcin facilita el ver donde se esta utilizando una variable y cual ser el impacto del cambio. Si esta opcin esta deshabilitada, necesita utilizar el elemento Buscar coincidencias desde el men Edicin. Resaltar el cdigo automticamente en el editor al utilizar el panel de jerarqua del cdigo Controla si el cdigo PL/SQL en el editor se resaltar automticamente cuando el cursor del ratn se mueva sobre un elemento en el panel de jerarqua del cdigo. Resaltar palabras reservadas if, loop, case - Cuando el cursor del ratn se encuentre situado en instrucciones de tipo: if/ then / else / elsif /end if, loop / end loop, for / loop / end loop, while / loop / end loop, case / when / then / else / end case, declare / begin / end. Mostrar sugerencias del compilador despus de compilar - Las sugerencias del compilador le proporcionan informacin acerca de declaraciones no utilizadas, asignaciones de variables no utilizadas, errores potenciales y alertas. Cuando esta opcin est habilitada, dichas sugerencias se mostrarn automticamente al finalizar el proceso de compilacin, debajo de los errores de compilacin (si los hubiese). Si deshabilita esta opcin, tendr que seleccionar explcitamente el elemento Mostrar sugerencias del compilador del men Herramientas o en el botn situado en la barra de herramientas. Color de fondo del error - Selecciona el color de fondo del texto de un error de compilacin. Texto del error - Selecciona el color del texto de un error de compilacin. Seguimiento - Selecciona el color de fondo para el texto resaltado del contenido del cdigo, de la jerarqua del cdigo y de las palabras reservadas. Guardar estado de las ventanas - Cuando esta habilitado, la posicin, tamao, marcadores, marcas de color y variables de sustitucin de una ventana de programa se guardan en un archivo .pfi separado y sern restauradas cuando el archivo o el objeto de la base de datos sea visto o editado otra vez. Tambin puede especificarse la ubicacin de esos archivos.

20.20 Tipos de ventanas - Ventana de consulta SQL.

Gua del usuario de PL/SQL Developer 9.0

156

Estas preferencias afectan al comportamiento de la ventana de consulta SQL (vea el captulo 7). Ejecutar commit automticamente - Esta opcin controla si se ejecuta automticamente una instruccin commit para las instrucciones de tipo DML ejecutadas en una ventana de consulta SQL. Ejecutar commit automticamente para los registros validados - Esta opcin controla si a los registros validados a travs de la rejilla de resultados se les aplican de forma automtica una instruccin commit. Ejecutar consultas automticamente - Si esta opcin esta habilitada, una ventana de consulta SQL que se ha creado seleccionando los elementos Consultar datos o Editar datos para una tabla o vista se ejecutar inmediatamente. Si esta opcin est deshabilitada, puede modificar la consulta generada antes de ejecutarla. Seleccionar consultas automticamente - Si tiene ms de una instruccin SQL en el editor (separadas por puntos y comas), la ventana de consulta SQL seleccionar automticamente la instruccin donde se encuentre situado el cursor antes de ejecutarla. De esta forma no tendr que seleccionarla explcitamente.

Gua del usuario de PL/SQL Developer 9.0

157

Preguntar si se guardan los cambios en las nuevas ventanas - Cuando cierra una ventana de consulta SQL que ha creado, normalmente se le preguntar si desea archivar. Si deshabilita esta opcin, esta confirmacin se omitir. Si ha modificado un archivo previamente abierto, siempre se le preguntar si desea guardar los cambios, independientemente de esta opcin. Ejecutar consulta vinculada en una nueva ventana - Cuando esta preferencia est establecida, al ejecutar una consulta vinculada (vea el captulo 7.4), crear una nueva ventana de consulta SQL. Si no est establecida, la consulta vinculada se ejecutar en la ventana de consulta SQL actual. Convertir campos numricos mediante to_char - Cuando esta opcin esta habilitada, los campos numricos se convertirn en caracteres en el servidor. Los parmetros NLS de la sesin determinarn el formato de esos valores. PL/SQL Developer no realizar ningn formateo o validacin adicional sobre los nmeros. Convertir fechas mediante to_char - Cuando esta opcin est habilitada, los campos de tipo fecha se convertirn en caracteres en el servidor. Los parmetros NLS de la sesin determinarn el formato de esos valores. PL/SQL Developer no realizar ningn formateo o validacin adicional sobre una fecha, y el selector de fechas no estar disponible cuando edite esos campos. Mostrar informacin del diccionario en la barra de estado - Cuando est habilitada, la siguiente informacin del diccionario de datos se mostrar en la rejilla de resultados: El tipo de datos de la columna y, opcionalmente, un comentario en la barra de estado. Se mostrara una lista para las columnas que tengan restricciones de comprobacin para columnas especificas (ejemplo col in (value1, value2, )). Se mostrar una lista para las columnas con restricciones de clave fornea para tablas pequeas de menos de 1000 registros. Mostrar nmero de lneas - Cuando est habilitada, el editor de SQL de PL/SQL Developer mostrar los nmeros de lnea en la parte izquierda del editor de SQL. Lneas inciales del editor vacas Cuando ejecuta una consulta en la ventana de SQL, aparecer el panel de resultados Esta opcin controla el nmero de lneas que se vern en el editor de SQL independientemente del nmero de lneas que ocupe la consulta. Color de fondo de las filas alternas - Cuando se encuentra habilitada, esta opcin le permite definir el color de fondo para las filas alternas en la rejilla de resultados. Color de fondo de la celda para los valores nulos - Este color se utilizar para indicar valores nulos. Esto hace que los valores nulos sean ms fciles de identificar para valores que slo son blancos o valores que no se muestran directamente en la rejilla (ejemplo LOB y Longs). Nmero de registros por pgina -Esta preferencia determina cuantos registros son devueltos por cada consulta de seleccin y cada vez que presiona el botn Pgina siguiente en la rejilla de resultados de una ventana de consulta SQL. Determinar automticamente El tamao de la rejilla de resultados determina cuantos registros se devuelven. Nmero fijo Se devuelve el nmero de registros especificados. Todos los registros Todos los registros se devuelven inmediatamente cuando se ejecuta la consulta.

Formato numrico - Esta preferencia controla como se muestran las columnas numricas: Alineado a la izquierda Los valores se muestran alineados a la izquierda sin ningn tipo de formato. Alineado a la derecha Los valores se muestran alineados a la derecha sin ningn tipo de formato.

Gua del usuario de PL/SQL Developer 9.0

158

Formateados Los valores se muestran alineados a la derecha, con un formato que corresponde a la precisin y la escala del campo. Formateado con separador de decimales Similar a la opcin anterior, pero incluye un separador de decimales (ejemplo. 1.277,65). Filtrar consulta - Esta opcin controla el comportamiento por defecto de la ventana de consulta SQL cuando se encuentra en modo de filtrado (vea el captulo 7.3): Maysculas / Minsculas Los valores de la consulta de los campos de caracteres se tratan en maysculas /minsculas. Realizar consultas exactas Los campos de tipo carcter slo necesitan contener los valores exactos de la consulta. Ignorar fracciones de tiempo La fraccin de tiempo de los campos de tipo fecha se ignoran si los valores de la consulta no contienen ninguna fraccin de tiempo.

20.21 Tipos de ventana - Ventana de prueba.


Ejecutar commit automticamente despus de la ejecucin - Esta opcin controla si al finalizar la ejecucin de un archivo de prueba se le aplica automticamente una instruccin commit.

20.22 Tipos de ventanas - Plan de ejecucin.

Estas opciones controlan que columnas de la tabla plan table se muestran en la ventana del plan de ejecucin (vea el captulo 6.1), y el orden en el cual deberan aparecer.

20.23 Herramientas - Comparacin.

En esta pgina de preferencias puede seleccionar la herramienta externa de comparacin de objetos (vea el captulo 21.10) . Utilice las siguientes directivas para especificar los parmetros que controlan si se ignoran las maysculas o los espacios en blanco:

Gua del usuario de PL/SQL Developer 9.0

159

<IgnoreCase=on|off> Esta directiva utilizar la expresin on o off en caso de que las diferencias entre maysculas y minsculas deban ser o no ignoradas. <IgnoreWhiteSpace=on|off> Esta directiva utilizar la expresin on o off en caso de que los espacios en blanco deban o no ser ignorados. Por ejemplo, para ExamDiff puede utilizar el parmetro /i parar ignorar las maysculas y /!i para tener en cuenta las maysculas a la hora de realizar la comparacin, puedes utilizar el parmetro /w para ignorar los espacios en blanco /!w para tener en cuenta los espacios en blanco. Estos parmetros deben especificarse despus del parmetro que indica el nombres de los archivos . Por lo tanto, la lista de parmetros para ExamDiff se vera de la siguiente manera: %1 %2 <IgnoreCase=/i|/!i> <IgnoreWhiteSpace=/w|/!w> La lista de parmetros resultantes cuando es necesario comparar 2 archivos y controlar si hay diferencias entre las maysculas y las minsculas e ignorar los espacios en blanco seria la que se muestra a continuacin: c:\temp\file1.sql c:\temp\file2.sql /!i /w

20.24 Herramientas - Generador de datos.

Esta pgina de preferencias le permite definir un conjunto genrico de resultados para el Generador de datos. Estos valores por defecto pueden sobrescribirse para cada definicin de datos del generador. Para ms informacin sobre el significado de esas preferencias, vea el captulo 21.9.

Gua del usuario de PL/SQL Developer 9.0

160

20.25 Herramientas - Lista de elementos pendientes.

Estas preferencias controlan los valores de las listas de seleccin Prioridades, Categoras y Propietarios que se encuentra en el editor de elementos pendientes. Para las propiedades puede ser til prefijar cada valor con un nmero, con lo que la lista puede ordenarse por prioridad. Vea el captulo 15 para ms detalles.

20.26 Herramientas - Lista de instrucciones ejecutadas

En esta pgina de preferencias puede definir el nmero mximo de instrucciones que almacenarn en el buffer, y el directorio donde deben almacenarse los archivos. Vea el captulo 22.4 para ms detalles.

20.27 Archivos - Directorios

Gua del usuario de PL/SQL Developer 9.0

161

Archivos de programa - Define el directorio inicial que se utilizar cuando abra o guarde un archivo de programa. Si deja este directorio en blanco, se utilizar el directorio que utiliz para abrir o guardar el ltimo archivo de programa. Archivos de prueba - Define el directorio inicial que se utilizar cuando abre o guarda archivos de prueba. Si deja este directorio en blanco, siempre se iniciar en el directorio que utiliz para abrir o guardar el ltimo archivo de prueba. Archivos SQL - Define el directorio inicial que se utilizar cuando abra o guarde archivos SQL. Si deja este directorio en blanco, se utilizar el directorio que utiliz para abrir o guardar el ltimo archivo SQL. Informes - Define el directorio inicial que se utilizar cuando abra o guarde los informes. Si deja este directorio en blanco, se utilizar el directorio que utiliz para abrir o guardar el ltimo informe. Archivos de comandos - Cuando abra un archivo de comandos desde el men o tecleando @file, este directorio ser el que se utilice por defecto. Si deja este directorio en blanco, se utilizar el directorio de trabajo. Macros - Este directorio se utilizar para almacenar sus libreras de macros. Si deja este directorio en blanco, se utilizar el subdirectorio Macro en el directorio de PL/SQL Developer. Plantillas - Este directorio se utilizar para almacenar las plantillas. Si deja este directorio en blanco, se utilizar el subdirectorio Template del directorio PL/SQL Developer. Plug-Ins - Este directorio se utilizar para buscar los complementos. Si deja este directorio en blanco, se utilizar el subdirectorio Plug-In del directorio de PL/SQL Developer. Proyectos - Define el directorio inicial cuando abra o guarde proyectos. Si deja este directorio en blanco siempre empezar en el directorio donde abri o guard el proyecto la ltima vez. Consultas estndar - Define el directorio donde se almacenan las consultas estndar. Si deja este directorio en blanco, las consultas estndar se almacenarn en el directorio de datos de su perfil. OFS - Define donde se encuentra el archivo ofs.ldf. El botn Organizador OFS le permite lanzar la aplicacin para ver o editar este archivo. Vea el capitulo 30.1.

Gua del usuario de PL/SQL Developer 9.0

162

20.28 Archivos - Extensiones.

En esta pgina puede definir las extensiones para todos los tipos de archivos. Cuando guarde o cargue dicho archivo PL/SQL Developer asumir la extensin por defecto si no especifica una extensin en el cuadro de dilogo. Por cada tipo de archivo puede especificar adicionalmente otras extensiones, que se mostrarn en el cuadro de dilogo. Puede separar varias extensiones mediante una coma. Si presiona el botn Registrar extensiones puede asociar las extensiones por defecto con PL/SQL Developer. Aparecer un cuadro de dilogo que le permite seleccionar las extensiones que desee asociar con PL/SQL Developer. Si hace doble clic en un archivo con dicha extensin en el explorador de Windows se abrir automticamente PL/SQL Developer.

20.29 Archivos - Formatos.

Gua del usuario de PL/SQL Developer 9.0

163

La opcin Salto de lnea controla como se finalizan las lneas en los archivos de texto. Pueden terminarse con formato Windows con el par de caracteres CR/LF o al estilo UNIX/LINUX con LF. Puede especificar de forma adicional que archivos se encuentran en formato UNIX o Windows en determinados directorios. Puede especificar mltiples directorios en lneas separadas y seleccionar un directorio presionando el botn Aadir directorio (). Observe que no solo los archivos guardados en este directorio estn en formato Unix, tambin los archivos guardados en los subdirectorios por debajo de este. La opcin Codificacin controla si los archivos se guardan siempre en formato Unicode UTF8 format, o si por el contrario PL/SQL Developer intenta determinar si un archivo contiene caracteres Unicode. Si contiene caracteres Unicode, el archivo se guardar en formato UTF8. Si todos los caracteres son ANSI, el archivo se guardar en formato ANSI. La opcin Exportar comillas controla como se exportan los valores en formato CSV. Cuando esta deshabilitada, todos los valores se encierran entre comillas. Cuando se encuentre habilitada, solo los valores que lo requieran sern encerrados entre comillas. Estos son los valores que contengan comas o comillas. La opcin Exportar a Excel con instrucciones SQL controla que si PL/SQL Developer guardar o no las instrucciones SQL en una nueva hoja de Excel cuando exporte los datos a Excel.

20.30 Archivos - Copia de seguridad.

Esta pgina de preferencias contiene opciones para las copias de seguridad y recuperacin de sus archivos.

Crear copias de seguridad.


Antes de que PL/SQL Developer guarde un archivo, realizar una copia del archivo original antes de sobrescribirlo. Esta copia de seguridad tendr el mismo nombre y extensin que el original pero con el prefijo ~ (por ejemplo employee.pck se guardar como employee.~pck). De esta forma siempre tendr una generacin de archivos previos. Todos los cuadros de dilogo que le permiten abrir un archivo, tienen el filtro Backup files (*.~*) que le permite abrir fcilmente una copia de seguridad.

Recuperacin.
PL/SQL Developer puede almacenar todos los archivos abiertos en un directorio temporal para determinados eventos. En caso de un error grave (por ejemplo: un corte de suministro elctrico, fallo del software, etc.) PL/SQL Developer le permite recuperar esos archivos cuando reinicie la aplicacin. Puede especificar los siguientes eventos:

Gua del usuario de PL/SQL Developer 9.0

164

Al ejecutar - Todos los archivos abiertos se guardarn en un directorio temporal antes de que ejecute una ventana de prueba, de programa, de comandos, de consulta SQL o de informes. Guardar cada - Todos los archivos abiertos se guardan en un directorio temporal en el intervalo de tiempo especificado.

20.31 Archivos - HTML/XML.

Estas preferencias le permiten controlar la salida en formato HTML y XML que genera la ventana de informes o las funciones de exportacin: Juego de caracteres - Le permite definir el conjunto de caracteres de codificacin del documento HTML o XML. Este debera corresponder con el conjunto de caracteres de su entorno de Oracle, para que los datos puedan interpretarse correctamente. Encabezado - Este texto se insertar en la seccin <HEAD> de un documento HTML o en la cabecera de un documento XML.

20.32 Otros - Imprimir.

Gua del usuario de PL/SQL Developer 9.0

165

General.
Mostrar el cuadro de dilogo de impresin - Cuando presione el botn Imprimir, PL/SQL Developer mostrar el cuadro de dilogo de impresin. Imprimir nmeros de lnea - Mostrar el nmero de cada lnea de cdigo cuando imprima el cdigo fuente SQL o PL/SQL. Ajustar lneas al imprimir - Las lneas que sobrepasen el ancho de la pgina continuarn la lnea siguiente. Imprimir en blanco y negro - La impresin se realizar en blanco y negro. Deshabilitando esta opcin imprimir el cdigo en colores o en escala de grises. Imprimir color de fondo - Cuando est habilitada, al realizar la impresin se imprimir el color de fondo. Imprimir el texto de la consulta - Determina si el texto de la consulta SQL se imprime encima de los resultados cuando imprima el contenido de una ventana de consulta SQL.

Rejilla.
Imprimir las lneas de la rejilla - Determina si se imprimen las lneas de la rejilla. Invertir los colores de la cabecera - Determina si la cabecera de la columna se imprime con los colores invertidos.

Encabezado.
Ttulo - Cuando est habilitada, cada pgina tendr impreso el tipo y el nombre de archivo en la parte izquierda de la cabecera. Fecha - Cuando est habilitada, cada pgina tendr impresa la fecha y hora actual en la parte derecha de la cabecera.

Pie de pgina.
Nmero de pgina - Cuando est habilitada, cada pgina tendr impresa en el nmero de pgina en la parte inferior.

20.33 Otros - Actualizaciones y noticias.

Gua del usuario de PL/SQL Developer 9.0

166

Le permite controlar si PL/SQL Developer comprueba automticamente el sitio Web de Allround Automations en busca de actualizaciones y noticias sobre de PL/SQL Developer. Si deshabilita esta opcin tendr que comprobar explcitamente las actualizaciones y noticias presionando la opcin correspondiente a travs de los elementos Buscar actualizaciones y Buscar noticias situados en el men de Ayuda.

20.34 Establecer las preferencias.

Gua del usuario de PL/SQL Developer 9.0

167

Como se menciona en el captulo 20, puede definir un conjunto de preferencia en mltiples niveles. Para definir una preferencia, presione el botn Configurar preferencias situado a la derecha de la lista de seleccin de preferencias. PL/SQL Developer le mostrar el siguiente cuadro de dilogo:

Las Preferencias personales se definen para el usuario de Windows (en este caso John). Las Preferencias por defecto pueden definirse por el administrador del sistema, y proporcionan las preferencias por defecto para todos los usuarios de Windows, tanto a nivel global como a nivel de conexin.

Preferencias personales.
Por defecto todos los usuarios tendrn un conjunto de preferencias personalizado Default <user>. Este es el conjunto de preferencias al que acceder por defecto. Para crear un conjunto de preferencias adicional para una o ms conexiones de Oracle, presione el botn Nuevo situado en la parte derecha de la lista de preferencias. Ahora puede introducir una descripcin y aadir una o ms conexiones. Para cada conexin puede utilizar comodines para varios usuarios y bases de datos. En el ejemplo anterior, John ha definido un conjunto de preferencias llamado Order admin databases para las bases de datos dev_oa, tst_oa y prd_oa. Cada vez que John se conecte a una de esas tres bases de datos, utilizar este conjunto de preferencias. Si una preferencia no esta definida dentro de este conjunto, se utilizar la preferencia correspondiente del conjunto de preferencias por defecto del usuario.

Preferencias por defecto.


El administrador del sistema puede definir un conjunto de preferencias globales por defecto para todos los usuarios y conexiones, pudiendo definir de forma adicional un conjunto de preferencias para una o ms conexiones. Para hacerlo, cambie a la pestaa Preferencias por defecto y presione el botn Nuevo situado en la parte derecha de la lista de preferencias. Si no introduce ninguna Conexin, el nuevo

Gua del usuario de PL/SQL Developer 9.0

168

conjunto de preferencias definir las preferencias por defecto para todos los usuarios .Si introduce una o ms conexiones, el conjunto de preferencias definir las preferencias por defecto para esas conexiones.

Orden del conjunto de preferencias.


Si una preferencia esta definida en mltiples niveles, el nivel ms especifico tendr preferencia: 1. Conjunto de preferencias personales de conexin (Utilizadas en primer lugar). 2. Conjunto de preferencias personales de Windows. 3. Conjunto de preferencias de la conexin por defecto. 4. Conjunto de preferencias globales por defecto (Utilizadas en ltimo lugar).

Conjuntos de preferencias y directorios.


Los conjuntos de preferencias se almacenan en un archivo en el subdirectorio Preferences en el directorio de instalacin de PL/SQL Developer. Dentro del directorio de preferencias, las preferencias personales de cada usuario se almacenan en un subdirectorio con el nombre del usuario de Windows. Por ejemplo:
C:\Program Files\PLSQL Developer\Preferences\John

Las preferencias por defecto se almacenan en el subdirectorio Default. Por ejemplo:


C:\Program Files\PLSQL Developer\Preferences\Default

Si instala PL/SQL Developer en un servidor de archivos, debe proporcionar permisos de lectura y escritura sobre el directorio Preferences, y permiso de lectura en el subdirectorio Preferences\Default. De forma alternativa puede utilizar el comando PREFPATH en la lnea de comandos para especificar el directorio donde se encuentran almacenadas las preferencias del usuario:
plsqldev.exe prefpath=u:\userdata

Si el usuario de Windows John utiliza PL/SQL Developer, su conjunto de preferencias personal estar almacenado en u:\userdata\john. Las preferencias por defecto siempre se almacenan en el subdirectorio Preferences\Default en el directorio de instalacin de P/SQL Developer. Para asegurarse de que todos los usuarios utilizan una ruta idntica para las preferencias, puede establecer este parmetro en el archivo params.ini (vea el captulo 32.4).

Gua del usuario de PL/SQL Developer 9.0

169

21. Herramientas.
En el men Herramientas se encuentran disponibles varias herramientas. Dichas herramientas se describen con detalle a lo largo de este captulo.

21.1

Explorador de Objetos.

El Explorador de Objetos se describe con ms detalle en el captulo 18. En el men Herramientas puede mostrar u ocultar el Explorador de Objetos si selecciona el elemento Explorador de Objetos. Tambin puede configurar los filtros del Explorador de Objetos en este men seleccionando el elemento Configurar filtros del explorador, lo que se describe en el captulo 18.

21.2

Buscar objetos de la base de datos.

Esta herramienta le permite realizar bsquedas de los objetos de la base de datos basndose en criterios especficos, como el nombre del objeto, el tipo, el propietario o el estado, as como una bsqueda completa de texto para las instrucciones DDL del cdigo de los objetos:

Puede introducir el criterio de bsqueda en las tres secciones principales de este formulario.

Buscar texto.
Esta opcin equivale al cuadro de dilogo de buscar de un editor de texto y le permite realizar bsquedas que distingan entre maysculas y minsculas, palabras completas o realizar la bsqueda mediante el uso de expresiones regulares. Si usted omite la bsqueda completa de texto se mostrarn los objetos que coincidan con otros criterios de bsqueda.

Criterios de bsqueda.
Aqu puede introducir los siguientes criterios de bsqueda:

Gua del usuario de PL/SQL Developer 9.0

170

Filtro del Explorador - Limita los objetos de acuerdo con el criterio del filtro seleccionado. Propietario El propietario del objeto. Puede utilizar los caracteres comodines del lenguaje SQL (por ejemplo sys %). El valor por defecto es <CURRENTE USER>, lo que limitar la bsqueda de objetos solamente al usuario conectado. Nombre El nombre del objeto. Puede utilizar los caracteres comodines del lenguaje SQL (por ejemplo %common). Estado Limita la bsqueda a los objetos marcados como validos o no validos. Creado antes/despus Limita la bsqueda a los objetos creados antes y despus de una fecha determinada. Utilice la casilla de control situada a la izquierda del campo fecha para habilitar o deshabilitar estos criterios. Modificado antes/despus Limita la bsqueda de los objetos modificados antes y despus de una fecha determinada. Utilice la casilla de control situada a la izquierda del campo fecha para habilitar o deshabilitar estos criterios.

Tipos de objetos.
Aqu puede seleccionar los tipos de objetos que desea incluir en su bsqueda.

Resultados de la bsqueda.
Despus de presionar el botn Buscar se ejecutar la funcin de bsqueda y se rellenar la lista de resultados. Si hace clic con el botn derecho del ratn sobre los resultados de la bsqueda podr ver el men contextual del objeto. El primer elemento del men es Localizar texto, que carga el cdigo del objeto seleccionado en una ventana de programa, e inmediatamente despus se desplaza a la primera lnea del texto. Tambin puede ejecutar la funcin Localizar texto si hace doble clic sobre el objeto en los resultados de la bsqueda. Para guardar los resultados de la bsqueda puede hacer clic con el botn derecho del ratn en ellos y seleccionar el formato apropiado desde el elemento Exportar lista en los resultados de la bsqueda.

Guardar los criterios de bsqueda.


Para guardar los criterios de bsqueda que utilice ms frecuentemente puede presionar el botn Guardar e introducir un directorio y un nombre de archivo. Puede volver a utilizar esos criterios de bsqueda ms adelante si presiona el botn Guardar.

21.3

Compilar objetos no validos.

Con esta herramienta puede volver a compilar fcilmente todos los objetos marcados como no validos en la base de datos. Cuando la seleccione, se le mostrar un cuadro de dilogo donde puede ver todos los objetos no validos:

Gua del usuario de PL/SQL Developer 9.0

171

Nota: Observe que el filtro del Explorador de Objetos que se encuentre seleccionado controla los objetos no validos que se incluirn. La seccin inferior de la ventana mostrar cualquier error de compilacin que haya ocurrido previamente para el objeto seleccionado. Para recompilar esos objetos, presione el botn Compilar objetos no validos situado en la barra de herramientas o el botn Ejecutar de la barra de herramientas principal. Las dependencias de los objetos sern analizadas para determinar en que orden debe ejecutarse el proceso de compilacin. Los iconos situados en la parte izquierda de la lista de objetos le indican si el objeto se ha compilado correctamente. La seccin de errores de compilacin se actualizar una vez finalizado el proceso de compilacin de los objetos. Para refrescar la lista de objetos no validos, presione el botn Refrescar lista de objetos situado en la barra de herramientas. Esto actualizar la lista con todos los objetos que se encuentran marcados como no validos en este momento. Puede hacer clic con el botn derecho del ratn sobre un objeto para acceder a su men desplegable.

21.4

Exportar tablas.

La herramienta de exportacin de tablas le permite exportar la definicin de una o ms tablas y de sus datos en un archivo, con lo que podr importar las tablas ms adelante. Despus de iniciar la herramienta Exportar tablas, puede seleccionar las tablas que desea exportar, escoger un mtodo de exportacin (Oracle, SQL, PL/SQL Developer), y establecer varias opciones sobre el mtodo de exportacin.

Utilice la opcin Comprimir para comprimir automticamente la salida en un archivo comprimido para ahorrar espacio en disco. En el ejemplo anterior, se crear el archivo C:\exportdata\demo.dmp, el cual se aadir a un archivo comprimido llamado C:\exportdata\demo.dmp.zip. Posteriormente el archivo original demo.dmp ser borrado. La funcin de exportar analiza las dependencias de las claves forneas que existen entre las tablas y colocar las tablas en el orden correcto en el archivo de salida generado.

Oracle.
La captura de pantalla anterior muestra el mtodo de exportacin de tablas de Oracle. Este mtodo le permite especificar las opciones que desea aplicar en la lnea de comandos para la herramienta de exportar de Oracle (vea la gua Oracle Server Utilities), y acto seguido lanzar el programa para realizar la exportacin. El campo Ejecutable le permite seleccionar una versin especfica de la utilidad de exportacin de Oracle. Por defecto se utilizar la versin ms reciente del directorio Oracle Home.

Gua del usuario de PL/SQL Developer 9.0

172

Una vez finalizado el proceso de exportacin, una nueva pestaa denominada Registro se har visible. Esta pgina contiene el registro creado por la utilidad de exportacin. Entre las ventajas de este mtodo se encuentran la velocidad y la portabilidad del archivo de salida. Despus de todo, puede importarlo desde cualquier parte con la utilidad de importacin de Oracle.

SQL.

Este mtodo crea un archivo estndar de SQL con instrucciones insert y (opcionalmente), instrucciones DDL para crear la definicin de las tablas. La pestaa contiene las siguientes opciones: Eliminar tablas El archivo creado contiene instrucciones para eliminar las tablas antes de que se vuelvan a crear y se carguen los datos. Las opciones Crear tablas, Truncar tablas, y Eliminar registros se encuentran deshabilitadas y tienen un valor implcito. Crear tablas El archivo creado contiene instrucciones para crear las tablas antes de que se carguen los datos. Esto incluye las restricciones, los ndices y los permisos. Truncar Tablas El archivo creado utiliza la instruccin truncate table para vaciar las tablas antes de que se carguen los datos. Esta opcin es ms rpida que la opcin Borrar tablas, pero no puede utilizarse si existen claves forneas. Borrar registros El archivo creado utiliza instrucciones delete para vaciar las tablas antes de que se carguen los datos. Deshabilitar disparadores El archivo SQL creado deshabilita todos los triggers de todas las tablas antes de que se carguen los datos y las vuelve a habilitar despus de la operacin. Esto puede mejorar el rendimiento y puede llegar a ser necesario si el trigger contiene comprobaciones que no pueden aplicarse durante el proceso de importacin. Deshabilitar restricciones de clave forneas El archivo SQL creado deshabilita todas las claves forneas de las tablas entes de que se carguen los datos, habilitndolos despus. Esto puede ser necesario para tablas auto referenciadas. Las claves forneas entre diferentes tablas no deben ocasionar problemas debido a que se exportan en el orden correcto. Deshabilitar las claves forneas puede mejorar el rendimiento del proceso. Incluir informacin de almacenamiento El archivo SQL creado incluir la informacin original sobre almacenamiento, como los nombres de los tablespaces y su tamao inicial, para las instrucciones de creacin de tablas Esta informacin puede ser distinta entre bases de datos por lo que no siempre es apropiado utilizarla. Incluir privilegios - El archivo SQL generado incluye los permisos de los privilegios de objetos para otros usuarios y roles. Cuando los objetos son recreados en una base de datos diferente, esos usuarios y roles deben existir por razones obvias. Ejecutar commit cada Controla cuantos registros se van a insertar en el archivo SQL generado antes de que se ejecute una instruccin commit. Si este valor se establece a cero, al final de todas las instrucciones insert se ejecutar una instruccin commit. Esto ser necesario para archivos de exportacin muy grandes y con un tamao de los segmentos de rollback pequeo.

Gua del usuario de PL/SQL Developer 9.0

173

Clusula Where Slo los registros que satisfacen la clusula where sern exportados. Es necesario que esta tabla se pueda aplicar a todas las tablas seleccionadas. Entre las ventajas de este mtodo se encuentra la portabilidad del archivo SQL y la posibilidad de editar los resultados con un editor de texto. Utilice la opcin Comprimir para comprimir automticamente la salida en un archivo comprimido para ahorrar espacio en disco. En el ejemplo anterior, se crear el archivo C:\exportdata\demo.sql, el cual se aadir a un archivo comprimido llamado C:\exportdata\demo.sql.zip. Posteriormente el archivo original demo.sql ser borrado.

Mtodo PL/SQL Developer.

Este mtodo de exportacin crea un archivo de exportacin comprimido de PL/SQL Developer, que contiene los datos y la definicin de las tablas. La pestaa contiene las siguientes opciones: Clusula Where Slo los registros que satisfagan las condiciones de la clusula where sern exportados. Las condiciones de la clusula where deben ser aplicables a todas las tablas seleccionadas. Comprimir archivo Deshabilitando esta opcin deshabilitar la compresin. Esto mejorar el rendimiento si los datos no pueden comprimirse bien (ejemplo LONG RAW o BLOB, datos que ya se encuentran comprimidos en la base de datos). Incluir informacin de almacenamiento - El archivo SQL creado contiene la informacin original sobre almacenamiento como los nombres de los tablespaces y los tamaos inciales para las instrucciones de creacin de tablas. Esta informacin puede diferir entre distintas bases de datos, con lo que no siempre puede ser adecuada utilizarla. Incluir privilegios - El archivo SQL generado incluye los permisos de los privilegios de objetos para otros usuarios y roles. Cuando los objetos son recreados en una base de datos diferente, esos usuarios y roles deben existir por razones obvias. Entre las ventajas de este mtodo se encuentra la reduccin en el tamao de los archivos de exportacin, el hecho de que todas las opciones se transfieran a la fase de importacin, y que puede seleccionar fcilmente las tablas durante la importacin.

21.5

Importar tablas.

Gua del usuario de PL/SQL Developer 9.0

174

La herramienta para importar tablas de PL/SQL Developer le permite importar la definicin de las tablas y los datos desde un archivo previamente exportado, existen 3 mtodos para importar tablas, cada uno con su propio formato de ficheros.

Oracle.

Este mtodo utiliza un archivo de volcado creado por la herramienta Oracle export y lanza la herramienta Oracle import para importar los datos. Puede especificar varias opciones, cada una de ellas se corresponde con una opcin de la lnea de comandos de la herramienta (vea la gua Oracle Server utilities). El campo Ejecutable le permite seleccionar una versin especfica de la herramienta Oracle import. Por defecto la versin ms reciente del directorio Oracle Home ser la utilizada. Una vez finalizado el proceso de importacin, una nueva pestaa llamada Registro se har visible. Esta pgina contiene los registros que se han creado mediante la herramienta de importacin.

Gua del usuario de PL/SQL Developer 9.0

175

Insertar SQL.

Este mtodo ejecuta el archivo SQL que fue generado mediante la herramienta de exportacin de las tablas. Puede seleccionar lanzar SQL*Plus para ejecutar el archivo, o utilizar una ventana de comandos. Para la alternativa a SQL*Plus puede seleccionar un archivo especifico de SQL*Plus. Por defecto la versin que se encuentre en el directorio Oracle Home ser la usada.

Mtodo PL/SQL Developer.

Despus de seleccionar un archivo de importacin que fue previamente exportado empleando el mtodo de PL/SQL Developer, puede seleccionar uno o ms archivos de la lista. Las opciones siguientes pueden especificarse:

Gua del usuario de PL/SQL Developer 9.0

176

Eliminar tablas Elimina las tablas antes de que se creen y carguen los datos. Las opciones Crear tablas, Truncar tablas, y Eliminar registros se encuentran deshabilitadas en esta situacin, y tienen un valor implcito. Crear tablas Crea la tabla antes de que se rellenen los datos. Incluyendo restricciones, ndices y permisos. Truncar tablas Trunca la tabla antes de que se carguen los datos. Esta opcin es ms rpida que Eliminar Tablas, pero no se puede utilizar si existen restricciones de clave fornea. Eliminar registros Borra todos los registros antes de que se carguen. Deshabilitar disparadores Deshabilita todos los disparadores de las tablas antes de que se carguen los datos y los vuelve a habilitar despus. Esto puede mejorar el rendimiento y puede ser necesario en algunas ocasiones si los triggers contienen comprobaciones que no pueden ser aplicadas durante el proceso de importacin. Deshabilitar restricciones de clave fornea Deshabilita todas las claves forneas de las tablas antes de que se carguen los datos y las vuelve a habilitar despus. Esto puede ser necesario para claves forneas auto referenciadas. Las claves forneas entre distintas tablas pueden no llevar conflictos, porque las tablas se exportan en el orden correcto. Deshabilitar esta opcin puede mejorar el rendimiento. Ejecutar commit cada Controla el nmero de registros que sern insertados antes de que se ejecute un commit. Si el valor es cero, se ejecutar la instruccin commit al final del archivo SQL para todos los datos insertados. Para archivos de exportacin de gran tamao y segmentos de rollback pequeos sera necesario proveer un valor apropiado aqu.

21.6

Exportar objetos.

Para exportar las instrucciones DDL de los objetos de un usuario puede utilizar la herramienta Exportar objetos. De esta forma puede recrear fcilmente objetos de un usuario a otro, o a otra base de datos. Despus de seleccionar Exportar objetos desde el men Herramientas, todos los objetos del usuario actual se mostrarn en una rejilla.

Despus de seleccionar un archivo de salida, puede presionar el botn Exportar para exportar los objetos. Si no especifica ningn objeto, todos los objetos del usuario se exportarn. Puede seleccionar

Gua del usuario de PL/SQL Developer 9.0

177

los objetos si hace clic sobre ellos, utilizando Control y Shift puede seleccionar varios o un rango de objetos. El archivo de salida es un archivo SQL que es compatible con SQL*Plus y con la ventana de comandos de PL/SQL Developer. Despus de la operacin de exportacin puede presionar el botn Ver para abrir el archivo generado en una ventana de comandos. Seleccionando un usuario diferente, puede exportar los objetos pertenecientes a otro usuario, si los privilegios del usuario actual lo permiten. La opcin Incluir Privilegios debe estar habilitada si quiere incluir los privilegios sobre objetos a otros usuarios y roles. Cuando se recrean los objetos en una base de datos diferente, los usuarios y los roles necesitan existir en la nueva base de datos por razones obvias. De forma similar puede habilitar la opcin Incluir informacin de almacenamiento para aadir la informacin de almacenamiento como los nombres de los tablespaces y su tamao inicial. Esta informacin puede ser diferente entre bases de datos, con lo que puede que no sea adecuada. La opcin Incluir propietario controla si a los objetos se les prefija con el propietario (ejemplo: SCOTT.EMP en lugar de EMP) en el archivo o archivos creados. Las opciones Archivo nico y Archivo por objeto y Archivo por objeto / spec. y body en un nico archivo controlan si se crea un nico archivo SQL que contenga las instrucciones DDL para todos los objetos o si cada objeto debe exportarse a un archivo especfico con el nombre del objeto por nombre del archivo, y la extensin SQL. En caso de un paquete de base de datos puede seleccionar guardar la especificacin y el cuerpo del paquete en un nico archivo. El archivo de salida contendr una serie de llamadas a esos archivos especficos. Todos los archivos se grabarn en el directorio del archivo generado.

21.7

Importar texto.

Gua del usuario de PL/SQL Developer 9.0

178

Con la herramienta Importar texto puede importar archivos ASCII en la base de datos. Orientado a formatos de texto delimitados con comas o tabulados. La herramienta Importar texto intentar determinar el formato de forma automtica, de modo que la mayora de las veces no necesitar definir nada, simplemente seleccionar el archivo, seleccionar la tabla y listo. Cuando abra la herramienta Importar texto y cargue un archivo de texto en ella, obtendr un mensaje como el siguiente:

El importador carga las 100 primeras lneas del archivo de texto, este texto sin formato se muestra en la parte superior de la seccin Datos del archivo. La seccin situada en mitad de la ventana le permite configurar la definicin del archivo de texto. La seccin inferior Previsualizar resultados tiene una rejilla que contiene los datos tal y como se van a importar. La barra de herramientas tiene botones para seleccionar un archivo de texto y pegar el texto desde el portapapeles. Los archivos pueden tener virtualmente un tamao ilimitado, no se leen por completo en memoria .El botn Nuevo borra el contenido de todos los campos de la ventana Importar texto. Los botones Abrir y Guardar definicin le permiten volver a utilizar la definicin. Si quiere importar el archivo de texto en una nueva tabla, presione el botn Crear tabla . Al hacer esto, PL/SQL Developer cargar la ventana de definicin de tablas con la configuracin idnea para importar los datos en la nueva tabla. La configuracin se determina automticamente tan pronto como cargue un archivo, si no es correcta puede crearla o modificarla. Establezca el campo Contador al nmero correcto y seleccione un campo

Gua del usuario de PL/SQL Developer 9.0

179

desde la lista de campos para definir la definicin de campos. En la seccin de datos del archivo el campo de datos especificado est resaltado, permitindole comprobar si la definicin del campo es correcta. Puede utilizar las siguientes opciones para configurar la definicin de los datos a importar. General Contador. Nmero de campos por registro. General Finalizar al final de la lnea. Indica que el registro de datos finaliza al final de la lnea. General Nombre en la cabecera. Indica si el primer registro contiene los nombres de los campos. General Omitir lneas en blanco. Indica que PL/SQL Developer omitir las lneas en blanco. General Carcter para las comillas. Indica cual es el carcter que se utilizar para las cadenas de texto, normalmente comillas dobles o simples. General Comentario. Puede seleccionar el carcter o caracteres que indican un comentario en archivo de texto. General Importar lneas. PL/SQL Developer importar las primeras y la ultima lneas del archivo de texto que indique. Si deja estos valores vacos PL/SQL Developer importar todo el archivo de texto. Campo inicial Posicin relativa. El campo comienza en una posicin relativa al final del campo anterior. 0 indica que el campo comienza donde el campo anterior finaliza. Campo inicial Posicin absoluta. Indica que el campo comienza en una posicin fija. Campo inicial Carcter. Indica que el campo comienza con un carcter especfico. Esta informacin es relativa al final del campo anterior. Campo final Longitud. Indica que el campo tiene una longitud fija. Campo final Carcter. Indica el final del campo con un carcter especfico. Para un archivo estndar delimitado por comas (csv) todos los campos tendrn una posicin inicial relativa de 0, el carcter final debera ser una coma. La lnea de fin (CR/LF o LF o CR), indicar tambin el final del campo, con lo cual para el campo final en una lnea, el carcter final no importa. Cuando tenga la definicin del archivo correcta, necesita seleccionar una tabla de Oracle e indicarle que campos de texto deben importarse en los campos de esa tabla. Esto puede hacerlo en la segunda pestaa:

Gua del usuario de PL/SQL Developer 9.0

180

La parte superior contiene parmetros importantes de tipo general. La seccin Campos le permite asociar campos de archivos de texto y campos de Oracle. La seccin inferior contiene el panel Previsualizar resultados para su informacin. Puede ver las siguientes opciones: Propietario - El nombre del propietario de la tabla o vista. Tabla - La tabla o vista de la base de datos de la que quiere importar los datos. Despus de seleccionar una tabla, la herramienta de importacin intentar determinar el campo y los tipos de campo automticamente. Esto solo funcionar correctamente si el archivo de texto tiene cabecera. Borrar tabla - Cuando esta opcin esta activada, PL/SQL Developer borrara los datos de la tabla antes de importar los nuevos datos. Ejecutar commit cada - Indica despus de cuantos registros se ejecutar una instruccin commit. Si establece esta opcin a 0, slo se ejecutar la instruccin commit al final del proceso de importacin. Sobrescribir duplicados - Especifica si un registro duplicado se actualizar en la base de datos. Los duplicados se basan en los valores contenidos en las claves primarias de las tablas. Ignorar duplicados - Los registros duplicados se ignorarn. Scripts de Inicio/Fin - PL/SQL Developer ejecutar estos scripts antes y despus de que importe los datos. Puede utilizar el cualquier comando o bloque de cdigo SQL, separados mediante puntos y coma.

Gua del usuario de PL/SQL Developer 9.0

181

En la definicin de los campos puede ver una lista con los campos del archivo de texto. Por cada campo puede establecer los siguientes datos: Campo - El campo de la tabla que quiere asociar con el campo de texto: puede dejar esta opcin vaca si no desea importar este campo. Tipo de dato - Definicin del tipo de dato: string, number, date. Funcin SQL - Esta forma le permite definir un proceso de datos adicional de SQL. Para los campos fecha se aade de forma automtica la funcin to_date. Esta es una opcin muy potente, que le permite convertir los datos que importe. Bsicamente puede introducir cualquier cosa que pueda ser procesada por Oracle. Puede aadir a# para indicar una fecha. El botn Crear SQL rellenar este campo con una funcin to_date para los campos tipo fecha. Cuando la definicin de los datos est completa, puede decidir si desea guardarla. La barra de herramientas tiene botones para guardar y cargar los archivos de definicin. La herramienta para importar texto recordar la definicin que se ha usado para el tipo de archivo, la definicin de los datos se cargar de forma automtica la siguiente vez que abra el mismo archivo de texto. Tiene dos botones de importacin, Importar y Generar archivo. La primera opcin comenzar a importar los datos en la tabla seleccionada. La segunda opcin crear un archivo SQL con las instrucciones de insercin necesarias.

21.8

Importar ODBC.

Gua del usuario de PL/SQL Developer 9.0

182

La herramienta Importar ODBC le permite importar los datos desde cualquier fuente de datos ODBC a una tabla de Oracle:

En la primera pgina de la herramienta de importacin ODBC necesita seleccionar la fuente de datos ODBC, y opcionalmente proporcionar un nombre de usuario y una contrasea para dicha fuente de datos. Puede realizar la conexin, despus de la cual la lista de datos ser rellenada con todas las tablas de la fuente de datos. Al seleccionar una tabla se rellenar el panel Vista previa de resultados. En lugar de seleccionar una tabla, puede tambin proporcionar una consulta seleccionando la opcin Importar resultados de la consulta e introducir una consulta. Esto puede resultar til si quiere limitar las filas o columnas, o los resultados provienen de una o ms tablas.

Gua del usuario de PL/SQL Developer 9.0

183

Despus de introducir las especificaciones de la fuente, puede cambiar a la pestaa Datos a Oracle para seleccionar la tabla de destino y especificar el mapeado de las columnas:

En la seccin General puede seleccionar un propietario y una tabla en la que se importarn los datos. Tambin puede seleccionar si desea borrar la tabla antes de realizar la importacin, seleccionar el intervalo a partir del cual se confirmarn los registros (0, indica que se realizar al final de la exportacin) e ignorar las filas duplicadas o sobrescribirlas. En la seccin Campos puede mapear los campos desde el origen de datos ODBC (a la izquierda) con las columnas de la tabla de Oracle (a la derecha). Para cada columna puede, de manera adicional, incluir una funcin SQL. Por ejemplo, si quiere convertir una campo de texto a maysculas, introduzca upper (#). El smbolo de la almohadilla ser reemplazado por el dato del campo para cada registro, y el resultado de la expresin se escribir en la instruccin insert correspondiente. Despus de completar el mapeado de los campos, puede presionar el botn Importar para importar los datos en la tabla de Oracle. Si mantiene presionada la tecla Ctrl se insertar una instruccin de ejemplo de forma que puede verificar el mapeado de los campos y de las funciones SQL que especifico. Para volver a utilizar esta definicin posteriormente, puede presionar el botn Guardar definicin en la barra de herramientas. Esta definicin puede abrirse posteriormente si presiona el botn Abrir definicin.

21.9

Generador de datos.

Gua del usuario de PL/SQL Developer 9.0

184

El generador de datos le permite crear datos de prueba: esto puede servir de ayuda para probar una aplicacin y ver como responde con grandes cantidades de datos. Puede encontrar el Generador de datos en el men Herramientas. Bsicamente, la definicin consiste en una o ms tablas, el nmero de registros que quiere generar y la definicin de los tipos de datos. Los botones de la parte superior izquierda le permiten abrir y guardar la definicin.

Arriba puede ver para la tabla deptdemo y empdemo, parecidas a las conocidas tablas dept y emp. Encontrar los siguientes elementos en esta pgina: Propietario - Nombre del propietario de la tabla. Tabla - Nombre de la tabla. Nmero de registros - El nmero de registros que quiera generar. Estos pueden ser nmeros o un rango de nmeros. Nombre - Nombre del campo. Tipo - Tipo de datos del campo. Tamao - Tamao del campo (cuando sea apropiado), para campos numricos ser, nmero, precisin. Datos - La definicin de los datos de un campo (vea ms abajo). Maestro - Si la tabla es un detalle de otra tabla, puede establecer la tabla maestra. Por cada registro generado, se genera un nmero de registros en el detalle.

Puede utilizar el botn Aadir una tabla existente para aadir una tabla existente. Puede arrastrar y soltar una tabla desde el Explorador de Objetos.

Definicin de los datos.


La definicin de datos determina los datos generados. Si simplemente desea crear caracteres, puede introducir la definicin de los caracteres entre corchetes: Los datos pueden ser una mezcla de los siguientes conjuntos predefinidos: a: a..z (Caracteres en minscula) A: A..Z (Caracteres en mayscula)

Gua del usuario de PL/SQL Developer 9.0

185

@: A..Z y a..z (Todos los caracteres) #: A..Z y a..z and 0..9 (Todos los caracteres y nmeros) *: #33..#126 (Todos los caracteres ASCII) 0: 0..9 (Todos los nmeros) 1: 1..9 (Todos los nmeros excepto el 0)

9: 0..9 (Todos los nmeros) Por ejemplo: [Aaa00] para generar cadenas de texto como: Gxe21, Liy05, etc. Puede aadir un literal, si lo escribe entre comillas simples: Por ejemplo: [AA '-' 1000] para generar cadenas de texto como: CX-4903, SY-1044, etc. Los espacios en blanco utilizados en la definicin de los datos son ignorados a menos que se escriban entre comillas simples. Si quiere repetir un carcter un determinado nmero de veces, puede aadir el nmero al final de cada carcter, si lo escribe entre parntesis (n). Puede tambin aadir un nmero aleatorio (minmax). Por ejemplo: [Aa(5..15) ' ' Aa(8..20)] para generar: "Masfae Qwwecdsadif". El texto introducido en la definicin no necesita ir encerrado entre corchetes. En otras palabras, [hola] y `hola son equivalentes. El texto introducido sin comillas es interpretado como una funcin. Existen varias funciones especiales disponibles: Signal (Min, Max, Delta, Noise) - Devuelve datos tcnicos de medida (como temperaturas). Min y Max determinan el rango, Delta el cambio mximo y Noise le permite aadir algn ruido. Ejemplo: Signal (-10, 20, 0.1, 0.1) Random ([Min], Max) - Devuelve nmeros aleatorios entre Min y Max. Si slo especifica Max, Min se establece a 0. Para campos de tipo fecha, puede introducir fechas para Min y para Max. Sequence (Start, [Inc], [WithinParent]) - Devuelve una secuencia de nmeros, empezando por Start, e incrementando con Inc (el cual es 1 por defecto). Para una tabla detalle puede especificar de forma adicional la palabra reservada WithinParent para indicar que la secuencia debe ser reiniciada para cada registro padre. List ('item'(weight), 'item'(weight), ...) - Devuelve un elemento aleatorio de los elementos especificados. Puede aadir la palabra reservada weight entre parntesis para permitir que los elementos especificados pueden ocurrir ms que otros. Por ejemplo: List ('CLERK'(50), 'SALESMAN'(30), 'MANAGER'(10)). List (select statement) - Igual que la funcin previa List, pero los elementos son devueltos mediante una consulta de seleccin SQL. Puedes utilizar variables para referirse mediante el nombre de valores generados. Por ejemplo: List(select empno from emp where deptno = :deptno) crear una lista para todos los managers en el departamento con el nmero de departamento generado por la consulta. SQL(expresin) - Devuelve la expresin SQL dada. Pudiendo incluir valores estndar de SQL, operadores, funciones, as como tambin funciones definidas por el usuario. La expresin tambin puede ser una instruccin SELECT que devuelva exactamente una columna y una fila. Puede utilizar variables para referirse mediante el nombre a otros valores generados. Por ejemplo: SQL('Department ' || :deptno) Text ([Style], MaxCharacters, [WordsPerLine, LinesPerParagraph]) - Esta funcin devuelve texto. El parmetro Style es opcional puede ser LorumIpsum (valor por defecto), Ingls, Alemn, y Japons. Puede ser un conjunto de caracteres como [aA], en cuyo caso las palabras se generan desde el conjunto especificado.

Gua del usuario de PL/SQL Developer 9.0

186

MaxCharacters determina el tamao mximo del texto generado, y el parmetro opcional WordsPerLine y LinesPerParagraph determinan el tamao de la lnea y del prrafo. El tamao especificado puede ser un nmero o un rango (min..mx.). File (path, path, ...) - Selecciona de forma aleatoria un archivo de las rutas introducidas e inserta sus contenidos. Le permite introducir datos binarios (como imgenes) en la base de datos. La ruta puede tener comodines como d:\images\*.bmp. Puede cambiar el texto resultante de las funciones previas si utilice las siguientes funciones: Uppercase() LowerCase() InitCaps() Por ejemplo: InitCaps( List(select ename from emp) ) Existen diversos tipos de datos predefinidos disponibles para generar datos ms o menos reales. Puede utilizar las siguientes definiciones: Firstname Lista genrica de nombres. Lastname Lista genrica de apellidos. Company Nombres de compaas (lista aleatoria con nombres de compaas existentes). Address1 Lnea de direccin 1. Address2 Lnea de direccin 2. ZIP Cdigo postal. City Ciudad. State Estado. Country Pas. Email (Directamente relacionado con el nombre, apellidos y pas). Existen tambin algunos ejemplos de definiciones de datos creadas por el usuario. Components.Code Elementos relacionados con artculos en general. Components.Description Descripcin del artculo. Components.Price Precio del artculo. Elements.Name Elementos qumicos (nombre). Elements.Symbol Elementos qumicos (smbolo).

Estos conjuntos de datos pueden encontrarse en el directorio DataGenerator\UserData\ como elements.txt y components.txt. Puede aadir su propio conjunto de resultados si lo desea. Simplemente aada un archivo delimitado por comas donde la primera lnea incluya la descripcin entre corchetes. Puede utilizar datos desde su archivo si especifica el nombre, descripcin como los dos ejemplos anteriores. Todas las funciones y los datos mencionados arriba pueden aadirse conjuntamente, por ejemplo: Random(10..99) + '-' + [A(4)] El + es opcional, pero debera existir como mnimo un espacio como separador.

Opciones.
La pestaa de opciones le permite establecer algunas opciones especficas para la definicin del generador de datos. Puede especificar el formato de una fecha (como el usado por ejemplo por la funcin Random). Puede tambin especificar cada cuantos registros quiere ejecutar una instruccin Commit (establezca esta opcin a 0 para ejecutarla slo una vez). La opcin Retraso es til slo en caso de que necesite hacer pruebas en tiempo real, si necesita insertar datos a una velocidad especifica.

Gua del usuario de PL/SQL Developer 9.0

187

La pestaa Definidos por el usuario le permite definir y sobrescribir el conjunto de caracteres utilizados en la definicin de los datos. El elemento ser siempre un carcter simple y el valor es uno o ms rangos de caracteres del estilo de A..Z a..z 0..9 #200..#220. Por ejemplo: para definir un conjunto de caracteres en formato hexadecimal, podra especificar H como el elemento y 0..9 A..F como valor de dicho elemento. La pestaa Script de inicio le permite especificar las instrucciones SQL que deberan ejecutarse antes de que los datos se inserten en la base de datos. Tpicamente podran ser instrucciones para crear las tablas, o truncar las tablas o para seleccionar un determinado segmento de tipo rollback, etc. .Si escribe mltiples instrucciones debe separarlas mediante comas. Las opciones generales sern las usadas por defecto para todos los datos generados y pueden definirse presionando el botn Preferencias situado en la parte izquierda de la ventana. Vea el captulo 20.24 para ms detalles. Esas opciones se sobrescribirn si la opcin correspondiente en el generador de datos est tambin establecida.

Generar datos.
Existen tres botones disponibles en la parte inferior izquierda para generar los datos: Iniciar una prueba Esto generar los datos y los mostrar en una rejilla en la pestaa de resultados. Puede exportar esos resultados en varios formatos si hace clic con el botn derecho del ratn sobre la rejilla. Crear datos como SQL Genera los datos como un archivo SQL. Esto slo funcionar si no aade datos desde un archivo. Crear datos en la base de datos Genera los datos en la base de datos de Oracle.

21.10 Comparar objetos.

Gua del usuario de PL/SQL Developer 9.0

188

Despus de realizar cambios en la definicin de las tablas, vistas, unidades de programa, etc., podra ser interesante propagar esos cambios a otro usuario. Este podra ser un entorno de desarrollo, o un entorno de pruebas. Para comparar los objetos de su usuario de desarrollo con otro usuario puede utilizar la herramienta Comparar objetos en el men Herramientas. Esto le mostrar la siguiente ventana:

En la pestaa de seleccin puede seleccionar los objetos que desea comparar. Despus de hacer esta seleccin, presione el botn Sesin, para seleccionar el usuario y la base de datos que quiere comparar. Esto habilitar el botn Comparar, que puede presionar para iniciar una operacin de comparacin. En la pestaa Opciones, puede establecer las siguientes opciones:

Puede seleccionar la opcin Incluir informacin de almacenamiento en el fichero DDL generado para incluir la informacin de almacenamiento como el nombre del tablespace o los tamaos inciales para los nuevos objetos. Estos podran ser distintos entre las distintas bases de datos, con lo que podra no ser una buena opcin. Puede escoger un Esquema si los objetos son propiedad de un usuario distinto al que se encuentra conectado. La opcin Ignorar capitalizacin en el cdigo PL/SQL ignorar las diferencias entre las maysculas y las minsculas que no afecten a la funcionalidad del cdigo. Las diferencias de capitalizacin de las cadenas de texto de las expresiones del cdigo no ser ignoradas, porque son significativas.

Gua del usuario de PL/SQL Developer 9.0

189

La opcin Ignorar espacios en blanco en el cdigo PL/SQL ignorar las diferencias en los espacios en blanco, los tabulados y los retornos de carro que no afecten a la funcionalidad del cdigo. Las diferencias en los espacios en blanco de las cadenas de texto de las expresiones del cdigo no ser ignoradas, porque son significativas. La opcin Ignorar comentarios en el cdigo PL/SQL ignorar todas las diferencias en todos los comentarios. Cuando finalice la operacin de comparacin, la ventana cambiar a la pestaa Diferencias, en donde ver una lista de todos los objetos que son diferentes:

La lista est ordenada mediante la dependencia. Debajo de la lista de objetos diferentes en el usuario de comparacin, puede ver el cdigo SQL que necesita ejecutarse para igualar los dos objetos entre los usuarios. Si no hay ningn objeto seleccionado, se mostrar el cdigo SQL de todos los objetos. Si uno o ms objetos se encuentran seleccionados, slo el cdigo SQL para el objeto(s) seleccionado se muestra. En el ejemplo anterior podemos ver como se aadi la restriccin EMP_MGR_EMPNO a la tabla EMP. El botn mostrar diferencias mostrar las diferencias lnea a lnea de forma visual de un objeto viejo y uno nuevo. Esto puede ser til para ver los cambios realizados en las unidades de programa, o puede ayudar para determinar porque una instruccin especfica DDL fue generada para otro tipo de objeto. El botn Configurar herramienta de comparacin le permite configurar la herramienta de diferencias que debera usarse. Por defecto se utilizar ExamDiff, para la cual esta disponible una versin Pro (Vea el elemento About del men Info men). Vea el captulo 20.23. Puede presionar el botn Aplicar SQL para ejecutar las instrucciones SQL en la sesin objetivo. Puede de forma alternativa copiar el archivo SQL en un archivo si presiona el botn Guardar SQL a un archivo, o puede copiar las instrucciones SQL al portapapeles si presiona el botn Copiar SQL al portapapeles. Cuando se comparan los objetos, se ignoran las siguientes propiedades: Almacenamiento Propiedades como next extent y pct free de las tablas y de los ndices no se consideran relevantes para el proceso de comparacin. Restricciones con nombres generados por el sistema Esas restricciones tendrn nombres distintos para 2 usuarios con lo que no pueden ser comparadas. Si una tabla es nueva en la sesin objetos, esas restricciones sern generadas. Propiedades de creacin de la tabla Propiedades que requieran que se vuelva a crear la tabla se ignoran.

Gua del usuario de PL/SQL Developer 9.0

190

Datos de la tabla Para exportar los datos de las tablas, utiliza la funcin Exportar tabla (Vea el captulo 21.4). Valores de una secuencia Los valores de una secuencia se consideran datos.

21.11 Comparar datos entre tablas.


Despus de insertar, actualizar y borrar registros en una o ms tablas durante el proceso de desarrollo, puede ser til propagar esos cambios a la misma tabla pero de un usuario diferente. Esto puede deberse a una propagacin de los datos de una base de datos de desarrollo a una base de datos de pruebas, a una base de datos de produccin o a un miembro diferente del proyecto. Para hacerlo puede utilizar la herramienta Comparar datos de las tablas desde el men Herramientas. Esta accin mostrar el siguiente cuadro de dialogo:

En la pestaa de Seleccin puede seleccionar la tabla(s) que quiere comparar. Si desea comparar datos entre tablas que son propiedad de un usuario diferente al que se encuentra conectado, puede seleccionarlo de la lista de usuarios. Despus de hacer esta seleccin, puede presin el botn Sesin para seleccionar el usuario y la base de datos que quiera comparar. Esto habilitar el botn Comparar, que puede presionar para iniciar la operacin de comparacin, aunque tambin puede ir a la pestaa opciones primero:

Gua del usuario de PL/SQL Developer 9.0

191

En esta pestaa puede especificar varias opciones para el proceso de comparacin: Acciones Puede seleccionar varias acciones que quiere realizar en la sesin seleccionada. Si, por ejemplo, omite la accin Borrar, solo se realizarn inserciones y actualizaciones. Confirmar cambios cada N registros Controla despus de cuantos registros se ejecutar la sentencia commit. Si especifica 0, solo se ejecutar la sentencia commit al final del proceso. Modo Seleccione Generar Script para generar un archivo SQL con los inserts, updates, deletes y commits. Puede guardar este archivo posteriormente y ejecutarlo en una ventana de comandos o en SQL*Plus. Seleccione actualizar base de datos para aplicar inmediatamente los cambios en la sesin seleccionada. Esquema Si las tablas se encuentran en un esquema diferente, puede seleccionar dicho esquema aqu. El usuario debe tener los privilegios necesarios en las tablas seleccionadas. Incluir propietario en SQL Esta opcin solo es til en el modo Generar Script, e incluir el nombre del propietario delante de los nombres de las tablas en el cdigo. Esto le permitir conectarse como un usuario diferente cuando ejecute el archivo y podr aplicar los cambios en el esquema correcto. Despus de seleccionar las opciones apropiadas puede presionar el botn Comparar para iniciar el proceso. Despus de su finalizacin se mostrarn las diferencias en la pestaa Diferencias:

Gua del usuario de PL/SQL Developer 9.0

192

En modo de actualizacin, esta pestaa simplemente mostrar el nmero total de registros insertados, actualizados y borrados para cada tabla. En modo de script, puede revisar todas las diferencias y guardar los resultados en un archivo presionando el botn Guardar SQL situado a la derecha. Observe que puede limitar el archivo a tablas especficas haciendo una seleccin de tablas en el panel superior. Tambin puede copiar la consulta SQL al portapapeles o aplicar los cambios seleccionados para la sesin presionando los botones correspondientes, situados en la parte derecha de la ventana.

21.12 Monitor de eventos.

Gua del usuario de PL/SQL Developer 9.0

193

El monitor de eventos le permite capturar y ver los mensajes (dbms_pipe) y las seales (dbms_alert), generadas por las unidades de programa en otras sesiones. Simplemente con especificar el tipo de evento (Alert o Pipe), el nombre(s) de la alerta o pipe, y presionar el botn Inicio. La siguiente captura de pantalla le muestra el monitor de eventos esperando por una alerta llamada DEPT o EMP:

Cualquiera que sea el evento que ocurra, el nombre del pipe o alerta y la fecha se escribe en la pgina de salida, seguida de la informacin del evento: Pipe - Todos los elementos del mensaje se muestran. Alert - El valor del parmetro mensaje de la llamada a dbms_alter.signal se muestra. Para las alertas puede especificar diversos nombres separados por comas. Para eventos pipe slo puede especificar un slo nombre.

21.13 Monitor de sesiones.

Gua del usuario de PL/SQL Developer 9.0

194

El monitor de sesiones le permite ver todas las sesiones en la instancia de la base de datos en la que se encuentra conectado:

En la mitad superior de la ventana puede ver informacin acerca de las sesiones, como el nombre de usuario, el SID y el nmero de serie (los que identifican la sesin), el estado, etc. Puede ordenar la lista de sesiones si hace clic sobre la cabecera de una columna. Por ejemplo: para encontrar rpidamente todas las sesiones activas, haga clic en la cabecera de la columna Status. Puede seleccionar un Filtro de sesin en la barra de tareas para limitar la lista de sesiones a una lista especfica, o limitar el nmero de columnas mostradas. Un filtro puede definir el orden de las sesiones y las columnas. Si hace clic con el botn derecho sobre una sesin, se le mostrar un men contextual con los siguientes elementos: Terminar sesin seleccionada Le permite terminar la sesin seleccionada. Habilitar trazado SQL Habilita el trazador de SQL para la sesin seleccionada. Esta opcin estar deshabilitada si su versin del servidor Oracle no soporta esta caracterstica, o si no tiene privilegios sobre el paquete dbms_system. Deshabilitar trazado SQL Deshabilita el trazador de SQL para la sesin seleccionada. Refrescar lista Refresca el listado de las sesiones. Copiar Copia la lista de sesiones en el portapapeles. Imprimir Imprime la lista de sesiones.

Exportar - Exporta la lista de sesiones en formato CSV, TSV, HTML o XML. Las funciones de refresco, terminar, habilitar trazado y deshabilitar trazado son accesibles a travs de la barra de herramientas que se encuentra en la parte superior de la ventana. La barra de herramientas adicionalmente incluye un botn de Refrescar automticamente. Cuando se encuentra presionado, la lista de sesiones y la informacin de las mismas se refrescar de forma automtica. Puede definir el periodo de refresco si hace clic con el botn derecho del ratn sobre el botn. La mitad inferior de la ventana contiene distintas pestaas con la informacin sobre la sesin seleccionada. La informacin sobre esas pestaas se puede refrescar, copiar o imprimirse si hace clic con el botn derecho del ratn sobre la lista de sesiones y selecciona el correspondiente elemento del

Gua del usuario de PL/SQL Developer 9.0

195

men contextual. Para ms informacin sobre las columnas mostradas en la lista, vea la gua Oracle Server Reference. Puede definir sus propias consultas para la informacin de la sesin de las pestaas o modificar las consultas estndar. Para hacerlo, presione el botn de la barra de herramientas Definir consultas de sesin. Esto le mostrar el siguiente cuadro de dilogo:

En la parte superior puede cambiar entre las consultas de Filtros y Detalles. Los filtros controlan lo que se muestra en la lista de sesiones, y los detalles controlan lo que se muestra en las pestaas de detalle. En la parte derecha puede ver cuatro botones para crear una nueva consulta, borrar una consulta o para mover hacia arriba o hacia abajo la consulta en la lista. Cuando cree o modifique una consulta debe proporcionar la siguiente informacin:

Filtros.
La Etiqueta se muestra en la lista de seleccin de filtros. La Consulta es la instruccin select que trae la informacin para la lista principal de sesiones. Puede utilizar estas consultas para: 1. Limitar las sesiones mostradas (por ejemplo : Solo las sesiones activas) 2. Definir el orden en el que se muestran las sesiones. 3. Definir que columnas se muestran y en que orden.

Detalles.
El Nombre se mostrar en la pestaa en el monitor de sesiones. La posicin en la lista determina la posicin de la pestaa en la ventana del monitor de sesiones. La Consulta es una instruccin SQL que muestra la informacin de la sesin. Esta instruccin select debera contener normalmente la variable: SID, que contendr el SID de la sesin seleccionada cuando ejecute la consulta. Puede utilizar cualquiera de las columnas de la vista v$session, como el: username, o :sql_address, o :sql_has_value. Si su consulta conlleva un error de ejecucin este se mostrar en su correspondiente pestaa despus de la ejecucin. En el ejemplo anterior la consulta Cursors mostrar todos los cursores abiertos para la sesin seleccionada, ordenados por el campo SQL text.

Gua del usuario de PL/SQL Developer 9.0

196

Para concatenar el valor o los valores de varias filas de una consulta de detalle, puede utilizar la sugerencia del compilador /*concatenate */ en la consulta. Por ejemplo:
select sql_text from v$sqltext_with_newlines where address = hextoraw(:sql_address) and hash_value = :sql_hash_value order by piece /* concatenate */

La columna sql_text de todas las filas devueltas por esta consulta ser concatenada y mostrada como un nico valor en los detalles de la sesin.

21.14 Herramientas definidas por el usuario.


Puede definir sus propias herramientas para integrarlas en el entorno de desarrollo de PL/SQL Developer. Esas herramientas pueden aadirse como elementos de men para iniciar aplicaciones externas o para ejecutar instrucciones SQL y PL/SQL en la base de datos para la sesin actual. Un buen ejemplo de esto podra ser SQL*Plus. Puede aadir un men para iniciar SQL*Plus y con las opciones adecuadas puede dejar que SQL*Plus se conecte e incluso ejecutar un archivo que se encuentre abierto actualmente. Otro ejemplo puede ser una herramienta que le permita establecer las opciones NLS a un valor especfico. Puede crear un archivo que ejecute correctamente las instrucciones de tipo alter session, y aadir ese archivo al men desde donde pueda ser llamado para la sesin de la ventana de consulta SQL, la ventana de prueba, etc. Para configurar las herramientas externas tiene que seleccionar el elemento Configurar herramientas en el men Herramientas. Aparecer el siguiente cuadro de dilogo:

Los cuatro botones situados en la parte derecha del cuadro de dilogo le permiten insertar o borrar elementos as como moverlos hacia arriba o hacia abajo en la lista. Si presiona la tecla Ctrl. mientras presiona el botn Nuevo elemento, el nuevo elemento creado se copiar del elemento seleccionado anteriormente. El botn Ejecutar puede utilizarse para ejecutar la herramienta seleccionada. Si pulsa la tecla Ctrl cuando seleccione el botn ejecutar, aparecer un mensaje emergente mostrando la informacin (los parmetros reemplazados), acerca de lo que se debera haber ejecutado. La lista muestra todas las herramientas configuradas y en la mitad inferior la configuracin de las herramientas seleccionadas. La configuracin se divide en tres secciones:

Gua del usuario de PL/SQL Developer 9.0

197

General Para definir el archivo o programa que se va a ejecutar y sus parmetros. Men Para definir el lugar donde el elemento de men debera aparecer. Botn Para definir la imagen del botn y la descripcin en la barra de herramientas. Opciones Para configuracin adicional.

Para explicar la configuracin de herramientas externas aadiremos un men denominado SQL*Plus a PL/SQL Developer como ejemplo.

La pestaa General.
Lo primero que hay que hacer despus de crear un nuevo elemento con el botn Nuevo es definir el tipo de herramienta. Si selecciona External, la herramienta se ejecutar como aplicacin externa. Esto es aplicable para SQL*Plus. Si selecciona Session, la herramienta ejecutar un archivo SQL para la sesin actual cuando se ejecute la herramienta. Lo siguiente que necesita es introducir una descripcin en la pestaa General. La descripcin es el nombre que se mostrar en el men y en la lista de herramientas. Puede introducir un & delante del carcter que quiere utilizar como tecla de acceso directo (S&QL*Plus -> SQL*Plus). Si introduce como descripcin un guin -, se mostrar un separador. El tercer paso es el nombre del programa o el archivo a ejecutar. Para las herramientas externas puede introducir cualquier archivo ejecutable o incluso documentos si as lo desea, en este caso la aplicacin deseada se lanzar. El botn Select directory abre un cuadro de dilogo que le permite buscar los archivos. La mayora de las aplicaciones de Oracle se encuentra en el directorio Oracle_Home\Bin y SQL*Plus puede encontrarse <oracle_home>\bin\sqlplusw.exe. Esos tres pasos son suficientes para hacer que SQL*Plus pueda trabajar desde un men. Puede definir de forma adicional parmetros para pasar a la aplicacin y establecer una ruta por defecto. Puede utilizar la ruta por defecto como alternativa a la ruta completa del archivo ejecutable o parmetros. Para SQL*Plus puede aadir una cadena de conexin (#connect) y un vinculo a un archivo a ejecutar (#file). El botn con una flecha hacia abajo situado en la parte derecha le permite seleccionar una variable que puede insertar en cualquiera de los campos. Esas variables tienen relacin con la conexin actual y el archivo abierto. Reemplazarn la informacin correspondiente cuando se ejecute el archivo. Las siguientes variables estn soportadas:
Variable #file #path #dir #object #otype #owner #oname #connect #username #password #database Significado Representa el nombre del archivo (sin la ruta) del archivo en la ventana actual. El nombre del archivo y su ruta. El directorio del archivo en la ventana actual. El objeto seleccionado en el Explorador de Objetos. (Ejemplo. SCOTT.EMP) El tipo del objeto seleccionado en el Explorador de Objetos. (Ejemplo. TABLE) El propietario del objeto.(SCOTT) El nombre del objeto. (EMP) La cadena de conexin completa de la conexin actual a PL/SQL Developer. (ejemplo scott/tiger@demo) El usuario. La contrasea. La base de datos.

Nota: SQL*Plus no funciona correctamente cuando se le pasa como parmetro una ruta de un archivo que contenga espacios en blanco, ese es el motivo por el cual la variable #dir se especifica como directorio por defecto, siendo necesario indicarle nicamente el nombre del archivo que debe utilizar SQL*Plus.

Gua del usuario de PL/SQL Developer 9.0

198

Herramientas de sesin.
Para las herramientas de sesin necesita especificar un archivo SQL que contenga varias instrucciones SQL o bloques de cdigo PL/SQL. Las instrucciones SQL pueden separarse mediante puntos y comas o barras inversas, los bloques de cdigo PL/SQL necesitan terminarse con una barra invertida, de la misma forma que la sintaxis en SQL*Plus. Ejemplo 1 Alemania.sql:
alter session set nls_language = 'german'; alter session set nls_territory = 'germany';

Ejemplo 2 Role_Especial.sql:
Begin dbms_session.set_role(role_cmd => 'special_role identified by &Password'); end; /

Observe que puede aadir variables de substitucin al archivo para hacerlo aun ms flexible. Se le preguntar por el valor de esas variables cuando ejecute la herramienta. Cuando ejecute el archivo Role_Especial.sql mencionado anteriormente, se le preguntar por el valor de la variable &Password. Si quiere utilizar cualquiera de los parmetros especificados en un archivo, debe utilizar &1, &2,etc. El nmero indica el orden de los parmetros en la lnea de comandos. No se le preguntar por las variables de sustitucin de la lnea de comandos.

La pestaa Men.
Por defecto todas las herramientas configuradas se aaden en la parte inferior del men Herramientas. Si desea crearlas en cualquier otro lado o incluso en su propio men, puede utilizar la pestaa Men:

Si quiere crear el elemento en un men especfico del men principal puede seleccionar uno desde la lista de seleccin Men principal o puede introducir un nuevo nombre si quiere crear un nuevo elemento de men. Si ha introducido un men principal, puede utilizar Submen y Sub-sub Men para indicar la localizacin exacta donde quiere crear el nuevo elemento de men. Puede utilizar los tres botones de radio (Debajo, Superior, Al final), para especificar donde debera colocar el Nuevo men en relacin al men especificado. Si especifica un nuevo (sub) men, debera seleccionar siempre Al final porque Debajo y Encima slo tienen significado si se refieren a un submen existente. Ejemplo 1:
Men principal Submen Sub-sub men Posicin Herramientas Oracle Al final

Gua del usuario de PL/SQL Developer 9.0

199

Esto crear un submen llamado Oracle en el men principal Herramientas. Si va a aadir varias herramientas, un submen especfico podra ser una buena idea. Ejemplo 2:
Men principal Submen Sub-sub men Posicin Oracle

Al final

Esto crear un men principal llamado Oracle. Debera crear solamente un nuevo men principal si utiliza las herramientas regularmente y desea tenerlas todas a mano. Si quiere aadir su herramienta como primer elemento del men Herramientas debera introducir:
Men principal Submen Sub-sub men Posicin Herramientas Preferencias Encima

Esto crear un men por encima del elemento de men existente Preferencias.

La pestaa Botn.
Puede definir si la herramienta externa se incluir en la barra de herramientas:

Botn de la barra de herramientas - Cuando esta opcin est habilitada, la herramienta externa puede incluirse en la barra de herramientas. Descripcin - La descripcin se mostrar como sugerencia cuando situ el cursor del ratn sobre un botn de la barra de herramientas. Si deja esta descripcin vaca, la descripcin de la herramienta externa (tal y como se muestra en el men), se utilizar. Imagen - Presione el botn imagen para seleccionar un archivo BMP (*.BMP), para los botones de la barra de herramienta. El tamao de esa imagen debera ser preferentemente 20x20 pxeles. Observe que PL/SQL Developer siempre cargar el archivo de mapa de bits desde su localizacin original, con lo que no debera eliminar o renombrar este archivo sin cambiar la configuracin de la herramienta externa. PL/SQL Developer viene con un nmero estndar de archivos de tipo bitmap que puede escoger. Esos archivos se encuentran en el subdirectorio Icons en el directorio de instalacin de PL/SQL Developer. Este es el directorio por defecto.

La pestaa Opciones.
La pestaa Opciones le permite establecer las siguientes opciones:

Gua del usuario de PL/SQL Developer 9.0

200

Guardar ventana - Cuando esta opcin esta marcada, la ventana activa se guardar antes de que se ejecute la herramienta. Debera probablemente hacer esto cuando la herramienta coge un archivo como parmetro y quiere asegurarse de que utiliza los datos actuales. Esperar la finalizacin de las herramientas - Cuando esta opcin se encuentra marcada, PL/SQL Developer esperar a que le herramienta se cierre. Esto es til si tiene una programa externo que est modificando un archivo. Cuando ejecute esta opcin el contenido de la ventana activa se refrescar con el cdigo del archivo modificado. Esta opcin se utiliza en combinacin con la opcin Guardar ventana. Conexin activa - Si la herramienta slo es til si PL/SQL Developer se encuentra conectado (si pasa la cadena de conexin como parmetro), debera establecer la opcin Conexin activa. Esto deshabilitar el men si PLSQL Developer no se est conectado. Explorador de Objetos - Marque esta opcin si la herramienta funcionar con los objetos seleccionados en el Explorador de Objetos. Tipo de ventana - Si la herramienta requiere una ventana concreta, puede especificarla en esta seccin. Si una o ms ventanas se encuentran seleccionadas, el men slo se habilitar si la ventana activa es la especificada.

21.15 Organizador de casos de prueba.

Gua del usuario de PL/SQL Developer 9.0

201

Para realizar test de regresin sobre sus programas, puede utilizar el Organizador de casos de prueba. Esta herramienta le permite definir un conjunto de pruebas, (una coleccin de archivos de prueba) con valores asignados a las variables de entrada. Adicionalmente puede especificar el rendimiento deseado:

Para este ejemplo el conjunto de pruebas consta de 3 archivos. Para el archivo seleccionado DeptName.tst, la variable p_emp no tendr el valor de entrada 7499 y despus de su ejecucin la variable result debe contener el valor SALES. Ejecutar un conjunto de pruebas revelar si el programa testeado funciona correctamente y/o se obtiene el rendimiento deseado :

Gua del usuario de PL/SQL Developer 9.0

202

Todos los archivos de prueba errneos tendrn un indicador rojo y sern colocados en la parte superior de la lista. En este caso DeptName (7499) el script fallo, debido a que la especificacin requerida es SALES en vez del valor actual Sales. El panel Log situado en la parte inferior de la ventana de resultados mostrar los resultados de los valores de entrada y de salida de cada variable. Si el archivo de prueba utiliza el paquete DBMS_OUTPUT, la informacin generada tambin se mostrar en el panel de Log.

Crear un conjunto de casos de prueba.


Para crear un conjunto de pruebas, seleccione el elemento Organizador de casos de prueba desde el men Herramientas. Aparecer una ventana vaca del Organizador de casos de prueba en la cual podr crear o aadir nuevos archivos de prueba. En la parte superior puede ver la lista de los archivos, donde podr aadir, crear o cambiar el orden de los archivos y en la parte inferior vera la definicin del archivo seleccionado. Antes de crear un archivo de prueba, es una buena idea guardar el conjunto de resultados presionando el botn Guardar conjunto de resultados en la barra de tareas. Todos los archivos de prueba nuevos sern creados en el mismo directorio que el conjunto de pruebas por defecto, y puede ser de utilidad usar un directorio separado para cada conjunto de pruebas, de forma que todas puedan manejarse desde un nico directorio.

Aadir archivos a un conjunto de casos de prueba.


Existen 2 mtodos para aadir un archivo al conjunto de pruebas:

Gua del usuario de PL/SQL Developer 9.0

203

1.

2.

Arrastrar y soltar un procedimiento o funcin desde el Explorador de Objetos al Organizador de casos de prueba. Se abrir una nueva ventana con una llamada a esta unidad de programa, variables para todos los parmetros y un valor de retorno. Guarde el archivo de prueba con un nombre descriptivo, preferiblemente en el mismo directorio que el conjunto de pruebas. Presione el botn Nuevo, situado en la parte derecha de la lista de archivos. Aparecer la siguiente ventana.

3.

Presione S para crear uno nuevo. Tendr que programar manualmente el archivo de prueba y guardarlo antes de que pueda ser utilizado. Presione No si quiere aadir un archivo de prueba existente al conjunto de resultados. Despus de que se ha guardado un archivo de prueba, puede especificar su definicin en el conjunto de pruebas: Archivo de prueba - El nombre del archivo de prueba. Este campo se rellenar automticamente si ha creado y guardado un Nuevo archivo de prueba. Si quiere aadir un archivo de prueba existente presione el botn Explorar situado a la derecha de este campo. Descripcin Una descripcin funcional para el archivo. Si ejecuta un nico archivo varias veces, debera incluirlo en la descripcin para que pueda ser fcilmente reconocible en la lista de archivos. Nueva sesin Utilice esta opcin para forzar la utilizacin de una nueva sesin para el archivo de pruebas, de esta forma, es independiente de los cambios realizados en el estado de la sesin por la ejecucin previa de otros archivos de pruebas. Por defecto todos los scripts utilizan la misma sesin. Habilitado Utilice esta opcin para habilitar o deshabilitar un archivo para el conjunto de pruebas. Solo los archivos habilitados sern incluidos en el test de prueba y los deshabilitados sern omitidos. Rendimiento El rendimiento requerido puede especificarse como el numero mximo de segundos (fracciones incluidas). Si deja este campo vaco, el rendimiento no ser testeado. Variables Por cada variable en el archivo de prueba, introduzca el nombre, el valor de entrada y el valor de salida requerido. El valor de entrada se pasar al archivo de prueba antes de su ejecucin . Si deja el valor de salida vaco, este no ser testeado. Para testear valores nulos, introduzca la palabra null. Para testear el paquete dbms_output, introduzca dbms_output en el nombre de la variable e introduzca el texto requerido para la variable de salida. Si una variable se marca como Global tendr un valor global que puede ser pasado a otros archivos de pruebas. Si una variable global no tiene ningn valor de entrada, se utilizar el valor global. Despus de la ejecucin el valor de la variable global ser actualizado correctamente. En la parte inferior izquierda puede ver 2 botones que le permitirn ejecutar y comprobar el archivo de prueba seleccionado, o abrirlo en una ventana de prueba para su edicin.

Duplicar un conjunto de pruebas.


Muy a menudo querr ejecutar el mismo conjunto de pruebas con unos valores de entrada y salida diferentes. Para hacer esto puede seleccionar un conjunto de pruebas y presionar la tecla ctrl. mientras presiona el botn Nuevo. El conjunto de pruebas creado heredara todas las propiedades del elemento seleccionando, de esta forma solo tendr que cambiar la descripcin y los valores de las variables.

Gua del usuario de PL/SQL Developer 9.0

204

Ejecutar un conjunto de pruebas.


Para ejecutar un conjunto de pruebas, presione el botn Ejecutar situado en la barra de herramientas. El organizador de casos de prueba cambiara a la pestaa Ejecucin, y cada uno de los archivos de prueba ser ejecutado en una ventana de prueba diferente. Los errores se indicarn con un indicador de color rojo y sern colocados en la parte superior de la lista. Los archivos validos se indicarn con un indicador de color verde y sern colocados en la parte inferior de la lista. Para investigar un error, haga clic con el botn derecho del ratn en el archivo y seleccione Depurar desde el men contextual o haga doble clic sobre el archivo. Se crear una ventana de prueba con el archivo y se establecern las variables de entrada . Ahora podr depurar el archivo de prueba para determinar las causas del error. Haga clic con el botn derecho del ratn sobre la ejecucin de un test para copiar, imprimir o exportar los resultados en varios formatos.

Ejecutar un conjunto de pruebas desde la lnea de comandos.


Puede ejecutar un conjunto de pruebas desde la lnea de comandos mediante la Ventana de Comandos de PL/SQL Developer, por ejemplo:
SQL> RunTestSet U:\TestSets\DeptEmp.ts D:\Temp\DeptEmp.log

Esta accin ejecutar el archivo U:\TestSets\DeptEmp.ts y crear el archivo de log D:\Temp\DeptEmp.log . Si omite el nombre del archivo de log, PL/SQL Developer lo crear automticamente con el mismo nombre que el archivo de pruebas. El archivo de log contiene 3 lneas por cada archivo de pruebas:
Test = <Description of the Test Script> Result = Success | Failed | Error | Slow | Skipped Message = <Message of the Test Script run>

De esta forma puede crear un archivo que ejecute uno o ms archivos de pruebas. El siguiente script ejecutar 2 conjuntos de pruebas y saldr de la aplicacin.
RunTestSet U:\TestSets\DeptEmp.ts D:\Temp\DeptEmp.log RunTestSet U:\TestSets\Sales.ts D:\Temp\Sales.log Exit Application

Este archivo puede ejecutarse directamente desde la lnea de comandos. Por ejemplo:
plsqldev.exe UserID=scott/tiger@chicago CommandFile=U:\TestSets\RunTests.sql

Gua del usuario de PL/SQL Developer 9.0

205

22. El Editor.
Cada ventana que le permite editar cdigo SQL o PL/SQL utiliza el mismo editor. Este editor posee algunas caractersticas especiales que hacen el trabajo del programador un poco ms sencillo.

22.1

Funciones de seleccin.

El editor le permite realizar varias funciones de seleccin de texto. Esas funciones estn disponibles desde el elemento Seleccin del men Edicin, y slo son aplicables si ha realizado una seleccin del texto. Puede asignar una tecla de funcin para esas funciones a travs de la configuracin de las teclas de funcin en la ventana opciones. Aumentar Sangra / Reducir Sangra - El nmero de caracteres depende de las preferencias del editor. Las teclas Tab y Shift-Tab se asigna a estas dos funciones si hay un texto seleccionado en el editor. Maysculas / Minsculas Comentar / Deshacer comentar - Hace un uso rpido de las instrucciones /* */ para comentar rpidamente el texto seleccionado. Aplicar estilo a la sintaxis - Si estableci la opcin Estilo palabras reservadas del Editor a Uppercase, Lowercase o Init Caps, esta opcin aplicar este estilo a las palabras reservadas del texto seleccionado. Ordenar - PL/SQL Developer ordenar las lneas del texto seleccionado en orden ascendente. Si vuelve a llamar a la funcin Ordenar otra vez, las lneas del texto seleccionado se ordenarn en orden descendente. Marcador de Color - Aplica el color determinado en las preferencias al texto seleccionado (vea el captulo 22.11)

22.2

Seleccin de columnas.

Puede seleccionar una columna de texto si mantiene presionada la tecla Alt. Cuando realice la seleccin:

Puede copiar, pegar, cortar, borrar, aumentar o disminuir la sangra, comentar y descomentar el texto seleccionado de forma habitual.

22.3

Asistente de cdigo.

Gua del usuario de PL/SQL Developer 9.0

206

El asistente de cdigo es una potente herramienta de PL/SQL Developer que le proporciona ayuda a medida que teclea cdigo SQL y PL/SQL. Cuando, por ejemplo, teclea dbms_alert. Y duda por un momento, el editor le mostrar la lista de elementos del paquete dbms_alert:

A medida que contina tecleando el nombre del procedimiento dbms_alert, la lista se reducir. Si por ejemplo teclea una r despus de dmbs_alert, slo los procedimientos register, remove, y removeall seguirn presentes en la lista. Cuando presione la tecla Enter mientras el asistente de cdigo se encuentre visible, el elemento seleccionado se insertar en el cdigo. Tambin puede utilizar las teclas de funcin para navegar a travs del asistente de cdigo y seleccionar el elemento deseado. Si presiona la tecla Escape desaparecer el asistente de cdigo. El asistente de cdigo le proporciona informacin acerca de los siguientes tipos de objetos: Tipo de objeto Paquetes. Funciones, Procedimientos. Tablas, Vistas. Secuencia. Usuarios. Variables de tipo Cursor. Variables de tipo Record. Variables de tipo Tabla%rowtype . Tipos de objetos. Variables basadas en objetos. Columnas basadas en objetos. Colecciones. :new and :old Self @ Elementos Procedimientos, funciones, tipos, variables, constantes y Parmetros, definidos con notacin nominal (param => ). Columnas. Valores: Nextval y Currval. Objetos propiedad del usuario. Campos de la consulta del cursor. Campos del tipo de registro. Columnas de la tabla. Atributos (constructor por defecto). Atributos y mtodos. Atributos y mtodos. Mtodos de la coleccin (first, next, limit, ect). Columnas de la table o de la vista del trigger actual. Atributos y mtodos del tipo de datos actual. Una lista de enlaces de bases de datos.

El asistente de cdigo tambin puede ayudarle a teclear los nombres de los objetos (tablas, paquetes, etc.), de las palabras reservadas y de los identificadores de PL/SQL que tengan significado dentro del contexto actual. Si, por ejemplo teclea pro en el editor SQL y duda, las palabras reservadas procedure y profile se mostrarn en el asistente de cdigo, con cualquier nombre de objeto de la base de datos que comience por pro. El contexto depende del usuario conectado (el cual determina la disponibilidad de los nombres de objetos), el tipo del editor (que determina las palabras reservadas disponibles) y la unidad de programa que esta editando (que determina los identificadores PL/SQL disponibles). Los nombres de los objetos de la base de datos que se incluyen en esta lista contextual se recogen cuando se conecta por primera vez a la base de datos. Las consultas que son ejecutadas estn definidas en el archivo CANames.sql que se encuentra en el directorio de instalacin de PL/SQL Developer o en el directorio %APPDATA%\PLSQL Developer. Puede cambiar esas consultas si es necesario.

Gua del usuario de PL/SQL Developer 9.0

207

El asistente de cdigo puede ejecutarse de forma automtica o de forma manual, y el retraso antes de que el asistente de cdigo se active automticamente puede establecerse mediante una opcin. Adems puede definir si desea describir a un usuario y si es as, que tipos de objeto deben incluirse. La descripcin del contexto y el nmero mnimo de caracteres que necesitan ser tecleados antes de que pueda activarse tambin. Todas esas preferencias se describen en el captulo 20.15.

22.4

Historial de instrucciones.

Cada vez que ejecute correctamente una instruccin en una ventana de consulta SQL, una ventana de comandos o una ventana de informes, esta instruccin se almacena en un buffer. Puede volver a ejecutar las instrucciones ejecutadas recientemente en el editor si selecciona el elemento Historial de instrucciones del men Edicin, o presionando las teclas Ctrl E. Esto mostrar una lista de seleccin como la siguiente:

Las instrucciones se muestran en orden de ejecucin, con la ms reciente en primer lugar. En esta lista puede ver la fecha y hora, el usuario y parte del texto de la instruccin ejecutada. Puede seleccionar la instruccin y hacer doble clic sobre ella (o presionar la tecla Enter) para insertarla en la posicin del cursor en el editor desde donde fue llamado. Observe que las instrucciones que incluyen contrasea no se guardan en el buffer por motivos de seguridad. Puede ordenar la lista por fecha y hora, usuario o texto de la instruccin presionando los botones correspondientes en la cabecera de la lista. Para mostrar las instrucciones ejecutadas por el usuario conectado, haga clic con el botn derecho del ratn sobre la lista y seleccione el elemento Usuario actual del men contextual. En el mismo men contextual puede cambiar a Todos los usuarios, borrar una instruccin o copiar el texto de la instruccin al portapapeles. Para encontrar una instruccin especifica puede llamar a la funcin de bsqueda utilizando la correspondiente tecla de funcin (por defecto Ctrl F), o haciendo clic con el botn derecho del ratn en la lista y seleccionando el elemento Buscar instruccin del men contextual. La funcin de bsqueda comenzar a buscar a partir de la instruccin seleccionada y continuar hasta la primera instruccin si no ha encontrado una instruccin exacta. Adems el men contextual contiene funciones para borrar las instrucciones seleccionadas de la lista, copiarlas al portapapeles o exportar la lista completa a un archivo CSV. El buffer puede almacenar hasta 200 instrucciones, que se guardarn en el directorio de datos de la aplicacin, en el perfil del usuario de Windows. Puede cambiar este limite y el directorio a travs de las opciones correspondientes en la ventana de preferencias (vea el captulo 20.26).

22.5

Formato especial.

Si utiliza PL/SQL Developer para escribir cdigo PL/SQL o SQL que luego utilizar en otras herramientas, como por ejemplo, un lenguaje de programacin de tercera generacin puede que necesite

Gua del usuario de PL/SQL Developer 9.0

208

el cdigo en un formato diferente. Asumiremos que quiere escribir y testear una instruccin SQL como la que se muestra a continuacin en PL/SQL Developer:
select deptno, sum(sal) mgr_sal from emp where job = 'MANAGER' group by deptno order by mgr_sal desc

Si, por ejemplo, quiere utilizar esta instruccin en Borland Delphi, necesita un formato como este:
SQL := 'select deptno, sum(sal) mgr_sal from emp' + #13#10 + 'where job = ''MANAGER''' + #13#10 + 'group by deptno' + #13#10 + 'order by mgr_sal desc';

Para este propsito puede utilizar la function Formato especial del men Edicin o del men contextual despus de hacer clic con el botn derecho del ratn sobre una seleccin de texto en el editor. Esta funcin tiene un submen, que le muestra todos los formatos que se encuentran definidos despus de seleccionar el formato, el cdigo convertido se almacena en el portapapeles, con lo que puede pegarlo posteriormente en el editor de la herramienta correspondiente. Los formatos estn definidos en el subdirectorio SpecialCopy en el directorio de instalacin de PL/SQL Developer. Puede cambiar los formatos de copia predefinidos o aadir nuevos formatos. Simplemente aada un archivo de texto con la extensin .copy que contenga la variable para la primera lnea de cdigo PL/SQL (<linea_n>) y una variable para todas las dems lneas (<lnea_*>). El ejemplo para Borland Delphi es como el siguiente:
;PL/SQL Developer SpecialCopy definition for Borland Delphi ;<line_1> for first line ;<line_*> for all other lines ;<line_N> for last line ; SQL := '<line_1>' + #13#10 + '<line_*>' + #13#10 + '<line_n>';

La primera lnea necesita ir precedida de la asignacin a la variable SQL, y necesita ir seguida de una pareja de CR/LF. La ltima lnea no necesita la pareja CR/LF, pero necesita finalizarse con un punto y coma. Todas las dems lneas necesitan ir seguidas de un CR/LF. En algunos lenguajes necesita utilizar secuencias de escape para caracteres especiales. Por ejemplo, en C++, debera utilizar \t para los tabulados (cdigo ASCII 9). Para definir esas secuencias de escape, utilice la palabra reservada #define:
#define char(9) = \t #define \ = \\ String("<line_1>\n") + String("<line_*>\n") + String("<line_n>");

Puede de forma adicional utilizar #define compress para indicar que desea eliminar todos los caracteres en blanco redundantes del resultado (espacios, tabulados). Observe que el nombre del archivo .copy ser incluido en el men, con lo que debera utilizar un nombre descriptivo.

Gua del usuario de PL/SQL Developer 9.0

209

22.6

Ayuda sensible al contexto.

La mayora de los programadores frecuentemente necesitan acceder a informacin acerca de las funciones que estn utilizando en sus programas. Para encontrar las referencias a esa informacin tan rpido como sea posible, site el cursor sobre el texto del cdigo y presione el botn F1 para buscar informacin sobre este elemento en los manuales en lnea de Oracle. Puede leer el captulo 31 para ms informacin sobre el sistema de ayuda de PL/SQL Developer.

22.7

Men contextual de los objetos de la base de datos.

Cuando su programa accede a los objetos de la base de datos, muy a menudo necesita obtener informacin sobre este objeto o quiere manipularlo. Puede querer conocer su descripcin o sus propiedades. Para una tabla o vista podra consultar o editar los datos. Para una funcin o procedimiento quiz quiera probar una determinada situacin. Si hace clic con el botn derecho sobre nombre de un objeto en el editor, ver el mismo men contextual que si hiciese clic con el botn derecho sobre el Explorador de Objetos. Adems, todas las funciones relevantes para este objeto se encuentran disponibles desde el propio editor.

22.8

Plan de ejecucin.

Para llamar a la ventana del plan de ejecucin para una consulta en el editor, seleccione el texto de la consulta, haga clic con el botn derecho del ratn sobre l y seleccione el elemento Explain Plan del men contextual. Si no ha seleccionado ningn texto, el cdigo completo se llevar a la ventana del plan de ejecucin. Si la consulta contiene cdigo PL/SQL, debe modificar las instrucciones en la ventana del plan de ejecucin como se describe en el captulo 6.1.

22.9

Macros.

El editor tiene una potente funcin de macros que le permite grabar y reproducir macros fcilmente, que pueden utilizarse para automatizar tareas repetitivas. Una macro grabada puede almacenarse en la librera de macros para ejecutarse posteriormente. Las macros en la librera normalmente realizarn algunas tareas repetitivas (como cambiar asignaciones a:=b; -> b:=a;), o pueden contener pequeos fragmentos de cdigo. Por ejemplo, porqu buscar como se declara un determinado tipo de cursor cuando puede teclearlo una vez y grabarlo para su posterior uso? Para grabar una macro, presione la tecla de funcin F11 o seleccione el elemento Record en el men Macro del men Herramientas. Todas las pulsaciones de teclado se graban. Presione F11 otra vez para finalizar la grabacin de la macro. Presione F12 para reproducir la macro.

Gua del usuario de PL/SQL Developer 9.0

210

Para almacenar una macro grabada en la librera de macros, seleccione el elemento Library en el men Macro. Esta accin abrir el cuadro de dilogo de la librera de macros:

Presione el botn Nuevo para aadir una nueva macro con la definicin grabada. Puede introducir una descripcin para la macro e indicar si debera aparecer en el men Macro. De esta forma puede hacer que las macros estn fcilmente disponibles, y puede asignarles una tecla de funcin a cada macro a travs de las preferencias Teclas. Si la opcin Macros como elementos del men est habilitada, el elemento Macro se sita en el men principal. Si no esta habilitada, se encuentra localizada en el men Herramientas. Cuando la opcin Botn de la barra de herramientas esta habilitada, la herramienta externa puede incluirse de forma adicional en la barra de herramientas .La descripcin se mostrar como sugerencia cuando mantenga el cursor del ratn sobre el botn de la barra de herramientas. Si deja esta descripcin en blanco, la descripcin principal de la macro (como se muestra en la librera y en el men) se utilizar. Presione el botn Imagen para seleccionar un archivo de tipo bitmap (*.bmp ) para el botn de la barra de herramientas. El tamao de la imagen debe ser preferiblemente de 20x20 pxeles. Observe que PL/SQL Developer siempre carga los archivos de bitmap desde su localizacin original, con lo cual no debera eliminar o cambiar el nombre sin cambiarlo tambin en la macro correspondiente. PL/SQL Developer viene con un nmero de archivos bitmap estndar que puede elegir. Esos archivos se encuentran en el directorio Icons en el directorio de instalacin de PL/SQL Developer. Este es el directorio por defecto para el selector de imgenes. En la pestaa Teclas puede ver y cambiar las acciones del teclado para esta macro. Para ejecutar una macro almacenada, abra la librera de macros y haga doble clic sobre el nombre de la macro que desea ejecutar. La macro seleccionada puede ejecutarse si presiona la tecla F11. Cuando seleccione una macro en el men, esta se ejecutar automticamente, pudiendo ejecutarla de nuevo si presiona la tecla F12.

22.10 Marcadores.
Para marcar una posicin especfica en un editor, puede aadir un marcador. Simplemente presione Ctrl-Kn (donde n es un numero desde el 0 hasta el 9) para aadir un marcador en dicha posicin. Un marcador de color verde aparecer en un lateral del editor, con el nmero correspondiente. Para navegar a ese marcador mas adelante, presione Ctrl-Qn. De forma alternativa puede utilizar los submens Establecer marcador e Ir a marcador desde el men Edicin.

Gua del usuario de PL/SQL Developer 9.0

211

El elemento Lista de marcadores del men Edicin mostrar una vista jerrquica con todos los marcadores de los editores:

En esta vista puede ver las ventanas, editores y lneas donde se encuentra un marcador. Si hace clic en un marcador se mostrara la ventana y el editor y se navegara a la posicin del marcador. Puede acoplar la lista de marcadores para que sea accesible siempre sin bloquear ninguna otra ventana.

22.11 Marcador de color.


Puede aadir marcas de color en un editor para resaltar secciones especficas. Para hacerlo, seleccione el texto que desee resaltar y presione el botn Marcador de color en la barra de herramientas: El color de fondo del texto seleccionado cambiara al color seleccionado del marcador:

Para cambiar el color del marcador, presione la flecha situada al lado del botn y seleccione un Nuevo color. Para limpiar el texto seleccionado, site el cursor dentro del texto marcado sin realizar ninguna seleccin, y presione el botn Marcador de color.

22.12 Contenido del cdigo.

Gua del usuario de PL/SQL Developer 9.0

212

La herramienta contenido del cdigo esta restringida al editor de programas. Este muestra la estructura completa de una unidad de programa. Esto es til para los cuerpos de los paquetes y tipos cuando estos son muy largos, extendindose miles de lneas de cdigo PL/SQL. El contenido de cdigo se muestra en un rbol jerrquico en la parte izquierda de la ventana de programas.

La herramienta contenido de cdigo controla su posicin en el cdigo. Mientras navega a travs del cdigo, el elemento seleccionado le indicar donde se encuentra situado exactamente. Si mueve el cursor del ratn sobre un elemento en el contenido del cdigo, el cdigo correspondiente en el editor se resaltar como se muestra en la imagen superior. Si hace clic en el contenido del cdigo inmediatamente navegar a la declaracin de dicho elemento. Si hace doble clic en el elemento lo expandir o lo colapsar. Si hace clic con el botn derecho del ratn sobre un elemento se mostrar un men contextual que le permitir seleccionar el cdigo en el editor, copiar o cortarlo al portapapeles, comentarlo, expandir todos sus elementos o crear un archivo de prueba (en caso de que sea una unidad de programa de tipo pblico). El contenido puede ordenarse alfabticamente si presiona el botn Ordenar contenido situado en la parte superior del panel de contenido. Slo se ordenar el contenido principal: parmetros, variables locales, etc., no se ordenarn. El botn permanecer presionado, y presionndolo otra vez cambiar el contenido a su orden original. Para cerrar el panel de contenido del cdigo, haga clic en el botn Cerrar contenido situado en esquina superior derecha. Tambin puede hacer clic con el botn derecho del ratn en el editor y seleccionar el elemento Mostrar contenidos para que aparezca o desaparezca, o seleccione el elemento Contenido del cdigo en el men Herramientas. Por defecto el panel de contenido del cdigo est visible. Para cambiar esta opcin por defecto cierre el contenido del cdigo en la ventana de programa y seleccione el elemento Guardar organizacin de las ventanas en el men Ventana.

22.13 Jerarqua del cdigo.

Gua del usuario de PL/SQL Developer 9.0

213

La jerarqua del cdigo est restringida al editor de programas y muestra la estructura jerrquica del cdigo PL/SQL en la posicin del cursor. La jerarqua de cdigo se encuentra situada en la parte superior del editor:

En el ejemplo anterior, el cursor se encuentra situado en una instruccin Select dentro de Code section dentro de Function .Si mueve el ratn sobre los elementos de la jerarqua del cdigo, PL/SQ Developer resaltar el cdigo correspondiente. Si hace clic con el ratn encima de un elemento se seleccionar el cdigo fuente correspondiente. Si hace clic con el botn derecho del ratn sobre un elemento (como se muestra en la imagen superior), se mostrar un men contextual que le permite seleccionar el cdigo fuente, para cortar o copiar el cdigo al portapapeles, para pegar el cdigo del portapapeles sobre el elemento, para borrar el cdigo o para comentar el cdigo y viceversa.

22.14 Mostrar / Ocultar cdigo.


Esta funcionalidad le permite mostrar u ocultar secciones especficas de cdigo fuente en PL/SQL Developer. De esta forma puede ocultar todos los procedimientos y funciones dentro de un paquete y mostrar nica y exclusivamente solo los que sean de inters para usted. Como ejemplo puede ocultar estructuras de cdigo como los loops y las instrucciones if..then..else, para tener una visin global mejor de su programa si este es muy amplio. En el siguiente ejemplo se han ocultado varias funciones as como tambin una instruccin if..then..else..

Gua del usuario de PL/SQL Developer 9.0

214

Para ocultar una seccin de cdigo simplemente haga clic sobre el smbolo menos - situado en la parte derecha del editor de cdigo. Puede hacer clic con el botn derecho del ratn sobre el margen izquierdo y seleccionar el elemento Mostrar /ocultar todo men contextual. Si mueve el puntero del ratn sobre una lnea de cdigo oculta en el editor, la seccin de cdigo que se encuentra oculta se mostrar en un panel diferente.

22.15 Divisin del editor de cdigo.


PL/SQL Developer le permite editar o ver 2 secciones separadas del mismo cdigo fuente. Para poder utilizar esta nueva funcionalidad, simplemente haga clic y arrastre hacia la parte inferior del editor la barra de divisin que se encuentra situada en la parte superior del editor de cdigo:

As podr navegar, editar y ver ambas secciones de cdigo al mismo tiempo.

22.16 Navegacin mediante vnculos.

Gua del usuario de PL/SQL Developer 9.0

215

A menudo en su cdigo PL/SQL puede tener referencias a otros elementos que se encuentran definidos en otra parte. Puede, por ejemplo, hacer referencia a un tipo de PL/SQL dentro del mismo cuerpo del paquete, dentro de la especificacin del mismo, o dentro de otro paquete de la base de datos. Lo mismo ocurre con las llamadas a las funciones o procedimientos, variables, vistas, etc. Es fcil encontrar una declaracin desde una ventana de programa, puede mover el puntero del ratn sobre dicha referencia, presionar la tecla Ctrl. y hacer clic con el botn izquierdo del ratn. Despus de presionar la tecla Ctrl.; el identificador situado debajo del puntero del ratn se volver azul claro y se subrayar, asemejndose a los vnculos de un documento HTML:

Si la declaracin se encuentra dentro de la misma fuente, PL/SQL Developer navegar all. Despus de esto, se buscarn el resto de las unidades de programa dentro de la misma ventana de programa. Despus buscar en todas las dems ventanas de programa que se encuentren abiertas. Finalmente intentar abrir una nueva ventana de programa o ventana de consulta SQL para el objeto que contenga la declaracin y navegar all. Por defecto la navegacin mediante vnculos localizar una declaracin en un paquete o en la especificacin de un tipo, si es apropiado. Para abrir el paquete o el cuerpo del tipo en lugar de la especificacin del mismo, puede hacer clic con el botn derecho del ratn sobre el vnculo.

22.17 Botones de navegacin.


Cada vez que cambia de posicin en una ventana de programa, PL/SQL Developer crear un marcador para la posicin anterior. Puede acceder a estos marcadores mediante los botones Volver a e Ir a...

Los marcadores se aadirn cuando navegue a travs del contenido del cdigo, utilice la funcin de bsqueda, haga clic en un error de compilacin o se desplace a la parte inicial o final del editor, utilice la navegacin mediante vnculos, abra una nueva ventana, etc.

22.18 Refactorizacin.
La funcin de refactorizacin le permite organizar rpidamente su cdigo PL/SQL. Trabaja sobre el cdigo seleccionado, o si no se ha realizado ninguna seleccin sobre la instruccin actual. Si hace

Gua del usuario de PL/SQL Developer 9.0

216

clic con el botn derecho del ratn sobre una instruccin o sobre una seleccin aparecern las siguientes opciones de refactorizacin en el submen correspondiente: Renombrar elemento - Renombra la variable, parmetro, constante o unidad de programa. Tanto la declaracin como la utilizacin sern renombradas. Extraer procedimiento - Si una unidad de programa se ha hecho muy larga o muy compleja, puede seleccionarla y convertirla en un procedimiento separado. Todas las variables utilizadas, tanto dentro como fuera de la seleccin se convertirn en parmetros. Slo las variables incluidas dentro de la seleccin se movern desde la unidad de programa actual a una nueva unidad de programa. La seleccin ser reemplazada con una llamada a la nueva unidad de programa. Extraer constante local - Si una determinada expresin debera convertirse en una constante local, puede seleccionarla y proporcionar un nombre para la constante. Se creara una constante local dentro del subprograma actual, del tipo determinado por la expresin. Todas las ocurrencias de la expresin en el subprograma actual sern reemplazadas por el nombre de la constante. Extraer constante global - Si una determinada expresin debera convertirse en una constante global, puede seleccionarla y proporcionar un nombre para la constante. Se crear una constante global dentro del paquete actual, de un tipo que vendr determinado por la expresin. Todas las coincidencias de la expresin en el paquete actual sern reemplazadas por el nombre de la constante. Reemplazar asignacin con inicializacin - Si la asignacin de un valor a una variable local es exclusivamente para su inicializacin, puede moverla a la declaracin de la variable. Puede hacer clic con el botn derecho del ratn sobre una o varias instrucciones. Si los resultados de la refactorizacin no son satisfactorios, puede simplemente, deshacerlo.

22.19 Barra de bsqueda.


La barra de bsqueda se encuentra disponible en el men Edicin y puede mostrarse como una barra de herramientas flotante o anclada en la parte superior o inferior del rea de trabajo. Cuando se encuentra acoplada, esta permanentemente disponible para realizar bsquedas a travs de mltiples ventanas y editores:

Despus de introducir una palabra a buscar, puede presionar el botn Buscar o presionar la tecla Enter. Los resultados de la bsqueda se resaltarn en el editor(es), puede presionar los botones de Buscar anterior / Buscar siguiente para navegar a travs de los resultados de la bsqueda. Puede presionar la tecla Esc para mover el foco de la aplicacin desde la barra de bsqueda al editor. Presione el botn Ocultar ocurrencias para limpiar los resultados resaltados en los editores.

Gua del usuario de PL/SQL Developer 9.0

217

El botn Lista de resultados mostrar una representacin jerrquica con los resultados de la bsqueda realizada.

En esta vista jerrquica puede ver las ventanas, editores y lneas donde se hayan encontrado resultados. Si hace clic en un resultado de la bsqueda se abrir la ventana y el editor, navegara hasta el resultado y se seleccionara. Puede acoplar la lista de resultados para que sea accesible siempre sin bloquear ninguna otra ventana. En la barra de bsqueda, puede adicionalmente habilitar las opciones para buscar en todos los editores o en el editor actual, para que la bsqueda distinga entre maysculas y minsculas, para buscar palabras completas nicamente o para utilizar expresiones regulares.

Gua del usuario de PL/SQL Developer 9.0

218

23. El editor de datos.


Puede utilizar el editor de datos siempre que necesite ver y editar columnas o variables de tipo long, long raw, CLOB, BLOB o BFILE. Puede utilizarlo adicionalmente para editar datos de tipo varchar2. El editor de datos analizar los datos e intentar mostrarlos en el formato correcto. Puede mostrar valores en formato texto, formato RTF, formato XML, formato HTML, imgenes (bmp, jpg, gif, tiff y otros) y datos en formato hexadecimal. Adems puede abrir aplicaciones externas (ejemplo Microsoft Word o Acrobat Reader) para ver o editar los datos. Si utiliza el editor de datos para visualizar una imagen se mostrar la siguiente ventana:

La barra de herramientas situada en la parte superior del editor incluye los siguientes botones: Abrir Abre el contenido de un archivo en el editor. Guardar Guarda el contenido del editor en un archivo. Imprimir Imprime el contenido del editor en el formato seleccionado. Cortar Coloca el contenido del editor en el portapapeles, borrndolo posteriormente del editor. Copiar - Copia el contenido del editor en el portapapeles en el formato seleccionado. Pegar Pega los datos del portapapeles en el editor en el formato seleccionado. Limpiar Borra el contenido del editor. Debajo de la barra de herramientas puede seleccionar la pestaa para el formato correcto del editor de contenidos. Mltiples formatos pueden aplicarse a algunos datos. Por ejemplo, un documento HTML puede verse en formato HTML o en formato de texto. Todos los datos pueden visualizarse en formato hexadecimal. Cuando realice cambios en el editor de contenido en un formato especifico, puede cambiar a un formato diferente para ver esos cambios. Por ejemplo cuando se encuentre visualizando un documento HTML puede cambiar a formato texto para realizar cambios y volver a la ventana formato HTML para ver esos cambios. Despus de presionar el botn Aceptar los cambios se reflejarn donde haya llamado al editor de datos.

Gua del usuario de PL/SQL Developer 9.0

219

23.1

Editar archivos de texto.

Puede utilizar el editor de texto para ver o editar cualquier tipo de datos en formato de texto plano:

Tambin puede ser utilizado para editar texto en formato XML y HTML. Si cambia entre las pestaas de XML y HTML se mostrarn de inmediato los resultados de esos cambios.

23.2

Editar datos en formato RTF.

El editor RTF puede ser utilizado para ver y mantener texto en formato enriquecido. Esto le permite cambiar fcilmente el tipo de fuente, tamao, color, estilo y alineacin.

23.3

Editar datos en formato XML.

Gua del usuario de PL/SQL Developer 9.0

220

Cuando visualice contenido XML, el editor cambiar a la pestaa XML:

Aqu puede ver la estructura de un documento XML en una vista jerrquica y editar los elementos individuales y sus atributos. Si presiona el botn Analizar XML analizar el documento XML y se visualizarn los errores. Esto requiere que tenga instalado Net8.1 o superior, y que el usuario tenga acceso al tipo SYS.XMLTYPE o al paquete XMLPARSER. Puede presionar el botn Formatear XML en la barra de herramientas para aplicar las reglas de formateo estndar en el documento. Si cambia a la pestaa de texto para visualizar un documento XML, se resaltar la sintaxis del mismo.

23.4

Editar HTML

Gua del usuario de PL/SQL Developer 9.0

221

Cuando est viendo contenido en formato HTML, el editor cambiar a la pestaa HTML:

Esta vista est siempre en modo de solo lectura. De todas formas, puede cambiar a la pestaa Texto para ver y editar los datos en formato texto plano, y volver a la pestaa HTML para ver los datos con el diseo formateado.

23.5

Editar imgenes.

El editor de imgenes mostrar imgenes en los formatos ms populares, como JPG, GIF, BMP, etc. Si una imagen es ms larga de lo que el editor puede mostrar, se ajustar para que pueda visualizarse completamente. Este ajuste no afectar al contenido, siendo un efecto puramente visual. Debajo de la imagen podr ver el formato de la imagen y su tamao en pxeles. Para cambiar una imagen, puede presionar el botn Abrir situado en la barra de herramientas para cargar una imagen desde un archivo, o puede copiar la imagen desde otra fuente al portapapeles y presionar el botn Pegar. Observe que el formato de la imagen cambiar a BMP cuando lo copie o lo pegue desde el portapapeles. Para asegurarse de que se mantiene el formato original debera cargarlo desde un archivo.

23.6

Editar datos en formato hexadecimal.

Gua del usuario de PL/SQL Developer 9.0

222

Para ver o editar contenidos en formato hexadecimal puede cambiar a la pestaa Hex:

En la parte izquierda puede ver 8 columnas con words (16 bits) de datos en formato hexadecimal. En la parte derecha puede ver la representacin de los datos en modo texto. Puede editar ambos, el hexadecimal y el formato texto. Si hace clic con el botn derecho del ratn sobre el editor hexadecimal puede seleccionar un diseo de columna diferente.

23.7

Cargar un visor o un editor externo.

Para muchos de los objetos que se almacenan en la base de datos podra ser necesario llamar a un visor o a un editor externo. Por ejemplo, si una columna de tipo BLOB contiene un archivo PDF (Portable Document File), podra ser necesario abrir el programa Acrobat Reader. Cuando llama al editor de datos para dicho contenido, se le llevar a la pestaa Texto o Hex. Despus de esto puede cambiar a la pestaa Herr. Externa.

Aqu puede definir que programa debe ejecutarse. Primero necesita definir la extensin del archivo. Antes de ejecutar el programa, se crear un archivo temporal con los contenidos del editor con dicha

Gua del usuario de PL/SQL Developer 9.0

223

extensin. A continuacin necesitar definir que programas deberan ser ejecutados. Despus puede presionar el botn Ejecutar para ver el contenido en el programa. Si cambia el archivo en un programa externo y lo guarda, el editor de datos le notificar los cambios y le permitir importarlos al editor. Cuando se encuentre visualizando los datos de una columna, la asociacin entre la tabla/columna y la aplicacin externa ser memorizada para la prxima vez que la visualice. Si activa la opcin Ejecutar automticamente la prxima vez, el editor de datos cargar directamente la aplicacin externa. Para evitar esto puede presionar la tecla Ctrl la prxima vez que llame al editor. La mayora de los programas tienen las extensiones registradas, en lugar de definir manualmente la extensin y el programa, puede seleccionarlo de una lista. Para ello presione el botn Mostrar extensiones registradas y despus busque el archivo correcto y haga doble clic en l. Para los archivos PDF podra ser Adobe Acrobat:

Si hace clic con el botn derecho del ratn sobre la lista de tipos, puede ordenar la lista por extensin o por su descripcin (valor por defecto).

Gua del usuario de PL/SQL Developer 9.0

224

24. Constructor de consultas.


El constructor de consultas le permite crear y modificar consultas de seleccin para sus archivos de cdigo PL/SQL y SQL. Le proporciona un interface sencillo para crear la lista de campos, la lista de tablas, la clusula Where y la clusula Order By de las consultas de seleccin.

24.1

Crear una nueva consulta de seleccin.

Para este ejemplo asumiremos que quiere crear una consulta de unin (join) entre la tabla dept y emp, y mostrar algunas columnas de ambas tablas:
select e.empno, e.ename, d.deptno, d.dname from emp e, dept d order by e.empno

Para crear una nueva consulta, site el cursor en la posicin en la que quiera insertar el texto y presione el botn Constructor de consultas situado en la barra de herramientas (o seleccione el elemento Constructor de consultas en el men Herramientas). Esto le mostrar una ventana vaca del Constructor de consultas:

En la parte izquierda puede ver un Explorador de Objetos con las tablas y vistas de la base de datos. En la parte inferior puede ver 3 paneles con la lista de campos (y de forma opcional la lista de elementos into), la clusula Where y la clusula Order By. La seccin inferior contiene una pestaa que le permite cambiar para ver el texto SQL que se ha generado desde la definicin de consulta actual. En la parte superior de la ventana, puede ver una barra de herramientas con los botones Nuevo, Abrir, para abrir un definicin de una consulta previamente guardada., Guardar para archivar la definicin actual a un archivo, el botn Parse para analizar la definicin de la consulta, y un botn de preferencias. El botn Aceptar le devuelve al editor de SQL o PL/SQL e inserta la consulta que ha construido.

Gua del usuario de PL/SQL Developer 9.0

225

Para incluir tablas o vistas en una consulta, arrstrelas desde el Explorador de Objetos hasta el rea de trabajo. Cada vez que aada una nueva tabla, aparecer el dilogo de propiedades de la tabla.

Desde aqu puede introducir un alias para la tabla. Para nuestro ejemplo queremos utilizar la e para la tabla emp:

Despus de aadir la tabla Dept de la misma forma, se le preguntar si desea unir las dos tablas utilizando las columnas de la clave fornea denominada EMP_FOREIGN_KEY:

Despus de marcar esta opcin, podr ver la nueva condicin de unin en la mitad inferior del formulario.

Gua del usuario de PL/SQL Developer 9.0

226

Ahora ha aadido la tabla Dept y la condicin de unin se ver en el rea de trabajo:

Lo que necesitamos hacer ahora es incluir las columnas en la lista de campos de la consulta. Para ello haga clic en las casillas de seleccin situadas al lado de los nombres de las columnas. Las columnas se mostrarn en el panel Campos:

Si quiere crear una consulta para un procedimiento o funcin PL/SQL, necesita especificar los elementos de tipo into en la lista de elementos. La lista de seleccin mostrar las variables que se encuentran definidas en el cdigo PL/SQL donde va a insertar la instruccin. En nuestro caso no queremos crear una lista de elementos into, con lo que dejamos esos elementos vacos.

Gua del usuario de PL/SQL Developer 9.0

227

Para crear la clusula order by arrastre la columna empno sobre el panel Order By:

Puede presionar Aceptar para insertar la consulta en el editor.

24.2

Modificar una consulta de seleccin existente.

Para modificar una consulta de seleccin existente en su cdigo PL/SQ o SQL, haga clic con el botn derecho del ratn sobre la consulta y seleccione el elemento Constructor de consultas del men contextual. La consulta ser seleccionada en el editor y se mostrar el editor de consultas. Ahora puede cambiar la definicin de la consulta como se ha descrito en el captulo anterior.

24.3

Manipular la definicin de la consulta.

Las siguientes secciones describen como puede modificar la definicin de la consulta. Para aadir un campo de una tabla en el rea de trabajo para la consulta, puede hacer clic con el botn izquierdo del ratn en la casilla de seleccin situada al lado de la columna, o puede arrastrar la columna hasta la lista de campos. De forma alternativa, puede hacer doble clic en una columna si la lista de campos tiene el foco de la aplicacin. Puede tambin arrastrar una columna o una carpeta de columnas directamente del Explorador de Objetos a la lista de campos. Las carpetas con las columnas se encuentran situadas debajo de la tabla, junto con las restricciones y los ndices de dicha tabla. Puede teclear los nombres de las columnas y otras expresiones directamente en la lista de campos. Para borrar un campo de la lista de campos, haga clic con el botn derecho del ratn sobre el y seleccione el elemento Borrar elementos seleccionados del men contextual. Si selecciona varios campos, puede eliminarlos de una sola vez. Puede mover campos a una posicin diferente si los selecciona y los arrastra a una nueva posicin. Si desea utilizar la clusula distinct, marque la opcin correspondiente en la lista de campos.

Utilizar alias para los nombres de campos.


Para utilizar un alias para un campo, simplemente teclee el alias despus de la expresin, de la misma forma que si estuviese escribiendo la consulta de forma manual.

Gua del usuario de PL/SQL Developer 9.0

228

Cambiar la clusula where.


La clusula where es un editor de texto normal, donde puede introducir las condiciones. Para incluir una columna, puede arrastrarla desde la tabla en el rea de trabajo, o puede hacer doble clic sobre la columna si la clusula where posee el foco de la aplicacin. Para aadir una condicin de unin basada en una clave fornea, haga clic con el botn derecho del ratn sobre la tabla en el rea de trabajo y seleccione Foreign keys desde el men contextual. No puede utilizar esta funcin para eliminar una condicin de unin (join) existente, pero puede eliminar el texto en su lugar.

Cambiar la clusula order by.


Puede manipular la clusula order by de la misma forma que la lista de campos, exceptuando que no puede utilizar las casillas de comprobacin situadas junto a los nombres de columnas. Para cambiar el orden de un elemento entre ascendente o descendente, puede hacer clic en el botn situado al lado del elemento, el cual le mostrar la flecha correspondiente.

Utilizar un sinnimo para una vista o tabla.


Puede utilizar una tabla o vista a travs de un sinnimo, haga clic con el botn derecho del ratn y seleccione el elemento Aadir tabla desde el men contextual. Teclee el nombre del sinnimo, introduzca un alias si fuese necesario y presione la tecla Aceptar.

24.4

Opciones del constructor de consultas.

Gua del usuario de PL/SQL Developer 9.0

229

Si presiona el botn Preferencias situado en la barra de herramientas puede cambiar el comportamiento del constructor de consultas. Aparecer el siguiente formulario:

La mayora de estas preferencias afectan a la disposicin de los elementos de la consulta generada. Palabras reservadas - Determina la forma en que se insertan las palabras reservadas en una consulta SQL. Elementos - Determina la forma en la que se insertan los elementos en una consulta SQL. Alinear palabras reservadas - Determina si las palabras reservadas del lenguaje SQL se alinean a la izquierda o a la derecha. Comas - Determina si la coma se coloca despus del siguiente elemento o antes del elemento actual. Esto es til si la opcin Single Item per line se encuentra habilitada. Separador AND - Determina cuando el separador AND se coloca antes de la siguiente instruccin o despus de la condicin actual en la clusula Where. Aadir el propietario de la tabla como prefijo - Cuando esta opcin est habilitada, a los nombres de las tablas se les aade el nombre propietario como prefijo (ej. scott.emp en vez de emp). Cuando este deshabilitada, slo se colocar el nombre del propietario si este no es el usuario actual. Palabras reservadas en una lnea nueva - Cuando esta opcin est habilitada, las palabras reservadas se sitan en una nueva lnea y todos los elementos se colocan en las lneas siguientes con una sangra de 2 caracteres. Si la opcin se encuentra deshabilitada, los elementos se colocan inmediatamente en la misma lnea. Slo un elemento por lnea - Cuando est habilitado, cada elemento se colocar en una nueva lnea. Cuando deshabilite esta opcin, los elementos se colocarn en una sola lnea hasta alcanzar el margen derecho. Margen derecho - Determina la longitud mxima de cada lnea cuando la opcin un elemento por lnea se encuentra deshabilitada. Mostrar siempre el editor de propiedades de la tabla - Cuando esta opcin esta habilitada, el editor de propiedades de la tabla siempre se mostrar despus de aadir una tabla a la definicin de la consulta. Cuando esta opcin se encuentra deshabilitada, el editor de propiedades de la tabla slo se mostrar si aade una nueva tabla a la consulta que ya se ha utilizado con anterioridad ya que necesita introducir un alias para dicha tabla. Mostrar partes de la consulta SQL en una sola pgina - Determina si las 3 partes de una consulta SQL (Lista de elementos, clusula Where y clusula Order by) se muestran de forma conjunta en una sola pestaa. Si esta opcin se encuentra desmarcada, cada parte de la consulta se muestra en una pestaa separada antes de la pestaa SQL.

24.5

Complementos del Constructor de Consultas.

Gua del usuario de PL/SQL Developer 9.0

230

Si existe algn complemento instalado, el Constructor de Consultas cargar este complemento. Si hace clic con el botn derecho del ratn sobre el botn del Constructor de Consultas podr seleccionar un constructor de consultas de una lista con todos los que se encuentre instalados. El complementos que haya sido utilizado ms recientemente ser el que se utilice la prxima vez que use el Constructor de Consultas

Gua del usuario de PL/SQL Developer 9.0

231

25. PL/SQL Beautifier.


Si desarrolla, mantiene y soporta cdigo PL/SQL en un equipo de trabajo con varios programadores, es til que todos los miembros del proyecto tengan el mismo estilo a la hora de codificar las instrucciones. Esto puede resultar beneficioso tanto para la calidad del cdigo generado como para la productividad de sus programadores. Para asegurar esto, PL/SQL Developer incluye una herramienta que le permite formatear el cdigo PL/SQL. Todo lo que necesita hacer es configurar las opciones y opcionalmente definir el estilo de cdigo mediante las reglas que le ofrece PL/SQL Beautifier (pudiendo adoptar los valores por defecto). Despus de esto, su cdigo PL/SQL se formatear automticamente a medida que vaya realizando el trabajo, o de forma explicita al activar la funcin de formateo.

25.1

Configurar PL/SQL Beautifier.

El Archivo de reglas determina que reglas se seguirn a la hora de formatear su cdigo. Puede dejar este campo vaco para adoptar las reglas por defecto, que pueden definirse mediante el archivo default.bf localizado en el directorio de instalacin de PL/SQL Developer. Vea la siguiente seccin para ms informacin sobre esas reglas. Adems puede definir cuando PL/SQL Beautifier formatear su cdigo automticamente: Despus de crear Cuando cree un programa nuevo utilizando una plantilla, o arrastre una nueva instruccin DML, desde el Explorador de Objetos a la ventana de programa. Despus de cargar Despus de que cargue un archivo desde el sistema de ficheros. Esto no afectar al cdigo que abra desde una base de datos Oracle. Antes de compilar Cuando compile un programa en la ventana de programa, esto le asegura que todo el cdigo PL/SQL almacenado en la base de datos se ajuste a las reglas definidas. Antes de guardar Antes de que guarde un archivo en el sistema.

25.2

Definir las reglas de PL/SQL Beautifier.

Gua del usuario de PL/SQL Developer 9.0

232

Si presiona el botn Editar, en la pantalla de preferencias, puede ver o editar las reglas del archivo seleccionado:

Despus de realizar cambios en esas reglas, puede presionar los botones de Guardar o Guardar como, para salvar los cambios. Puede abrir otro archivo de reglas para ver su contenido o para editarlo, y puede restablecer las reglas por defecto si presiona el botn correspondiente. Si guarda el archivo con un nombre nuevo, o abre un archivo diferente, es necesario que seleccione ese archivo de reglas en la ventana de preferencias para hacer que esas reglas contenidas en dicho archivo sean efectivas. En la pestaa General puede cambiar las reglas que PL/SQL Beautifier aplicar a aspectos generales de su cdigo PL/SQL. Todos los cambios que realice sern inmediatamente visibles en el panel de vista previa, situado en la parte inferior del cuadro de dilogo, la mayora de las opciones son auto aclaratorias. Las siguientes opciones necesitan explicarse con ms detalle: Sangra Nmero de espacios que se utilizarn en la sangra del texto para estructuras anidadas como begin/end, if/then/else, loops, etc. Margen derecho Cuando el cdigo necesite ajustarse a la siguiente lnea, puede utilizar el margen derecho como gua. A menudo pueden presentarse situaciones en las que el cdigo exceda el margen derecho, por ejemplo cuando se han escrito cadenas de texto muy largas. Utilizar carcter de tabulado Cuando esta habilitado, el cdigo formateado contendr el carcter del tabulado. Cuando est deshabilitado PL/SQL Beautifier utilizar espacios en blanco. Tamao del tabulado Nmero de caracteres que representa un tabulado. No slo es til cuando la opcin Utilizar carcter de tabulado, se encuentra habilitada, tambin puede ser til para corregir la alineacin de los tabulados que se ha realizado mediante espacios en blanco. Lneas en blanco Puede definir que lneas en blanco pueden eliminarse y PL/SQL Beautifier insertar las lneas en blanco con sus propias reglas, o los grupos de lneas que deberan juntarse en una lnea en blanco, o si todas las lneas en blanco se conservan tal cual se encuentran en el editor.

Gua del usuario de PL/SQL Developer 9.0

233

Listas de elementos Estas reglas se aplican a todos los elementos que no se agrupan en ninguna de las categoras de las otras pestaas Maysculas / Minsculas Determina si las palabras reservadas del lenguaje PL/SQL y los identificadores se escriben en maysculas o minsculas. La opcin Utilizar sintaxis especial, le permite definir un nmero de palabras que se capitalizarn de la forma especificada. Si, por ejemplo, incluye la palabra DMBS_Output.Put_Line en la lista, esta se escribir de la misma forma en todo el cdigo PL/SQL. Puede utilizar los comodines % o *, de forma que para este ejemplo DBA_% convertir a maysculas los 3 primeros caracteres para cualquier palabra que empiece con DBA_. Las otras pestaas contienen reglas que puede aplicar a aspectos especficos de su cdigo PL/SQL. Esas reglas son auto aclaratorias, puede ver el efecto que causan mediante el panel de vista previa.

25.3

Utilizando PL/SQL Beautifier.

Si no ha seleccionado ninguno de los eventos en el cuadro de dilogo opciones, puede de forma explicita, formatear su cdigo seleccionando el elemento PL/SQL Beautifier en el men Edicin, presionando el botn correspondiente en la barra de herramientas o utilizando la tecla de funcin asignada para ello. Por defecto, todo el cdigo PL/SQL en el editor ser formateado. Si existe un error crtico de sintaxis presente en el cdigo, este no se formatear, y recibir un mensaje de error. Puede seleccionar de forma alternativa un conjunto de instrucciones PL/SQL (funcin, procedimiento) y activar manualmente la herramienta de formateo.

25.4

Eliminando el formato aplicado por PL/SQL Beautifier.

Si tiene cdigo PL/SQL que desea formatear de forma manual y eliminar el formato aplicado por PL/SQL Developer, puede utilizar las directivas NoFormat Start y NoFormat End . Por ejemplo:
... TimeOut := 1000; -- NoFormat Start DBMS_Alert.WaitOne('SHUTDOWN', Message, Status, TimeOut); -- NoFormat End if Status = 0 then ...

Gua del usuario de PL/SQL Developer 9.0

234

26. Plantillas.
Cada vez que crea una nueva unidad de programa, su contenido inicial esta basado en una plantilla que contiene texto predefinido y variables. Cuando seleccione una plantilla, se le preguntar por los valores de esas variables, los cuales se reemplazarn despus en el texto de la plantilla. Tambin puede utilizar las plantillas para insertar fragmentos de cdigo SQL o PL/SQL en cdigo ya existente. Podr crear, por ejemplo una plantilla un cursor for.. loop y utilizarla siempre que necesite dicha estructura de control. Las plantillas son archivos de texto plano que se encuentran en el directorio Templates y tienen la extensin .TPL. Existen plantillas predefinidas para todo tipo de unidades de programa, as como plantillas con construcciones comunes del lenguaje SQL y del lenguaje PL/SQL. Puede modificar y crear plantillas para cubrir necesidades especficas.

26.1

La ventana de plantillas.

La ventana de plantillas muestra la estructura jerrquica del directorio de plantillas. Esto le permite organizar sus plantillas fcilmente. Cuando inicie PL/SQL Developer por primera vez, la ventana de plantillas se encontrar anclada debajo del Explorador de Objetos. De esta forma siempre se encuentra disponible y no obstaculiza la vista de otras ventanas de documentos:

Existe un nmero predefinido de plantillas que se encuentra organizado en las siguientes carpetas: Constants Plantillas para la declaracin de constantes del lenguaje PL/SQL. Default Plantillas con los contenidos por defecto de la ventana de consulta SQL, la ventana de prueba, la ventana de comandos y el Explain plan. Tambin contiene las plantillas para crear nuevas vistas. Seguramente no utilice directamente estas plantillas, pero puede mantenerlas aqu. DML Statements Plantillas para las instrucciones DML que puede utilizar en su cdigo PL/SQL. Loops Plantillas con la estructura de los diversos tipos de bucles existentes en el lenguaje PL/SQL. Package elementes Plantillas para elementos que pueden utilizarse en las especificaciones o cuerpos de los paquetes. PLSQL Types Plantillas para todos los tipos de datos que se pueden declarar en PL/SQL.

Gua del usuario de PL/SQL Developer 9.0

235

Program Units Esta es una carpeta especial que contiene plantillas para las nuevas unidades de programa. Siempre que cree una nueva unidad de programa, se utilizar una plantilla de esta carpeta cuyo nombre corresponda con la unidad de programa que va a utilizar. SQL Functions Plantillas con todas las funciones de SQL, como add_months, substr, etc. Estas plantillas pueden resultar tiles si no conoce el nombre exacto o el significado de los parmetros de una funcin determinada. Type elements Plantillas para elementos que pueden utilizarse en las especificaciones de tipos o en el cuerpo de los mismos. Variables Plantillas para la declaracin de variables. Por defecto la ventana de plantillas se encuentra anclada debajo del Explorador de Objetos, puede convertirla en una ventana flotante si hace clic con el botn derecho del ratn sobre la misma y selecciona el elemento Flotante del men contextual. Para anclar la ventana nuevamente, siga el mismo procedimiento. Puede guardar la disposicin de las ventanas para la prxima vez que inicie PL/SQL Developer, utilizando el elemento Guardar organizacin de las ventanas del men Ventana, que guardar la disposicin actual de las ventanas. Esta funcin se explica con ms detalle en el captulo 32.2.

26.2

Utilizar las plantillas.

Para insertar una plantilla en un fuente existente, simplemente haga doble clic sobre ella. Si la plantilla contiene variables que deben ser definidas por el usuario se mostrar un formulario antes de que se inserte el texto. Si, por ejemplo, hace doble clic en la plantilla Function implementation, se le mostrar la siguiente ventana:

Gua del usuario de PL/SQL Developer 9.0

236

Despus de rellenar el formulario y presionar el botn de Aceptar, la plantilla se insertar en el cdigo, en la posicin del cursor:

Tambin puede arrastrar y soltar las plantillas desde la ventana de plantillas a una posicin especfica en el editor. Esta posicin determinar la sangra del texto de la plantilla. De forma similar puede hacer clic con el botn derecho del ratn en cualquier parte del editor y seleccionar el submen Plantillas del men contextual.

26.3

Crear y modificar plantillas.

Para modificar una plantilla existente, haga clic con el botn derecho del ratn sobre la misma y seleccione el elemento Modificar del men contextual. Se abrir un editor de texto con el texto de la plantilla. Este texto contiene la especificacin completa de la plantilla, incluyendo variables, consultas, etc. El formato de la plantilla se describe en las siguientes secciones. Para crear una nueva plantilla, haga clic con el botn derecho del ratn sobre la carpeta en la que desee crear la plantilla y seleccione el elemento Nueva Plantilla en el men contextual. PL/SQL Developer le preguntar primero por el nombre de la plantilla, para a continuacin mostrarle el editor de plantillas. Tambin puede crear una nueva carpeta, seleccionando el elemento Nueva carpeta desde el men contextual.

Valores literales en la plantilla.


La especificacin de la plantilla contiene literales y variables. El texto de los literales simplemente se copiar en el archivo de destino sin ningn tipo de modificacin. Imagnese una plantilla llamada Commit que slo contenga el texto Commit;. Cuando haga doble clic sobre la plantilla, el texto Commit; se insertar en el cdigo fuente, en la posicin del cursor. Los corchetes indican la presencia de una variable en la plantilla (vea ms abajo), por lo que si desea utilizar corchetes en el texto, debe utilizar dobles corchetes en su lugar. Por ejemplo: [[opcin]]

Variables de usuario.
Las variables son cdigos en el texto de la plantilla, que se reemplazan por el texto de sustitucin en el momento de utilizar la plantilla. Este texto puede tener un valor implcito, como la fecha o el usuario, o puede ser especfico del usuario. Las variables definidas en la plantilla, aparecern en el formulario de la plantilla cuando se cargue. El siguiente ejemplo define las variables Nombre y Tipo para la plantilla de una funcin:

Gua del usuario de PL/SQL Developer 9.0

237

create or replace function [Nombre] return [Tipo] is begin return(resultado); end [Nombre];

Cuando se utilice esta plantilla, el usuario puede especificar los valores para las variables Nombre y Tipo. Como puede ver, la variable Nombre se utiliza dos veces. Al usuario slo se le preguntar una vez por el valor y las dos variables utilizadas en la funcin se rellenarn con dicho valor. Las siguientes funcionalidades se encuentran disponibles para las variables de usuario: Valor por defecto - Puede establecer un valor por defecto para una variable justo despus de su nombre. Para definir el texto varchar2 como el tipo por defecto de la funcin creada en el ejemplo anterior, puede emplear la siguiente declaracin: [Tipo = varchar2] Listas de restriccin - Para restringir los posibles valores de una variable, puede definirla como una lista de valores. Para limitar los tipos de una funcin a varchar2, number y date, puede utilizar la siguiente declaracin: [Tipo = varchar2, *number, date] El valor precedido con un asterisco se utilizar como valor por defecto. Listas de sugerencias - Puede proporcionar al usuario una lista con los valores sugeridos para una variable, permitindole utilizar el uso de otros valores, para ello utilice despus del ltimo elemento de la lista: [Tipo = varchar2, number, date,...] Listas de descripcin - En lugar de utilizar el mismo texto para los elementos y el texto de sustitucin, puede utilizar una lista de descripcin para cada elemento. Despus de la descripcin coloque el carcter : y el valor que almacenar la variable: [Nivel = Write No Database State: WNPS, Read No Database State: RNDS,...] Casillas de verificacin - Para variables que pueden contener dos valores, puede utilizar una casilla de verificacin. Coloque una barra (/) entre el valor desmarcado (izquierda) y el valor marcado (derecha). La siguiente variable insertar el texto for each row cuando se encuentre desmarcada y for each statement cuando se encuentre marcada. [Nivel de la instruccin = for each row / for each statement] Si desea utilizar caracteres especiales (comas, corchetes, etc.) en el texto de substitucin, puede colocarlos entre comillas dobles. El siguiente ejemplo muestra una plantilla para un disparador (trigger) de la base de datos, que utiliza variables de usuario.
create or replace trigger [Name] [Fires = before, after, instead of] [Event = insert, update, delete, ...] on [Table or view] [Statement level? = for each row/for each statement] declare -- variables locales begin ; end [Name];

Nota: Puede crear varias unidades de programa en una nica plantilla si las separa entre s con el carcter (/). De esta forma puede juntar las plantillas de especificacin y el cuerpo de un paquete en una sola plantilla.

Gua del usuario de PL/SQL Developer 9.0

238

Cuando utilice la plantilla, se le preguntar al usuario los valores de las variables como se muestra a continuacin:

Variables implcitas.
Adems de las variables de usuario puede utilizar variables implcitas. El texto de sustitucin para esas variables no lo especifica el usuario, sino el sistema (fecha, hora, usuario), o el programador de la plantilla (consultas, texto).

Variables de sistema.
Las siguientes cuatro variables de sistema estn definidas en PL/SQL Developer: $OSUSER El nombre del usuario del sistema operativo. $DBUSER El nombre de la base de datos en la que el usuario se encuentra conectado. $DATE La fecha actual. $TIME La hora actual. Las dos primeras lneas de la siguiente plantilla de ejemplo, insertan el usuario de Windows y la fecha y hora en un fuente:
-- Autor : $OSUSER -- Fecha de creacin : $DATE $TIME -- Propsito : [Propsito] procedure [Nombre] is begin ; end [Nombre];

Nota: las variables de sistema no utilizan corchetes en el texto de la plantilla, se preceden del carcter $. Si desea utilizar el nombre de una variable de sistema en el texto resultante en vez del valor de sustitucin, puede colocar un segundo smbolo de $ antes del nombre de la variable. Por ejemplo:
-- $$Date$ $Revision$

El texto resultante debera ser $Date$ $Revision$ .

Posicin del cursor.


La variable de posicin del cursor determina el lugar donde se colocar el cursor despus de que se inserte el texto de la plantilla en el editor. Simplemente coloque el carcter [#] donde desee.
loop [#] end loop;

Gua del usuario de PL/SQL Developer 9.0

239

Variables basadas en consultas.


Puede utilizar consultas para rellenar las listas de seleccin de una plantilla. El siguiente ejemplo define la consulta seq_query, que se utilizar despus como una lista de sugerencias para la variable Sequence:
[$QUERY seq_query = select lower(object_name) from user_objects where object_type = 'SEQUENCE' order by object_name] select [Sequence=$seq_query,...].nextval into [Variable name] from dual;

La variable Sequence es una lista de seleccin, porque va seguido de ,, permitiendo que el usuario pueda introducir otros valores. Los resultados de la consulta se pueden ver como una lista de valores separados por comas.

Incluir y excluir texto.


Puede incluir o excluir texto de una plantilla, dependiendo del valor de otra variable. En el siguiente ejemplo, se aade la palabra where si el usuario introduce una condicin de bsqueda:
select [Item list] into [Variable list] from [Table list] [+Search condition=where] [Search condition];

Como resultado, el usuario no tiene que teclear where en la condicin de bsqueda. Para excluir un texto, utilice Variable name en vez de +Variable syntax.

Variables de texto.
Puede definir variables de texto en una plantilla y referirse a las mismas en otras partes de la misma. Ser particularmente til si quiere incluir de forma condicional largas piezas de texto. El siguiente ejemplo incluye una excepcin si el usuario as lo indica:
[$TEXT exception_block= exception when no_data_found then ... when too_many_rows then ... when others then ... end;] select [Item list] from [Table list] into [Variable list] where [Search condition]; [Exception block =/$exception_block]

Iconos de las plantillas.


El rbol de directorios de la ventana de plantillas muestra un icono por cada plantilla. La ventana de plantillas buscar el archivo bitmap que tenga el mismo nombre que la plantilla dentro del directorio donde se encuentra situada la plantilla. Para la plantilla Cursor.tpl, mostrar el archivo Cursor.bmp del mismo directorio, si se encuentra presente, si no se encuentra el archivo, buscara un archivo Cursor.bmp en los directorios situados por debajo del directorio actual. Si el archivo bitmap no se encuentra, buscar un archivo default.bmp en el directorio actual y en los subdirectorios por debajo. Los archivos de bitmap que se mostrarn como iconos de las plantillas deben tener un tamao de 16x16 con 16 colores.

Gua del usuario de PL/SQL Developer 9.0

240

27. Lista de ventanas.


La lista de ventanas permite una navegacin fcil y directa sobre las mltiples ventanas de la aplicacin. Esta caracterstica es especialmente til si le gusta trabajar con las ventanas maximizadas y mantiene muchas ventanas abiertas al mismo tiempo. Por defecto la lista de ventanas se encuentra anclada bajo el Explorador de objetos y el Explorador de archivos, en la misma rea de anclaje que la lista de plantillas. Esta lista slo es visible si una o ms ventanas se encuentran abiertas y muestra el ttulo, el estado y el indicador de conexin de esas ventanas:

Si hace clic en uno de los elementos de la lista activar la ventana correspondiente. Si hace clic con el botn derecho del ratn en un elemento de la lista de ventanas, se mostrar un men contextual:

Desde el men contextual usted puede activar, cerrar o cambiar el estado de la ventana (normal o minimizada). Puede cerrar la ventana directamente haciendo clic con el botn izquierdo del ratn mientras mantiene pulsada la tecla de maysculas sobre un elemento de la lista. Puede cambiar la conexin de una ventana si la selecciona desde el submen Cambiar conexin. Adems puede renombrar una ventana, Esto puede ser til en el caso de que cree una nueva ventana y necesite emplear un ttulo ms descriptivo en lugar de, por ejemplo, Consulta Nuevo. El elemento de men Acortar texto har que se muestren las descripciones de forma acortada. Por ejemplo, la descripcin Program Window - employee.pck se acortar a P - employee.pck. El elemento de men Nuevo le permite crear una nueva ventana de programa, de consulta SQL, de prueba, de comandos, de plan de ejecucin, de diagrama o de un nuevo objeto de la base de datos. Para ejecutar un determinado tipo de ventana, seleccione el elemento Ejecutar. Para cerrar la lista de ventanas, seleccione el botn Cerrar. Para volver a mostrar la lista de ventanas seleccione el elemento Lista de ventanas del men Herramientas. Puede guardar la organizacin de las ventanas para la prxima vez que ejecute PL/SQL Developer. Haga clic en el elemento Guardar organizacin de las ventanas en el men Ventana, esto guardar la disposicin actual de las ventanas. Esta funcin se describe con ms detalle en el captulo 32.2.

Gua del usuario de PL/SQL Developer 9.0

241

28. Barras de herramientas.


Las siguientes herramientas pueden anclarse o permanecer flotantes en la pantalla: Explorador de Objetos. Explorador de Archivos. Lista de conexiones. Lista de ventanas. Lista de plantillas. Lista de marcadores. Barra de bsqueda.

Lista de resultados. Elementos pendientes. Elementos de proyectos Puede anclar las diferentes herramientas que forman el entorno de desarrollo de PL/SQL Developer, en la parte superior o inferior y al lado derecho o izquierdo del rea de trabajo.

Para anclar una herramienta de PL/SQL Developer, simplemente arrstrela a la zona deseada del rea de trabajo. Tan pronto como se acerque a un borde del rea de trabajo, se mostrar un marco, indicando la posicin de anclaje. Si otra herramienta se encuentra anclada en esta posicin puede arrastrar la nueva herramienta encima, debajo, a la izquierda o a la derecha o incluso dentro de la otra herramienta. Si arrastra una herramienta dentro de otra, las dos estarn disponibles en la misma posicin en distintas pestaas (vea la Lista de ventanas y la Lista de plantillas en la parte inferior izquierda, en la captura de pantalla superior). Observe que solo puede anclar una herramienta en la parte izquierda o derecha solo si el panel no se encuentra dividido verticalmente.

Gua del usuario de PL/SQL Developer 9.0

242

Para hacer una herramienta flotante, arrstrela desde su posicin de anclaje a la nueva posicin. Una vez anclada una herramienta en el entorno de desarrollo de PL/SQL Developer, podr ver 3 botones en la parte superior derecha: Este botn le permite maximizar o restaurar el tamao de la ventana de la herramienta anclada. Este botn le permite mantener visible u ocultar la ventana de la herramienta anclada. Cuando el botn se encuentre pulsado la ventana estar siempre visible y las herramientas siempre estarn accesibles. Cuando no se encuentre pulsado, la ventana de la herramienta se ocultar siempre que no tenga el puntero del ratn encima. Este botn le permite cerrar la herramienta anclada.

Gua del usuario de PL/SQL Developer 9.0

243

29. Autorizaciones.
Despus de instalar PL/SQL Developer todos los usuarios puede utilizar todas las funciones del programa, dentro de los lmites de los privilegios del sistema y de los privilegios sobre objetos que se le hayan asignado al usuario conectado a la base de datos. Por ejemplo, si el usuario no tiene el privilegio de sistema de create user, el usuario de PL/SQL Developer puede iniciar la funcin de creacin de usuarios en PL/SQL Developer, pero recibir el mensaje de error del servidor ORA-01031, insufficient privileges. Puede autorizar todas las funciones relevantes de PL/SQL Developer a usuarios y roles especficos. En una base de datos de desarrollo puede permitir que los desarrolladores tengan acceso a todas las funciones, mientras que en una base de datos de produccin normalmente deshabilitar todas las funciones de la mayora de los usuarios que pueden alterar la base de datos o consumir muchos recursos y afectar de forma considerable al rendimiento del sistema. Autorizando los privilegios de PL/SQL Developer a roles puede personalizar el nivel de autorizacin para determinados grupos de usuarios. Puede hacer uso de los roles existentes para un grupo de usuarios (como DBA y RESOURCE) o puede crear roles especficos para grupos de usuarios de PL/SQL Developer.

29.1

Habilitar el sistema de autorizaciones.

La informacin sobre los niveles de autorizacin se guarda en la tabla plsqldev_authorization en el esquema SYS. Mientras esta tabla no est creada en la base de datos, todos los usuarios pueden acceder a todas las funciones de PL/SQL Developer. Si se encuentra conectado a una base de datos donde la autorizacin no se ha habilitado y selecciona el elemento Autorizacin desde el men Archivo, PL/SQL Developer le realizar la siguiente pregunta:

Si selecciona S, se crear una tabla de autorizaciones vaca. Observe que debe conectarse a la base de datos como DBA para poder crear esta tabla. Tan pronto como cree uno o ms privilegios en esta tabla se habilitara el sistema de autorizaciones, y solo los usuarios a los que se les hayan asignado privilegios podrn utilizar PL/SQL Developer en esta base de datos. Por defecto slo el propietario de la tabla (SYS) u otro DBA pueden modificar la tabla o actualizar su contenido. Todos los usuarios deben tener privilegios de seleccin sobre la tabla.

29.2

Definir autorizaciones.

Gua del usuario de PL/SQL Developer 9.0

244

Para definir el nivel de autorizacin debe conectarse a la base de datos como DBA e iniciar la funcin de Autorizacin desde el men Archivo. PL/SQL Developer le mostrar el siguiente cuadro de dilogo:

En la parte superior puede ver todos los usuarios y roles a los cuales ha asignado uno o ms privilegios del programa PL/SQL Developer. En la parte inferior puede ver los privilegios para el usuario o rol seleccionado. Para aadir un nuevo usuario o rol, presione el botn Nueva autorizado, en la parte derecha de la lista de roles y usuarios. Al hacerlo se mostrar una lista con los usuarios y los roles. Puede seleccionar uno o varios roles (Ctrl.-clic o Shift-clic) y presionar el botn Aceptar para aadirlos a la lista. En este momento los nuevos elementos no tienen ningn privilegio asignado todava. Para conceder privilegios, seleccione el usuario o rol de la lista y presione el botn Aadir privilegios que se encuentra situado en la parte derecha de la lista de privilegios. PL/SQL Developer le mostrar una lista con todos los privilegios disponibles en la que podr seleccionar uno o ms privilegios. Existen 3 categoras: Privilegios del sistema Funciones del sistema de PL/SQL Developer (Ejemplo Logon). Privilegios sobre objetos Privilegios especficos de objetos de la base de datos (Ejemplo Drop Table). Privilegios de men Privilegios para utilizar las funciones de men de PL/SQL Developer (Ejemplo Herramientas > Monitor de sesiones). Nota: Si un usuario no tiene el privilegio System.Logon o el privilegio All, no podr utilizar PL/SQL Developer en la instancia de la base de datos. Puede seleccionar privilegios individuales o seleccionarlos desde un conjunto jerrquico de privilegios. All Concede todos los privilegios de PL/SQL Developer. Objects.All Concede todos los privilegios de PL/SQL Developer que hacen referencia a objetos de la base de datos. Objects.Rename All Concede todos los privilegios de PL/SQL Developer que hacen referencia a renombrar objetos de la base de datos (rename table, view, sequence y synonym). Objects.Rename Table Concede el privilegio de PL/SQL Developer para renombrar una tabla.

Gua del usuario de PL/SQL Developer 9.0

245

Observe que para los objetos de la base de datos, el usuario o rol deben tener los privilegios de sistema necesarios para realizar la operacin. El hecho de autorizar el privilegio Objets.Drop User de PL/SQL Developer requiere tener el privilegio de sistema drop user. Nota: Si un usuario tiene el privilegio de sistema Drop User, todava puede ejecutar el comando Drop user desde una consulta SQL o un archivo PL/SQL.

29.3

Deshabilitar el sistema de autorizaciones.

Para deshabilitar de forma permanente la autorizacin, puede eliminar la tabla sys.plsqldev_authorization, o borrar todos los registros. Para deshabilitar de forma temporal la autorizacin puede revocar los privilegios sobre la tabla o bien renombrarla (haciendo que sea invisible para los usuarios de PL/SQL Developer). Para volver a habilitar de nuevo, puede dar privilegios de select sobre la tabla.

Gua del usuario de PL/SQL Developer 9.0

246

30. Sistema de archivos de Oracle.


Este sistema le permite almacenar todos sus archivos (cdigo fuente, informes, descripciones, etc.)dentro de la propia base de datos. La ventaja de utilizar este sistema radica en que tanto los objetos de la base de datos y los archivos que interactan con ella, pueden almacenarse en la misma base de datos, y pueden ser utilizados por todos los usuarios que tengan acceso a esa base de datos. Adems, de esta forma, se garantiza que los objetos de la base de datos y los distintos archivos almacenados en la misma son consistentes, pudindose realizar copias de seguridad y recuperaciones de los mismos de una forma consistente. Los archivos se pueden abrir y guardar de la forma habitual, mediante el cuadro de dialogo de abrir y guardar con algunas extensiones.

30.1

Organizador OFS.

Antes de que se pueda utilizar el sistema OFS desde PL/SQL Developer, el usuario tiene que utilizar el programa de gestin de OFS para definir un directorio de localizacin con una o ms localizaciones OFS. Para cada una de ellas es necesario instalar los objetos OFS de la base de datos.

Crear un directorio de localizacin OFS .


Para iniciar el programa de gestin de OFS, vaya a las Preferencias del programa PL/SQL Developer y seleccione la pgina de Directorios. Al final de esta pgina encontrara un botn para ejecutar el programa de gestin de OFS. Despus de pulsarlo obtendr la siguiente pantalla:

Este es un directorio de localizacin OFS vaco, para el que puede aadir localizaciones, y que puede guardar en un archivo de localizacin de directorio OFS (.ldf). Este archivo se emplea desde PL/SQL Developer para explorar el directorio y los archivos y conectar a las localizaciones.

Gua del usuario de PL/SQL Developer 9.0

247

Aadir localizaciones OFS.


Para aadir una localizacin OFS, seleccione el botn Aadir localizacin (+). Ahora puede introducir la siguiente informacin:

Nombre El nombre que se mostrara en el selector de localizaciones. Base de datos La base de datos donde se almacenaran los ficheros. Esquema El esquema que contendr los objetos de la base de datos (tablas, paquetes, etc.). Este usuario necesita el privilegio resource y el privilegio de sistema quert rewrite para crear sus objetos. Usuario - El nombre del usuario que se utilizara para acceder al OFS. Si no especifica un nombre de usuario, el usuario que intente acceder al sistema necesitara especificar un nombre de usuario y una contrasea o se utilizar el usuario que se encuentre conectado actualmente con PL/SQL Developer. Contrasea La contrasea del usuario de Oracle que se utilizar para acceder al sistema OFS. Solo es til si se introducen datos en el campo Usuario. Despus de crear una o mas localizaciones, puede grabarlas si presiona el botn Guardar. Si guarda el archivo en el directorio de instalacin de PL/SQL Developer con el nombre OFS.ldf, PL/SQL Developer seleccionara automticamente este directorio. Sino el usuario de PL/SQL Developer tendr que indicarle el archivo de localizacin de directorios OFS en las preferencias del programa.

Instalar los objetos OFS en la base de datos.


Despus de aadir una localizacin al directorio, necesita instalar los objetos de la base de datos. Si el esquema de OFS y el usuario (opcional) todava no existen en la base de datos, necesitara crearlos primero:
create user OFS identified by <password>; grant connect, resource, query rewrite to OFS; create user OFS_USER identified by <password>; grant connect to OFS_USER;

Despus de esto podr instalar los objetos OFS de la base de datos presionando el botn Instalar objetos de la base de datos. Despus de proporcionar la contrasea del usuario del esquema, se crearan los objetos de la base de datos, y la localizacin estar preparada para su uso.

Gua del usuario de PL/SQL Developer 9.0

248

30.2

Utilizar OFS.

Despus de la creacin de un directorio de localizacin OFS, instalar las localizaciones y hacer el directorio disponible para PL/SQL Developer, puede utilizar el elemento Guardar OFS como desde el men Archivo para guardar el archivo dentro del OFS. Aparecer el siguiente cuadro de dialogo:

Primero necesita abrir una localizacin, despus de lo cual podr guarda el archivo o crear un directorio:

Para abrir un archivo desde un sistema OFS, puede utilizar el elemento Abrir OFS desde el men Archivo o utilizar el men Reabrir. Los archivos de localizacin tienen la ruta OFS:\Localizacin\Ruta (ejemplo: OFS:\Chicago\Programs\Employee.bdy).Un archivo OFS abierto previamente puede guardarse utilizando la funcin estndar Guardar. Puede utilizar la funcin Guardar Como para guardar un archivo OFS en el sistema de archivos estndar. La funcin Guardar como puede utilizarse para guardar un archivo en el sistema con un nombre diferente o en un directorio diferente. Cuando guarde o abra un archivo, puede seleccionar la opcin Mantener el archivo bloqueado para bloquearlo. De esta forma otros usuarios no podrn sobrescribir o bloquear un archivo que se encuentra bloqueado. Si hace clic con el botn derecho sobre un archivo del selector de ficheros se muestra el men contextual con las opciones Copiar, Pegar, Borrar o Renombrar el fichero. Puede ver y cambiar las

Gua del usuario de PL/SQL Developer 9.0

249

propiedades del objeto desde el men. Las propiedades que puede cambiar incluyen el estado del fichero, el estado de bloqueo y la compresin del fichero. Los archivos solo pueden comprimirse a partir de la versin 10g de Oracle y posterior, ya que utiliza el paquete utl_compress. Dicho paquete solo se encuentra disponible a partir de la versin 10g.

Gua del usuario de PL/SQL Developer 9.0

250

31. Sistema de ayuda.


Puede configurar PL/SQL Developer para que se integre con los archivos de ayuda y los manuales distribuidos con el software de Oracle. En este captulo se describe como puede configurar y utilizar el sistema de ayuda de PL/SQL Developer.

31.1

Archivos de ayuda MS Help.

Hasta la versin 7.2 de Oracle los manuales entregados con el programa estaban escritos en formato MS Help. Estos archivos de ayuda pueden ser utilizados para proporcionar ayuda sensible al contexto en el editor, haciendo clic con el botn derecho del ratn sobre una palabra en el editor o seleccionando los elementos SQL Help o PL/SQL Help en el men de ayuda o tambin presionando la tecla de funcin que tengan asignados esos dos elementos de men. PL/SQL Developer busca los archivos de ayuda en dos directorios: 1. En el directorio de instalacin de PL/SQL Developer. 2. En el directorio de instalacin de SQL*Plus. PL/SQL Developer asume que el archivo de ayuda del lenguaje SQL es sqlhelp.hlp y que el archivo de ayuda del lenguaje PL/SQL es plshelp.hlp. Si dichos archivos no se encuentran disponibles, o tiene otros archivos de ayuda que desee utilizar para SQL y PL/SQL, puede colocar esos archivos en el directorio de instalacin de PL/SQL Developer y renombrarlos, como se mencion anteriormente.

31.2

Manuales HTML.

A partir de la versin 7.3 de Oracle los manuales en lnea se encuentran disponibles en formato HTML y en formato PDF. Puede configurar PL/SQL Developer para utilizar los manuales en formato HTML, haciendo clic con el botn derecho del ratn en el editor, seleccionando el elemento Manuales HTML en el men Ayuda o presionando la tecla de funcin F1.Adems puede presionar el botn de Ayuda en un mensaje de error en el caso de una excepcin de Oracle, lo que le dirigir automticamente al prrafo adecuado del manual Oracle Error Messages. Si hace doble clic con el botn izquierdo del ratn en un error de compilacin en la ventana de programa tambin se mostrar esta informacin. Nota: La documentacin de algunas versiones del servidor Oracle tienen archivos HTML que sobrepasan 1 mega bite de tamao. Cargar estos archivos puede llevar mucho tiempo. Si esto ocurre puede utilizar la documentacin en lnea del servidor Oracle en la que los captulos se encuentran divididos en archivos ms pequeos. Oracle ha reducido el tamao de los archivos para la documentacin de la versin 8.1.5

Configuracin de los manuales HTML.


La primera vez que utilice los manuales HTML bajo cualquiera de las formas descritas anteriormente, necesita indicarle a PL/SQL Developer donde se encuentran los archivos HTML.

Gua del usuario de PL/SQL Developer 9.0

251

Seleccione el directorio principal y presione el botn Crear para crear los ndices de las palabras reservadas que se encuentran en los manuales. Dichos ndices se almacenarn en el subdirectorio Books del directorio de instalacin de PL/SQL Developer. El proceso de creacin de los ndices puede llevar varios minutos. Si no tiene disponible la documentacin HTML de Oracle, puede presionar el botn Descargar. Esto le mostrar un archivo local en formato HTML donde puede seleccionar la versin apropiada del servidor Oracle y descargar un archivo comprimido con la documentacin en formato HTML. Esta descarga requiere que tenga una cuenta en Oracle Technology Network. Si no dispone de una cuenta OTN, puede crear una gratuitamente. Una vez terminada la construccin de los ndices, se le presentar una lista con todos los manuales que se han localizado. Ahora puede seleccionar los libros que desee utilizar para la ayuda sensible al contexto. Por defecto esta seleccin incluir los manual Error Messages, SQL Reference y PL/SQL Reference, todos ellos contienen informacin importante para el desarrollo de cdigo SQL y PL/SQL. El manual Error Messages es necesario, si quiere obtener respuestas rpidas, en caso de que se produzca una excepcin o un error de compilacin. El manual que se encuentra disponible de la versin 7 de Oracle no est correctamente indexado para permitir esta caracterstica de PL/SQL Developer, el manual distribuido con la versin 8 funciona correctamente si ningn tipo de problema.

Gua del usuario de PL/SQL Developer 9.0

252

Presione el botn Aplicar para hacer efectiva la seleccin. Despus de esto se mostrar la pgina de bsqueda, de la que encontrar explicacin en el siguiente captulo. Si presiona el botn Instalar puede seleccionar un directorio diferente donde buscar los manuales HTML.

Utilizacin de los manuales HTML.


Despus de cargar los manuales HTML, puede teclear una palabra reservada que necesite buscar en la pestaa Buscar. Las dos listas muestran las palabras reservadas que se han encontrado y los temas en los manuales en los que aparece dicha palabra reservada:

En el panel de Opciones de bsqueda situado a la derecha de la lista de palabras reservadas, puede definir los criterios de bsqueda. Acto seguido puede hacer doble clic en un elemento de la lista de

Gua del usuario de PL/SQL Developer 9.0

253

temas en la parte inferior de la pgina de bsqueda para mostrar el correspondiente prrafo del manual HTML.

La pestaa de bsqueda mostrar una pgina HTML por la que puede navegar mediante vnculos de forma normal. Los botones de la parte superior de la ventana pueden utilizarse para navegar en la pgina anterior o en la pgina siguiente que haya visitado antes, para cancelar la carga de la pgina o para volver a la pgina inicial antes de la navegacin. Puede volver a la pestaa Buscar para buscar diferentes palabras reservadas o ir a la pestaa Books para seleccionar otros libros. Cada nueva bsqueda que realice crear una nueva pestaa de resultados, de esta forma puede tener todos los resultados de la bsqueda disponibles. Para cerrar todas las pestaas, presione el botn Limpiar resultados en la pgina de bsqueda. Por defecto la ventana de HTML, permanecer situada por encima de las dems ventanas en el entorno de desarrollo de PL/SQL Developer, as que la informacin permanecer siempre visible. Para ocultar temporalmente la ventana, puede utilizar el botn verde que se encuentra en la parte derecha de la ventana.

Gua del usuario de PL/SQL Developer 9.0

254

32. Personalizar PL/SQL Developer.


Puede personalizar muchos de las funciones de PL/SQL Developer para que se ajusten a sus necesidades como usuario. Estas funciones, se describen en las siguientes secciones:

32.1 32.2

Preferencias. Disposicin de las ventanas.

El elemento Preferencias, que se encuentra en el men Herramientas, le permite establecer las preferencias de PL/SQL Developer. Estas preferencias se describen con ms detalle en el captulo 20.

Existen varios parmetros en la disposicin de las ventanas, que puede modificar para adaptarlos a sus necesidades. Seleccione el elemento Guardar organizacin de las ventanas en el men Ventana para guardar la configuracin. Tamao y posicin de la ventana principal de la aplicacin. Presencia y tamao del Explorador de objetos. Presencia y tamao del asistente de cdigo en la ventana de programa. Presencia, estado (anclada o flotante) y posicin de la lista de ventanas y de plantillas. Tamao de la ventana de programa, la ventana de pruebas, la ventana de consulta SQL, Explain Plan, la ventana de comandos, la ventana de informes, la ventana de compilacin de objetos no validos, la ventana de bsqueda de objetos y la ventana de comparacin de objetos. Cuando guarde la disposicin de las ventanas, se guardar el tamao de la ltima ventana abierta .Si una ventana de un determinado tipo no se encuentra abierta en el momento de guardar la disposicin de las ventanas, la configuracin del tamao de esa ventana permanecer intacta.

32.3

Documentacin en lnea.

La mayor parte de la documentacin ofrecida por Oracle est disponible como documentacin en lnea. A lo largo del tiempo esta documentacin ha tenido distintos formatos, desde archivos de ayuda de Windows en formato MS HELP hasta archivos Oracle Book, pasando por archivos PDF y HTML. Es muy probable que en el futuro, Oracle escoja un nuevo tipo de formato. Por otra parte, tambin es probable, que tenga en su trabajo estndares corporativos y documentos de proyectos con el formato de un procesador de texto y necesite acceder a ellos en repetidas ocasiones. Todos esos documentos en lnea pueden ser integrados dentro del entorno de desarrollo de PL/SQL Developer, incluyndolos en el men Documentos. Haciendo que se encuentren disponibles con un simple clic de ratn. Para configurar la documentacin en lnea seleccione el elemento Configurar documentos en el men Herramientas. El siguiente cuadro de dilogo le permitir definir la configuracin de cada uno de los documentos definidos y como visualizarlos:

Gua del usuario de PL/SQL Developer 9.0

255

En la parte de la derecha de la ventana, puede ver cuatro botones, que le permitirn crear un nuevo documento, borrar un documento o variar su ubicacin en el men desplazndolos hacia arriba o abajo segn le convenga. Cuando crea o modifica un documento debe proporcionar la siguiente informacin: La Descripcin, es el nombre a mostrar en el men. Para crear una tecla de acceso directo para el elemento de men del documento, adale el carcter ampersand (&) delante de la letra que quiera utilizar como acceso directo. Si desea utilizar un ampersand (&) en la descripcin utilice dos caracteres ampersand (&&) en vez de uno. Si emplea un - en la descripcin, convertir el elemento en un separador de mens, permitindole organizar la documentacin en grupo lgicos. El campo Ejecutable debe contener la ruta completa del programa que desee emplear para ver la documentacin. Si el tipo de documento se encuentra registrado por Windows (como por ejemplo un documento HTML o un archivo msHelp), puede introducir la ruta del documento. Los parmetros pueden utilizarse para pasar informacin al archivo ejecutable si este es un programa. Debera incluir como mnimo la ruta del documento, pero pueden ser empleados para dar informacin al programa. Si la opcin Documentos como elemento de men se encuentra seleccionada, el men Documentos aparecer en el men principal de la aplicacin, si no se encuentra seleccionada, el elemento Documentos aparecer bajo el men Herramientas. En el ejemplo anterior, el Manual de Referencia de PL/SQL (P:\O9DOC\A89856_01.pdf), es un tipo de archivo registrado por Windows, con lo que slo debe introducir la ruta en el campo Ejecutable. La letra P se utiliza como acceso directo en el men. El men Documentos debera parecerse a la imagen que se muestra a continuacin:

Gua del usuario de PL/SQL Developer 9.0

256

Cuando la opcin Establecer como botn de la barra de herramientas est seleccionada, el documento se aadir tambin a la barra de herramientas. En este caso la Descripcin se mostrar como sugerencia cuando pase el ratn por encima del botn de la barra de herramientas. Si deja en blanco la descripcin, PL/SQL Developer utilizar la descripcin principal del documento (tal como se muestra en el men). Presione el botn Imagen para seleccionar un archivo bitmap de Windows (*.bmp) como imagen del botn. El tamao de este archivo debe ser preferiblemente de 20 x 20 pxeles. Observe que PL/SQL Developer siempre cargar la imagen desde su localizacin original, por lo tanto no debera renombrar o borrar el archivo sin cambiar el documento correspondiente. PL/SQL Developer viene con un conjunto de archivos BMP que puede utilizar. Esos archivos estn localizados en el subdirectorio Icons que se encuentra en el directorio de instalacin de PL/SQL Developer. Es el directorio por defecto para seleccionar imgenes.

32.4

Parmetros de la lnea de comandos.

Los parmetros de PL/SQL Developer que se muestran a continuacin, pueden utilizarse desde la lnea de comandos. El acceso directo por defecto, que se crea durante el proceso de instalacin, no incluye ningn tipo de parmetro, simplemente llama al programa plsqldev.exe desde el directorio de instalacin de PL/SQL Developer. Puede definir un conjunto de parmetros a travs del archivo param.ini, que se encuentra en el directorio de instalacin de PL/SQL Developer. Puede editar este archivo con su editor de texto favorito. El archivo param.ini contiene, en su interior, una descripcin con la explicacin de la utilidad de cada uno de los parmetros. Si define un parmetro en el archivo param.ini y define ese mismo parmetro en la lnea de comandos, esta ltima definicin tiene preferencia sobre el archivo de parmetros.

userid
Cada vez que inicia PL/SQL Developer aparece automticamente la ventana de inicio de sesin. Para evitar este comportamiento de la aplicacin, puede utilizar el parmetro userid con el formato usuario/contrasea@basededatos.
plsqldev.exe userid=scott/tiger@chicago

Observe que tambin puede utilizar la siguiente entrada en el registro de Windows para proporcionar una conexin por defecto. HKEY_CURRENT_USER\Software\Allround Automations\PL/SQL Developer\Logon En esta entrada puede aadir el usuario, la contrasea y la base de datos. Este ltimo mtodo le permite realizar el inicio de sesin de forma automtica cada vez que hace dobleclic sobre un archivo cuya extensin est registrada por PL/SQL Developer.

nologon
El parmetro nologon evita la aparicin del cuadro de dilogo de inicio de sesin de PL/SQL Developer. Este parmetro no requiere ningn argumento:
plsqldev.exe nologon

oraclehome
Puede especificar el nombre del directorio Oracle Home en la lnea de comandos, invalidando de esta forma la ruta por defecto y la ruta establecida en las preferencias de PL/SQL Developer.
plsqldev.exe oraclehome=ora817

Gua del usuario de PL/SQL Developer 9.0

257

Observe que el nombre de Oracle Home, est tal y como se encuentra en el registro en ORACLE_HOME_NAME. Este nombre es el utilizado por el selector de Oracle. No es una seccin del registro o un nombre de directorio

dontadjustpath
Con este parmetro PL/SQL Developer no modificar temporalmente la ruta de inicializacin de Oracle Net:
plsqldev.exe dontadjustpath

nosplash
El parmetro nosplash evita que se muestre la ventana de presentacin de PL/SQL Developer. Este parmetro no requiere ningn argumento.
plsqldev.exe nosplash

noplugins
Al especificar este parmetro, est obligando a PL/SQL Developer a omitir la carga de los complementos, que se encuentran dentro del directorio Plugins.
plsqldev.exe noplugins

library
Especifica la ruta donde se encuentran las libreras de estilo para los informes.
plsqldev.exe library=p:\standard.lib

prefpath
Especifica la ruta donde se encuentra el archivo de preferencias.
plsqldev.exe prefpath=u:\userdata

Puede ver el captulo 20.34 para ms detalles.

defaultprefpath
Especifica la ruta por defecto donde se encuentra el archivo de preferencias.
plsqldev.exe defaultprefpath=p:\common\plspfref

commandfile
Ejecuta el archivo de comandos especificado en la ventana de comandos.
plsqldev.exe userid=scott/tiger commandfile=u:\sql scripts\demo_build.sql

Gua del usuario de PL/SQL Developer 9.0

258

Este comando se conectar primeramente a la base de datos y acto seguido ejecutar el archivo demo_build.sql.

viewobject
Este parmetro le permite ver la informacin del objeto de la base de datos especificado. Este parmetro requiere que especifique tambin el parmetro userid.
plsqldev.exe userid=scott/tiger@chicago viewobject=emp

Este comando se conectar primeramente a la base de datos y acto seguido mostrar la informacin de definicin de la tabla EMP. Recuerde que en la especificacin del objeto puede incluir tambin el propietario del mismo (por ejemplo: SCOTT.EMP).

editobject
Edita el objeto de la base de datos especificado. Este parmetro requiere que especifique tambin el parmetro userid. Por ejemplo:
plsqldev.exe userid=scott/tiger@chicago editobject=emp

Este comando se conectar primeramente a la base de datos y acto seguido mostrar la informacin de definicin de la tabla EMP. Observe que en la especificacin del objeto puede incluir tambin el propietario del mismo (por ejemplo: SCOTT.EMP)

registry
Para utilizar distintas configuraciones en el entorno integrado de desarrollo puede utilizar el parmetro registry.
plsqldev.exe registry=home

Este comando provocar que todas las configuraciones de PL/SQL Developer (tamao de las ventanas, posiciones, historial de archivos, historial de conexiones, etc.) se carguen y se almacenen bajo el nombre home.

sesssionmode
Le permite definir el modo de sesin que va a utilizar: simple, doble o mltiple. Los valores vlidos son SINGLE,DUAL o MULTI. Tambin puede utilizar 1,2 o 3.
plsqldev.exe sessionmode=dual

noscwarning
Cuando introduzca este parmetro, PL/SQL Developer no le mostrar ningn tipo de alerta cuando el contrato de su licencia est a punto de terminar
plsqldev.exe noscwarning

hexedit

Gua del usuario de PL/SQL Developer 9.0

259

Le permite abrir en el editor hexadecimal el archivo indicado.


plsqldev.exe hexedit=c:\temp\blob.dat

project
Abre el proyecto especificado.
plsqldev.exe project=u:\userdate\projects\deptemp.prj

noconnectionlist
Elimina la lista de conexin al iniciar la aplicacin y muestra el viejo cuadro de dialogo de inicio de sesin en su lugar. Por ejemplo:
plsqldev.exe noconnectionlist

32.5

SQL, PL/SQL y palabras reservadas y comandos.

Las palabras reservadas que se resaltan en el editor de SQL de PL/SQL Developer y en la ventana de comandos, se encuentran definidas en un archivo. Puede encontrar este archivo, denominado default.kwf, en el directorio de instalacin de PL/SQL Developer. Este archivo contiene tres secciones: [PLSQL] - Esta seccin contiene las palabras reservadas del lenguaje PL/SQL. [SQL] - Esta seccin contiene las palabras reservadas del lenguaje SQL. [COMMAND] - Esta seccin contiene las palabras reservadas de los comandos. Puede cambiar, aadir o eliminar palabras reservadas simplemente con editar las secciones apropiadas en su editor de texto favorito.

32.6

Complementos.

Puede programar sus propios complementos para extender la funcionalidad de PL/SQL Developer. Las funciones de los complementos se pueden agregar a los mens de PL/SQL Developer y pueden realizar cualquier tipo de accin: acceder a la base de datos, el explorador de objetos, el editor, etc. Un complemento es una biblioteca de vnculos dinmicos (DLL) que expone una interfaz especfico de PL/SQL Developer. Para crear un complemento puede utilizar cualquier lenguaje de programacin que permita la creacin de archivos DLL. Para instalar un plugo-in muvalo al directorio Plumines dentro del directorio principal de PL/SQL Developer, PL/SQL Developer lo detectar automticamente, haciendo que la distribucin de los complementos sea un sencillo proceso. Puede construir complementos para su uso propio o para uso pblico. En el sitio Web de Allround Automations se encuentran disponibles algunos complementos estndar que pueden resultarle tiles, as como tambin estn disponibles complementos desarrollados por terceras personas. La documentacin, as como diferentes ejemplos, se encuentran disponibles en el subdirectorio PluginDoc, en el directorio principal de PL/SQL Developer.

También podría gustarte