Paramètres du pool de connexions (version 4)

Utilisez cette page pour créer un pool de connexions pour une source de données version 4.0.

Pour afficher cette page de la console d'administration, cliquez sur Ressources > Fournisseurs JDBC > fournisseur_JDBC > Sources de données (version 4.0) > source_données > Pool de connexions.

Onglet Configuration

Portée
Indique à quel niveau cette définition de ressource est visible : cellule, noeud ou serveur.

Des ressources telles que les fournisseurs JDBC, les liaisons d'espace de noms et les bibliothèques partagées peuvent être définies à plusieurs niveaux. Dans ce cas, pour une ressource donnée, la définition figurant au niveau le plus spécifique (par exemple, le serveur) l'emporte sur l'éventuelle définition homologue figurant à un niveau plus général (par exemple, la cellule).

Notez que quelle que soit la portée d'une ressource définie, les propriétés de cette ressource s'appliquent uniquement au niveau d'un serveur individuel. Par exemple, si vous définissez la portée d'une source de données au niveau cellule, tous les utilisateurs de cette cellule peuvent rechercher et utiliser cette source de données, laquelle est unique au sein de cette cellule. Cependant, les paramètres de propriété de la ressource sont locaux à chaque serveur de la cellule. Par exemple, si vous attribuez la valeur 10 à la propriété Nombre maximal de connexions, chaque serveur de cette cellule pourra avoir 10 connexions.

Cellule
Niveau de portée le plus général. Les ressources définies au niveau cellule sont visibles depuis tous les noeuds et serveurs de cette cellule, sauf si elles sont redéfinies à un niveau inférieur. Pour visualiser les ressources définies au niveau cellule, ne spécifiez pas de nom de serveur ni de nom de noeud dans le formulaire de sélection de portée.
Noeud
Portée par défaut de la plupart des types de ressources. Les ressources définies au niveau noeud l'emportent sur les éventuelles définitions homologues figurant au niveau cellule et sont visibles depuis tous les serveurs du noeud considéré, sauf si elles sont redéfinies à un niveau serveur sur ce noeud. Pour visualiser les ressources définies au niveau d'un noeud, ne spécifiez pas de serveur dans le formulaire de sélection de portée ; spécifiez simplement le nom du noeud concerné.
Serveur
Niveau de portée le plus spécifique pour la définition des ressources. Les ressources définies au niveau d'un serveur l'emportent sur les éventuelles définitions homologues apparaissant au niveau de la cellule parente ou du noeud parent ; elles sont visibles uniquement depuis ce serveur. Pour visualiser les ressources définies au niveau d'un serveur, spécifiez le nom de ce serveur ainsi que celui de son noeud parent dans le formulaire de sélection de portée.

Lorsque des ressources sont créées, elles le sont toujours dans la portée en cours, c'est-à-dire celle qui est sélectionnée dans le formulaire. Pour afficher les ressources d'autres portées, spécifiez un noeud ou un serveur différent dans le formulaire de sélection de portée.

Type de données String (chaîne)
Taille minimale du pool
Nombre minimal de connexions à maintenir dans le pool.

La taille minimale du pool peut affecter les performances d'une application. Les pools de petite taille nécessitent moins de temps système lorsque la demande est faible car le nombre de connexions maintenues ouvertes à la base de données est restreint. Lorsque la demande augmente, les premières applications ont un temps de réponse plus long, car de nouvelles connexions doivent être créées si toutes celles du pool sont déjà utilisées.

Type de données Integer (entier)
Valeur par défaut 1
Plage de valeurs Tout nombre entier positif.
Taille maximale du pool
Nombre maximal de connexions à maintenir dans le pool.

Si le nombre maximal de connexions est atteint et que toutes les connexions sont utilisées, les demandes de connexion supplémentaires peuvent attendre pendant la durée spécifiée par la propriété Délai d'expiration de connexion. La taille maximale du pool peut affecter les performances d'une application. Les pools de grande taille nécessitent plus de temps système lorsque la demande est élevée, car davantage de connexions à la base de données sont ouvertes en période de forte charge. Ces connexions persistent jusqu'à ce qu'elles soient mises au repos. A l'inverse, si vous limitez trop la taille du pool, les demandes de connexion risquent de souffrir de délais d'attente trop longs en période de forte charge, conduisant à des erreurs dues au dépassement du délai d'expiration de connexion. Assurez-vous que la base de données peut faire face au nombre maximal de connexions configuré dans le serveur d'applications, en plus de l'éventuelle charge qu'elle doit traiter en dehors du serveur d'applications.

