リレーショナル・データベース・ツール - リリース情報

1.0 概要
2.0 サポートするソフトウェアと仕様
3.0 制限
   3.1 ストアード・プロシージャーから Java Bean または EJB メソッドを生成するには、オンラインでなければならない
4.0 既知の問題
   4.1 データベース・モデル
   4.2 SQL 照会
   4.3 データベース接続
   4.4 SQL DDL
   4.5 エラー報告
   4.6 SQL ステートメントを実行すると Oracle に誤ったテーブルが作成される
   4.7 データのエクスポート
   4.8 Java ストアード・プロシージャーの編集
   4.9 読み取り専用文書のエディターをクローズすると変更が失われる
   4.10 非英語ロケールで、スキーマ・オブジェクト ID の引用符が欠落する
   4.11 DB2 サーバーへの接続
   4.12 DB2 バージョン 7 クライアントでは、DB2 バージョン 8 からの Java ストアード・プロシージャーのドロップをサポートしていない
   4.13 DB2 テーブル UDF について戻された SQL データ型を手動で変更する
   4.14 DB2 ルーチンのビルドまたは実行時のエラー - 無効な接続ハンドルまたは接続がクローズされました (Invalid connection handle or connection is closed)
   4.15 WebSphere Studio に付属の Sequelink 5.1 の問題
   4.16 DataDirect Sequelink 5.3 ドライバー
   4.17 接続ウィザードの内容が表示されない
   4.18 Microsoft SQL Server からテーブルを検索するときの問題
   4.19 Cloudscape 5.1 への接続時の問題
   4.20 EJB JAR ファイルのインポート、削除、または再インポート時に重複したスキーマ・ ノードが表示される
   4.21 リレーショナル・データのエクスポート中に表示される破壊されたアラビア語のエラー ・メッセージ

1.0 概要

WebSphere Studio のリレーショナル・データベース・ツールを使用すると、 データベースへの接続、データベース設計のブラウズまたはインポート、ウィザードを使用した新規データベースの設計、 新規設計のデータベースへのエクスポート、SQL ビルダーを使用した SQL 照会の作成および実行、 DB2 ストアード・プロシージャーや DB2 ユーザー定義関数などの作成と実行を行うことができます。 リレーショナル・データベース・ツールには、データ・パースペクティブ・データ定義と DB サーバー・ビューを使用してアクセスします。

2.0 サポートするソフトウェアと仕様

リレーショナル・データベース・ツールは、以下のデータベース・タイプへの接続 およびそれらからのインポートをサポートしています。

SQL ウィザードおよび SQL 照会ビルダーでの SQL サポートは、 データベース・ベンダーが提供するサポートのレベルに依存します。

全選択のサポート:

結合のサポート: 照会結果のグループ化のサポート: キャスト式のサポート:

Linux で AS/400 Toolbox for Java JDBC ドライバーを使用して DB2 Universal Database for iSeries V5R1 に接続すると、クラッシュが発生することがあります。 この問題は、誤ったパスワードを入力するか、パスワード・フィールドを空白のままに すると発生します。この問題が発生した場合は、製品を再始動し、正しいパスワードを 使用して再接続してください。

3.0 制限

3.1 ストアード・プロシージャーから Java Bean または EJB メソッドを生成するには、オンラインでなければならない

ストアード・プロシージャーから Java Bean または EJB メソッドを生成できるウィザードを使用するには、オンラインで作業している必要があります。

4.0 既知の問題

4.1 データベース・モデル

  1. 現在、索引のモデリング、検査および固有の制約、トリガー、構造化タイプ、識別列などはサポートされていません。
  2. リレーショナル・データベース・ツールは、ビューでのチェック・オプションをサポートしません。

