La page Modifier le pool de connexions permet de modifier les propriétés générales d'un pool de connexions JDBC.
Elle contient les options suivantes.
Bouton de restauration des valeurs par défaut des paramètres qui ont des valeurs par défaut. Les paramètres qui n'ont pas de valeurs par défaut ne sont pas modifiés.
Bouton permettant de réinitialiser les connexions dans le pool de connexions. Cliquer sur ce bouton revient à détruire toutes les connexions existantes, à recréer les connexions établies pour le pool et à restaurer le pool à sa taille initiale et minimale.
Bouton permettant de vérifier que le pool de connexions est utilisable. Si un message d'erreur apparaît lorsque vous cliquez sur ce bouton, vérifiez que le serveur de base de données a été démarré.
Nom du pool de connexions. Ce champ est en lecture seule. Vous ne pouvez spécifier le nom du pool qu'à la création d'un pool de connexions JDBC.
Les types de ressource disponibles incluent : javax.sql.XADataSource (transactions globales), java.sql.ConnectionPoolDataSource (transactions locales, améliorations possibles des performances), javax.sql.DataSource (transactions locales uniquement) et java.sql.Driver
.
Nom de classe propre au fournisseur qui implémente la source de données.
Nom de classe du pilote JDBC indiqué par le fournisseur. Si vous sélectionnez le type de ressource java.sql.Driver, ce champ indique habituellement automatiquement le nom de classe associé au pilote et au fournisseur de base de données que vous avez choisis. Si vous sélectionnez l'un des types de ressource de source de données, ce champ est désactivé.
Si cette option est sélectionnée, la commande ping est automatiquement envoyée au pool lors de sa création ou de sa reconfiguration, afin d'identifier et de signaler toute erreur de valeur d'attribut. Cette option est désactivée par défaut.
Brève description du pool de connexions.
Nombre minimal de connexions dans le pool. Cette valeur détermine également le nombre de connexions placées dans le pool lors de sa création initiale ou lors du démarrage de GlassFish Server. La valeur par défaut est 8.
Nombre maximal de connexions dans le pool. La valeur par défaut est 32.
Lors de la montée en puissance du pool jusqu'à sa taille maximale ou de sa réduction jusqu'à sa taille minimale, ce dernier est redimensionné par batch. Cette valeur détermine le nombre de connexions dans le batch. Une valeur trop élevée retarde la création et le recyclage de la connexion, alors qu'une valeur trop basse réduit les performances. La valeur par défaut est 2.
Durée maximale, en secondes, pendant laquelle une connexion peut rester inactive dans le pool. Une fois ce délai expiré, la connexion est enlevée du pool. La valeur par défaut est 300.
Délai d'attente maximal, en millisecondes, d'une application demandant une connexion au-delà duquel il y a temporisation de la connexion. La valeur par défaut est 60 000.
Si cette option est activée, des connexions non transactionnelles sont renvoyées. Par défaut, cette option n'est pas spécifiée.
Lorsqu'un niveau d'isolement de transaction est spécifié, les connexions de ce pool opèrent au niveau indiqué. Si aucune valeur n'est spécifiée, les connexions sont établies au niveau d'isolement par défaut indiqué par le pilote JDBC. Par défaut, cette option n'est pas spécifiée.
Si la case Garanti est cochée, toutes les connexions empruntées au pool partagent le même niveau d'isolement. Par exemple, si le niveau d'isolement de la connexion a été modifié par programmation (avec con.setTransactionIsolation
) lors de sa dernière utilisation, ce mécanisme rétablit le statut au niveau d'isolement spécifié.
Ce paramètre ne s'applique que lorsqu'un niveau d'isolement de transaction a été spécifié.