Para crear un conjunto de conexiones JDBC

Cuando crea un conjunto de conexiones con la Consola de administración, está definiendo los aspectos de una conexión a una base de datos específica.

Antes de empezar

Para crear un conjunto de conexiones, en primer lugar, debe instalar e integrar un controlador compatible con la API JDBC (controlador JDBC). Consulte Para integrar un controlador JDBC.

La siguiente información es necesaria a la hora de crear el conjunto de conexiones JDBC. Recopile esta información antes de continuar:

  1. En el árbol de navegación, seleccione el nodo Tareas comunes.
  2. En la página Tareas comunes, haga clic en el botón Crear nuevo conjunto de conexiones JDBC.

    Se abrirá la página Nuevo conjunto de conexiones JDBC (paso 1 de 2).


    Nota – También puede acceder a la página Conjunto de conexiones JDBC si expande los nodos Recursos y JDBC, y después selecciona el nodo Conjuntos de conexiones. A continuación, en la página de conjunto de conexiones, seleccione Nuevo para crear un conjunto de conexiones.


  3. En el campo Nombre, introduzca un nombre para el nuevo conjunto de conexiones.

    Se trata de un campo obligatorio.

  4. En la lista desplegable Tipo de recurso, seleccione un tipo de recurso.

    Las opciones incluyen javax.sql.XADataSource (transacciones globales) y java.sql.ConnectionPoolDataSource (transacciones locales, posibles mejoras de rendimiento), javax.sql.DataSource (sólo transacciones locales).

  5. En la lista desplegable Proveedor de bases de datos, seleccione un proveedor de bases de datos.
  6. Haga clic en Siguiente.

    Se abrirá la página Nuevo conjunto de conexiones JDBC (paso 2 de 2).

  7. En el campo Nombre de clase de fuente de datos, introduzca el nombre de la clase específica del proveedor que implementa las API DataSource o XADataSource.
  8. En el campo Descripción, introduzca una breve descripción del conjunto de conexiones.
  9. En el campo Tamaño de conjunto inicial y mínimo, introduzca el número mínimo de conexiones de este conjunto.

    Este valor también determina el número de conexiones incluidas en el conjunto cuando se crea el conjunto por primera vez o cuando se inicia el servidor de aplicaciones. El valor predeterminado es 8.

  10. En el campo Tamaño de conjunto máximo, introduzca el número máximo de conexiones de este conjunto.

    El valor predeterminado es 32.

  11. En el campo Cantidad de cambio de tamaño de conjunto, introduzca el número de conexiones por lote de cambio de tamaño de conjunto.

    Cuando el conjunto aumenta y disminuye hacia el tamaño máximo y mínimo respectivamente, se cambia el tamaño en lotes. Este valor determina el número de conexiones en el lote. Si este valor es demasiado grande, se retrasará la creación y el reciclado de las conexiones y, si es demasiado pequeño, el proceso perderá eficacia. El valor predeterminado es 2.

  12. En el campo Tiempo de espera de inactividad, introduzca el tiempo máximo, en segundos, que una conexión puede permanecer inactiva en el conjunto.

    Cuando expire este tiempo, la conexión quedará eliminada del conjunto. El valor predeterminado es 30.

  13. En el campo Tiempo de espera máximo, introduzca el tiempo máximo, en milésimas de segundo, que la aplicación que solicita una conexión esperará antes de que se agote el tiempo de espera de la conexión.

    El valor predeterminado es 60.000.

  14. Marque la casilla de verificación Validación de conexión necesaria para habilitar la validación de la conexión.

    La validación de la conexión permite al servidor volver a conectarse en caso de error.

  15. En la lista desplegable Método de validación, seleccione un método de validación.

    El servidor de aplicaciones puede validar las conexiones de base de datos de tres formas: confirmación automática, metadatos, tabla.

    Asignación automática y metadatos

    El servidor de aplicaciones valida una conexión llamando a los métodos con.getAutoCommit y con.getMetaData.


    Nota – Muchos controladores JDBC guardan en caché los resultados de estas llamadas. Como resultado, al utilizar estas llamadas es posible que no siempre se obtengan validaciones fiables. Consulte con el proveedor del controlador para determinar si estas llamadas se almacenan en caché o no.


    Tabla

    La aplicación consulta la tabla de base de datos que se especifica. La tabla debe existir y estar accesible, aunque no requiera ninguna fila. No utilice una tabla existente que tenga un gran número de filas o una tabla a la que se accede con frecuencia.

  16. Si ha seleccionado Tabla en la lista desplegable Método de validación, introduzca el nombre de la tabla de base de datos en el campo Nombre de tabla.

    El nombre de la tabla debe contener únicamente caracteres alfanuméricos, de subrayado, guiones y puntos.

  17. Marque la casilla de verificación Cerrar todas las conexiones ante cualquier fallo para cerrar todas las conexiones del servidor en el conjunto y restablecerlas cuando no se realice correctamente alguna conexión.

    Si anula la selección de esta casilla de verificación, las conexiones individuales se restablecerán sólo cuando se utilicen.

  18. Seleccione la casilla de verificación Permitir solicitantes que no son componentes habilitado para habilitar el conjunto que van a utilizar los solicitantes que no sean componentes.

    Entre los ejemplo de solicitantes que no son componentes se incluyen los filtros del servlet y los módulos de ciclo de vida.

  19. Marque la casilla de verificación Conexiones no transaccionales habilitadas para devolver conexiones que no sean de transacción.
  20. En la lista desplegable Nivel de aislamiento de transacción, seleccione un nivel de aislamiento de transacción para este conjunto de conexiones.

    Si no se especifica nada, las conexiones funcionan con los niveles de aislamiento predeterminados que proporciona el controlador JDBC.

  21. La casilla de verificación Nivel de aislamiento garantizado sólo es aplicable si se ha especificado un nivel de aislamiento de transacción en el paso 20.

    Si selecciona la casilla de verificación Garantizado, todas las conexiones tomadas del conjunto tendrán el mismo nivel de aislamiento. Por ejemplo, si el nivel de aislamiento para la conexión se cambia de forma programada (con con.setTransactionIsolation ) cuando se utiliza por última vez, este mecanismo devuelve el estado al nivel de aislamiento especificado.

  22. (Opcional) En la sección Propiedades adicionales, especifique las propiedades adicionales.

    Entre los ejemplos de propiedades necesarias, se incluyen el nombre de la base de datos (URL), el nombre de usuario y la contraseña. Puesto que las propiedades varían según el proveedor de la base de datos, consulte la documentación del proveedor para obtener información.

  23. Haga clic en Finalizar (Finish).
Véase también