Documente Academic
Documente Profesional
Documente Cultură
2
Ref. del documento: 74880-01-0520-01 ltima actualizacin: noviembre 1999 Tema 1. Acceso a informacin actualizada de las Notas de versin 2. Informacin resumida sobre el producto 3. Contenido de la versin 4. Instrucciones especiales de instalacin 5. Instrucciones especiales de actualizacin 6. Limitaciones de la versin 7. Problemas conocidos 8. Asistencia tcnica 9. Otras fuentes de informacin Pgina 1 2 3 4 4 4 12 13 14
Vaya a la sede Product Manuals http://sybooks.sybase.com. Elija una familia de producto. Elija un producto. En la lista Collection de la ventana izquierda, elija el enlace correspondiente al producto y a la versin por los que est interesado. En la ventana de la derecha, elija la lista de los documentos individuales, y seleccione el enlace a la versin correspondiente a su platforma. Para explorar el documento en lnea o telecargar la versin PDF, haga clic en el botn PDF situado en la parte inferior de la ventana izquierda.
Java puro. jConnect permite un acceso directo de gran rendimiento a la totalidad de la familia de productos Sybase, incluidos Adaptive Server Enterprise, Adaptive Server Anywhere, Adaptive Server IQ (antes denominado Sybase IQ) y Replication Server.
Nota Sybase emplea los nombres Adaptive Server y Adaptive Server
Enterprise para hacer referencia a todas las versiones compatibles de Sybase SQL Server y Adaptive Server Enterprise.
3.Contenido de la versin
Conformidad con los requisitos de las especificaciones JDBC 1.x y JDBC 2.0. Compatibilidad con protocolos nativos. No es precisa su instalacin en el cliente. Configuraciones de varios niveles.
jConnect permite: Interoperatividad con otros controladores JDBC. Acceso directo y de alto rendimiento a bases de datos. Instalacin inexistente en los clientes. Compatibilidad con bases de datos heterogneas y de legado. Portabilidad entre cualquier tipo de servidor web y cualquier cliente preparado para Java. Escalabilidad para las aplicaciones vitales de una empresa. Seguridad y fiabilidad.
3. Contenido de la versin
En esta seccin se resume la informacin sobre las funciones nuevas o que han sido modificadas en jConnect Versiones 4.2 y 5.2. Consulte el documento Sybase jConnect for JDBC Programmers Reference si precisa informacin ms detallada sobre estas prestaciones. Adaptive Server Enterprise 12.0 y las versiones posteriores, admiten la sintaxis de escape para uniones externas {oj...}. Adaptive Server Enterprise, versin 12.0, es compatible con el modo Failover HA (funciones de recuperacin tras fallo de Sybase para sistemas de alta disponibilidad). jConnect, versiones 4.2 y 5.2, incorpora un cargador de clases dinmico, que proporciona la posibilidad de cargar una clase directamente desde un servidor Adaptive Server Anywhere o Adaptive Server Enterprise y utilizarla como si estuviera presente en CLASSPATH.
Compatibilidad con las extensiones estndar JDBC 2.0. El paquete JDBC 2.0 Optional Package (denominado anteriormente JDBC 2.0 Standard Extension API) incorpora varias prestaciones nuevas que los controladores JDBC 2.0 pueden implementar (consulte la direccin java.sun.com/product/jdbc si precisa informacin ms detallada). jConnect versin 5.2 ha incorporado las caractersticas de extensin estndar siguientes: JNDI para denominacin de bases de datos. Agrupacin de conexiones. Compatibilidad con la gestin de transacciones distribuidas.
6. Limitaciones de la versin
En esta seccin se describen los problemas o limitaciones ms comunes existentes en jConnect, que afectan a todas las aplicaciones y conciernen a todas las versiones y plataformas Java. Se describen los siguientes temas: 4 Implementacin de los mtodos estndar JDBC 1.0 Implementacin de mtodos estndar JDBC 2.0 Limitaciones especficas del explorador o la mquina virtual Limitaciones especficas de la base de datos Problemas conocidos
6.Limitaciones de la versin
Todos los mtodos DatabaseMetaData requieren la instalacin de la informacin sql_server12.sql, sql_server.sql o sql_anywhere.sql en cualquier servidor con el que se deseen emplear. Los cdigos SQLSTATE no son estndar. Existen ciertos casos en los que se devuelve un valor SQLSTATE definido por el proveedor para una condicin en la que existe un valor estndar. Los errores originados en el servidor suelen tener un SQLSTATE 'ZZZZZ'. Sin embargo, como las excepciones SQL almacenan el nmero de error procedente de sysmessages en el campo SQLException.getErrorCode(), puede utilizar este valor en lugar del valor SQLSTATE.
6.Limitaciones de la versin
Interfaz
CallableStatement
ResultSet
Statement
Nota jConnect, en sus versiones 5.x, no admite algunos de los mtodos opcionales de la API de JDBC 2.0 (por ejemplo, Array, Blob, Clob). Dichos mtodos generarn una excepcin java.lang.UnsupportedOperationException si se les invoca. Si precisa informacin ms detallada sobre los mtodos estndar de JDBC 2.0, consulte el documento Java 2 API Specification en la direccin: http://java.sun.com./products/jdk/1.2/docs/api/index.html/
6.Limitaciones de la versin
La utilizacin de jConnect con HP-UX 10.2 y JDK 1.1.3 puede producir la aparicin de una declaracin o error de falta de memoria. Dicho error es producido por la mquina virtual, y no por el controlador jConnect. Algunos usuarios nos han informado de que el problema parece solucionarse ampliando el espacio de intercambio. jConnect no es compatible con JDK 1.1.3 en sistemas Solaris. Esto es vlido para todas las versiones de jConnect. Con Internet Explorer y algunas mquinas virtuales AIX de IBM, los inicializadores de clase esttica que invocan a mtodos estticos en otras clases descargadas no funcionan correctamente, cosa que afecta a la forma en que se registran los controladores en DriverManager. Si escribe applets para Internet Explorer, consulte el documento Sybase jConnect for JDBC Programmers Reference si precisa ms informacin sobre la utilizacin del controlador jConnect con Internet Explorer. Consulte Utilizacin de la Gua del Programador de jConnect y la Documentacin Javadoc en la Gua de Instalacin de jConnect for JDBC si necesita saber cmo puede examinar e imprimir esta documentacin.
Para utilizar la pasarela Cascade HTTP con Internet Explorer 4.0, deber cambiar la configuracin de Internet Explorer con el fin de utilizar HTTP 1.0 en lugar de HTTP 1.1. Encontrar las instrucciones completas en la documentacin de Internet Explorer.
Al utilizar objetos ResultSets TYPE_SCROLL_INSENSITIVE en jConnect 5.0, slo puede invocarse el mtodo isLast( ) una vez leda la ltima fila del objeto ResultSet. Si se invoca a isLast( ) antes de que haber alcanzado la ltima fila, se genera una excepcin UnimplementedOperationException.
6.Limitaciones de la versin
jConnect Versiones 4.2 y 5.2 Algunos mtodos MetaData pueden provocar la excepcin JZ0R2 u otros errores, si se ejecutan durante una conexin mientras se est realizando una transaccin ampliada. Durante una conexin no es posible utilizar los mtodos DatabaseMetaData abajo citados mientras la conexin se encuentre en una transaccin (es decir, si el valor de setAutoCommit( ) es false y se aplica un comando select, insert, update, delete, o execute, o bien si se utiliza un comando explcito begin transaction):
getColumns( ) getColumnPrivileges( ) getCrossReference( ) getIndexInfo( ) getExportedKeys( ) getImportedKeys( ) getPrimaryKeys( )
La utilizacin de los mtodos DatabaseMetaData getCrossReference( ), getImportedKeys( ) o getExportedKeys( ) con SQL Server versin 11.0.1 y 11.0.2, puede producir un error de seguimiento de la pila que concluir el proceso. Este problema no se presenta con SQL Server 11.0.3 y versiones posteriores.
6.Limitaciones de la versin
Para evitar estos problemas, asigne a la propiedad de controlador LITERAL_PARAMS el valor true. De esta forma, los parmetros definidos por los mtodos setXXX en los objetos PreparedStatement se introducirn en la instruccin SQL en forma literal cuando sta se ejecute. Los procedimientos almacenados no pueden devolver conjuntos de resultados y parmetros de salida, sino una cosa o la otra. Con SQL Anywhere, los procedimientos almacenados no devuelven valores de estado, por lo que una instruccin CallableStatement en la forma {?=invocacin ...} fallara, al no recibirse valor de retorno alguno. SQL Anywhere 5.5.02 y versiones posteriores, devuelve parmetros de salida procedentes de la misma aplicacin. No obstante, dichos parmetros no devuelven un valor de estado correcto. Adems, tampoco se devuelve un conjunto de resultados; es posible contar con parmetros de salida y conjuntos de resultados en procedimientos almacenados independientes, pero no as contar con ambos en un solo procedimiento almacenado. Si una actualizacin o eliminacin no afecta a ninguna fila, SQL Anywhere genera un error "02000". En SQL Anywhere no estn disponibles cuentas de filas. Por ello, debe evitarse la agrupacin de instrucciones por lotes.
6.Limitaciones de la versin
jConnect Versiones 4.2 y 5.2 Puede presentarse tambin un problema al utilizar objetos CallableStatement para invocar a un procedimiento almacenado que tenga un objeto Java como parmetro. Para evitar este problema, utilice en su lugar el mtodo setBytes( ). Por ejemplo:
callStmt.setBytes(1, sybase.sql.ASAUtils.toByteArray(objeto))
6.Limitaciones de la versin
java=`which java` if ["$JAVA_HOME" = "" ] then echo "Please specify JAVA_HOME" exit else java="$JAVA_HOME/bin/java" fi
11
7.Problemas conocidos
7. Problemas conocidos
En esta seccin se describen los problemas que est previsto solucionar en una futura versin de jConnect.
Nmero 186838 Descripcin/Solucin
Select {fn concat(null,x)} debe devolver un valor NULL.
Segn la especificacin JDBC, si DatabaseMetaData.nullPlusNonNullIsNull() devuelve true, en una operacin que implique un valor NON NULL y otro NULL, el resultado deber siempre ser NULL. El resultado NON NULL obtenido con el procesamiento de escape anterior se obtiene porque se ha intentado realizar una operacin + entre un valor NULL y un tipo varchar(cadena), por ello se devuelve el valor de varchar. Una operacin en que estn implicados un valor NULL y otro numrico dar como resultado el valor NULL esperado. 189291 Slo se produce un error de E/S en ResultSet.close( ) si la propiedad de conexin LANGUAGE_CURSOR est definida como true. Si define LANGUAGE_CURSOR de forma especfica como true, esta propiedad intenta definir un nombre de cursor, ejecuta la consulta, invoca a rs.next( ) y cierra el conjunto de resultados sin leer todas las filas o sin llegar al final del objeto ResultSet, lo que generar una excepcin de E/S. Comportamiento con chained mode,Connection.commit(), DatbaseMetadata.getcolumns. Al realizar una conexin, jConnect ejecuta sp_mda antes de la devolucin del objeto de conexin. De esta forma, se habilita jConnect para la implementacin de mtodos en DatabaseMetadata, y se define el modo de transaccin encadenada como desactivado segn la especificacin JDBC 1.x. De esta manera se altera el comportamiento por defecto de la base de datos, en que la configuracin por defecto suele definir el modo de transaccin encadenado como activado. Solucin: Utilice Connection.setAutoCommit(falso), que emitir el comando para restablecer el modo de transaccin encadenada al estado activado. 193431 Un error en la implementacin de la propiedad PROTOCOL_CAPTURE de jConnect producir una excepcin en la utilidad Ribo. Si la lnea conn.commit() se pone en efecto, y se incorpora una propiedad PROTOCOL_CAPTURE para capturar el flujo TDS, Ribo recibir el error siguiente al intentar analizar el archivo de captura:
Excepcin detectada al leer un testigo: java.io.EOFException IOException inesperada: java.io.EOFException.
193381
Si se utiliza setTimestamp(1, null), se enva al backend el valor 1970-01-01 00:00:00.0. El testigo SSL para jConnect versin 5.0 ha dejado de ser vlido, ya que Sun ha modificado
sun.security.ssl.SSLSocketImpl.setEnabledCipherSuites() en JDK 1.2.2.
12
8.Asistencia tcnica
Nmero 202534
Descripcin/Solucin Si cuenta con ms de 1000 parmetros en su instruccin por lotes, se generar la excepcin BatchException siguiente:
PreparedStatement BATCH caused an Unexpected com.sybase.jdbc2.jdbc.SybBatchUpdateException: JZ0BE: BatchUpdateException: Error al ejecutar la instruccin por lotes: Demasiados parmetros -- desbordamiento de tabla de smbolos.
202606 203365
Solucin: Asegrese de que la cantidad total de parmetros y lotes definidos no supere los 1000. Este problema slo se produce con Adaptive Server Enterprise. DatabaseMetaData.allTablesAreSelectable() en Adaptive Server Enterprise devuelve siempre '0', y '1' en Adaptive Server Anywhere. El cdigo siguiente muestra un problema con getByte() al recuperar un valor de una columna char(1), generndose la excepcin SQL siguiente:
*** SQLException caught *** SQLState: Mensaje JZ009: JZ009: Error en la conversin.
203675
209420
Si al implementar el soporte failover en jConnect versin 4.2 5.2, y si la entrada JNDI para el servidor secundario no es vlido (por ejemplo, nombre host desconocido o nmero de puerto incorrecto), se producir un bucle infinito durante la conexin.
Este problema ha sido resuelto en el EBF 8719. jConnect versin 4.2 y 5.2 falla con una excepcin IOException al ejecutar un procedimiento almacenado como una instruccin CallableStatement en el servidor Adaptive Server Enterprise versin 12.0. Este problema ha sido resuelto en el EBF 8719.
209605
8. Asistencia tcnica
Todas las instalaciones Sybase que hayan adquirido un contrato de asistencia tienen una o varias personas designadas que estn autorizadas a ponerse en contacto con el servicio de asistencia tcnica de Sybase. Si tiene algn tipo de pregunta sobre este tipo de instalacin, o si precisa ayuda durante el proceso de instalacin, pdale a la persona encargada que se ponga en contacto con el servicio de asistencia tcnica de Sybase o con la delegacin de Sybase para su zona
13
14
Introduzca en el explorador la direccin del sitio web siguiente para entrar en la seccin Technical Documents: techinfo.sybase.com http://techinfo.sybase.com/css/techinfo.nsf/Home
2 3
En la seccin Browse, haga clic en la entrada Whats Hot. Explore el rea que le interese: Hot Docs, que cubre distintos temas, o Hot Links con noticias tcnicas, informes sobre certificaciones, certificaciones de partners, etc.
Consulte el sitio web siguiente para entrar en la seccin Technical Documents: techinfo.sybase.com http://techinfo.sybase.com/css/techinfo.nsf/Home
2 3
En la seccin Browse, haga clic en la entrada Whats Hot. Haga clic en la entrada EBF Rollups. Puede documentarse sobre los EBF mediante los documentos Technical Documents, y podr descargarlos mediante ESD (Electronic Software Distribution, distribucin electrnica de software).
Siga las instrucciones asociadas con las entradas SupportPlusSM Online Services.
Puede registrarse siguiendo las instrucciones de la Web. Para utilizar SupportPlus, necesitar: 1 2 3 4 Un explorador web compatible con SSL (Secure Sockets Layer, capa de sockets seguros), como Netscape Navigator 1.2 o versin posterior. Una licencia de asistencia vlida. Conocer a la persona designada para ponerse en contacto con el servicio de asistencia tcnica. Su identificador de usuario y contrasea.
Puede utilizar Technical Documents de Sybase. Los informes de certificacin se encuentran entre los documentos de este sitio. 1 Introduzca en el explorador la direccin del sitio web siguiente para entrar en la seccin Technical Documents: techinfo.sybase.com http://techinfo.sybase.com/css/techinfo.nsf/Home 2 3 En la seccin Browse, haga clic en la entrada Whats Hot. Haga clic en el tema que le interese.
15
16