Lors de la création d'un pool de connexions à l'aide de la Console d’administration, vous définissez les aspects d'une connexion à une base de données spécifique.
Pour créer un pool de connexions, vous devez d'abord installer et intégrer un pilote prenant en charge l'API JDBC (pilote JDBC). Voir Intégrer un pilote JDBC.
Les informations suivantes sont requises pour créer le pool de connexions JDBC. Rassemblez ces informations avant de procéder :
Nom du fournisseur de base de données
Type de ressource, notamment javax.sql.DataSource (transactions locales uniquement), java.sql.ConnectionPoolDataSource (transactions locales, améliorations possibles des performances) et javax.sql.XADataSource (transactions globales)
Nom de la classe de source de données
Propriétés requises, telles que le nom de la base de données (URL), nom de l'utilisateur et mot de passe
La page Nouveau pool de connexions JDBC (étape 1 sur 2) s'ouvre.
Remarque – Vous pouvez également accéder à la page Pool de connexions JDBC en développant les nœuds Ressources et JDBC et en sélectionnant le nœud Pools de connexions. Sélectionnez l'option Nouveau sur la page Nouveau pool de connexions pour créer un pool de connexions.
Ce champ est obligatoire.
Les options incluent : javax.sql.XADataSource (transactions globales) et java.sql.ConnectionPoolDataSource (transactions locales, améliorations possibles des performances), javax.sql.DataSource (transactions locales seulement).
La page Nouveau pool de connexions JDBC (étape 2 sur 2) s'ouvre.
Cette valeur détermine également le nombre de connexions placées dans le pool lors de la création initiale du pool ou du démarrage du serveur d'application. La valeur par défaut est 8.
La valeur par défaut est 32.
Lorsque le pool augmente ou diminue à la taille maximale et minimale respectivement, il est redimensionné par lots. Cette valeur détermine le nombre de connexions dans le lot. Une valeur trop élevée retarde la création et le recyclage de la connexion, alors qu'une valeur trop basse affecte les performances. La valeur par défaut est 2.
Une fois ce délai expiré, la connexion est supprimée du pool. La valeur par défaut est 30.
La valeur par défaut est 60,000.
La validation des connexions permet au serveur de se reconnecter en cas d'échec.
Le serveur d'application peut valider des connexions à la base de données de trois manières : validation automatique, méta-données et table.
Le serveur d'application valide une connexion en appelant les méthodes con.getAutoCommit et con.getMetaData.
Remarque – La plupart des pilotes JDBC mettent en cache le résultat de ces appels. Par conséquent, l'utilisation de ces appels ne donne pas toujours une validation fiable. Contactez votre fournisseur de pilotes pour savoir si ces appels sont mis ou non en cache.
L'application interroge la table de base de données indiquée. La table doit exister et être accessible, mais ne requiert aucune ligne. N'utilisez pas une table existante comportant un nombre important de lignes ou une table déjà fréquemment consultée.
Le nom ne peut contenir que des caractères alphanumériques, des caractères de soulignement, des tirets ou des points.
Si cette case à cocher est désactivée, les connexions individuelles ne sont rétablies que lorsqu'elles sont utilisées.
Les modules Filtres de servlet et Cycle de vie sont des exemples d'appelants non-composant.
Si aucune valeur n'est spécifiée, les connexions sont établies au niveau d'isolement par défaut indiqué par le pilote JDBC.
Si la case à cocher Garanti est activé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 est systématiquement modifié (avec con.setTransactionIsolation) lors de sa dernière utilisation, ce mécanisme rétablit l'état au niveau d'isolement spécifié.
Le nom de la base de données (URL), le nom d'utilisateur et le mot de passe sont des exemples de propriétés requises. Les propriétés variant d'un fournisseur de bases de données à l'autre, consultez la documentation de chacun pour plus d'informations.