4.2 SQL 照会

  1. 照会ステートメント内の不要な大括弧があると、パーサー・エラーが発生します。
  2. 照会の WHERE 条件文節での括弧の使用は現在サポートされていません。
  3. 大きな SQL ファイルは、エディターをスローダウンさせる場合があります。
  4. Oracle では、更新ステートメントは、括弧で囲まれたグループを使わずに、各列に値を個別に割り当てなければなりません。 個々に列を追加し、 副照会を使用して値を追加するには、「値テーブル・セル (Value table cell)」 コンボ・ボックスの「式のビルド (Build Expression)」オプションを使用して その列の照会式を作成してください。
  5. ステートメントで使われるデータベース・オブジェクトを変更すると、 ローカルのデータ・モデルに対してステートメントの構文解析を正常に行なわなくなるため、SQL が失敗する原因となります。
  6. ビューを編集して、その後にビューを含むステートメントをオープンすると、予期しないワークベンチのシャットダウンが行われることがあります。
  7. データベース接続が WebSphere Studio の外で強制的に切断された場合、 ステートメント実行時に接続のプロンプトが表示されません。 接続をリストアするには、データベースを DB サーバー・ビューからプロジェクトに再インポートしてください。
  8. ユーザー定義関数から派生したビューを使用して照会を作成することはできません。
  9. データベース・オブジェクトのドラッグ・アンド・ドロップは、DB サーバー・ビューでなく、データ定義ビューにおいてのみサポートされます。

4.3 データベース接続

  1. DATALINK 型の列を持つ DB2 UDB または DB2 for iSeries のテーブルをインポートしても、 その列のリンク制御オプションはインポートされません。 DATALINK の長さはデフォルトでは 200 に設定されており、リンク・オプションは NO LINK CONTROL にデフォルト設定されています。これらのプロパティーは、テーブルをデータ・ビューにインポートした後、テーブル・エディターで更新できます。
  2. DB サーバー・ビューで複数の接続を除去できない場合があります。 このような問題が発生した場合、ユーザーは接続を維持することも、1 つずつ除去することもできます。
  3. iSeries サーバーへの接続では、文字ストリング・データ型が正しくインポートされない場合があります。 CHAR FOR BIT DATA、VARCHAR FOR BIT DATA、および LONG VARCHAR FOR BIT DATA の型は、FOR BIT DATA のオプションなしにインポートできます。 このような場合には、データ・パースペクティブ内のテーブル・エディターを使用して、影響を受けた列を編集します。
  4. DBCS 文字を含むスキーマ・オブジェクト名は、iSeries から正しくインポートできない場合があります。 区切り ID に引用符が欠落している可能性があります。 このような場合には、テーブル・エディターを使用して列と制約名を編集してください。
  5. OS/390 の接続では、基本キー制約の ID はインポートされません。
  6. 列のデフォルト値が、ストアード・プロシージャー、関数、 あるいは識別文節で定義されている場合は、正常にインポートできず、テーブルの文書で ASCII以外の文字が使われることがあります。 ASCII 以外の文字は、文書のロード時に問題が発生します。 この状態になった場合は、問題となっている tblxmi 文書を手動で編集して、デフォルトのタグと値を削除する必要があります。
  7. SQL サーバー・データベースに接続するために WebSphere Connect JDBC ドライバーを使う場合は、一般的にはクラス・ロケーションを指定するために 3 つの JAR ファイルが必要です。これらのJAR ファイルは、結合して単一の JAR ファイルにすることをお勧めします。 そうしないと、接続後にウィザードを再オープンしたときに、ファイルが異常に大きくなります。 これは「ドライバー・ロケーション (Driver location)」フィールドの長さが原因です。
  8. DB2 バージョン 8 のクライアントから新しいデータベース接続を作成する場合、IBM DB2 NET DRIVER JDBC ドライバーを使用するには、「クラス・ロケーション (Class location)」フィールドに、<DB2HOME>/java/db2jcc.jar および <DB2HOME>/java/common.jar (ここで <DB2HOME> は、DB2 をインストールしたディレクトリー) という 2 つの JAR ファイルを追加する必要があります。 これを行わない場合、エラーになります。 注: これらの JAR ファイルをクラス・ロケーションに追加しないまま新規データベース接続ウィザードを使用すると、ストアード・プロシージャーはロードされません。 「クラス・ロケーション (Class location)」フィールドにファイルを入力するために接続ウィザードをもう一度起動する必要があります。
  9. DB2 UDB バージョン 8 のクライアントを使用して、z/OS 上のバージョン 7 またはそれより前の DB2 に接続する場合、スキーマおよびテーブル・メタデータはインポートされない場合があります。 問題を修正するには、DB2 for z/OS PTF UQ72081 をインストールします。

