La page Nouveau pool de connexions JDBC (étape 2 sur 2) permet de créer un pool de connexions JDBC.
Elle contient les options suivantes.
Nom de classe propre au fournisseur qui implémente l'API DataSource
, ConnectionPoolDataSource
ou XADataSource
. Si vous sélectionnez l'un des types de ressource de source de données, ce champ indique habituellement automatiquement le nom de classe associé au type de ressource et au fournisseur de base de données que vous avez choisis. Si vous sélectionnez le type de ressource java.sql.Driver
, ce champ est désactivé.
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.
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é. Cette option est activée par défaut.
Ce paramètre ne s'applique que lorsqu'un niveau d'isolement de transaction a été spécifié.
Propriétés supplémentaires du pool de connexions JDBC. Ces propriétés peuvent inclure le nom de la base de données (URL), le nom utilisateur et le mot de passe. La table contient normalement les propriétés utilisées par le fournisseur de base de données.
Pour obtenir la description d'une partie des propriétés disponibles, reportez-vous à Propriétés propres aux pools de connexions JDBC.
Si vous n'indiquez pas de valeur pour une propriété, celle-ci est enlevée de la table à l'issue de la création du pool de connexions. Si vous ne souhaitez pas définir immédiatement la valeur d'une propriété mais souhaitez conserver cette propriété dans la table afin de définir sa valeur ultérieurement, entrez des parenthèses vides dans le champ Valeur :
()