Modifier les paramètres généraux du pool de connexions JDBC

Lors de la modification d'un pool de connexions JDBC, tous les paramètres peuvent être revus à l'exception du nom du pool.

  1. Dans l'arborescence de navigation, développez le nœud Ressources.
  2. Sélectionnez le nœud Pools de connexions.

    La page Pools de connexions s'ouvre.

  3. Cliquez sur le nom du pool de connexions que vous modifiez.

    La page Modification du pool de connexions s'ouvre.


    Remarque – Le champ Nom est en lecture seule. Vous pouvez indiquer le nom du pool de connexions uniquement au moment de sa création.


  4. Dans le champ Nom de classe de la source de données, entrez le nom de la classe spécifique du fournisseur qui implémente les API DataSource et/ou XADataSource.

    Cette classe est située dans le pilote JDBC.

  5. Dans la liste déroulante Type de ressource, sélectionnez un type de ressource.

    Les options incluent : javax.sql.DataSource (transactions locales uniquement), javax.sql.XADataSource (transactions globales) et java.sql.ConnectionPoolDataSource (transactions locales, améliorations possibles des performances).

  6. Dans le champ Description, entrez une brève description du pool de connexions.
  7. Dans le champ Taille initiale et minimale du pool, entrez le nombre minimal de connexions de ce 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 Enterprise Server.

  8. Dans le champ Taille maximale du pool, entrez le nombre maximal de connexions de ce pool.
  9. Dans le champ Valeur de redimensionnement du pool, entrez le nombre de connexions par lot de redimensionnement du pool.

    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.

  10. Dans le champ Délai d'inactivité, entrez le délai maximal, en secondes, durant lequel une connexion peut demeurer inactive dans le pool.

    Une fois ce délai expiré, la connexion est supprimée du pool.

  11. Dans le champ Attente max., entrez le délai maximal, en millisecondes, durant lequel l'application demandant une connexion attend avant que la connexion n'arrive à expiration.
  12. Cochez la case Validation des connexions requise pour activer la validation des connexions.

    La validation des connexions permet au serveur de se reconnecter en cas d'échec.

  13. Dans la liste déroulante Méthode de validation, sélectionnez une méthode de validation.

    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.

    Validation automatique et métadonnées

    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.


    Table

    L'application interroge la table de base de données spécifié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.

  14. Si vous sélectionnez Table dans la liste déroulante Méthode de validation, entrez ensuite le nom de la table de base de données dans le champ Nom de la table.

    Le nom de la table ne peut contenir que des caractères alphanumériques, des caractères de soulignement, des tirets ou des points.

  15. Cochez la case Fermer toutes les connexions sur tout échec pour que le serveur ferme et rétablisse toutes les connexions du pool en cas d'échec d'une connexion.

    Si cette option est désactivée, les connexions individuelles ne sont rétablies que lorsqu'elles sont utilisées.

  16. Cochez la case Autoriser des programmes appelants non composant de sorte que le pool puisse être utilisé par des appelants non-composant, tels que les modules de filtres de servlet et de cycle de vie.
  17. Cochez la case Connexions non transactionnelles pour revenir aux connexions non transactionnelles.
  18. Dans la liste déroulante, sélectionnez le niveau d'isolement des transactions du pool de connexions.

    Si aucune valeur n'est spécifiée, les connexions sont établies au niveau d'isolement par défaut indiqué par le pilote JDBC.

  19. Cochez la case Niveau d'isolement garanti pour que 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 modifié systématiquement (avec con.setTransactionIsolation) lors de sa dernière utilisation, ce mécanisme rétablit l'état au niveau d'isolement indiqué.

    Ce paramètre ne s'applique que lorsqu'un niveau d'isolement de transaction a été spécifié à l'étape 18.

  20. Cliquez sur Enregistrer.
Voir aussi