Tools für relationale Datenbanken - Release-Informationen

1.0 Einführung
2.0 Unterstützte Software und Spezifikationen
3.0 Einschränkungen
   3.1 Generieren einer JavaBean oder einer EJB-Methode von einer gespeicherten Prozedur kann nur online erfolgen
4.0 Bekannte Probleme
   4.1 Datenbankmodelle
   4.2 SQL-Abfragen
   4.3 Datenbankverbindungen
   4.4 SQL DDL
   4.5 Fehlermeldungen
   4.6 Ausführen von SQL-Anweisungen erstellt fehlerhafte Tabellen in Oracle
   4.7 Datenexport
   4.8 Gespeicherte Java-Prozeduren bearbeiten
   4.9 Beim Schließen des Editors für ein Dokument mit Lesezugriff gehen die Änderungen verloren
   4.10 Fehlende Anführungszeichen bei Schemaobjektkennungen für nicht-englische Ländereinstellungen
   4.11 Herstellen einer Verbindung zu einem DB2-Server
   4.12 Löschen von gespeicherten Java-Prozeduren aus DB2 Version 8 wird bei Verwendung des DB2-Clients der Version 7 nicht unterstützt
   4.13 Manuelles Ändern der zurückgegebenen SQL-Datentypen für DB2-Tabellen-UDFs
   4.14 Fehler beim Erstellen oder Ausführen einer DB2-Routine - Verbindungskennung ungültig oder Verbindung geschlossen
   4.15 Probleme mit SequeLink 5.1, das mit WebSphere Studio ausgeliefert wird
   4.16 Treiber für DataDirect Sequelink 5.3
   4.17 Inhalt des Verbindungsassistenten ist nicht sichtbar
   4.18 SQL-Dateien für Beispiele für WebSphere Application Server - Express enthalten möglicherweise Fehler, können aber erfolgreich ausgeführt werden
   4.19 Cloudscape unter Linux ausführen
   4.20 Probleme beim Abrufen von Tabellen von Microsoft SQL Server
   4.21 Probleme beim Herstellen einer Verbindung zu Cloudscape 5.1
   4.22 Doppelte Schemaknoten erscheinen beim Importieren, Löschen oder erneuten Importieren von EJB-JAR-Dateien
   4.23 Beschädigte arabische Fehlernachrichten beim Exportieren von relationalen Daten

1.0 Einführung

Mit den Tools für relationale Datenbanken in WebSphere Studio können Sie eine Verbindung zu Datenbanken herstellen, Datenbankentwürfe durchsuchen oder importieren, neue Datenbanken mit Hilfe von Assistenten entwerfen, neue Entwürfe in Ihre Datenbank exportieren, SQL-Abfragen mit Hilfe des SQL-Erstellungsprogramms erstellen und ausführen sowie gespeicherte DB2-Prozeduren und benutzerdefinierte DB2-Funktionen erstellen und ausführen. Auf die Tools für relationale Datenbanken kann über die Perspektive 'Daten' sowie über die Sichten 'Datendefinition' und 'Datenbankserver' zugegriffen werden.

2.0 Unterstützte Software und Spezifikationen

Die Tools für relationale Datenbanken unterstützen das Herstellen der Verbindung zu und das Importieren von folgenden Datenbanktypen:

Die SQL-Unterstützung im SQL-Assistenten und SQL-Abfragenerstellungsprogramm hängt von der Unterstützungsstufe Ihres Datenbanklieferanten ab.

Fullselect-Unterstützung:

Unterstützung für JOIN: Unterstützung für die Gruppierung von Abfrageergebnissen: Unterstützung für Umsetzungsausdrücke:

Wenn Sie unter Linux eine Datenbankverbindung zu DB2 Universal Database für iSeries mit dem AS/400 Toolbox für Java-JDBC-Treiber herstellen, kann das System abstürzen. Dieses Problem tritt auf, wenn Sie ein falsches Kennwort eingeben oder keine Eingabe in das Kennwortfeld erfolgt. Starten Sie in diesem Fall das Programm erneut und stellen Sie die Verbindung unter Verwendung des korrekten Kennworts wieder her.

3.0 Einschränkungen

3.1 Generieren einer JavaBean oder einer EJB-Methode von einer gespeicherten Prozedur kann nur online erfolgen

Um die Assistenten verwenden zu können, die Ihnen das Generieren einer JavaBean oder einer EJB-Methode von einer gespeicherten Prozedur ermöglichen, müssen Sie online arbeiten.

4.0 Bekannte Probleme

