Paramètres de la source de données

Cette page permet de créer une source de données sous un fournisseur JDBC qui fournit la classe d'implémentation d'un pilote JDBC spécifique.

Vérifiez que vous souhaitez bien utiliser une source de données version 5.0. Si vous utilisez le modèle de composant Enterprise JavaBean version 1.0 et l'API Servlet 2.2, vous devez utiliser 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 > source_données.

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)
Nom
Indique le nom affiché de la source de données.

Par exemple, vous pouvez indiquer Source de données test dans cette zone.

Type de données String (chaîne)
Nom JNDI
Indique le nom JNDI (Java Naming and Directory Interface).

Les environnements informatiques répartis utilisent souvent des services d'annuaire et de nommage pour obtenir des composants et des ressources partagés. Les services de nommage et d'annuaire associent des noms à des emplacements, des services, des informations et des ressources.

Les services de nommage fournissent des mappages nom-vers-objet. Les services d'annuaire et de nommage fournissent des informations sur les objets et des outils de recherche nécessaires pour localiser ces objets.

Il existe un grand nombre d'implémentations de services d'annuaire et les interfaces associées varient. L'interface JNDI fournit une interface commune utilisée pour accéder à différents services d'annuaire et de nommage.

Par exemple, vous pouvez indiquer le nom jdbc/markSection.

Si vous n'indiquez pas de valeur dans cette zone, un nom JNDI est généré à partir du nom de la source de données. Par exemple, un nom de source de données markSection génère le nom JNDI jdbc/markSection.

Une fois la valeur définie, sauvegardez-la et redémarrez le serveur. Cette chaîne doit apparaître lorsque vous exécutez dumpnamespace.

Type de données String (chaîne)
Persistance gérée par conteneur
Indique si cette source de données est utilisée pour la persistance gérée par conteneur des Enterprise JavaBeans (EJB).

Si vous cochez cette case, le système crée une fabrique de connecteurs CMP correspondant à cette source de données pour l'adaptateur de ressources relationnelles.

Type de données Case à cocher
Valeur par défaut Désélectionnée
Description
Texte décrivant la ressource.
Type de données String (chaîne)
Catégorie
Chaîne de catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
Type de données String (chaîne)
Taille de la cache d'instructions
Indique le nombre d'instructions disponibles en mémoire cache pour chaque connexion.

La source de données WebSphere Application Server optimise le traitement des instructions préparées. On entend par instruction préparée une instruction SQL pré-compilée, stockée dans un objet spécifique (que l'on appelle objet instruction préparée). Cet objet est utilisé pour exécuter efficacement et de manière répétée l'instruction SQL concernée.

Si la cache n'est pas assez importante, des entrées utiles sont supprimées pour laisser de la place aux nouvelles entrées. Pour déterminer une taille maximale pour votre mémoire cache et éviter ainsi d'effectuer des suppressions dans celle-ci, ajoutez le nombre d'instructions préparées uniques et appelables (déterminé par la chaîne sql, le mode d'accès concurrent et le type de défilement) pour chaque application qui utilise cette source de données sur un serveur spécifique. 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. En général, plus votre application comporte d'instructions, plus la taille de la cache doit être importante. Par exemple, si l'application possède 5 instructions SQL, choisissez 5 comme taille de cache des instructions pour que chaque connexion ait 5 instructions.

Vous pouvez également utiliser Tivoli Performance Viewer pour réduire au minimum les suppressions de la mémoire cache. Utilisez une charge de travail standard représentant un nombre typique de demandes client entrantes, un nombre fixe d'itérations et un jeu standard de paramètres de configuration. Remarque : Plus la mémoire cache des instructions est importante, plus les ressources système sont retardées. Par conséquent, si vous choisissez un nombre trop élevé, vous risquez de manquer de ressources car votre système ne parvient pas à ouvrir un si grand nombre d'instructions préparées.

Lors des tests, le paramétrage de la mémoire cache des instructions a permis d'augmenter le débit entre 10 et 20%. 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 Varie en fonction de la base de données. La plupart du temps, il s'agit de la valeur 10. Pour Informix version 7.3, 9.2 ou 9.3 sans le dernier correctif, la valeur doit être également 0. La valeur par défaut 0 indique qu'il n'y a pas d'instruction cache.
Nom de classe auxiliaire de la source de données
Spécifie la classe auxiliaire du magasin de données utilisée pour exécuter les fonctions spécifiques de la base de données.

Cette classe est utilisée par l'adaptateur de ressources relationnelles à l'exécution. La classe d'implémentation par défaut de DataStoreHelper est définie en fonction de la classe d'implémentation du pilote JDBC, sa structure étant de la forme : com.ibm.websphere.rsadapter.<base_de_données>DataStoreHelper. Par exemple, si le fournisseur JDBC est DB2, la classe d'implémentation par défaut est com.ibm.websphere.rsadapter.DB2DataStoreHelper. Si nécessaire, vous pouvez sous-classer cette classe générique et utiliser votre propre classe à la place.

Type de données String (chaîne)
Valeur par défaut Dépend de la classe d'implémentation du pilote JDBC
Alias d'authentification géré par composant
Cet alias sera utilisé, à l'exécution, pour l'authentification auprès de la base de données.

Si l'authentification de la ressource (propriété res-auth) est réglée sur Application, définissez l'alias dans la section Alias d'authentification géré par composant.

Si vous n'indiquez pas de valeur dans cette zone et que la base de données requiert l'ID utilisateur et le mot de passe pour établir une connexion, une exception sera générée lors de l'exécution.

Si votre base de données n'accepte pas la spécification d'un ID utilisateur et d'un mot de passe (c'est le cas de Cloudscape), ne spécifiez pas d'alias dans les zones Alias d'authentification géré par composant et Alias d'authentification géré par conteneur. Sinon, un message d'avertissement sera consigné dans le journal système pour indiquer que l'utilisateur et le mot de passe ne sont pas des propriétés valides. Ce message est un simple avertissement. La source de données est quand même correctement créée.

Type de données Liste de sélection
Alias d'authentification géré par conteneur
Cet alias sera utilisé, à l'exécution, pour l'authentification auprès de la base de données.

Si res-auth a pour valeur Container, définissez l'alias d'authentification géré par conteneur.

Si vous n'indiquez pas de valeur dans cette zone et que la base de données requiert l'ID utilisateur et le mot de passe pour établir une connexion, une exception sera générée lors de l'exécution.

Si votre base de données n'accepte pas la spécification d'un ID utilisateur et d'un mot de passe (c'est le cas de Cloudscape), ne spécifiez pas d'alias dans les zones Alias d'authentification géré par composant et Alias d'authentification géré par conteneur. Sinon, un message d'avertissement sera consigné dans le journal système pour indiquer que l'utilisateur et le mot de passe ne sont pas des propriétés valides. Ce message est un simple avertissement. La source de données est quand même correctement créée.

Type de données Liste de sélection
Alias de configuration de mappage
Permet aux utilisateurs de faire leur choix dans la liste Sécurité > Configuration JAAS > Configuration de connexion de l'application.

La configuration JAAS DefaultPrincipalMapping associe l'alias de connexion à l'ID utilisateur et au mot de passe. Vous pouvez définir et utiliser d'autres configurations de mappage.

Type de données Liste de sélection

Informations connexes

Boutons de la console administrative