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 :
Nom du fournisseur de base de données
Type de ressource : javax.sql.DataSource (transactions locales uniquement), java.sql.ConnectionPoolDataSource (transactions locales, améliorations possibles des performances), javax.sql.XADataSource (transactions globales) et java.sql.Driver
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 Tâches courantes s’affiche.
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.
Ce champ est obligatoire.
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.
La page Nouveau pool de connexions JDBC (étape 2 sur 2) s’ouvre.
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é.
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é.
Cette option est désactivée par défaut.
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.
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 300.
La valeur par défaut est 60 000.
Cette option est désactivée par défaut.
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.
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é.
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 :
()
Voir aussi
<para><olink targetptr="task-jdbcresourcetargets">To Edit JDBC Resource Targets </olink></para>