4.1 Datenbankmodelle

  1. Momentan wird das Modellieren von Indizes, Prüfungen auf Integritätsbedingungen und eindeutige Integritätsbedingungen, Auslösern, strukturierten Typen oder Identitätsspalten nicht unterstützt.
  2. Die Tools für relationale Datenbanken unterstützen keine Prüfoptionen für Ansichten.

4.2 SQL-Abfragen

  1. Nicht erforderliche eckige Klammern in Abfrageanweisungen führen zu Parser-Fehlern.
  2. Die Verwendung von runden Klammern in WHERE-Bedingungsklauseln von Abfragen wird momentan nicht unterstützt.
  3. Große SQL-Dateien verlangsamen möglicherweise den Editor.
  4. Für Oracle müssen Werte von Aktualisierungsanweisungen individuell zu Spalten zugeordnet werden, ohne dabei Gruppen in eckigen Klammern zu verwenden. Verwenden Sie beim individuellen Hinzufügen von Spalten und zum Hinzufügen eines Werts mit Hilfe einer Unterabfrage die Option 'Erstellungsausdruck' im Zellenkombinationsfeld der Tabelle 'Wert', um einen Abfrageausdruck für die Spalte zu erstellen.
  5. Änderungen an von einer Anweisung verwendeten Datenbankobjekten können zum Fehlschlagen des SQL-Erstellungsprogramms führen, da kein erfolgreiches Parsing der Anweisung gegenüber dem lokalen Datenmodell mehr ausgeführt werden kann.
  6. Das Bearbeiten einer Sicht und anschließende Öffnen einer Anweisung, die diese Sicht enthält, kann zum unerwarteten Herunterfahren der Workbench führen.
  7. Wenn eine Datenbankverbindung außerhalb WebSphere Studio zwangsweise abgemeldet wird, wird bei der Ausführung der Anweisung nicht zur Verbindungsherstellung aufgefordert. Importieren Sie die Datenbank von der Sicht 'Datenbankserver' erneut in das Projekt, um die Verbindung wiederherzustellen.
  8. Eine Abfrage kann nicht mit Hilfe einer Sicht erstellt werden, die von einer benutzerdefinierten Funktion abgeleitet wurde.
  9. Das Ziehen und Übergeben von Datenbankobjekten wird nur von der Sicht 'Datendefinition', nicht aber von der Sicht 'Datenbankserver' unterstützt.

4.3 Datenbankverbindungen

  1. Wenn Sie eine DB2 UDB- oder DB2 for iSeries-Tabelle mit einem Spaltentyp DATALINK importieren, werden die Optionen zur Verbindungssteuerung für die Spalte nicht importiert. Als Standardwert für die DATALINK-Länge wird 200 eingesetzt und als Standardwert für die Verbindungsoptionen wird NO LINK CONTROL eingesetzt. Sie können diese Eigenschaften im Tabelleneditor aktualisieren, nachdem Sie die Tabelle in die Sicht 'Daten' importiert haben.
  2. Das Entfernen mehrerer Verbindungen in der Sicht 'Datenbankserver' funktioniert nicht immer. Wenn dieses Problem auftritt, können Sie entweder die Verbindungen belassen oder sie nacheinander löschen.
  3. Zeichenfolgedatentypen werden bei Verbindungen zu iSeries-Servern möglicherweise nicht einwandfrei importiert. Die Typen CHAR FOR BIT DATA, VARCHAR FOR BIT DATA und LONG VARCHAR FOR BIT DATA werden möglicherweise ohne die Option FOR BIT DATA importiert. Verwenden Sie in diesem Fall den Tabelleneditor in der Datenperspektive, um die betroffenen Spalten zu bearbeiten.
  4. Schemaobjektnamen, die DBCS-Zeichen enthalten, werden möglicherweise nicht korrekt aus iSeries importiert. Begrenzten Bezeichnern können Anführungszeichen fehlen. Verwenden Sie in diesem Fall den Tabelleneditor, um die Spalte und die Einschränkungsnamen zu bearbeiten.
  5. Kennungen für Integritätsbedingungen über Primärschlüssel werden für OS/390-Verbindungen nicht importiert.
  6. Standardwerte für Spalten, die gespeicherte Prozeduren oder Funktionen sind oder mit einer Identitätsklausel definiert wurden, werden nicht korrekt importiert und können zu Nicht-ASCII-Zeichen in einem Tabellendokument führen. Die Nicht-ASCII-Zeichen verursachen Probleme beim Laden des Dokuments. In einem solchen Fall muss das fehlerhafte tblxmi-Dokument manuell bearbeitet werden, und Standardtag und -wert müssen entfernt werden.
  7. Wenn Sie den Connect-JDBC-Treiber von WebSphere für Verbindungen zu einer SQL Server-Datenbank verwenden, benötigen Sie typischerweise 3 JAR-Dateien zum Spezifizieren der Klassenposition. Wir empfehlen, diese JAR-Dateien zu einer einzigen JAR-Datei zusammenzufügen. Ansonsten hat der Assistent beim erneuten Öffnen nach einer hergestellten Verbindung eine abnormale Größe. Dies ist auf die Länge des Feldes Treiberposition zurückzuführen.
  8. Wenn Sie eine neue Datenbankverbindung von einem DB2 Version 8-Client erstellen und den Treiber IBM DB2 NET DRIVER JDBC verwenden wollen, müssen Sie diese beiden JAR-Dateien zum Feld Klassenposition hinzufügen: <DB2HOME>/java/db2jcc.jar und <DB2HOME>/java/common.jar (wobei <DB2HOME> das Verzeichnis angibt, in dem Sie DB2 installiert haben). Falls Sie diesen Schritt nicht ausführen, wird ein Fehler gemeldet. Hinweis: Wenn Sie den Assistenten für neue Datenbankverbindungen verwenden, ohne diese JAR-Dateien zur Klassenposition hinzugefügt zu haben, werden die gespeicherten Prozeduren nicht geladen. In diesem Fall müssen Sie den Verbindungsassistenten zu einem späteren Zeitpunkt aufrufen und die Namen der Dateien im Feld Klassenposition eingeben.
  9. Möglicherweise werden die Metadaten von Schemata und Tabellen nicht importiert, wenn ein DB2 UDB-Client der Version 8 zum Herstellen einer Verbindung zu DB2 Version 7 oder früher auf z/OS verwendet wird. Das Problem wird behoben, indem Sie PTF UQ72081 für DB2 für z/OS installieren.

