Cette page permet de créer un pool de connexions pour une source de données version 4.0.
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.
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.
Pour obtenir des informations générales, voir Paramètres de portée de la console d'administration dans la section Références connexes.
Type de données | Chaîne |
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 | Entier |
Valeur par défaut | 1 |
Intervalle | Tout nombre entier positif. |
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 | Entier |
Valeur par défaut | 10 |
Intervalle | Tout nombre entier positif |
Durée maximale, en secondes, pendant laquelle une application peut attendre une connexion du pool avant de renoncer et de déclencher une exception ConnectionWaitTimeout. WebSphere Application Server agit sur cette valeur uniquement si vous définissez la propriété de la taille maximale du pool. Dans ce cas, le nombre de connexions maximales sert de déclencheur pour appliquer la propriété du délai d'attente.
Type de données | Entier |
Unité | Secondes |
Valeur par défaut | 180 |
Intervalle | Tout nombre entier positif. |
Si la valeur de ce paramètre est 0, le délai d'expiration de connexion est désactivé.
Si vous acceptez la valeur par défaut, Application Server émet l'exception ResourceAllocation immédiatement après que le gestionnaire de pool a indiqué que le nombre maximal de connexions est utilisé. Si vous désactivez le délai de connexion, Application Server n'émet pas d'exception. A la place, le gestionnaire de pool met en file d'attente les requêtes de connexion suivantes jusqu'à ce qu'il puisse attribuer une connexion.
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 | Entier |
Unité | Secondes |
Valeur par défaut | 1800 |
Intervalle | Tout nombre entier positif. |
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 de connexion périmée. 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 | Entier |
Unité | Secondes |
Valeur par défaut | 1800 |
Intervalle | Tout nombre entier positif. |
Nombre d'instructions préparées à maintenir en cache par connexion.
Si vous ne voulez pas que des entrées soient éliminées du 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 du cache, aucune donnée n'est jamais supprimée du cache. Les performances sont optimisées. Toutefois, la disponibilité limitée des ressources ne permet pas toujours d'optimiser ainsi la taille du cache.
Type de données | Entier |
Valeur | 10 |
Intervalle | Tout nombre entier positif. |
Indique si le logiciel de mise en pool des connexions ferme automatiquement les connexions de la source de données à la fin d'une transaction. Définissez cette propriété si vous souhaitez conserver et réutiliser la même connexion à travers plusieurs transactions.
La valeur par défaut est false, ce qui signifie que lorsqu'une transaction s'achève, le serveur d'applications 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 de connexion périmée, 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 | Booléen (case à cocher) |
Valeur par défaut | False (désélectionné) |
Les liens marqués (en ligne) requièrent un accès à Internet.