El Asistente de SQL permite crear una sentencia de SQL, enviarla a un servidor de
bases de datos remoto, recuperar los datos resultantes, si existen, guardar los
datos resultantes y guardar la sentencia de SQL para poder utilizarla de nuevo.
El servidor de bases de datos remoto debe estar ejecut�ndose en un sistema iSeries o AS/400,
y debe haber controlador JDBC (Java Database Connectivity) apropiado
en la estaci�n de trabajo cliente.
El cliente Host On-Demand y el cliente Database On-Demand ya incluyen un controlador
JDBC de AS/400 Toolbox para Java, que permite dichos clientes
acceder a datos de DB2/400 en un sistema iSeries o AS/400 correctamente configurado
(consulte el campo URL de la base de datos de la pesta�a Inicio de sesi�n).
Los servidores de bases de datos que se ejecutan en sus plataformas s�lo se admiten
si se ha instalado el controlador JDBC apropiado en la estaci�n de trabajo
cliente Host On-Demand o Database On-Demand
(consulte el campo URL de la base de datos en la pesta�a Inicio de sesi�n).
La interfaz de usuario del Asistente de SQL ayuda a seleccionar las tablas con las que se
desea trabajar, seleccionar las columnas de las que deben devolverse datos,
seleccionar las columnas en las que deben almacenarse los datos devueltos y
crear una sentencia de SQL v�lida. El sistema puede mostrar los datos devueltos
o bien puede escribirlos en un archivo. Se admiten varios formatos de archivo,
incluido XML. Las sentencias de SQL pueden etiquetarse y guardarse para utilizarlas
de nuevo m�s adelante.
Puede establecer valores por omisi�n para algunos de los campos del asistente,
si el administrador ha configurado el cliente o su ID de usuario para que pueda hacerlo:
Si el Asistente de SQL se inicia desde una sesi�n de pantalla 5250,
inicialmente el asistente muestra en el campo URL de la base de datos un URL de base de
datos por omisi�n que contiene el nombre del sistema principal iSeries actual.
ID de usuario
Si es necesario utilizar un ID de usuario para iniciar una sesi�n en el servidor de bases de datos
remoto, escriba el ID de usuario en el campo ID de usuario. De lo contrario, deje el campo en blanco.
Contrase�a
Si es necesario utilizar una contrase�a para iniciar una sesi�n en el servidor de bases de datos
remoto, escriba la contrase�a en el campo Contrase�a. De lo contrario, deje el campo en blanco.
Filtro de tablas (Asistente de SQL)
Este campo no aparece si el administrador de Host On-Demand no lo ha habilitado.
Especifique en una lista separada por comas los nombres de esquema, los filtros
de esquema, los nombres de tabla y los filtros de tabla.
Para obtener ayuda, consulte Ejemplos.
Para obtener una descripci�n detallada de los nombres de esquema, filtros de esquema, nombres de tabla y filtros
de tabla, consulte Especificaci�n de una lista de esquemas y tablas disponibles.
La lista separada por comas que escribe en este campo especifica los esquemas y las tablas que desea que aparezcan
en la lista de tablas disponibles de la pesta�a Tablas del Asistente de SQL una vez que se
ha conectado a la base de datos.
Para utilizar el valor por omisi�n, deje este campo en blanco.
El cuadro de lista incluye los nombres de todos los controladores JDBC
que se han registrado con Host On-Demand.
Expanda el cuadro de lista y pulse el nombre del controlador JDBC
que desea utilizar o pulse Otro para especificar otro controlador.
Para obtener informaci�n general sobre el uso de un controlador JDBC con
el cliente Host On-Demand o el cliente Database On-Demand, consulte
Registro de un controlador JDBC.
Nombre de clase
Este campo debe contener el nombre de clase Java completo del controlador
JDBC que se especifique en el campo Descripci�n del controlador.
Si en el campo Descripci�n del controlador selecciona el nombre
de un controlador registrado, el Asistente de SQL
muestra el nombre de clase Java completo en este campo y no
permite su modificaci�n.
En cambio, si en el campo Descripci�n del controlador
ha seleccionado Otro, deber� especificar el nombre de clase completo del
controlador en este campo.
Es importante mantener las may�sculas y min�sculas (COM es distinto
de com).
Si no conoce el nombre de clase completo, p�ngase en contacto con el proveedor del
controlador.
El controlador debe estar instalado en la estaci�n de trabajo cliente y debe ser posible acceder
al mismo desde el cliente Host On-Demand o el cliente Database On-Demand
(consulte Implantaci�n de un controlador JDBC).
Conectar y Desconectar
Pulse Conectar para establecer conexi�n con el servidor de bases de datos remoto.
Pulse Desconectar para desconectarse del servidor de bases de datos remoto.
Tablas
Tipo de sentencia
Select
Pulse Select para seleccionar filas de una tabla o tablas.
Select unique
Pulse Select unique para excluir las filas duplicadas
de los resultados de una sentencia Select.
Al seleccionar esta casilla de verificaci�n, el Asistente de SQL a�ade el modificador DISTINCT
al verbo SELECT de la sentencia de SQL en la pesta�a SQL.
Insert
Pulse Insert para insertar una fila en una tabla.
Update
Pulse Update para actualizar una o m�s filas de una tabla.
Delete
Pulse Delete para suprimir una o m�s filas de una tabla.
Seleccionar tabla(s)
Lista de los esquemas y las tablas que est�n disponibles
para ser utilizados en la sentencia de SQL actual
(consulte Lista de tablas disponibles).
Para seleccionar una tabla y utilizarla en la sentencia de SQL actual,
seleccione la casilla de verificaci�n que aparece junto al nombre de la tabla.
Observar� lo siguiente:
Para operaciones Insert, Update y Delete, s�lo puede seleccionar una tabla.
Para una operaci�n Select, puede seleccionar varias tablas.
Si el tipo de sentencia de SQL es Select, el Asistente de
SQL a�ade los nombres de las tablas seleccionadas a la cl�usula
FROM de la sentencia de SQL de la pesta�a SQL.
Ver esquema(s)
Pulse Filtrar esquema(s)
para seleccionar los nombres de los esquemas que desea que aparezcan
en la lista de tablas disponibles en Seleccionar tabla(s).
Filtrar tabla(s)
Pulse Filtrar tabla(s)
para especificar los nombres o tipos de tablas que desea que aparezcan en la lista
de tablas disponibles en Seleccionar tabla(s).
Renovar
Pulse Renovar para renovar la lista de tablas
disponibles de Seleccionar tabla(s).
Unir
Una uni�n es un mecanismo que permite seleccionar qu� filas de dos tablas relacionadas
se incluyen en una sentencia de SQL, en funci�n de la
igualdad (o alg�n otro tipo de relaci�n, como desigualdad, mayor que, etc.) entre el contenido de las
columnas seleccionadas.
La pesta�a Uni�n s�lo est� disponible cuando el tipo de sentencia de SQL es Select.
El �rea interna de la pesta�a Uni�n muestra una ventana peque�a para cada
una de las tablas que se ha incluido en la lista de tablas seleccionadas de la pesta�a Tablas.
En la ventana peque�a de cada tabla se indican los nombres de las columnas de la tabla.
En el �rea externa de la pesta�a Uni�n, utilice los botones de la derecha de la pesta�a para crear y
manipular uniones.
Las l�neas de color de conexi�n indican lo siguiente:
Gris claro: uni�n propuesta
Azul: uni�n existente
Rojo: uni�n seleccionada actualmente
Unir
Pulse Unir para crear una uni�n nueva. Siga estos pasos:
Seleccione un nombre de columna de la primera tabla que desea unir.
Seleccione un nombre de columna de la segunda tabla que desea unir.
El Asistente de SQL muestra una l�nea de color gris claro entre las dos
columnas seleccionadas para mostrar que dichas columnas se han propuesto
como candidatas para la uni�n.
Si la uni�n es posible entre las dos columnas seleccionadas, el Asistente
de SQL habilita el bot�n Unir.
Si no es posible establecer una uni�n entre las dos columnas seleccionadas
porque los tipos de datos son distintos, el Asistente de SQL
inhabilita el bot�n Unir.
Utilice la clave Tipo de uni�n para seleccionar un tipo de
uni�n (consulte Tipo de uni�n m�s adelante).
El tipo por omisi�n es una uni�n interna.
Pulse Unir para crear la uni�n.
El Asistente de SQL muestra una l�nea azul entre los nombres de columna
para indicar que la uni�n ha finalizado.
<, >
Utilice estos botones para seleccionar la uni�n con la que desea trabajar.
El Asistente de SQL indica la uni�n seleccionada mostrando una l�nea
de color rojo entre los nombres de columna.
Separar
Utilice este bot�n para disolver una uni�n existente. Siga estos pasos:
Seleccione una uni�n existente mediante el bot�n > o <.
Pulse Separar.
Tipo de uni�n
Utilice este bot�n para seleccionar el operador de uni�n y el tipo de uni�n.
El operador de uni�n es uno de los siguientes:
=
<>
<
>
<=
>=
El tipo de uni�n es uno de los siguientes (en estas descripciones,
se presupone que el operador de uni�n es =):
Uni�n interna.
Las filas que se seleccionan para el proceso son:
Las filas de la tabla izquierda y de la tabla derecha
en las que el contenido de las columnas unidas es el mismo.
Uni�n exterior izquierda.
Las filas que se seleccionan para el proceso son:
Todas las filas de la tabla izquierda.
Las filas de la tabla derecha
en las que el contenido de las columnas unidas es el mismo.
Uni�n exterior derecha.
Las filas que se seleccionan para el proceso son:
Las filas de la tabla izquierda
en las que el contenido de las columnas unidas es el mismo.
Todas las filas de la tabla derecha.
Condici�n
Utilice la pesta�a Condici�n para especificar una o m�s condiciones
para seleccionar filas.
Las filas que cumplan las condiciones que especifique se mostrar�n en la pesta�a
Resultados (tipo Select),
se actualizan (tipo Update) o se eliminan (tipo Delete).
La pesta�a Condiciones s�lo est� disponible cuando el tipo de sentencia de SQL es Select, Update o Delete.
Una condici�n es un criterio que se define para que el servidor de bases de datos remoto
lo utilice al seleccionar filas de las tablas que se han incluido en la lista de
tablas seleccionadas de la pesta�a Tablas.
Puede especificar una o m�s condiciones.
Si una fila cumple todas las condiciones especificadas, el servidor de bases de datos remoto
incluye dicha fila en la operaci�n (Select, Update o Delete).
Utilice esta pesta�a para especificar una condici�n para una �nica sentencia de SQL.
Si es necesario especificar m�s de una condici�n, utilice el bot�n
Buscar en otra columna como se describe a continuaci�n.
Siga estos pasos para crear una condici�n:
Expanda el cuadro de lista Tablas seleccionadas y seleccione la tabla
que desea utilizar en la condici�n.
El cuadro de lista contiene los nombres de todas las tablas que se han incluido
en la lista de tablas seleccionadas de la pesta�a Tablas.
En el cuadro de lista Columnas, seleccione
la columna que desea que pruebe la condici�n.
En el cuadro de lista Operadores, seleccione el operador que desea utilizar en la
condici�n.
En el cuadro de lista Valores, especifique el valor o los valores
que desee utilizar en la condici�n.
Puede hacer lo siguiente:
Escribir un valor directamente en un campo; o bien
Pulsar Buscar para buscar valores
en la tabla y la columna que ha seleccionado.
Una vez que haya especificado la condici�n,
vaya a la pesta�a siguiente en la que desea trabajar
o pulse Buscar en otra columna
para especificar otra condici�n.
Buscar
Pulse Buscar para abrir la ventana B�squeda de valor
y buscar valores de la tabla y la columna que ha seleccionado para
esta condici�n. Siga estos pasos para utilizar la ventana B�squeda de valor:
Escriba en el campo de b�squeda la cadena de caracteres o el valor que desea buscar.
Seleccione Sensible a may�sculas y min�sculas
si desea buscar caracteres en may�sculas y min�sculas
exactamente igual que se escribieron.
Seleccione un valor de N�mero m�ximo de coincidencias. Esta
acci�n controla el n�mero de valores que se devuelve para cada b�squeda.
Pulse Buscar ahora.
La ventana B�squeda de valor busca en cada fila de la tabla especificada, en la columna
especificada, un valor que contenga la cadena de caracteres o el valor que ha
especificado.
La ventana B�squeda de valor muestra los resultados de la b�squeda en la ventana
Valores disponibles.
S�lo se muestra una instancia de cada valor.
Por ejemplo, si la cadena de b�squeda es dispositivo
y la tabla contiene cuarenta filas que presentan Abrir dispositivo en la columna especificada
y doce filas que presentan Cerrar dispositivo en la columna especificada,
la ventana B�squeda de valor muestra una instancia de
Abrir dispositivo y una instancia de Cerrar dispositivo.
Cuando haya observado los resultados de la b�squeda,
realice una de estas acciones:
Para utilizar un valor de la condici�n, seleccione uno o m�s valores
de la lista y pulse Utilizar valores.
Para cerrar la ventana, pulse Aceptar.
Borrar
Pulse Borrar para borrar todos los valores de los campos Valores.
Buscar en otra columna
Pulse Buscar en otra columna para crear una condici�n nueva.
El Asistente de SQL crea otra pesta�a Condici�n.
Buscar menos filas (AND), Buscar m�s filas (OR)
En cada pesta�a Condici�n posterior a la primera,
pulse uno de estos botones de selecci�n para indicar la relaci�n
l�gica (AND u OR) que existe entre la condici�n actual
y las precedentes.
Suprimir condici�n
Pulse Suprimir condici�n para suprimir la condici�n actual.
Columnas
Utilice la pesta�a Columnas para seleccionar las columnas que desea que se incluyan
en los datos que devuelva la sentencia de SQL.
La pesta�a Columnas s�lo est� disponible cuando el tipo de sentencia de SQL es Select.
Al seleccionar una columna de la pesta�a Columnas, el Asistente de SQL
a�ade el nombre de la columna a la cl�usula SELECT de la sentencia de SQL en la pesta�a SQL.
Si no selecciona ninguna columna en la pesta�a Columnas,
la sentencia de SQL selecciona, por omisi�n, todas las columnas
de la tabla o tablas especificadas.
Esto es as� porque la sentencia de SQL por omisi�n para una operaci�n Select
es SELECT * from nombretabla,
donde *
significa "todas las columnas".
A�adir >>
Utilice este bot�n para seleccionar las columnas que deben incluirse en los datos que
devuelve la sentencia Select de SQL.
Para a�adir columnas a la lista de columnas que deben incluirse:
Pulse el nombre de la tabla en la lista Tablas seleccionadas.
La lista contiene los nombres de todas las tablas que se han seleccionado en la pesta�a Tablas.
Seleccione una o m�s columnas en la lista Columnas.
La lista contiene todas las columnas de la tabla que se acaba de seleccionar.
Pulse A�adir >>.
<< Eliminar
Utilice este bot�n para eliminar columnas de la lista de columnas que deben incluirse.
Para eliminar una o m�s columnas de la lista:
Seleccione la columna o columnas que desea eliminar.
Pulse << Eliminar.
Seleccionar todo, Deseleccionar todo
Utilice estos botones para seleccionar o deseleccionar todas las columnas de ambas listas.
Mover hacia arriba, Mover hacia abajo
Utilice estos botones para cambiar el orden de visualizaci�n de las columnas seleccionadas.
Al ejecutar la sentencia de SQL, el Asistente de SQL
muestra las columnas de izquierda a derecha en la pesta�a Resultados, en el mismo orden
que se ha especificado en la pesta�a Columnas.
Clasificar
Utilice la pesta�a Clasificar para clasificar las filas que aparecen en la pesta�a Salida.
Las filas de la pesta�a Salida son las filas que devuelve el servidor de bases de datos
remoto en respuesta a la sentencia Select de SQL.
La pesta�a Clasificar s�lo est� disponible cuando el tipo de sentencia de SQL es Select.
Generalmente (es decir, sin la pesta�a Clasificar), las
filas de la pesta�a Salida se muestran en el orden en el
que aparecen las filas en la tabla o las tablas a las que
pertenecen.
Con la pesta�a Clasificar, puede seleccionar una o m�s columnas
que desee utilizar para clasificar las filas devueltas.
Por ejemplo, si selecciona una columna denominada OBJECTID y especifica el orden ascendente,
y si el contenido de OBJECTID son n�meros positivos, las filas devueltas
se ordenan empezando por la fila o filas que contienen el valor m�s peque�o
en OBJECTID (como 00001), seguidas por la fila o filas que contienen el valor siguiente m�s
peque�o en OBJECTID (como 00004), y as� sucesivamente.
Adem�s:
Puede seleccionar m�s de una columna para clasificar las filas devueltas.
Las filas se ordenan primero seg�n el contenido de la primera columna especificada
(por ejemplo, OBJECTID).
A continuaci�n, para cada grupo de filas que tengan el mismo valor en la primera columna
(por ejemplo, para todas las filas que tengan el valor 00007 en la columna OBJECTID),
las filas se clasifican seg�n los valores de la segunda columna especificada
(por ejemplo, SEVRITY).
Este proceso se contin�a para cada columna adicional que se especifique.
Para cada columna, puede especificar la clasificaci�n en orden ascendente o descendente.
A�adir >>
Utilice este bot�n para seleccionar las columnas para la clasificaci�n.
Para a�adir columnas a la lista de columnas sobre las que clasificar:
Pulse el nombre de la tabla en la lista Tablas seleccionadas.
La lista contiene los nombres de todas las tablas que se han seleccionado en la pesta�a Tablas.
Seleccione una o m�s columnas en la lista Columnas.
La lista contiene todas las columnas de la tabla que se acaba de seleccionar.
Pulse A�adir >>.
<< Eliminar
Utilice este bot�n para eliminar columnas de la lista de columnas sobre las que clasificar.
Para eliminar una o m�s columnas de la lista:
Seleccione la columna o columnas que desea eliminar.
Pulse << Eliminar.
Seleccionar todo, Deseleccionar todo
Utilice estos botones para seleccionar o deseleccionar todas las columnas de ambas listas.
Orden de clasificaci�n
Seleccione Ascendente o Descendente para especificar el orden de clasificaci�n.
Mover hacia arriba, Mover hacia abajo
Utilice estos botones para cambiar el orden en que se utilizan las columnas seleccionadas para la clasificaci�n.
Cuando se ejecuta una sentencia de SQL, el Asistente de SQL
clasifica los datos devueltos primer en la primera columna especificada
en la lista de columnas sobre las que clasificar, luego en la
segunda columna especificada en la lista, y as� sucesivamente.
SQL
Esta pesta�a se utiliza primordialmente para poder ejecutar la sentencia de
SQL generada. Tambi�n puede realizar las siguientes operaciones:
Escriba los cambios en la sentencia de SQL generada.
Tenga en cuenta que si entra cambios en la sentencia de
SQL generada (a�adiendo o suprimiendo caracteres) y luego
guarda la sentencia con el bot�n Guardar, ya no podr�
modificar la sentencia de SQL con los controles de las otras
pesta�as del Asistente de SQL (como los operadores de la
pesta�a Condici�n).
El Asistente de SQL muestra un mensaje de aviso a este efecto la primera
vez que intenta escribir cambios en la sentencia de SQL generada.
Al entrar cambios en la sentencia de SQL generada, �stos
no pasan a ser permanentes hasta que no se pulsa
Guardar para guardar la sentencia.
Los cambios entrados s�lo pueden deshacerse si no
se ha pulsado Guardar. Para deshacer los cambios entrados,
haga una de las siguientes operaciones:
Pulse Deshacer, o bien
Pulse otra pesta�a del Asistente de SQL.
Copiar la sentencia de SQL generada en el portapapeles. Una vez copiada,
el contenido del portapapeles puede pegarse en cualquier otra aplicaci�n
que acepte datos de texto procedentes del portapapeles. Esta caracter�stica
resulta �til si dispone de otra aplicaci�n que ejecute una consulta SQL, pero no facilita la prueba o generaci�n
sencilla de una consulta SQL.
Deshacer
Deshace un cambio que se ha entrado en la sentencia de SQL.
Deshacer s�lo funciona si no ha guardado la sentencia de SQL
con el bot�n Guardar.
Tambi�n se puede deshacer un cambio entrado pulsando otra pesta�a
del Asistente de SQL, si no se ha pulsado Guardar.
Ejecutar
Env�a la sentencia de SQL al servidor de base de datos remoto para su ejecuci�n.
Guardar
Guarda la sentencia de SQL para reutilizarla m�s adelante.
Puede utilizar esta caracter�stica para guardar sentencias de SQL comunes que se
ejecutan muchas veces. Las consultas para obtener informes de ventas mensuales
o para generar listas de clientes que han efectuado compras en los �ltimos
seis meses son ejemplos de consultas id�neas para ser guardadas.
Si realiza cambios en la sentencia de SQL generada
y pulsa Guardar, no podr� modificar m�s la sentencia
de SQL con los controles de las otras pesta�as
del Asistente de SQL (como los operadores de la pesta�a
Condici�n).
Insertar
Esta pesta�a s�lo se visualiza si selecciona un tipo de sentencia Insert de
SQL en la pesta�a Tablas. Insertar le permite insertar
una nueva fila en la tabla seleccionada.
Cuando acabe con la pesta�a Insertar, pulse Siguiente.
La informaci�n de la columna Insertar es como sigue:
La columna 1 indica el nombre de la columna en la fila de la base de
datos. Este nombre puede ser algo gen�rico como, por ejemplo,
CAMPO1 o CAMPO2 o bien puede tener un significado descriptivo
como NOMBRE o EDAD.
La columna 2 indica el tipo de datos que existe en esta columna
de la base de datos. Por ejemplo, CHAR(4) indica que en esta columna
pueden colocarse un m�ximo de cuatro caracteres.
La columna 3 va precedida por un signo igual (=). Esta columna se
utiliza para entrar los datos que desea actualizar en la columna de
la base de datos al crear esta nueva fila. Por ejemplo, si la base de datos contiene piezas de autom�vil y
hay un campo llamado PART# con un tipo de DOUBLE(8), podr�a escribir
10345 para representar un n�mero de pieza nuevo para
un volante.
Actualizar
Esta pesta�a s�lo se visualiza si selecciona un tipo de sentencia Update de SQL
en la pesta�a de Tablas. Actualizar le permite
modificar datos en una fila de base de datos existente.
Cuando acabe con la pesta�a Actualizar, pulse Siguiente.
La informaci�n de la columna Actualizar es como sigue:
La columna 1 indica el nombre de la columna en la fila de la base de
datos. Este nombre puede ser algo gen�rico como, por ejemplo, CAMPO1 o
CAMPO2, o bien puede tener un significado descriptivo como NOMBRE o EDAD.
La columna 2 indica el tipo de datos que existe en esta columna
de la base de datos. Por ejemplo, CHAR(4) indica que en esta columna
pueden colocarse un m�ximo de cuatro caracteres.
La columna 3 va precedida por un signo igual (=). Esta columna se
utiliza para entrar los datos que desea actualizar en la columna de
la base de datos al crear esta nueva fila. Por ejemplo, si la base de datos contiene piezas de autom�vil y hay un n�mero de pieza de
volante listado incorrectamente como 01234 en vez de 10345 en un campo llamado PART#,
escribir�a 10345 en la l�nea PART# que contiene la primera columna.