4.4 SQL DDL

  1. Oracle の long データ型のインポートおよび編集操作で問題が起こる場合があります。
  2. 極端に大きな SQL DDL ファイルは、エディターをスローダウンさせることがあります。
  3. 極端に大きな SQL DDL ファイルは、構文解析中または実行中にメモリー不足の例外の原因になる場合があります。
  4. Oracle スクリプトを編集すると、エディターのアウトライン・ビューにエラーが表示されることがあります。 例えば、「CREATE SEQUENCE」、「CREATE OR REPLACE TRIGGER」、および「END」のステートメントはエラーとして表示されます。 ただし、これらの項目はこのまま Oracle サーバーにエクスポートできます。

4.5 エラー報告

SQL ファイルの構文解析中にエラーになった場合、エラー・メッセージで報告された場所の次のトークンで問題が発生していることが多くあります。エラー・メッセージはタスク・リストにも表示されます。

4.6 SQL ステートメントを実行すると Oracle に誤ったテーブルが作成される

Oracle データベース・サーバーで SQL ファイルを実行する場合は、最初にテーブル・シーケンスおよびトリガーを作成するように選択する必要があります。 これは、WebSphere が余分なスペースを挿入することによって Oracle と誤った対話を行うためです。 テーブルを作成した後、Oracle サーバー・マシンに移動してステートメントを編集し、挿入されたスペースを除去してコマンド「end;」を追加します。 次に、WebSphere に戻り、サーバーで再度 SQL ステートメントを実行します。このとき、Alter ステートメントと挿入ステートメントを選択します。

4.7 データのエクスポート

  1. バックエンド・データベース/カタログにある既存の ART ファイルは、SQL DDL スクリプトで「サーバーで実行」 を実行することによってドロップすることができます。 データ・オブジェクト (例: データベース、スキーマ、テーブルなど) で既存のオブジェクトをドロップしたい場合は、 ポップアップ・メニューから「DDL の生成」を選択して、既存のステートメントをドロップするように指定します。 生成した SQL DDL スクリプト上で、ポップアップ・メニューから「サーバーで実行」を選択してください。 現在、オブジェクトがバックエンド・データベース/カタログに存在しない場合には、 データ・オブジェクトで「サーバーにエクスポート」を選択すればエクスポートできます。
  2. 特定のステートメントを Oracle サーバーにエクスポートすると、 サーバー上で ID のスペーシングに問題が発生することがあります。 例えば、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; などのステートメントです。

    サーバーに対してこのスクリプトを実行すると、SELECT 文節に指定した ID が異なった形で表示されることがあります。 例えば、「TRANSACTION_TRANID_SQ.NEXTVAL」は「TRANSACTIONS_TRANID_SQ . NEXTVAL」のように表示されます。

4.8 Java ストアード・プロシージャーの編集

4.9 読み取り専用文書のエディターをクローズすると変更が失われる

文書をチェックアウト (つまり読み取り専用とマーク) した際、 エディターで文書がオープンしていると、保留されていた変更はエディターをクローズしたときにすべて失われます。 エディターで文書をオープンする前に、文書がチェックアウトされていることを確認してください。

4.10 非英語ロケールで、スキーマ・オブジェクト ID の引用符が欠落する

非英語のロケールの場合、JDBC カタログ・ローダーは、スキーマ・オブジェクト ID を区切るべきかどうか決定できません。 区切るべき ID については、インポートしたあと、スキーマ/テーブル・エディターをオープンして、スキーマ・オブジェクトを名前変更してください。 どのような場合 ID を区切るべきなのかについては、データベース・サーバーの資料を参照してください。

4.11 DB2 サーバーへの接続

その他の DB2 サーバーについては、データベース接続を作成するときに、オンライン・ヘルプで JDBC ドライバーの選択方法を参照してください。

4.12 DB2 バージョン 7 クライアントでは、DB2 バージョン 8 からの Java ストアード・プロシージャーのドロップをサポートしていない

