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). Reportez-vous à Intégrer un pilote JDBC.

Les informations suivantes sont requises pour créer un pool de connexions JDBC. Rassemblez ces informations avant de poursuivre :

  1. Dans l'arborescence de navigation, sélectionnez le noeud Tâches courantes.

    La page Tâches courantes apparaît.

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

    La page Nouveau pool de connexions JDBC (étape 1 sur 2) apparaît.


    Remarque:

    Vous pouvez également accéder à la page Nouveau pool de connexions JDBC en développant les noeuds Ressources et JDBC, puis en sélectionnant le noeud 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 ressource 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 :

    1. Dans la liste déroulante Fournisseur du pilote de base de données, sélectionnez un fournisseur de base de données.

    2. Si le fournisseur de base de données ne figure pas dans la liste, saisissez son nom dans la zone de texte Fournisseur du pilote de base de données.

  6. Sélectionnez la case Activé du champ Introspecter pour activer l'introspection du pilote de base de données en fonction des noms de classe de la source de données ou de l'implémentation du pilote.

  7. Cliquez sur Suivant.

    La page Nouveau pool de connexions JDBC (étape 2 sur 2) apparaît.

  8. Dans le champ Nom de classe de la source de données, saisissez le nom de la 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é.

  9. Dans le champ Nom de classe du pilote, saisissez le nom de classe propre 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é.

  10. Cochez la case Activé du champ Ping pour envoyer automatiquement la commande ping à 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.

  11. Dans le champ Description, entrez une brève description du pool de connexions.

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

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

    La valeur par défaut est 32.

  14. Dans le champ Valeur de redimensionnement du pool, entrez le nombre de connexions par batch de redimensionnement du pool.

    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.

  15. Dans le champ Délai d'inactivité, entrez la 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.

  16. Dans le champ Attente max., entrez le délai d'attente maximal (en millisecondes) au-delà duquel il y a temporisation de la connexion pour une application demandant une connexion.

    La valeur par défaut est 60 000.

  17. Cochez la case Activé du champ Connexions non transactionnelles pour renvoyer les connexions non transactionnelles.

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

  18. Dans la liste déroulante Niveau d'isolement de la transaction, 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.

  19. Cochez la case Garanti du champ Niveau d'isolement 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 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 indiqué. 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é.

  20. Dans la section Autres propriétés, spécifiez les propriétés supplémentaires.

    Le nom de la base de données (URL), le nom 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 base de données. Pour plus d'informations sur une partie de ces 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 :

    ()
    
  21. Cliquez sur Terminer.

Voir aussi
Copyright © 2005, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices