Einstellungen für Datenquellen

Auf dieser Seite können Sie eine Datenquelle unter einem JDBC-Provider erstellen, der die Implementierungsklasse des spezifischen JDBC-Treibers bereitstellt.

Prüfen Sie, ob Sie eine Datenquelle der Version 5.0 verwenden möchten. Wenn Sie das EJB-Komponentenmodell der Version 1.0 und Servlets der Version 2.2 verwenden möchten, müssen Sie eine Datenquelle der Version 4.0 verwenden.

Klicken Sie, um diese Seite der Administrationskonsole anzuzeigen, auf Ressourcen > JDBC-Provider > JDBC-Provider > Datenquellen > Datenquelle.

Register "Konfiguration"

Bereich
Gibt die Ebene an, bis zu der diese Ressourcendefinition sichtbar ist - Zelle, Knoten oder Server.

Ressourcen, wie z. B. JDBC-Provider, Namespace-Bindungen oder gemeinsam benutzte Bibliotheken können in mehreren Bereichen definiert werden. Dabei überschreiben Ressourcen, die in spezifischeren Bereichen definiert wurden, Ressourcen, die in allgemeineren Bereichen definiert wurden.

Die Merkmale einer Ressource gelten nur für eine bestimmte Serverebene, unabhängig vom Geltungsbereich einer definierten Ressource. Wenn Sie beispielsweise den Geltungsbereich einer Datenquelle auf Zellenebene definieren, können alle Benutzer in dieser Zelle diese Datenquelle durchsuchen und verwenden. Die Einstellungen von Ressourcenmerkmalen gelten jedoch lokal für jeden Server in der Zelle. Wenn Sie beispielsweise die maximale Anzahl von Verbindungen mit 10 definieren, kann jeder Server in dieser Zelle 10 Verbindungen haben.

Zelle
Der allgemeinste Bereich. Ressourcen, die im Zellenbereich definiert werden, sind auf allen Knoten und Servern sichtbar, vorausgesetzt, sie wurden nicht überschrieben. Möchten Sie Ressourcen anzeigen, die im Zellenbereich definiert wurden, dürfen Sie keinen Server oder Knotennamen im Formular für die Bereichsauswahl angeben.
Knoten
Der Standardbereich für die meisten Ressourcentypen. Ressourcen, die im Knotenbereich definiert werden, überschreiben alle Duplikate im Zellenbereich und sind auf allen Servern, die sich auf demselben Knoten befinden, sichtbar, vorausgesetzt, sie wurden nicht in einem Serverbereich auf diesem Knoten überschrieben. Möchten Sie Ressourcen anzeigen, die in einem Knotenbereich definiert wurden, dürfen Sie keinen Server angeben, sondern müssen einen Knotennamen im Formular für die Bereichsauswahl auswählen.
Server
Der spezifischste Bereich für die Definition von Ressourcen. Ressourcen, die im Serverbereich definiert werden, überschreiben alle Duplikate von Ressourcendefinitionen, die im Zellenbereich oder im übergeordneten Knotenbereich definiert wurden, und können nur von einem spezifischen Server erkannt werden. Möchten Sie Ressourcen anzeigen, die in einem Serverbereich definiert wurden, müssen Sie im Formular für die Bereichsauswahl einen Servernamen und einen Knotennamen auswählen.

Wenn Ressourcen erstellt werden, werden sie immer im aktuellen, in der Anzeige ausgewählten Bereich erstellt. Möchten Sie Ressourcen in anderen Bereichen anzeigen, geben Sie einen anderen Knoten oder Server im Formular für die Bereichsauswahl an.

Datentyp String
Name
Gibt den Anzeigenamen für die Datenquelle an.

Beispielsweise können Sie dieses Feld auf Datenquelle testen einstellen.

Datentyp String
JNDI-Name
Gibt den JNDI-Namen (Java Naming and Directory Interface) an.

Verteilte Datenverarbeitungsumgebungen verwenden häufig Namens- und Verzeichnisservices, um gemeinsam verwendete Komponenten und Ressourcen abzurufen. Namens- und Verzeichnisservices ordnen Namen Verzeichnissen, Services, Daten und Ressourcen zu.

Namensservices ermöglichen die Zuordnung von Namen zu Objekten. Verzeichnisservices stellen Informationen zu Objekten und Such-Tools bereit, die zum Lokalisieren dieser Objekte erforderlich sind.

