Modifier les attributs avancés du pool de connexions JDBC

  1. Dans l'arborescence de navigation, développez le noeud Ressources.

  2. Sous le noeud Ressources, sélectionnez le noeud JDBC.

  3. Sous le noeud JDBC, sélectionnez le noeud Pools de connexions.

    La page Pools de connexions apparaît.

  4. Dans la page Pools de connexions, cliquez sur le nom du pool à modifier.

    La page Modifier le pool de connexions apparaît.

  5. Dans la page Modifier le pool de connexions, cliquez sur l'onglet Avancé.

    La page Modifier les attributs avancés du pool de connexions apparaît.

  6. Dans le champ Temporisation de l'instruction, entrez le délai, en secondes, au-delà duquel les requêtes dont l'exécution est anormalement longue sont abandonnées.

    GlassFish Server définit la valeur de QueryTimeout sur les instructions créées. Définissez la valeur sur -1 pour désactiver cette option. La valeur par défaut est -1.

  7. Dans le champ Taille du cache d'instruction, entrez le nombre d'instructions devant être mises en mémoire cache à l'aide du système de mise en mémoire cache LRU (utilisé le moins récemment).

    Pour désactiver la mise en mémoire cache des instructions, entrez la valeur 0. La valeur par défaut est 0.

  8. Dans le champ Init. SQL, entrez une chaîne SQL à exécuter lors de la création (mais pas de la réutilisation) d'une connexion dans le pool.

    L'exécution de cette chaîne initialise l'état de la connexion.

  9. Dans le champ Processus d'écoute de trace SQL, entrez une liste de noms de classe d'implémentation de processus d'écoute, séparés par des virgules, pour indiquer que les instructions SQL exécutées par les applications sont suivies.

    Les classes de processus d'écoute doivent implémenter l'interface org.glassfish.api.jdbc.SQLTraceListener. L'utilisation de processus d'écoute facilite le filtrage des messages du fichier journal des instructions SQL et aide les administrateurs à analyser ces instructions.

  10. Cochez la case Activé du champ Encapsuler les objets JDBC pour que les applications obtiennent des objets JDBC encapsulés pour les éléments Statement, PreparedStatement, CallableStatement, ResultSet et DatabaseMetaData.

    Cette option est activée par défaut.

  11. Cochez la case Groupement pour activer le groupement des connexions du pool.

    Cette option est activée par défaut.

  12. Dans le champ Valider une fois au plus, saisissez le délai, en secondes, au bout duquel une connexion est validée une fois au plus.

    La définition de cet attribut sur une valeur appropriée réduit le nombre de demandes de validation émanant d'une connexion. La valeur par défaut est 0, ce qui signifie que l'attribut n'est pas activé.

  13. Dans le champ Temporisation de la perte de connexion, saisissez la durée, en secondes, nécessaire au suivi des pertes de connexion dans un pool de connexions.

    Ce champ permet de détecter les éventuelles pertes de connexion de l'application. Une connexion non renvoyée au pool par l'application dans l'intervalle spécifié est soupçonnée de présenter une perte. La trace de pile de l'appelant est alors consignée dans le journal. Définissez la valeur sur 0 pour désactiver le suivi des pertes de connexion. La valeur par défaut est 0.

    Utilisez ce champ avec le champ Récupération de la perte de connexion pour éviter tout risque de perte de connexion de l'application.

  14. Cochez la case Récupération de la perte de connexion pour restaurer les connexions présentant des pertes dans le pool une fois le suivi des pertes de connexion terminé.

    Cette option est désactivée par défaut.

  15. Dans le champ Temporisation de la perte d'instruction, saisissez la durée, en secondes, nécessaire au suivi des pertes d'instruction dans un pool de connexions.

    Ce champ permet de détecter les éventuelles pertes d'instruction de l'application. Une instruction non renvoyée au pool par l'application dans l'intervalle spécifié est soupçonnée de présenter une perte. La trace de pile de l'appelant est alors consignée dans le journal. Définissez la valeur sur 0 pour désactiver le suivi des pertes d'instruction. La valeur par défaut est 0.

    Utilisez ce champ avec le champ Récupération de perte d'instruction pour éviter tout risque de perte d'instruction de l'application.

  16. Cochez la case Récupération de perte d'instruction pour restaurer les instructions présentant des pertes dans le pool une fois le suivi des pertes d'instruction terminé.

    Cette option est désactivée par défaut.

  17. Dans le champ Tentatives de création, saisissez le nombre de tentatives effectuées en cas d'échec de création d'une connexion.

    Définissez la valeur sur 0 pour annuler les tentatives de recréation de la connexion. La valeur par défaut est 0.

  18. Dans le champ Intervalle entre les tentatives, saisissez l'intervalle, en secondes, entre deux tentatives de création d'une connexion.

    La valeur par défaut est 10. Cet attribut n'est utilisé que si la valeur de l'option Tentatives de création est supérieure à 0.

  19. Cochez la case Activé du champ Association lazy pour n'associer une connexion physique à une collection logique que lorsque la connexion est utilisée.

    Les connexions sont dissociées lorsque la transaction est terminée et qu'une méthode de composant prend fin, ce qui facilite la réutilisation des connexions physiques. Si cette option est désactivée, une connexion physique est associée à une connexion logique avant même d'être utilisée. Cette option est désactivée par défaut.

  20. Cochez la case Activé du champ Participation des connexions lazy à la transaction pour engager une ressource dans une transaction uniquement lorsqu'elle est utilisée dans une méthode.

    Cette option est désactivée par défaut.

  21. Cochez la case Activé du champ Associer au thread pour créer des associations entre des connexions et des threads.

    Lorsqu'un thread nécessite une autre connexion, il peut réutiliser celle qui lui est déjà associée, limitant ainsi le temps système lié à l'obtention d'une connexion à partir du pool. Cette option est désactivée par défaut.

  22. Cochez la case Activé du champ Faire correspondre les connexions pour activer la mise en correspondance des connexions du pool.

    Si cette option est activée, une connexion sélectionnée dans le pool doit être mise en correspondance avec les connexions disposant de certaines informations d'identification et de connexion. Cette option doit être activée si le pool de connexions est utilisé par des applications disposant de plusieurs informations d'identification et de connexion utilisateur. Cette option peut être désactivée si l'administrateur sait que les connexions du pool seront toujours homogènes et qu'il est donc inutile pour l'adaptateur de ressource d'associer une connexion empruntée au pool. Cette option est désactivée par défaut.

  23. Dans le champ Utilisation maximale des connexions, saisissez le nombre de réutilisations possibles d'une connexion par le pool.

    Une fois qu'une connexion a été réutilisée le nombre de fois spécifié, elle est fermée. En limitant le nombre de réutilisations d'une connexion, vous pouvez éviter les pertes d'instruction lorsqu'une application ne ferme pas les instructions. Définissez la valeur sur 0 pour désactiver cet attribut. La valeur par défaut est 0.

  24. Cochez la case Requis du champ Validation des connexions pour activer la validation des connexions.

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

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

    GlassFish Server peut valider les connexions à la base de données de l'une des manières suivantes.

    auto-commit et metadata

    GlassFish Server valide une connexion en appelant les méthodes con.getAutoCommit et con.getMetaData.


    Remarque:

    La plupart des pilotes JDBC mettent en mémoire 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 pilote pour savoir si ces appels sont mis en mémoire cache ou non.
    custom-validation

    GlassFish Server utilise un mécanisme de validation défini par l'utilisateur spécifié par la classe d'implémentation personnalisée dans le champ Nom de classe de validation.

    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.

  26. Si vous sélectionnez table dans la liste déroulante Méthode de validation, entrez le nom de la table de base de données ou sélectionnez-le dans la liste déroulante Nom de la table.

  27. Si vous sélectionnez custom-validation dans la liste déroulante Méthode de validation, entrez le nom de la classe d'implémentation de la validation personnalisée ou sélectionnez-le dans la liste déroulante Nom de classe de validation.

    GlassFish Server doit pouvoir accéder au nom de classe indiqué. La classe spécifiée doit implémenter l'interface org.glassfish.api.jdbc.ConnectionValidation.

  28. Cochez la case Fermer toutes les connexions du champ Echec sur tout pour que le serveur ferme et rétablisse toutes les connexions du pool en cas d'échec de l'une d'entre elles.

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

  29. Cochez la case Activé du champ Autoriser des programmes appelants non-composant de sorte que le pool puisse être utilisé par des programmes appelants autres que des composants, tels que des filtres de servlet et des gestionnaires de persistance tiers.

    Les connexions obtenues par des programmes appelants autres que des composants ne sont pas automatiquement fermées par le conteneur à la fin d'une transaction. Elles doivent être explicitement fermées par le programme appelant. Cette option est désactivée par défaut.

  30. Cliquez sur le bouton Vider de l'onglet Général pour vider toutes les connexions du pool.

    Cliquez sur le bouton Vider revient à détruire toutes les connexions existantes, à recréer les connexions établies pour le pool et à restaurer le pool à sa taille initiale et minimale.

  31. Cliquez sur Enregistrer.


    Conseil:

    Pour revenir aux paramètres par défaut, cliquez sur le bouton Charger les valeurs par défaut, puis sur Enregistrer.
Voir aussi
Copyright © 2005, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices