ToraManual de usuario
Fecha: 31/08/2007
Referencia:
EJIE S.A. Mediterrneo, 3 Tel. 945 01 73 00* Fax. 945 01 73 01
01010 Vitoria-Gasteiz Posta-kutxatila / Apartado: 809 01080
Vitoria-Gasteiz www.ejie.es
Este documento es propiedad de EJIE, S.A. y su contenido es
confidencial. Este documento no puede ser reproducido, en su
totalidad o parcialmente, ni mostrado a otros, ni utilizado para
otros propsitos que los que han originado su entrega, sin el previo
permiso escrito de EJIE, S.A.. En el caso de ser entregado en
virtud de un contrato, su utilizacin estar limitada a lo
expresamente autorizado en dicho contrato. EJIE, S.A. no podr ser
considerada responsable de eventuales errores u omisiones en la
edicin del documento.
Control de documentacinTtulo de documento: TORA
Histrico de versionesCdigo: Versin: Fecha: 1.0 31/08/2007
Resumen de cambios:
Cambios producidos desde la ltima versinPrimera versin.
Control de difusinResponsable: Ander Martnez Aprobado por: Ander
Martnez Firma: Distribucin: Fecha:
Referencias de archivoAutor: Consultora de reas de conocimiento
Nombre archivo: Localizacin: Tora. Manual de usuario v1.0.doc
Toad. Manual de usuario
2/20
ContenidoCaptulo/seccin Pgina
1 2 3 3.1 3.2
Introduccin Conceptos bsicos Funciones elementales Inicio de la
aplicacin Operativa bsica
4 4 4 4 4 4 6 7 9 11 12 12 16 16
3.2.1. SQL Worksheet 3.2.2. Schema Browser 3.2.3. PL/SQL
Debugger 3.2.4. Otras herramientas 4 5 5.1 6 6.1 Utilidad prctica
Anexo 1: Ejemplo Realizar un filtrado en una tabla Resolucin Anexo
2: Ejemplo exportacin Resolucin
Toad. Manual de usuario
3/20
1
Introduccin
El presente documento describe cules son las tareas bsicas que
se pueden ejecutar en la explotacin de la herramienta Tora.
2
Conceptos bsicos
El proyecto Tora se define a si mismo como la alternativa al
TOAD, en la gestin de BBDD Oracle. Se trata de un completo sistema
de gestin de bases de datos para la parte cliente, que incorpora
funcionalidades que permiten realizar todas las tareas bsicas del
administrador de base de datos y de los desarrolladores, tales como
la edicin de SQL con resaltado de la sintaxis, un debugger de
PL/SQL, un navegador de la BD y otras funciones ms especficas para
el trabajo del administrador. La versin actualmente homologada es
la 1.3.21 Para obtener informacin adicional sobre el producto
acceder a su sitio web: http://sourceforge.net/projects/tora/
33.1
Funciones elementalesInicio de la aplicacin
La aplicacin puede iniciarse desde el acceso directo creado por
el instalador en el men de inicio, situado en Programas >
Toolkit for Oracle > Tora. Al ejecutar la aplicacin, lo primero
que aparece es una pantalla de login para elegir la BD y el usuario
con el que se quiere conectar. Las bases de datos que aparecen en
el desplegable se leen automticamente del fichero del cliente
Oracle TSNAMES.ORA. Una vez conectado a una BD, aparecer el editor
de SQL donde se podran construir sentencia SQL. En esta vista puede
acceder al resultado del lanzar la SQL o la vista del Explain Plan
entre otras. 3.2 Operativa bsica Tora incluye un amplio conjunto de
herramientas, cuya utilizacin se describe a continuacin. 3.2.1. SQL
Worksheet
Esta herramienta permite ejecutar sentencias SQL o PL/SQL as
como obtener informacin acerca de cmo se estn ejecutando y el
consumo de recursos. Es la herramienta que se muestra por defecto
al entrar por primera vez en la aplicacin. Se divide en dos
secciones. La de arriba es donde se puede escribir el cdigo y la de
abajo donde se pueden ver los resultados. Las sentencias se separan
utilizando punto y coma. Adems, Tora analiza el cdigo
Toad. Manual de usuario
4/20
introducido para determinar si se trata de un bloque PL/SQL, en
cuyo caso ejecuta el bloque completo. Se mantiene la compatibilidad
con los scripts SQL*Plus de manera que por ejemplo se pueden
utilizar los caracteres -- para insertar comentarios, que tambin
pueden crearse en varias lneas utilizando /* .. */. Otra
caracterstica interesante de la herramienta es el guardado de las
sentencias SQL. Facilitndose as, la reutilizacin de las sentencias
usadas ms a menudo. Veamos alguna opcin interesante de la barra de
iconos de una SQL Worksheet.
Se puede guardar la ltima sentencia ejecutada e insertar o
ejecutar una sentencia previamente guardada, escogindola de un men
desplegable. Al guardar una sentencia se le puede poner un nombre
(por ejemplo Una select) y organizar las sentencias en submens
usando dos puntos (por ejemplo Men 1: select de ejemplo). En la
seccin inferior, donde se pueden observar los resultados, existen
seis pestaas diferentes: Result: muestra el resultado de la query
ejecutada. Visualize: muestra grficamente los resultados, asumiendo
que la primera columna contiene las etiquetas de los datos a
mostrar. Information: la informacin disponible acerca de la
sentencia actual en la SGA (rea Global del Sistema). Statistics: si
se activa la opcin de aqu se muestran las estadsticas creadas
cuando se ejecut la ltima sentencia. Logging: muestra la historia
de las sentencias que se han ido ejecutando y su resultado, as como
la fecha de su ejecucin. Execution plan: muestra el plan de
ejecucin de la sentencia actual. Este plan de ejecucin es el que se
llevara a cabo si se ejecuta la sentencia por parte del usuario que
est conectado actualmente (otro usuario podra obtener otro plan de
ejecucin) y en la sesin actual (en otra sesin se podran haber
cambiado algunos parmetros de optimizacin). El plan de ejecucin
necesita una tabla para almacenar en ella el resultado. El nombre
de esta tabla puede ser configurado en las opciones (men
Edit>Preferentes). Si la tabla no existe, Tora pregunta al
usuario si debe intentar crearla (si no se crea, Tora no puede
mostrar el plan de ejecucin).
El plan aparecer en esta pestaa siguiendo una estructura
jerrquica, dictaminada segn el orden en el
Toad. Manual de usuario
5/20
que aparecen las tablas que han sido referenciadas por la
sentencia. Mostrara tambin los mtodos de acceso a cada tabla, los
mtodos de unin en caso de que hayan existido operaciones de join,
informacin acerca de la optimizacin y mostrara una columna de coste
(siempre que est activada la optimizacin de funcin del coste). La
estructura jerrquica se conforma de tal manera que los elementos
hijos se ejecutan primero y sus resultados son entregados a los
elementos padres. Por ejemplo, si se hace una sentencia del tipo:
SELECT * FROM boaelab_anuncios; Se obtendra lo siguiente en la
pestaa de Execution Plan:
Esto significa que la primera operacin es el acceso a la tabla,
indicndose adems que se accede a la tabla completa (la columna
Options indica FULL). Los resultados de este acceso se pasan a la
sentencia SELECT, que en realidad no es una operacin como tal. Si
en lugar de la sentencia anterior se hubiese hecho: select * from
boaelab_anuncios where anoreg_anu = 1; Se obtendra:
En este caso, se ha utilizado primero un ndice que poda devolver
ms de una fila (la columna Options indica RANGE SCAN), con lo que
la tabla se ha accedido utilizando el ROWID en lugar de un acceso
completo.
3.2.2.
Schema Browser
El Tora permite explorar la estructura de la base de datos, as
como actuar sobre los diferentes objetos contenidos en ella (de una
manera bastante bsica). Por ejemplo, se pueden crear tablas nuevas,
modificar columnas, borrar tablas, etc. Existen adems del browser o
navegador dos ventanas con pestaas, una dentro de la otra. En la
primera se puede escoger el tipo de objeto que se quiere
inspeccionar (tablas, vistas, ndices, secuencias, etc.). En la
segunda se escoge el tipo de informacin que se quiere examinar a
partir de ese objeto. La informacin disponible depender del tipo de
objeto (por ejemplo columnas en una tabla, informacin en la SGA
para un ndice, la declaracin de un paquete o tipo para un objeto
PL/SQL). La nica parte del browser que permite modificar datos se
encuentra en la pestaa de datos para el tipo
Toad. Manual de usuario
6/20
de objeto tabla. Escogiendo estas dos pestaas se muestra el
editor de contenidos, con sus propios iconos para definir filtros,
aadir nuevas entradas a la tabla, etc. Este editor slo guarda los
cambios cuando considera que se ha terminado de editar una fila: al
cambiar la fila actual o bien al hacer un commit (puede escogerse
la opcin de Autocommit en la ventana de Preferences>Database
Settings). La barra de estado indicar si faltan datos por
guardar.
3.2.3.
PL/SQL Debugger
El Tora proporciona un editor y debugger avanzado para
desarrollar objetos PL/SQL. Bajo la barra de herramientas estn los
iconos para compilar, ejecutar, manejar breakpoints, etc. El
debugger consta de dos secciones: En la izquierda se encuentran los
apartados de objetos (que contienen los objetos disponibles en el
esquema seleccionado) y los apartados de contenidos (que muestra la
estructura del objeto seleccionado). Al seleccionar un elemento en
la seccin de contenidos, el cursor se situar en el editor en el
lugar donde est implementado ese cdigo. En la parte derecha, se
muestra el cdigo del objeto editado actualmente. ), se mostrara
Adems de esto si se pulsara el botn F11 o bien se pulsara el icono
correspondiente ( una seccin adicional situada bajo las otras dos
en la que se ve la informacin correspondiente al estado actual de
ejecucin.
Toad. Manual de usuario
7/20
Antes de empezar a usar el editor se debe escoger un objeto de
cdigo que ya exista o bien crear uno nuevo. El editor muestra los
errores resaltando el fondo de la lnea en cuestin (por defecto en
color rojo). Los breakpoints se indican mediante una pequea seal de
stop en el margen de la lnea. Finalmente, la lnea actual de
ejecucin se muestra por defecto con fondo verde. Hay que tener en
cuenta que en realidad existen dos editores: en el que se edita la
declaracin de un paquete, y en el que se edita la implementacin de
ese paquete. Si se editan procedimientos o funciones se estar
utilizando nicamente el segundo editor. Por otro lado, la seccin
inferior del interfaz consta de diferentes pestaas: Stack trace:
contiene la lista de objetos a los que se ha ido llamando hasta
llegar a la lnea actual de ejecucin. Seleccionando una lnea del
stack trace har aparecer en el editor el objeto y la lnea donde se
hizo la llamada. Watches: los watches o vigas permiten inspeccionar
los contenidos de las variables en un programa que se est
ejecutando. Cuando se selecciona el icono de aadir un nuevo watch
aparece el siguiente cuadro de dilogo:
Toad. Manual de usuario
8/20
Este cuadro de dialogo difiere con respecto al indicado en la
documentacin de ayuda. El presente en la documentacin no contiene
los scope HEAD o BODY. Si no se escoge autodetectar el scope se
puede indicar seleccionando local (la variable est declarada en la
funcin o procedimiento actual), package (declarada en el package) o
global (declarada de manera global). Por ltimo se indica el nombre
de la variable. Si se tena el cursor sobre una variable en el
editor, ese ser el nombre que muestre el programa por defecto. La
pestaa de watch mostrar el contenido de esta variable, actualizando
su valor cada vez que se detenga la ejecucin del cdigo. Para que la
variable est disponible, es necesario haber compilado el cdigo con
la opcin debug. En caso de que no se haya hecho as, se puede usar
el icono de compile (Tora siempre compila con esta opcin desde el
PL/SQL Debugger). Una vez se ha creado un watch se activan tambin
los iconos que permiten eliminarlos o cambiar su valor. 3.2.4.
Otras herramientas Security manager Esta herramienta proporciona
una interfaz sencilla para gestionar usuarios, roles y privilegios.
La ventana consta de tres partes: 1. La barra de herramientas (en
la parte superior de la pantalla) 2. La lista de usuarios y roles
(en el borde izquierda de la pantalla) 3. Una ventana con pestaas
que contiene las diferentes configuraciones y privilegios que
pueden gestionarse para el usuario seleccionado (en el borde
derecha de la pantalla). Los roles y privilegios de sistema o de
objeto se definen utilizando bsicamente el mismo interfaz. La
pestaa correspondiente muestra un rbol de privilegios de objeto; en
el cual muestra primero cual es hijo el tipo, cual es hijo el
objeto y finalmente el privilegio a definir. Adems, los privilegios
tienen un elemento adicional como hijo llamado . Si se selecciona
admin esto dar al usuario o al rol la capacidad de otorgar dicho
privilegio a otros usuarios o roles. En el caso de los roles, los
privilegios tendrn otro elemento hijo llamado . Si se
selecciona
Toad. Manual de usuario
9/20
este elemento el rol ser activado por defecto cuando el usuario
se conecte. Cuando se est gestionando un usuario estar tambin
activada la pestaa que permite asignarle cuotas en los tablespaces
de la base de datos. Storage manager Esta herramienta proporciona
un interfaz para administrar tablespaces y datafiles. Consiste
bsicamente en un listado de los tablespaces disponibles en la base
de datos. Se puede expandir un tablespace para ver los datafiles
que lo componen. La barra de herramientas permite realizar las
diferentes acciones de creacin, modificacin, etc. Cuando se
selecciona un tablespace o datafile en la parte de abajo aparecen a
la izquierda los objetos y a la derecha los extents que existen en
dicho tablespace o datafile. Los colores utilizados en la vista de
la derecha son los siguientes: extents utilizados en verde,
utilizados que pertenecen al objeto actualmente seleccionado en
rojo y espacio no utilizado en blanco. Si el tablespace est formado
por varios datafiles, stos aparecen separados por una lnea negra.
Server tuning Esta herramienta da acceso a informacin sobre
diferentes indicadores importantes del servidor, a estadsticas y a
un editor de parmetros de la base de datos. Session manager Se
utiliza para gestionar las conexiones a la base de datos. Consiste
de una barra de herramientas, una lista de las conexiones abiertas
actualmente y en la parte de abajo una ventana con pestaas para
acceder a informacin sobre una conexin especfica. Rollback segments
Esta herramienta permite gestionar los segmentos de rollback en la
base de datos. La parte de arriba muestra los segmentos disponibles
(en la columna transactions puede verse una barra por cada
transaccin que utiliza dicho segmento). La parte de abajo se emplea
para detectar problemas de tipo snapshot too old (imagen demasiado
antigua). En esa vista se muestran las sentencias, la fecha de
cundo fueron detectadas y quin las est ejecutando. En la columna de
snapshot puede verse una barra por cada segmento de rollback
indicando hasta dnde ha llegado su utilizacin: si la barra es tan
larga como la columna probablemente se pueda haber producido un
error de snapshot too old. SGA trace Permite informarse sobre las
sentencias disponibles en la SGA. Aqu tambin puede obtenerse
informacin sobre el plan de ejecucin de una sentencia, como ocurra
en una pestaa del SQL Worksheet. Current session Proporciona
informacin sobre la sesin actual. Existen diez pestaas en esta
ventana, proporcionando ms informacin de la que se detalla en el
manual que acompaa a la aplicacin, ya que tambin incluye entre
otros informacin sobre locks, cursores abiertos, etc.
Toad. Manual de usuario
10/20
DB Extraction/Compare/Search Esta herramienta se emplea para
extraer scripts que permitan recrear objetos de la base de datos o
para comparar o buscar objetos o generar informes (opcin que no
viene incluida en el manual incluido en el programa pero que tambin
existe en la ltima versin). Se escoge el tipo de operacin que se
desea realizar, despus el tipo de informacin que se quiere incluir
en la operacin y finalmente se ejecuta con el icono
correspondiente, en las pestaas de result o difference (para una
comparacin). , pudindose observar los resultados
Si se escoge la opcin de extraccin se activa tambin la pestaa de
resize, donde se pueden almacenar diferentes especificaciones de
almacenamiento para la base de datos. Statistics Manager Permite
recoger estadsticas y analizar tablas en paralelo, as como revisar
estadsticas almacenadas. Alert Tool til para hacer debugging de
elementos que envan o dependen de alertas del sistema gestor de
base de datos. Invalid Objects Esta herramienta permite recompilar
objetos invlidos en la base de datos. En el interfaz, a la
izquierda se muestra una lista de los objetos invlidos y a la
derecha un editor que muestra el cdigo del objeto seleccionado,
para que puedan corregirse los errores. Las lneas con error se
muestran con fondo rojo, y colocando el cursor sobre una de estas
lneas se puede leer dicho error en la barra de estado. SQL Output
Viewer Muestra la salida del paquete DBMS_OUTPUT. Se utiliza cuando
se est ejecutando PL/SQL desde la herramienta de SQL Worksheet y
tambin aparece como la pestaa Debug Output en la herramienta de
Debugger.
4
Utilidad prctica
Uno de los usos ms frecuentes del Tora puede ser el lanzamiento
de sentencias sql para comprobar si la sentencia est bien formada,
qu resultados se obtienen y ver el comportamiento de la sentencia
en el Execution plan para comprobar el costo computacional de la
sentencia. Tora se recomienda en BD Oracle 8i, ya que para
versiones superiores, podr utilizarse el Oracle SQL Developer. Este
tipo de herramientas tambin se suelen utilizar para visualizar el
modelo de datos de una aplicacin. Se pueden ver todos los objetos
que forman el modelo de datos, as como modificarlos, aadir ms
datos, ver los datos de toda una tabla, realizar un filtrado de los
datos, etc. Otra utilidad del Tora es la definicin e implementacin
de funciones y procedimientos, nos permite editarlos, compilarlos
incluso debuggearlos. Adems Tora nos permite importar y exportar
datos desde o hacia otras BD y obtener los scripts de un
determinado esquema de BD para poder migrar la BD,
Toad. Manual de usuario
11/20
5
Anexo 1: Ejemplo Realizar un filtrado en una tabla
Se va ha realizar un filtrado en la tabla S73A08T00 de la
aplicacin PETSTORE, esta tabla esta compuesta por los siguientes
campos:
Y el filtrado se va a realizar por el campo CATEGORY,
seleccionando nicamente aquellos registros de la tabla que tengan
la categora de DOGS.
5.1
Resolucin
Lo primero que hay que hacer una vez abierta la herramienta
Tora, es conectarnos con la BD PETSTORE, seleccionamos la base de
datos, e indicamos el usuario y la contrasea para conectarnos.
Una vez realizada la conexin se muestra la interfaz SQL
Worksheet, y para ver la tabla hay que seleccionar el interfaz
Schema Browser, para ello se pincha sobre el icono que se encuentra
en la parte superior de la pantalla, justo debajo del men. Tras
pinchar se abre la nueva interfaz que tiene la siguiente
Toad. Manual de usuario
12/20
apariencia:
En la parte izquierda de la pantalla seleccionamos la tabla que
se quiere filtrar , en nuestro caso la S73A08T00, inmediatamente la
aplicacin muestra la estructura de la tabla en el marco derecho de
la interfaz
Toad. Manual de usuario
13/20
Seleccionamos la pestaa Data, y se muestran todos los registros
que contiene la tabla, y una barra de herramientas que nos presenta
diferentes operaciones para realizar sobre los datos de la
tabla
A continuacin pinchamos sobre el primer icono de la barra de
herramientas para realizar el filtrado. Y en la pantalla que se
muestra introducimos la condicin para el filtrado, en este caso
CATEGORY=DOGS
Toad. Manual de usuario
14/20
Para introducir el campo a filtrar se puede escribir o arrastrar
directamente del marco de la izquierda. Una vez creado el filtro
pinchamos sobre el botn OK, y se mostraran nicamente los registros
que cumplen la condicin de filtrado.
Toad. Manual de usuario
15/20
6
Anexo 2: Ejemplo exportacin
Se va ha realizar una exportacin de los datos de la tabla
S73A08T00, y vamos a dejar el resultado en un fichero denominado
Datos08.sql. 6.1 Resolucin
Lo primero que hay que hacer una vez abierta la herramienta
Tora, es conectarnos con la BD PETSTORE, seleccionamos la base de
datos, e indicamos el usuario y la contrasea para conectarnos.
Una vez realizada la conexin se muestra la interfaz SQL
Worksheet, y para exportar datos hay que seleccionar el interfaz DB
Export/Compare/Search, para ello se pincha sobre el icono que se
encuentra en la parte superior de la pantalla, justo debajo del
men. Tras pinchar se abre la nueva interfaz que tiene la siguiente
apariencia:
Toad. Manual de usuario
16/20
A continuacin para realizar la exportacin debemos seleccionar el
radio Extract y lo que queremos incluir en la exportacin,
marcaremos nicamente Include content of tables. Adems hay que
seleccionar el destino donde se dejaran los datos. En nuestro caso
Output file y escogemos el fichero que queramos, hay que tener en
cuenta que si no est creado el fichero habr que crearlo. Y despus
hay que seleccionar el objeto a exportar, para ello iremos al
Schema del PETSTORE y escogeremos la tabla S73A080T00.
Toad. Manual de usuario
17/20
Por ltimo presionando el botn de ejecutar elegido de la
siguiente manera.
la aplicacin volcar los datos en forma de scripts sobre el
fichero
Toad. Manual de usuario
18/20
Toad. Manual de usuario
19/20