Es gibt viele Implementierungen von Namens- und Verzeichnisservices, und die Interfaces zu diesen Services variieren. JNDI bietet ein gemeinsames Interface für den Zugriff auf die verschiedenen Namens- und Verzeichnisservices.

Sie können z. B. den Namen jdbc/markSection verwenden.

Wenn Sie dieses Feld leer lassen, wird ein JNDI-Name aus dem Namen der Datenquelle generiert. Beispielsweise wird für den Namen der Datenquelle von markSection der JNDI-Name jdbc/markSection generiert.

Nachdem Sie diesen Wert definiert, gespeichert und den Server erneut gestartet haben, ist diese Zeichenfolge bei Ausführung von dumpnamespace sichtbar.

Datentyp String
CMP (Container Managed Persistence)
Gibt an, ob diese Datenquelle für die containergestützte Persistenz von Enterprise-Beans verwendet wird.

Bei Auswahl dieses Markierungsfelds wird eine CMP-Connector-Factory, die dieser Datenquelle entspricht, für den relationalen Ressourcenadapter erstellt.

Datentyp Markierungsfeld
Standardwert Nicht aktiviert
Beschreibung
Gibt eine Textbeschreibung der Ressource an.
Datentyp String
Kategorie
Gibt eine Kategoriezeichenfolge an, die zur Klassifizierung oder Gruppierung der Ressource verwendet werden kann.
Datentyp String
Größe des Anweisungs-Cache
Gibt die Anzahl der freien Anweisungen an, die pro Verbindung zwischengespeichert werden.

Die WAS-Datenquelle optimiert die Verarbeitung vorbereiteter Anweisungen. Eine vorbereitete Anweisung ist eine vorkompilierte SQL-Anweisung, die in einem Objekt für vorbereitete Anweisungen (Prepared Statement Object) gespeichert ist. Mit diesem Objekt kann eine gegebene-SQL-Anweisungen effizient mehrfach ausgeführt werden.

Wenn der Cache nicht groß genug ist, werden möglicherweise wichtige Einträge gelöscht, um Platz für neue Einträge zu schaffen. Der größte Wert, auf den Sie die Cache-Größe einstellen müssen, wenn Sie vermeiden möchten, dass der Cache gelöscht wird, stellt sich wie folgt dar: Für jede Anwendung, die diese Datenquelle auf einem bestimmten Server verwendet, müssen Sie die Anzahl eindeutiger vorbereiteter Anweisungen hinzufügen (wie durch sql-Zeichenfolge, gemeinsamen Zugriff und Blättertyp festgelegt). Das ist die Maximalanzahl möglicher vorbereiteter Anweisungen, die für eine bestimmte Verbindung während der Lebensdauer des Servers zwischengespeichert werden können. Wenn Sie die Cache-Größe auf diesen Wert einstellen, bedeutet das, dass der Cache nie gelöscht wird. Allgemein gilt: Je mehr Anweisungen Ihre Anwendung enthält, desto größer sollte der Cache sein. Enthält die Anwendung beispielsweise fünf SQL-Anweisungen, setzen Sie die Größe des Cache für Anweisungen auf 5, so dass jeder Verbindung fünf Anweisungen zugeordnet sind.

Die Anzahl der aus dem Cache gelöschten Objekte kann mit Tivoli Performance Viewer minimiert werden. Verwenden Sie eine Standardarbeitsbelastung mit einer typischen Anzahl eingehender Clientanforderungen, eine feste Anzahl von Iterationen und eine Gruppe von Standardkonfigurationseinstellungen. Anmerkung: Jede größer der Cache für Anweisungen ist, desto mehr Verspätungen treten bei den Systemressourcen auf. Wenn Sie einen zu hohen Wert wählen, könnten deshalb Ressourcen fehlen, weil Ihr System nicht in der Lage ist, eine entsprechende Anzahl von vorbereiteten Anweisungen zu öffnen.

In Testanwendungen konnte der Durchsatz durch die Optimierung des Cache für Anweisungen um 10 bis 20 % gesteigert werden. Möglicherweise ist dies aufgrund von Ressourceneinschränkungen jedoch nicht immer möglich.

