Cuando se crea un pool de conexiones con la Consola de administración, está definiendo los aspectos de una conexión con una base de datos específica.
Para crear un pool de conexiones, en primer lugar debe instalar e integrar un controlador que soporte la API de JDBC (controlador JDBC). Consulte Para integrar una controlador JDBC.
La siguiente información es necesaria a la hora de crear el pool de conexiones JDBC. Recopile esta información antes de continuar:
Nombre de proveedor del controlador de la base de datos
Tipo de recurso, como javax.sql.DataSource
(sólo transacciones locales), java.sql.ConnectionPoolDataSource
(transacciones locales, posibles mejoras de rendimiento), javax.sql.XADataSource
(transacciones globales) y java.sql.Driver
Nombre de clase de origen de datos
Propiedades obligatorias, como el nombre de la base de datos (URL), nombre de usuario y la contraseña.
En el árbol de navegación, seleccione el nodo Tareas comunes.
Se abrirá la página Tareas comunes.
En la página Tareas comunes, haga clic en el botón Crear nuevo pool de conexiones JDBC
Se abrirá la página Nuevo pool de conexiones JDBC (paso 1 de 2)
Nota:
También puede acceder a la página Nuevo pool de conexiones JDBC si amplía los nodos Recursos y JDBC, y después selecciona el nodo Pools de conexiones. A continuación, en la página Pools de conexiones, haga clic en Nuevo para crear un pool de conexiones.En el campo Nombre de pool, asigne un nombre al nuevo pool de conexiones.
Se trata de un campo obligatorio.
En la lista desplegable Tipo de recurso, seleccione un tipo de recurso.
Entre las opciones se incluyen javax.sql.XADataSource
(transacciones globales), java.sql.ConnectionPoolDataSource
(transacciones locales, posibles mejoras del rendimiento), javax.sql.DataSource
(sólo transacciones locales) y java.sql.Driver
.
Especifique un proveedor de base de datos:
En la lista desplegable Proveedor de Controladores de la Base de Datos, seleccione un proveedor de base de datos.
Si el proveedor de base de datos no aparece en la lista, escriba el nombre del proveedor en el campo de texto Proveedor de Controladores de la Base de Datos.
Active la casilla de control de activación de introspección para realizar la introspección del controlador de la base de datos en función del tipo de recurso y del proveedor del controlador de la base de datos.
Para que la introspección funcione correctamente, el controlador JDBC debe estar disponible para GlassFish Server. Consulte Para integrar una controlador JDBC.
Haga clic en Siguiente.
Se abrirá la página Nuevo pool de conexiones JDBC (paso 2 de 2)
En el campo Nombre de Clase de Origen de Datos, introduzca el nombre de la clase específica del proveedor que implanta las API DataSource
, ConnectionPoolDataSource
o XADataSource
.
Si ha activado la introspección y seleccionado uno de los tipos de recursos de origen de datos, este campo se rellenará automáticamente con el nombre de clase asociada al tipo de recurso y al proveedor de bases de datos que haya seleccionado. Si ha seleccionado el tipo de recurso java.sql.Driver
, este campo está desactivado.
En el campo Nombre de clase del controlador, escriba la clase específica del proveedor que implanta la API java.sql.Driver
.
Si ha activado la introspección o seleccionado el tipo de recurso java.sql.Driver
, este campo se rellenará automáticamente con el nombre de clase asociada al controlador y al proveedor de bases de datos que haya seleccionado. Si ha seleccionado uno de los tipos de recursos de origen de datos, este campo está desactivado.
Active la casilla de control de activación de ping para hacer ping automáticamente en el pool de conexiones durante la creación o reconfiguración del pool para identificar y avisarle de cualquier valor de atributo incorrecto.
Esta opción se activada por defecto.
En el campo Descripción, introduzca una breve descripción del pool de conexiones.
En el campo Tamaño de pool inicial y mínimo:, introduzca el número mínimo de conexiones de este pool.
Este valor también determina el número de conexiones incluidas en el pool cuando se crea el pool por primera vez o cuando se inicia GlassFish Server. El valor por defecto es 8.
En el campo Tamaño de pool máximo, introduzca el número máximo de conexiones de este pool.
El valor por defecto es 32.
En el campo Cantidad de cambio de tamaño de pool, introduzca el número de conexiones por lote de cambio de tamaño de pool.
Cuando el pool se amplía y reduce 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 por defecto es 2.
En el campo Timeout de inactividad, introduzca el tiempo máximo, en segundos, que una conexión puede permanecer inactiva en el pool.
Una vez vencido el tiempo, se elimina la conexión del pool. El valor por defecto es 300.
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 obtener un timeout de conexión.
El valor por defecto es 60.000.
Active la casilla de control de activación de conexiones no transaccionales activadas para devolver conexiones no transaccionales.
Esta opción se activada por defecto.
En la lista desplegable Nivel de aislamiento de transacción, seleccione un nivel de aislamiento de transacción para este pool de conexiones.
Si no se especifica nada, las conexiones funcionan con los niveles de aislamiento por defecto que proporciona el controlador JDBC. Por defecto, no se especifica esta opción.
Active la casilla de control Nivel garantizado para asegurarse de que todas las conexiones que se han obtenido del pool tengan 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. Esta opción se encuentra activada por defecto.
Esta configuración sólo es aplicable si se ha especificado un nivel de aislamiento de transacción.
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. La tabla suele contener las propiedades utilizadas por el proveedor de la base de datos. Para obtener información sobre algunas de las propiedades disponibles, consulte Propiedades específicas de JDBC pools de conexiones.
Si no especifica un valor para una propiedad, éste se eliminará de la tabla cuando acabe de crear el pool de conexiones. Si no desea definir un valor para una propiedad ahora, pero desea que la propiedad permanezca en la tabla para que el valor se pueda definir más adelante, introduzca un juego de paréntesis vacío en el campo Valor:
()
Para agregar una propiedad, haga clic en el botón Agregar Propiedad. En la fila en blanco que aparece, introduzca el nombre de propiedad en el campo Nombre y escriba el valor de propiedad en el campo Valor.
Para modificar una propiedad, edite el campo Valor.
Para suprimir una propiedad, active la casilla de control a la izquierda del campo Nombre de la propiedad que está suprimiendo y, a continuación, haga clic en el botón Suprimir Propiedades.
Haga clic en Finalizar.