Pour créer des connexions entre une application et une base de données relationnelle, le serveur d'applications utilise les classes d'implémentation qui sont encapsulées par le fournisseur JDBC (Java™ Database
Connectivity).
Avant de commencer
Chaque fournisseur JDBC est essentiellement un objet qui représente les classes du pilote JDBC spécifiques au fournisseur de serveur d'applications, en vue de l'établissement d'un accès à cette base de données fournisseur. Les fournisseurs JDBC sont des éléments prérequis pour les sources de données : ils offrent aux applications les connexions physiques à une base de données. Pour connaître le fournisseur JDBC approprié à votre base de données et aux besoins de l'application, voir le
tableau des fournisseurs JDBC.
Fonction obsolète: Le produit ne prend plus en charge le pilote JDBC Legacy DB2 pour 390 et z/OS de même que le fournisseur JDBC correspondant et le fournisseur JDBC local DB2 pour z/OS (RRS). Employez
DB2 utilisant le pilote JCC IBM® JCC ou le pilote JDBC DB2 Universal pour vous connecter à DB2 for z/OS.
depfeat
Pourquoi et quand exécuter cette tâche
Configurez au moins un fournisseur JDBC pour chaque serveur de base de données que vous
prévoyez d'utiliser à une portée particulière dans votre environnement de serveur d'applications.
Procédure
- Ouvrez la console d'administration.
- Cliquez sur
.
- Sélectionnez la portée à laquelle les applications peuvent utiliser le fournisseur de données JDBC. La portée que vous sélectionnez devient la portée de toute source de données que vous associez à ce fournisseur. Vous pouvez choisir cellule, noeud, cluster ou serveur. Pour
de plus amples informations sur les portées et leur effet sur les ressources, reportez-vous
à la rubrique du centre d'informations relative aux paramètres de portée d'administration.
- Cliquez sur Nouveau. Cette action entraîne le lancement de l'assistant Création d'un nouveau fournisseur JDBC.
- Utilisez la première liste déroulante pour sélectionner le type de base de données du fournisseur JDBC à créer.
Option Défini par l'utilisateur : En présence d'un des scénarios suivants, sélectionnez le type de base de données
défini par l'utilisateur :
- Vous ne visualisez pas le type de base de données.
- Vous ne pouvez pas sélectionner le type de fournisseur JDBC dont vous avez besoin à l'étape suivante.
Cette sélection conduit l'assistant à afficher votre type de fournisseur en tant que Fournisseur JDBC défini par l'utilisateur, et votre type d'implémentation en tant que Défini par l'utilisateur. Consultez
la documentation de votre base de données pour connaître les fichiers de classe JDBC, les propriétés de sources de données,
etc. nécessaires pour votre fournisseur défini par l'utilisateur. Vous devez fournir ces informations concernant les deux panneaux suivants :
- chemin d'accès aux classes de base de données ;
- propriétés spécifiques de base de données.
- Sélectionnez le type de fournisseur JDBC voulu, s'il apparaît dans la deuxième liste déroulante. Sélectionnez Afficher les fournisseurs obsolètes pour déclencher l'affichage des fournisseurs en cours et obsolètes. Si le fournisseur voulu est introuvable dans la liste déroulée, sélectionnez Défini par l'utilisateur dans la liste précédente des types de base de données.
Eviter les incidents: Le produit émet le message d'erreur DSRA360 si vous sélectionnez le fournisseur JDBC local DB2 pour z/OS (RRS). Dans les versions 6.1 et supérieures, le serveur d'applications supprime entièrement la prise en charge du fournisseur JDBC local DB2 pour z/OS (RRS).
gotcha
- Dans la troisième liste déroulante, sélectionnez le type d'implémentation nécessaire à votre application. Si l'application ne requiert pas de connexions prenant en charge les transactions à validation en deux phases, sélectionnez Source de données du pool de connexions. Toutefois, si votre application requiert des connexions prenant en charge les transactions à validation en deux phases, sélectionnez Source de données XA. Les applications qui utilisent cette configuration de source de données bénéficient d'une reprise des transactions gérées par conteneur.
Une fois un type d'implémentation sélectionné, l'assistant complète les champs de nom et de description pour votre fournisseur JDBC.
Vous pouvez saisir différentes valeurs dans ces champs ; ils ne sont utilisés qu'à des fins administratives.
- Cliquez sur Suivant pour afficher le panneau de l'assistant Saisie des informations de chemin d'accès aux classes de base de données.
- Dans le champ du chemin d'accès aux classes, entrez l'emplacement du chemin complet des fichiers de classes du pilote JDBC de la base de données. Les informations de chemin d'accès aux classes deviennent la valeur de la variable d'environnement WebSphere qui s'affiche sur ce panneau, sous la forme ${DATABASE_JDBC_DRIVER_PATH}.
Le serveur d'applications définit votre fournisseur JDBC à l'aide de la variable.
Vous ne devez plus de ce fait spécifier des chemins d'accès aux classes JDBC statiques
d'applications individuelles. N'oubliez pas que si vous n'indiquez pas le chemin d'accès aux classes complet et correct du pilote JDBC pour la variable, vous obtenez un échec au niveau de la source de données. Si le champ présente déjà un chemin de classe qualifié complet, vous pouvez accepter cette définition de variable en complétant le reste du panneau de l'assistant et en cliquant sur Suivant.
Remarque : Le serveur d'applications prend en charge plusieurs versions du
pilote JDBC sélectionné pour le pilote DataDirect ConnectJDBC de type 4 pour MS SQL
Server. Chaque version du pilote JDBC possède un seul chemin d'accès de classe. Sélectionnez la
version appropriée du pilote JDBC pour renseigner correctement le chemin d'accès de classe.
- Utilisez la zone Chemin d'accès à la bibliothèque native pour définir des fichiers de
classe supplémentaires éventuellement nécessaires au pilote JDBC pour fonctionner correctement
sur la plate-forme de votre serveur d'applications. Entrez le nom complet du chemin d'accès au répertoire de ces fichiers de classe.
Eviter les incidents: Si vous utilisez un pilote Oracle OCI comme fournisseur JDBC,
vous devez indiquer le chemin d'accès
des bibliothèques natives.
Si vous n'indiquez pas de chemin d'accès pour la bibliothèque native, la première fois
que vous vous connectez en utilisant ce fournisseur, des erreurs de chargeur de classe se produisent.
gotcha
- Cliquez sur Suivant pour afficher un récapitulatif des paramètres de votre fournisseur JDBC.
- Cliquez sur Fin lorsque la configuration du fournisseur JDBC vous convient. Vous visualisez à présent le panneau Collection de fournisseurs JDBC, qui affiche le nouveau fournisseur JDBC dans un tableau avec les autres fournisseurs configurés pour la même portée.
Que faire ensuite
La prochaine étape consiste à créer une source de données à associer à un fournisseur JDBC. Pour de plus amples informations, reportez-vous à la rubrique du centre d'informations relative à la configuration
d'une source de données à l'aide de la console d'administration.
A faire : Si vous modifiez la configuration d'un fournisseur JDBC, en changeant, par exemple, le chemin d'accès aux classes, le chemin de bibliothèque native ou les propriétés personnalisées, cliquez sur OK et redémarrez le serveur d'applications dans la poprtées du fournisseur JDBC. Autrement, la nouvelle configuration ne fonctionne pas et vous recevez des messages d'erreur de source de données.