4.4 SQL DDL

  1. Beim Importieren oder Bearbeiten von DDL-Dateien, die den Datentyp long von Oracle enthalten, treten möglicherweise Probleme auf.
  2. Große SQL DDL-Dateien verlangsamen möglicherweise den Editor.
  3. Extrem große SQL DDL-Dateien führen beim Parsing oder bei der Ausführung möglicherweise zur Ausnahmebedingung, die angibt, dass kein Speicher mehr verfügbar ist.
  4. Durch das Bearbeiten von Oracle-Scripts können in der Gliederungsansicht des Editors Fehler angezeigt werden. Zum Beispiel werden die Anweisungen 'CREATE SEQUENCE', 'CREATE OR REPLACE TRIGGER' und 'END' falsch angezeigt. Sie können jedoch fortfahren und diese Elemente auf einen Oracle-Server exportieren.

4.5 Fehlermeldungen

Wenn ein Fehler während der Syntaxanalyse einer SQL-Datei auftritt, ist im Allgemeinen das Token nach dem in der Fehlernachricht angegebenen Token fehlerhaft. Die Fehlernachricht wird auch in der Taskliste angezeigt.

4.6 Ausführen von SQL-Anweisungen erstellt fehlerhafte Tabellen in Oracle

Wenn eine SQL-Datei auf dem Oracle-Datenbankserver ausgeführt wird, ist es erforderlich, zuerst die Tabellenreihenfolge und die Auslöser erstellen zu lassen. Dies ist notwendig, weil WebSphere insofern falsch mit Oracle interagiert, als dass zusätzliche Leerzeichen eingefügt werden. Nachdem die Tabellen erstellt worden sind, wechseln Sie zum Oracle-Serversystem und bearbeiten Sie die Anweisung, indem Sie die eingefügten Leerzeichen entfernen und den Befehl 'end;' einfügen. Wechseln Sie anschließend zurück zu WebSphere und führen Sie die SQL-Anweisung erneut auf dem Server aus. Wählen Sie dieses Mal die Anweisungen ALTER (Ändern) und INSERT (Einfügen) aus.