クライアント・ワークステーション上で DB2 Universal Database のバージョン 7 を使用して、 サーバー上の DB2 Universal Database バージョン 8 に接続している場合、 DB2 バージョン 8 サーバーから Java ストアード・プロシージャーをドロップすることはできません。

4.13 DB2 テーブル UDF について戻された SQL データ型を手動で変更する

「新しい SQL ユーザー定義関数 (New SQL User-Defined Function)」ウィザードを使用して DB2 テーブル UDF を作成すると、それぞれの列の戻りデータに対し、ウィザードが SQL データ型を推奨します。

ウィザードが該当するデータ型を列に対してマップできない場合、または列に対して異なる戻りデータ型を使用する場合は、 生成された UDF をエディターで開き、データ型を手動で変更してください。

4.14 DB2 ルーチンのビルドまたは実行時のエラー - 無効な接続ハンドルまたは接続がクローズされました (Invalid connection handle or connection is closed)

DB2 ストアード・プロシージャーまたは UDF をビルドまたは実行しようとしたときに、以下のエラー・メッセージが表示される場合があります。

[IBM][JDBC Driver] CLI0600E. Invalid connection handle or connection is closed. SQLSTATE=S1000

このエラーを回避するには、ルーチンをもう一度ビルドまたは実行します。 エラー・メッセージは 2 回目には表示されないため、無視してかまいません。

4.15 WebSphere Studio に付属の Sequelink 5.1 の問題

WebSphere Studio には、WebSphere ブランド・バージョンの Sequelink 5.1 JDBC クライアントが WS_installdir/runtimes/aes_v4/lib/sljc.jar に組み込まれています。 WebSphere Studio リレーショナル・データベース・ツールは、JDBC 接続にこのバージョンのクライアントを使用できません。 以下のエラー・メッセージが表示される場合があります。

IWAS0126E Problems encountered while trying to establish connection connection_name Reason: Connection was not established because the selected JAR file is not a WebSphere branded DataDirect client. Ensure the selected JAR comes from a WebSphere install.

エラー・メッセージが表示されるのは、この JAR ファイルが接続ウィザードの「JDBC クラス・ロケーション (JDBC class location)」フィールドで指定されている場合です。 リレーショナル・データベース・ツールが使用できるクライアントのバージョンは、IBM サポートから使用可能です。

4.16 DataDirect Sequelink 5.3 ドライバー

WebSphere Studio バージョン 5.x には、新しいバージョンの DataDirect Sequelink JDBC クライアントが組み込まれています。 DataDirect Sequelink 5.3 JDBC クライアントは、WS_installdir/runtimes/base_v5/lib/sljc.jar アーカイブにあります。Sequelink 5.1 JDBC ドライバーを使用してデータベースに接続する方法については、リレーショナル・データベース・ツールの資料を参照してください。

4.17 接続ウィザードの内容が表示されない

接続ウィザードの内容を可視にするには、最低限の解像度として 1280x1024 が必要です。

4.18 Microsoft SQL Server からテーブルを検索するときの問題

4.19 Cloudscape 5.1 への接続時の問題

Cloudscape 5.1 を使用して接続および切断アクションを複数回実行すると、「DB サーバー (DB Servers)」ペインにカラムのないテーブルが表示される場合があります。 この問題が発生した場合は、WebSphere Studio を再始動してください。

4.20 EJB JAR ファイルのインポート、削除、または再インポート時に重複したスキーマ・ノードが 表示される

データ・パースペクティブまたは J2EE パースペクティブのいずれかまたは両方を開いた状態で 、EJB JAR ファイル (サンプルまたはサンプル以外のファイル) をインポート、削除、および再インポートすると、 その EJB JAR ファイルのバックエンド・データベースの下に重複したスキーマ・ノードが表示されることがあります。 これらのエントリーは無害ですが、パースペクティブをシャットダウンして再始動し、重複したエントリーを除去することをお勧めします。

4.21 リレーショナル・データのエクスポート中に表示される破壊されたアラビア語のエラー・ メッセージ

アラビア語ロケールを使用して UTF-8 UDB DB2 V7 データベースに リレーショナル・データをエクスポートすると、エラーが発生した場合に破壊されたエラー・ メッセージが表示されることがあります。この問題に対する回避策はありません。

メインの README ファイルに戻る