Type de données Integer (entier)
Valeur par défaut 10
Plage de valeurs Tout nombre entier positif.
Délai d'expiration de connexion
Durée maximale, en secondes, pendant laquelle une application peut attendre une connexion du pool avant de renoncer et de lancer une exception ConnectionWaitTimeoutException.

Si la valeur de ce paramètre est 0, le délai d'expiration de connexion est désactivé.

Type de données Integer (entier)
Unités Secondes
Valeur par défaut 180
Plage de valeurs Tout nombre entier positif.
Délai d'inactivité
Durée maximale, en secondes, durant laquelle une connexion inactive (non allouée) peut rester dans le pool avant d'être supprimée pour libérer des ressources.

Les connexions inactives doivent être supprimées du pool, car le fait de les garder ouvertes peut entraîner des problèmes de mémoire dans la base de données. Cependant, toutes les connexions ne sont pas supprimées du pool, même si leur ancienneté dépasse la valeur du paramètre Délai d'inactivité. C'est le cas si la suppression d'une connexion ferait passer la taille du pool en dessous de la valeur minimale configurée. Si la valeur de ce paramètre est 0, le délai d'inactivité est désactivé.

Type de données Integer (entier)
Unités Secondes
Valeur par défaut 1800
Plage de valeurs Tout nombre entier positif.
Délai d'expiration des connexions orphelines
Nombre maximum de secondes durant lesquelles une application peut détenir une connexion sans l'utiliser avant que la connexion ne soit renvoyée au pool.

Si aucune activité n'est enregistrée sur une connexion allouée depuis plus longtemps que la durée définie par le paramètre Délai d'expiration des connexions orphelines, la connexion est marquée comme orpheline. Au terme d'une autre période égale au délai d'expiration des connexions orphelines, si la connexion ne présente toujours pas d'activité, elle est restituée au pool. Si l'application tente d'utiliser de nouveau cette connexion, elle reçoit une exception StaleConnectionException. Les connexions enrôlées dans une transaction ne sont pas déclarées orphelines. Si la valeur de ce paramètre est 0, le délai d'expiration des connexions orphelines est désactivé.

Type de données Integer (entier)
Unités Secondes
Valeur par défaut 1800
Plage de valeurs Tout nombre entier positif.
Taille de la cache d'instructions
Nombre d'instructions préparées à maintenir en cache par connexion.

Si vous ne voulez pas que des entrées soient éliminées de la cache faute de place, la talle la plus élevée à adopter est déterminée de la manière suivante : pour chaque application qui utilise cette source de données sur un serveur spécifique, faites le total du nombre d'instructions préparées uniques (déterminé par la chaîne sql, le mode d'accès concurrent et le type de défilement, ou "scroll type"). Cette valeur représente le nombre maximal d'instructions préparées qui peuvent être placées en cache sur une connexion donnée au cours de l'utilisation du serveur. Si vous l'attribuez à la taille de la cache, aucune donnée n'est jamais supprimée de la cache. Les performances sont optimisées. Toutefois, la disponibilité limitée des ressources ne permet pas toujours d'optimiser ainsi la taille de la cache.

Type de données Integer (entier)
Valeur par défaut 10
Plage de valeurs Tout nombre entier positif.
Nettoyage automatique des connexions
Indique si le processus de mise en pool des connexions ferme automatiquement les connexions de cette source de données à la fin d'une transaction.

La valeur par défaut est false, ce qui signifie que lorsqu'une transaction s'achève, WebSphere Application Server ferme la connexion et la restitue au pool. Toute tentative d'utilisation de la connexion une fois la transaction terminée entraîne une exception StaleConnectionException, car la connexion est fermée et a été restituée au pool. Ce mécanisme garantit que les connexions ne sont pas conservées indéfiniment par l'application. Si la valeur de ce paramètre est true, la connexion n'est pas restituée au pool à la fin d'une transaction. Dans ce cas, l'application doit restituer la connexion au pool en appelant close(). Si l'application ne ferme pas la connexion, le pool peut venir à manquer de connexions pour d'autres applications.

Type de données Case à cocher
Valeur par défaut False (désélectionné)

Informations connexes

Boutons de la console administrative
Caractéristiques de la page de la console d'administration