4.7 Datenexport

  1. Sie können vorhandene Artefakte in der Backend-Datenbank/im Backend-Katalog nur übergeben, indem Sie für SQL DDL-Scripts Auf Server ausführen auswählen. Handelt es sich um Datenobjekte (z. B. Datenbank, Schema, Tabelle), müssen Sie zum Übergeben der vorhandenen Objekte DDL generieren im Kontextmenü auswählen und angeben, dass vorhandene Anweisungen übergeben werden. Wählen Sie für das generierte SQL DDL-Script die Option Auf Server ausführen im Kontextmenü aus. Wenn die Objekte momentan nicht in der Backend-Datenbank bzw. im Backend-Katalog vorhanden sind, reicht das Auswählen von Auf Server exportieren für die Datenobjekte aus.
  2. Das Exportieren von bestimmten Anweisungen auf einen Oracle-Server kann zu Abständen in den Kennungen auf dem Server führen. Beispiel für eine solche Anweisung: CREATE OR REPLACE TRIGGER SET_TRANSACTIONS_TRANID BEFORE INSERT ON TRANSACTIONS FOR EACH ROW WHEN (NEW.TRANID IS NULL) BEGIN SELECT TRANSACTIONS_TRANID_SQ.NEXTVAL INTO :NEW.TRANID FROM DUAL; END;

    Nach Ausführung dieses Scripts für den Server erscheinen die in der Klausel SELECT angegebenen Kennungen möglicherweise anders, z. B. kann die Anweisung 'TRANSACTION_TRANID_SQ.NEXTVAL' als 'TRANSACTIONS_TRANID_SQ . NEXTVAL' erscheinen.

4.8 Gespeicherte Java-Prozeduren bearbeiten

4.9 Beim Schließen des Editors für ein Dokument mit Lesezugriff gehen die Änderungen verloren

Wenn der Zugriff auf ein Dokument eingeschränkt wird (d. h., das Dokument wird nur für Lesezugriff markiert), während es in einem Editor geöffnet ist, gehen beim Schließen des Editors alle anstehenden Änderungen verloren. Stellen Sie daher sicher, dass der Zugriff auf ein Dokument eingeschränkt ist, bevor es in einem Editor geöffnet wird.

4.10 Fehlende Anführungszeichen bei Schemaobjektkennungen für nicht-englische Ländereinstellungen

Das JDBC-Katalogladeprogramm kann nicht feststellen, ob eine Schemaobjektkennung für Ländereinstellung in anderen Sprachen als Englisch begrenzt werden sollte. Öffnen Sie für Objektkennungen, die begrenzt werden sollen, nach dem Import den Schema/Tabelleneditor, um das Schemaobjekt umzubenennen. Wenden Sie sich an die Dokumentation zu Ihrem Datenbankserver, um festzustellen, wann eine Kennung begrenzt werden sollte.

4.11 Herstellen einer Verbindung zu einem DB2-Server

Informationen zu anderen DB2-Servern finden Sie in der Onlinehilfe zur Auswahl von JDBC-Treibern beim Erstellen von Datenbankverbindungen.

4.12 Löschen von gespeicherten Java-Prozeduren aus DB2 Version 8 wird bei Verwendung des DB2-Clients der Version 7 nicht unterstützt

Wenn Sie auf Ihrer Client-Workstation mit DB2 Universal Database Version 7 arbeiten und eine Verbindung zu DB2 Universal Database Version 8 auf dem Server herstellen, können Sie auf dem Server mit DB2 Version 8 keine gespeicherten Java-Prozeduren löschen.

4.13 Manuelles Ändern der zurückgegebenen SQL-Datentypen für DB2-Tabellen-UDFs

Wenn Sie zum Erstellen einer DB2-Tabellen-UDF den Assistenten für neue benutzerdefinierte SQL-Funktion verwenden, schlägt der Assistent SQL-Datentypen für die zurückgegebenen Daten für jede Spalte vor.

Kann der Assistent einer Spalte nicht den entsprechenden Datentyp zuordnen, oder möchten Sie für eine Spalte einen anderen zurückgegebenen Datentyp verwenden, öffnen Sie die generierte UDF im Editor und ändern Sie den Datentyp manuell.

4.14 Fehler beim Erstellen oder Ausführen einer DB2-Routine - Verbindungskennung ungültig oder Verbindung geschlossen

Wenn Sie versuchen, eine gespeicherte DB2-Prozedur oder UDF zu erstellen oder auszuführen, wird möglicherweise die folgende Fehlernachricht angezeigt:

[IBM][JDBC Driver] CLI0600E. Invalid connection handle or connection is closed. SQLSTATE=S1000
[IBM][JDBC-Treiber] CLI0600E. Ungültige Verbindungskennung oder Verbindung ist geschlossen. SQLSTATE=S1000

Um dieses Problem zu umgehen, erstellen Sie einfach die Routine erneut bzw. führen Sie sie erneut aus. Die Fehlernachricht wird beim erneuten Erstellen oder Ausführen nicht wieder angezeigt und kann daher ignoriert werden.

4.15 Probleme mit SequeLink 5.1, das mit WebSphere Studio ausgeliefert wird