Datentyp Integer
Standardwert Ist von der Datenbank abhängig. Der obere Grenzwert ist 10. Für Informix Version 7.3, 9.2 bzw. 9.3 ohne das aktuellste Fix muss ebenfalls 0 angegeben werden. Der Standardwert 0 bedeutet, dass keine Cache-Anweisung vorhanden ist.
Name der DatasourceHelper-Klasse
Die DatastoreHelper-Klasse, die zur Ausführung der datenbankspezifischen Funktionen verwendet wird.

Dieses Merkmal wird vom relationalen Ressourcenadapter zur Laufzeit verwendet. Die DataStoreHelper-Standardimplementierungsklasse wird basierend auf der Implementierungsklasse des JDBC-Treibers definiert. Dabei wird folgende Struktur verwendet: com.ibm.websphere.rsadapter.<database>DataStoreHelper. Wenn z. B. DB2 als JDBC-Provider eingesetzt wird, lautet die standardmäßig vorgegebene DataStoreHelper-Klasse com.ibm.websphere.rsadapter.DB2DataStoreHelper. Sie können diese Klasse in die Unterklasse dieser DataStoreHelper-Klasse ändern, falls erforderlich.

Datentyp String
Standardwert Ist abhängig von der Implementierungsklasse des JDBC-Treibers.
Aliasname für komponentengestützte Authentifizierung
Dieser Aliasname wird für die Datenbankauthentifizierung in der Laufzeit verwendet.

Wenn die ressourcengestützte Authentifizierung (res-auth) auf Anwendung eingestellt ist, müssen Sie den Aliasnamen im Feld des Aliasnamens für komponentengestützte Authentifizierung definieren.

Wenn Sie in diesem Feld keinen Wert angeben und für Ihre Datenbank eine Kombination aus Benutzer-ID und Kennwort eingegeben werden muss, um eine Verbindung abzurufen, erhalten Sie eine Ausnahmebedingung während der Laufzeit.

Wenn Ihre Datenbank (z. B. Cloudscape) die Merkmale Benutzer-ID und Kennwort nicht unterstützt, dürfen Sie den Aliasnamen nicht in den Feldern, die für den Aliasnamen für komponentengestützte bzw. containergestützte Authentifizierung vorgesehen sind, definieren. Andernfalls sehen Sie die Warnung im Systemprotokoll, die anzeigt, dass der Benutzer und das Kennwort keine gültigen Merkmale sind. Diese Nachricht ist nur eine Warnnachricht, daher wird die Datenquelle erfolgreich erstellt.

Datentyp Auswahlliste
Aliasname für containergestützte Authentifizierung
Dieser Aliasname wird für die Datenbankauthentifizierung in der Laufzeit verwendet.

Wenn für res-auth der Wert Container angegeben ist, müssen Sie den Aliasnamen für containergestützte Authentifizierung angeben.

Wenn Sie in diesem Feld keinen Wert angeben und für Ihre Datenbank eine Kombination aus Benutzer-ID und Kennwort eingegeben werden muss, um eine Verbindung abzurufen, erhalten Sie eine Ausnahmebedingung während der Laufzeit.

Wenn Ihre Datenbank (z. B. Cloudscape) die Merkmale Benutzer-ID und Kennwort nicht unterstützt, dürfen Sie den Aliasnamen nicht in den Feldern, die für den Aliasnamen für komponentengestützte bzw. containergestützte Authentifizierung vorgesehen sind, definieren. Andernfalls sehen Sie die Warnung im Systemprotokoll, die anzeigt, dass der Benutzer und das Kennwort keine gültigen Merkmale sind. Diese Nachricht ist nur eine Warnnachricht, daher wird die Datenquelle erfolgreich erstellt.

Datentyp Auswahlliste
Aliasname für die Zuordnung der Konfiguration
Ermöglicht Benutzern die Auswahl eines Eintrags in der Liste, die nach Anklicken von Sicherheit > JAAS-Konfiguration > Anmeldekonfigurationen der Anwendung angezeigt wird.

Die JAAS-Konfiguration DefaultPrincipalMapping ordnet den Authentifizierungaliasnamen der Benutzer-ID und dem Kennwort zu. Sie können andere Zuordnungskonfigurationen definieren und verwenden.

Datentyp Auswahlliste

Zugehörige Informationen

Knöpfe in der Adminstrationskonsole