1.0 Introducción
2.0 Software soportado y especificaciones
3.0 Limitaciones
3.1
Hay que estar en línea para generar un bean Java o un método EJB a partir de un procedimiento almacenado
4.0 Problemas conocidos
4.1 Modelos de base de datos
4.2 Consultas SQL
4.3 Conexiones a base de datos
4.4 DDL SQL
4.5 Elaboración de informes de error
4.6
La ejecución de sentencias SQL crea tablas incorrectas en Oracle
4.7 Exportación de datos
4.8 Editar
procedimientos almacenados Java
4.9
Los cambios se perdieron al cerrar el editor del documento solo de lectura
4.10
Faltan comillas en los identificadores de objetos de
esquema para los entornos locales distintos del inglés
4.11
Conectarse a un servidor DB2
4.12
No está soportada la operación de eliminar procedimientos almacenados Java
de DB2 Versión 8 cuando se utiliza el cliente DB2 Versión 7
4.13
Cambiar manualmente los tipos de datos SQL devueltos para
las funciones definidas por usuario (UDF) de tablas DB2
4.14
Error al construir o ejecutar una rutina DB2: el handle de conexión no es válido o la conexión está cerrada
4.15
Problemas relacionados con Sequelink 5.1, enviado junto con WebSphere Studio
4.16
Controlador DataDirect Sequelink 5.3
4.17
El contenido del asistente Conexión no está visible
4.18 Los archivos de ejemplos SQL de WebSphere Application Server - Express pueden contener errores pero pueden ejecutarse satisfactoriamente
4.19 Ejecutar Cloudscape en Linux
4.20
Problemas al recuperar tablas a partir de Microsoft SQL Server
4.21
Problemas de conexión con Cloudscape 5.1
4.22
Aparecen nodos de esquema duplicados al importar, suprimir o volver a importar archivos JAR de
EJB
4.23
Mensajes de error árabes dañados durante la exportación de datos relacionales
Las herramientas de bases de datos relacionales de WebSphere Studio le permiten conectarse a bases de datos, examinar o importar diseños de bases de datos, diseñar nuevas bases de datos utilizando asistentes, exportar nuevos diseños a su base de datos, crear y ejecutar consultas SQL utilizando SQL Builder, crear y ejecutar procedimientos almacenados de DB2 y funciones definidas por usuario de DB2. Se accede a las herramientas de bases de datos relacionales mediante la perspectiva Datos y las vistas Definición de datos y Servidores BD.
Las herramientas de bases de datos relacionales dan soporte a la conexión e importación de los siguientes tipos de bases de datos:
- SQL 92, 99
- Cloudscape 5.0.4
- DB2 UDB 6.1, 7.1, 7.2, 8.1
- DB2 UDB para iSeries 4.5, 5.1
- DB2 UDB para OS/390 6, 7
- DB2 UDB Express Edition 8.1
- Oracle 8i 8.1.7
- Oracle 9i 9.0.1
- SQL Server Enterprise 7.0 SP2
- SQL Server Enterprise 2000
- Sybase Adaptive Server Enterprise 11.9.2, 12, 12.5
- Informix Dynamic Server.2000 9.2
- Informix Dynamic Server 7.3, 9.3, 9.3.1
- MySQL 3.23
- InstantDB 3.26
El soporte SQL del asistente SQL y del constructor de consultas SQL depende del nivel de soporte suministrado por el proveedor de la base de datos.
Soporte de selección completa:
Soporte de uniones:
- Aplicable solo para DB2, Oracle, Cloudscape y Sybase.
- Para DB2, están soportados los operadores Union, Union All, Except, Except All, Intersect e Intersect All, así como las cláusulas values.
- Para Oracle, están soportados los operadores Union, Union All, MINUS e Intersect.
- Para Sybase, están soportados los operadores Union y Union All.
- Para Cloudscape, están soportados Union y Union All, así como las cláusulas values.
Soporte de agrupación de resultados de consulta:
- DB2: unión interna, unión externa izquierda, unión externa derecha, unión externa completa.
- Oracle: unión interna, unión externa izquierda y unión externa derecha. La sintaxis de las uniones externas izquierda y derecha es coherente con la sintaxis "+" de Oracle en la cláusula where.
- Sybase, Cloudscape y MySQL: unión interna, unión externa izquierda y unión externa derecha.
Soporte de expresiones CAST:
- DB2: Group By, Rollup, Cube y Grouping Sets
- Oracle: Group By, Rollup y Cube
- Sybase: Group By
- Cloudscape: Group By
- DB2 - CAST expresión AS expresión
- MS SQL Server - CAST expresión AS tipo_datos
- Oracle - TRANSLATE no está soportada
En Linux, puede experimentar una anomalía al conectarse a DB2 Universal Database para iSeries V5R1 mediante el controlador JDBC de AS/400 Toolbox para Java. El problema se produce al especificar una contraseña incorrecta o dejar en blanco el campo de contraseña. Si esto ocurre, reinicie el producto y conéctese de nuevo con la contraseña correcta.
Para utilizar los asistentes que le permitan generar un bean Java o generar un método EJB a partir de un procedimiento almacenado, debe trabajar en línea.
- Actualmente, no existe soporte para modelar índices, restricciones de comprobación y unicidad, desencadenantes, tipos estructurados o columnas de identidad.
- Las herramientas de bases de datos relacionales no dan soporte a las opciones de comprobación en las vistas.
- Los corchetes innecesarios en las sentencias de consulta provocarán errores del analizador.
- El uso de paréntesis en las cláusulas de condición WHERE no está soportado actualmente.
- Los archivos SQL pueden ralentizar el editor.
- En Oracle, las sentencias de actualización deben asignar valores a las columnas individualmente sin utilizar grupos de corchetes. Para añadir columnas individualmente y añadir un valor mediante una subconsulta, utilice la opción "Construir expresión" del cuadro combinado de casillas de la tabla de valores para crear una expresión de consulta para la columna.
- Las modificaciones realizadas en objetos de bases de datos utilizados por una sentencia podrían provocar que SQL Builder fallara, debido a que ya no puede analizar la sentencia satisfactoriamente respecto al modelo de datos locales.
- Editar una vista y, a continuación, abrir una sentencia que contenga la vista puede provocar un cierre inesperado del entorno de trabajo.
- Si se realiza una desconexión forzada de una conexión de base de datos fuera de WebSphere Studio, no se solicitará la conexión al ejecutarse la sentencia. Vuelva a importar la base de datos al proyecto desde la vista Servidores BD para restaurar la conexión.
- No puede crearse una consulta utilizando una vista que se derive de una función definida por usuario.
- Arrastrar y soltar objetos de base de datos solamente está soportado desde la vista Definición de datos, no desde la vista Servidores DB.
- Si importa una tabla DB2 UDB o DB2 para iSeries con una columna de tipo DATALINK, no se importarán las opciones de control de enlace para la columna. La longitud de DATALINK tomará por omisión el valor 200, y las opciones de enlace tomarán por omisión el valor NO LINK CONTROL. Puede actualizar estas propiedades en el editor de tablas después de importar la tabla a la vista Datos.
- La operación de eliminar múltiples conexiones en la vista Servidores BD no siempre funciona. Si se encuentra con un problema de este tipo, puede conservar las conexiones o proceder a eliminarlas de una en una.
- Es posible que los tipos de datos de series de caracteres no se importen correctamente para las conexiones con servidores iSeries. Los tipos CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA podrían importarse sin las opciones FOR BIT DATA. En estos casos, utilice el editor de tablas en la perspectiva Datos para editar las columnas afectadas.
- Los nombres de objetos de esquema que contienen caracteres DBCS pueden no importarse adecuadamente desde iSeries. Los identificadores delimitados pueden ser comillas que faltan. En estos casos, utilice el editor de tablas para editar los nombres de las columnas y restricciones.
- Los identificadores de las restricciones de clave primaria no se importan para las conexiones OS/390.
- Los valores por omisión de columna que sean procedimientos almacenados o funciones, o que estén definidos con una cláusula de identidad, no se importan como es debido y pueden provocar que aparezcan caracteres no ASCII en un documento de tabla. Los caracteres no ASCII causan problemas mientras se carga el documento. Cuando esto ocurre, es necesario editar manualmente el documento tblxmi del problema y eliminar el código y el valor por omisión.
- Cuando se utiliza la opción Conectar controlador JDBC de WebSphere para las conexiones a una base de datos de servidor SQL, se necesitan en general 3 archivos JAR para especificar la ubicación de las clases. Le recomendamos que combine los 3 archivos JAR en un solo archivo JAR. De lo contrario, cuando se vuelve a abrir el asistente después de establecer una conexión, su tamaño será demasiado grande. Ello se debe a la longitud del campo Ubicación de controlador.
- Al crear una nueva conexión a base de datos desde un cliente DB2 Versión 8, si desea utilizar el controlador IBM DB2 NET DRIVER JDBC, debe añadir estos dos archivos JAR en el campo Ubicación de clase: <DB2HOME>/java/db2jcc.jar y <DB2HOME>/java/common.jar (siendo <DB2HOME> el directorio en el que ha instalado DB2). Si no lo hace, se producirá un error. Nota: si utiliza el asistente Conexión a base de datos nueva sin haber añadido estos archivos JAR a la ubicación de la clase, los procedimientos almacenados no se cargarán. Debe volver a abrir el asistente de conexión para entrar los archivos en el campo Ubicación de clase.
- Los metadatos de la tabla y el esquema tal vez no se importen cuando se utiliza un cliente DB2 UDB Versión 8 para conectar con un cliente DB2 Versión 7 o anterior en z/OS. Para arreglar el problema, instale el PTF UQ72081 de DB2 para z/OS.
- Es posible que se produzcan problemas en las operaciones de importación o edición que impliquen el tipo de datos long de Oracle.
- Los archivos DDL SQL de grandes dimensiones pueden ralentizar el editor.
- Los archivos DDL SQL de grandes dimensiones pueden provocar excepciones de falta de memoria durante el análisis o la ejecución.
- Al editar scripts de Oracle, se pueden visualizar errores en la vista Esquema del editor. Por ejemplo, las sentencias "CREATE SEQUENCE", "CREATE OR REPLACE TRIGGER" y "END" se pueden mostrar de manera errónea. Sin embargo, ello no impide que pueda seguir exportando estos elementos a un servidor Oracle.
Cuando se produce un error durante el análisis de un archivo SQL, generalmente el problema se debe al símbolo que sigue al que aparece en el mensaje de error. El mensaje de error también se visualiza en la lista de tareas.
Cuando se ejecuta un archivo SQL en el servidor de base de datos Oracle, es necesario seleccionar inicialmente que se creen las secuencias y desencadenantes de las tablas. Ello se debe a que WebSphere interacciona de manera incorrecta con Oracle, insertando espacios adicionales. Una vez creadas las tablas, vaya a la máquina del servidor Oracle y edite la sentencia que quita los espacios insertados y añada el mandato 'end;'. Después vuelva a WebSphere y ejecute la sentencia SQL de nuevo en el servidor, seleccionando esta vez las sentencias Alter y las sentencias de inserción.
- Solamente puede eliminar artefactos existentes en la base de datos/catálogo de fondo ejecutando Ejecutar en servidor en scripts DDL de SQL. En los objetos de datos (por ejemplo, base de datos, esquema, tabla), si desea eliminar los objetos existentes, deberá seleccionar Generar DDL en el menú emergente, especificando eliminar sentencias existentes. En el script DDL de SQL generado, seleccione Ejecutar en servidor en el menú emergente. Si los objetos no existen actualmente en la base de datos/catálogo de fondo, será suficiente elegir Exportar a servidor para los objetos de datos.
- La exportación de determinadas sentencias al servidor Oracle puede provocar un espaciado en los identificadores en el servidor. Por ejemplo, supongamos esta sentencia: CREATE OR REPLACE TRIGGER SET_TRANSACTIONS_TRANID BEFORE INSERT ON TRANSACTIONS FOR EACH ROW WHEN (NEW.TRANID IS NULL) BEGIN SELECT TRANSACTIONS_TRANID_SQ.NEXTVAL INTO :NEW.TRANID FROM DUAL; END;
Después de la ejecución de este script con respecto al servidor,los identificadores especificados en la cláusula SELECT podrían aparecer de manera distinta; por ejemplo, "TRANSACTION_TRANID_SQ.NEXTVAL" podría aparecer como "TRANSACTIONS_TRANID_SQ . NEXTVAL"
- Si el proyecto es de tipo Java, el editor muestra un icono con forma de bombilla en la barra de marcadores en la primera línea de un procedimiento almacenado Java. Puede hacer caso omiso de este marcador. El marcador no provocará problemas cuando construya el procedimiento almacenado Java.
- El editor le permite añadir puntos de interrupción al código fuente de un procedimiento almacenado Java. Sin embargo, estos puntos de interrupción se pasan por alto porque la depuración de procedimientos almacenados Java aún no está soportada.
Si se reserva un documento (por ejemplo, si se marca como solo de lectura) cuando hay un editor abierto, al cerrarse el editor se perderán todos los cambios pendientes. Asegúrese de reservar un documento antes de abrirlo en un editor.
El cargador de catálogos JDBC no puede determinar si un identificador de objetos de esquema debe delimitarse para los entornos locales que no estén en inglés. Para los identificadores que deban delimitarse, después de la importación abra el editor de esquemas/tablas para redenominar el objeto de esquema. Consulte la documentación del servidor de base de datos para determinar cuándo debe delimitarse un identificador.
- Cuando se conecte a DB2 Universal Database para iSeries, debe seleccionar el controlador JDBC de AS/400 Toolbox para Java en el campo desplegable Controlador JDBC de asistente Conexión a base de datos nueva. Hallará más información en el tema de ayuda "Crear una conexión JDBC utilizando un controlador de DB2 Universal Database para iSeries".
- En el controlador DB2 Universal para Linux, Unix y Windows no están soportados los procedimientos almacenados SQLJ ni Java.
- No está permitido conectarse desde un cliente DB2 v8 a un servidor DB2 v7 en Linux, Unix y Windows.
En el caso de otros servidores DB2, vea la ayuda en línea para seleccionar controladores JDBC al establecer conexiones de base de datos.
Si está trabajando con DB2 Universal Database Versión 7 en la estación de trabajo cliente y se conecta a DB2 Universal Database Versión 8 en el servidor, no podrá eliminar procedimientos almacenados Java del servidor DB2 Versión 8.
Cuando utilice el asistente Función definida por usuario SQL nueva para crear una UDF de tabla DB2, el asistente recomienda tipos de datos SQL para los datos devueltos de cada columna.
Si el asistente no puede correlacionar el correspondiente tipo de datos de una columna, o si usted desea utilizar un tipo de datos devuelto distinto en una columna, abra la UDF generada en el editor y cambie el tipo de datos manualmente.
Cuando intente construir o ejecutar un procedimiento almacenado o una función definida por usuario (UDF) de DB2, podría recibir el siguiente mensaje de error:
[IBM][JDBC Driver] CLI0600E. El handle de conexión no es válido o la conexión está cerrada. SQLSTATE=S1000
Para evitar este error, basta con que vuelva a construir o ejecutar la rutina. El mensaje de error no aparecerá la segunda vez y se puede pasar por alto.
WebSphere Studio incluye una versión WebSphere del cliente JDBC Sequelink 5.1 en el archivo Dir_instalación_WS/runtimes/aes_v4/lib/sljc.jar. Las herramientas de bases de datos relacionales de WebSphere Studio no están habilitadas para utilizar esta versión del cliente para la conexión JDBC. Podría recibir este mensaje de error:
IWAS0126E Se encontraron problemas mientras se intentaba establecer la conexión nombre_conexión Razón: la conexión no se ha establecido porque el archivo JAR seleccionado no es un cliente DataDirect de WebSphere. Asegúrese de que el JAR seleccionado procede de una instalación de WebSphere.
cuando se especifica este JAR en el campo Ubicación de clase JDBC del asistente Conexión. En el servicio de soporte de IBM está disponible una versión del cliente que se puede utilizar en las herramientas de bases de datos relacionales.
WebSphere Studio Versión 5.x incluye una nueva versión del cliente JDBC de DataDirect Sequelink. El cliente JDBC de DataDirect Sequelink 5.3 está en el archivador Dir_instalación_WS/runtimes/base_v5/lib/sljc.jar. En la documentación de las herramientas de bases de datos relacionales encontrará información sobre cómo conectarse a una base de datos utilizando el controlador JDBC de Sequelink 5.1.
Se necesita una resolución mínima de 1280x1024 para hacer que el contenido del asistente Conexión esté visible.
Los archivos SQL de la carpeta de proyectos Setup/database de cada ejemplo de WebSphere Application Server - Express pueden contener errores de análisis que aparezcan en la vista Esquema de la perspectiva Datos. Sin embargo, los archivos SQL se ejecutan satisfactoriamente utilizando la acción "Ejecutar en servidor de base de datos" tal como se describe en el archivo README.html de los ejemplos.
WebSphere Application Server - Express proporciona una base de datos Cloudscape poblada con datos.
Para utilizar Cloudscape en Linux, utilice el script EXPcview.sh que se encuentra en el directorio /opt/IBM/WebSphere/Express/Express/bin.
- Si utiliza controladores JDBC de conexión para DataDirect SequeLink 5.1, 5.3 o WebSphere, no podrá recuperar tablas a partir de Microsoft SQL Server Versión 7 si las tablas no son suyas (no es su propietario). Por ejemplo, si es el propietario de la Tabla1 y la Tabla2 en la BaseDatosA y especifica en el asistente de conexión a base de datos que desea conectarse a la BaseDatosB, solo se mostrarán la Tabla1 y la Tabla2, aunque estar tablas no pertenecen a la BaseDatosB, pero se recuperan porque el ID de usuario empleado para la conexión es el propietario de las tablas.
- También debe ser el propietario de las tablas si utiliza los controladores JDBC de DataDirect SequeLink 5.1 ó 5.3 para recuperarlas a partir de Microsoft SQL Server 2000.
Si se realizan múltiples acciones de conexión y desconexión utilizando Cloudscape 5.1, podrían aparecer tablas sin columnas en el panel Servidores BD. Si se produce este problema, reinicie WebSphere Studio.
Al importar, suprimir y volver a importar archivos JAR de EJB (de ejemplos o similares) teniendo abierta la perspectiva Datos o la perspectiva J2EE o las dos, a veces aparecen nodos de esquema duplicados en las bases de datos de fondo para esos archivos JAR de EJB. Las entradas no son nocivas, pero le recomendamos que cierre la perspectiva y la abra de nuevo para que desaparezcan las entradas duplicadas.
Al exportar datos relacionales a la base de datos UTF-8 UDB DB2 V7 en el entorno local árabe, puede recibir mensajes de error dañados si se producen errores. No hay ninguna solución para este problema.
Volver al archivo readme principal
(C) Copyright IBM Corporation 2000, 2003. Reservados todos los derechos.