WebSphere Studio enthält eine Version des WebSphere SequeLink 5.1 JDBC-Clients im Verzeichnis WS_installationsverzeichnis/runtimes/aes_v4/lib/sljc.jar. Die Tools von WebSphere Studio für relationale Datenbanken sind nicht für die Verwendung dieser Version des Clients für JDBC-Verbindungen konzipiert. Möglicherweise wird die folgende Fehlernachricht angezeigt:

IWAS0126E Bei dem Versuch, die Verbindung verbindungsname herzustellen, sind Fehler aufgetreten. Ursache: Die Verbindung konnte nicht hergestellt werden, weil die ausgewählte JAR-Datei kein WebSphere DataDirect-Client ist. Stellen Sie sicher, dass die JAR-Datei aus einer WebSphere Installation stammt.

Obige Fehlernachricht wird möglicherweise angezeigt, wenn diese JAR-Datei im Verbindungsassistenten im Feld JDBC-Klassenposition angegeben wird. Eine Version des Clients, für dessen Verwendung die Tools für relationale Datenbanken aktiviert sind, ist bei der IBM Unterstützungsfunktion erhältlich.

4.16 Treiber für DataDirect SequeLink 5.3

WebSphere Studio Version 5.x enthält eine neue Version des DataDirect SequeLink JDBC-Clients. Der DataDirect SequeLink 5.3 JDBC-Client befindet sich im Archiv WS_installationsverzeichnis/runtimes/base_v5/lib/sljc.jar. Informationen dazu, wie Sie eine Verbindung zu einer Datenbank mit dem SequeLink 5.1 JDBC-Treiber herstellen, enthält die Dokumentation für Tools für relationale Datenbanken.

4.17 Inhalt des Verbindungsassistenten ist nicht sichtbar

Es ist mindestens eine Auflösung von 1280 x 1024 Pixel erforderlich, damit der Inhalt des Verbindungsassistenten angezeigt werden kann.

4.18 SQL-Dateien für Beispiele für WebSphere Application Server - Express enthalten möglicherweise Fehler, können aber erfolgreich ausgeführt werden

Die SQL-Dateien in dem Projektordner Setup/databases jedes Beispiels für WebSphere Application Server - Express können Parsing-Fehler enthalten (wie in der Sicht 'Gliederung' der Perspektive 'Daten' angezeigt). Die SQL-Dateien werden jedoch erfolgreich mit der Aktion 'Auf Datenbankserver ausführen' ausgeführt, wie in der Datei 'README.html' zu den Beispielen beschrieben.

4.19 Cloudscape unter Linux ausführen

WebSphere Application Server - Express wird mit einer Cloudscape-Datenbank ausgeliefert, die bereits Daten enthält.

Für die Verwendung von Cloudscape unter Linux verwenden Sie das Shell-Script 'EXPcview.sh', das im Verzeichnis /opt/IBM/WebSphere/Express/Express/bin zur Verfügung steht.

4.20 Probleme beim Abrufen von Tabellen von Microsoft SQL Server

4.21 Probleme beim Herstellen einer Verbindung zu Cloudscape 5.1

Das mehrfache Aufbauen und Trennen von Verbindungen mit Cloudscape 5.1 kann spaltenlose Tabellen im Teilfenster für Datenbankserver zur Folge haben. Sollte dieses Problem auftreten, starten Sie WebSphere Studio neu.

4.22 Doppelte Schemaknoten erscheinen beim Importieren, Löschen oder erneuten Importieren von EJB-JAR-Dateien

Wenn EJB-JAR-Dateien (für Beispiele oder sonstiges) importiert, gelöscht und erneut importiert werden, während die Perspektive 'Daten' und/oder 'J2EE' geöffnet ist, hat gelegentlich zur Folge, dass die Schemaknoten unter den Backend-Datenbanken für diese EJB-JAR-Datei doppelt angezeigt werden. Die Einträge sind harmlos, es ist jedoch ratsam, die Perspektive zu schließen und neu zu starten, um die doppelten Einträge zu entfernen.

4.23 Beschädigte arabische Fehlernachrichten beim Exportieren von relationalen Daten

Wenn Sie relationale Daten in eine UDB DB2-Datenbank der Version 7 in UTF-8 unter Verwendung der arabischen Ländereinstellung exportieren, werden in dem Fall, dass Fehler aufgetreten, die Fehlernachrichten eventuell beschädigt angezeigt. Zu diesem Problem gibt es derzeit keine Fehlerumgehung.

Zurück zur Readme-Hauptdatei