Créer un pool de connexions JDBC

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.

Avant de commencer

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 :

  1. Dans l’arborescence de navigation, sélectionnez le nœud Tâches courantes.

    La page Tâches courantes s’affiche.

  2. Sur la page Tâches courantes, cliquez sur le bouton Créer un nouveau pool de connexions JDBC.

    La page Nouveau pool de connexions JDBC (étape 1 sur 2) s’ouvre.


    Remarque - Vous pouvez également accéder à la page Nouveau 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 Pools de connexions pour créer un pool de connexions.


  3. Dans le champ Nom du pool, entrez le nom du nouveau pool de connexions.

    Ce champ est obligatoire.

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

    Les types de ressources 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.

  5. Spécifiez un fournisseur de base de données en effectuant l’une des actions suivantes :
  6. Cliquez sur Suivant.

    La page Nouveau pool de connexions JDBC (étape 2 sur 2) s’ouvre.

  7. Dans le champ Nom de classe de la source de données, saisissez le nom de la classe spécifique au fournisseur qui implémente l’API DataSource, ConnectionPoolDataSource ou XADataSource.

    Si vous sélectionnez l’un des types de ressource 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é.

  8. Dans le champ Nom de classe du pilote, saisissez le nom de classe spécifique au fournisseur qui implémente l’API java.sql.Driver.

    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é.

  9. Cochez la case Ping activé pour effectuer automatiquement un ping sur un 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.

  10. Dans le champ Description, entrez une brève description du pool de connexions.
  11. Dans le champ Taille initiale et minimale du pool, entrez le nombre minimal de connexions pour 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 GlassFish Server. La valeur par défaut est 8.

  12. Dans le champ Taille maximale du pool, entrez le nombre maximal de connexions pour ce pool.

    La valeur par défaut est 32.

  13. 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. La valeur par défaut est 2.

  14. 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. La valeur par défaut est 300.

  15. 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.

    La valeur par défaut est 60 000.

  16. Cochez la case Connexions non transactionnelles pour revenir aux connexions non transactionnelles.

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

  17. Dans la liste déroulante Niveau d’isolement des transactions, sélectionnez le niveau d’isolement des transactions de ce 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. Par défaut, cette option n’est pas spécifiée.

  18. 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 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é. 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é.

  19. (Facultatif) Dans la section Autres propriétés, spécifiez d’autres propriétés.

    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. La table contient normalement les propriétés utilisées par le fournisseur de la base de données. Pour obtenir des informations sur quelques unes des propriétés disponibles, reportez-vous à la section Propriétés spécifiques aux pools de connexions JDBC.

    Si vous n’indiquez pas de valeur pour une propriété, celle-ci est supprimé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 :

    ()
  20. Cliquez sur Terminer.

Voir aussi

Copyright © 2005, 2011, Oracle et/ou ses affiliés. Tous droits réservés. Notice légale