OracleのObject型またはCollection型のデータ・メンバーとして取得または挿入されないCHAR/VARCHAR/LONGVARCHAR/CLOB型データ用のOracleキャラクタ・セット。
共通に使用される少数のキャラクタ・セット用のObject型とCollection型のCHAR/VARCHARデータ・メンバーに対するNLSサポート。この種のキャラクタ・セットは、US7ASCII、WE8DEC、WE8ISO8859P1およびUTF8です。

Object型またはCollection型のCHAR/VARCHARデータ・メンバーに他のキャラクタ・セットを使用する必要がある場合は、CLASSPATHにNLS拡張機能のjarファイル（orai18n.jar）を含める必要があります。新規のorai18n.jarにより、以前のリリースのnls_charset*.*ファイルが置き換えられます。

NLS拡張機能のjarファイルは、多数のキャラクタ・セットをサポートする必要があるため大型であることに注意してください。必要な場合は、拡張機能のjarファイルから必要なクラスのみを含めるように選択できます。そのためには、最初にNLS拡張機能のjarファイルを解凍し、必要なファイルのみをCLASSPATHに指定します。拡張機能のjarファイルでは、各クラスに次の形式の名前が使用されています。

  lx20<OracleCharacterSetId>.glb キャラクタ・セット
  lx1<OracleTerritoryId>.glb 地域
  lx3<OralceLinguisticSortId>.glb 言語ソート
  lx4<OracleMapingId>.glb マッピング

<Oracle*>は、対応するOracle NLS IDの16進表現です。

また、各国対応のJDBCエラー・メッセージ・ファイルを選択的に含めることもできます。メッセージ・ファイルは、classes12*.jarおよびojdbc14*.jar内のoracle/jdbc/driver/Messages_*.propertiesファイルに含まれています。

5 インストール

CLASSPATHには、Oracle JDBC Driversの複数バージョンを指定しないでください。Oracle Installerを実行すると、Oracle JDBC Driversが[ORACLE_HOME]/jdbcディレクトリにインストールされます。

6 環境の設定

Windowsプラットフォームの場合

JDK 1.2または1.3を使用する場合は、CLASSPATHに[ORACLE_HOME]\jdbc\lib\classes12.jarを追加します。JDK 1.4を使用する場合は、CLASSPATHに[ORACLE_HOME]\jdbc\lib\ojdbc14.jarを追加します。
NLS機能を使用する場合は、CLASSPATHに[ORACLE_HOME]\jdbc\lib\orai18n.jarを追加します。
JDBC OCIドライバを使用する場合は、PATHに[ORACLE_HOME]\binを追加します。

Solaris/HP Tru64 Unixの場合

JDK 1.2または1.3を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/classes12.jarを追加します。JDK 1.4を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/ojdbc14.jarを追加します。
NLS機能を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/orai18n.jarを追加します。
JDBC OCIドライバを使用する場合は、LD_LIBRARY_PATHに[ORACLE_HOME]/jdbc/libを追加します。

HP/UXの場合

JDK 1.2または1.3を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/classes12.jarを追加します。JDK 1.4を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/ojdbc14.jarを追加します。
NLS機能を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/orai18n.jarを追加します。
JDBC OCIドライバを使用する場合は、SHLIB_PATHおよびLD_LIBRARY_PATHに[ORACLE_HOME]/jdbc/libを追加します。

AIXの場合

JDK 1.2または1.3を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/classes12.jarを追加します。JDK 1.4を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/ojdbc14.jarを追加します。
NLS機能を使用する場合は、CLASSPATHに[ORACLE_HOME]/jdbc/lib/orai18n.jarを追加します。
JDBC OCIドライバを使用する場合は、LIBPATHおよびLD_LIBRARY_PATHに[ORACLE_HOME]/jdbc/libを追加します

7 JDBCドライバ使用時に役立つヒント

Oracle JDBC Driversの使用方法の詳細は、『Oracle Database JDBC開発者ガイドおよびリファレンス』を参照してください。この項では、ヒントのみを説明します。これらのヒントは網羅的ではありません。

あくまでもJDBCプログラムで必要な事項です。

1) JDBCを使用するプログラムに必要なJDBCクラスをインポートします。次に例を示します。

  import java.sql.*;
  import java.math.*;

OracleDataSourceを使用するには、次のように入力する必要があります。

  import oracle.jdbc.pool.OracleDataSource;

2) OracleDataSourceインスタンスを作成します。

  OracleDataSource ods = new OracleDataSource( );

3) デフォルトのプロパティを使用しない場合は、必要なプロパティを設定します。JDBCドライバごとに異なる接続URLを使用する必要があります。

  ods.setUser("my_user");
  ods.setPassword("my_password");

JDBC OCIドライバの場合

Bequeathed接続を確立するには、URLを次のように設定します。

  ods.setURL("jdbc:oracle:oci:@");

リモート接続を確立するには、URLを次のように設定します。

  ods.setURL("jdbc:oracle:oci:@<database>");

<database>は、TNSEntryNameまたはtnsnames.oraに定義されているSQL*Netの名前/値ペアです。

JDBC Thinドライバまたはサーバー側Thinドライバの場合

  ods.setURL("jdbc:oracle:thin:@<database>");

<database>は、//<host>:<port>/<service_name>形式の文字列またはSQL*Netの名前/値ペアです。

サーバー側JDBC内部ドライバの場合

  ods.setURL("jdbc:oracle:kprb:");

後続の「:」が必要であることに注意してください。サーバー側内部ドライバを使用する場合は、常に実行中のデータベースに接続します。また、次のように指定できます。

  Connection conn = new oracle.jdbc.OracleDriver().defaultConnection( );

4) OracleDataSourceクラスに定義されているgetConnection()メソッドを使用して、データベースへの接続をオープンします。

  Connection conn = ods.getConnection( );

8 以前のoracle.jdbc.driverパッケージはまもなく廃止

Oracle9iからは、JDBCへのOracleの拡張機能はoracle.jdbcパッケージで提供されます。このパッケージには、java.sql内のクラスとインタフェースでパブリックJDBC APIが指定されるのと同様の方法で、Oracleの拡張機能を指定するクラスとインタフェースが含まれています。

9iの初期バージョン以降は、oracle.jdbc.driverパッケージの使用が廃止されています。コードでは、かわりにoracle.jdbcパッケージを使用してください。Oracle9i以降の新機能には、oracle.jdbc.driverパッケージの使用との互換性がありません。このリリースでは下位互換性を提供するために古いoracle.jdbc.driverパッケージも引き続きサポートされますが、このパッケージは最終的には次回のメジャー・リリースで削除されます。古いoracle.jdbc.driverパッケージを使用する既存のアプリケーションが残っている場合は、この時点でコードを変換してください。

ソース内でoracle.jdbc.driverをoracle.jdbcで置き換えて再コンパイルするだけで、コードを変換できます。この操作は、ピース単位では実行できません。アプリケーションで参照されるクラスとインタフェースをすべて変換する必要があります。

9 Javaストアド・プロシージャ

OracleのObjectを使用したコールインとインスタンス・メソッドの例は、次のファイルにあります。

  [ORACLE_HOME]/javavm/demo/demo.zip

このファイルを解凍すると、次のディレクトリに例が抽出されます。

  [ORACLE_HOME]/javavm/demo/examples/jsp

10 このリリースの既知の問題/制限事項

次のリストに、既知の問題または制限事項を示します。

データベースのキャラクタ・セットがAL32UTF8の場合は、次の状況でエラーが表示されることがあります。

- LONGデータ型とVARCHAR2データ型へのアクセス時。
- setString()およびsetCharacterStream()を使用したデータのバインド時。

ScrollableResultSetでADTデータに対してgetSTRUCT()をコールすると、NullpointerExceptionが発生することがあります。

LONG列を含む表に1回のPreparedStatement.executeUpdate()のコールで8000バイトを超えるデータをバインドすると、ORA-22295エラーが発生することがあります。

LOB型の場合、ストリーム入力の使用に関して制限があります。LOB型のストリーム入力を使用できるのは、リリース8.1.7以上のOracleサーバーに接続しているリリース8.1.7以上のJDBC OCIドライバの場合のみです。他のすべての構成では、LOB型にストリーム入力を使用するとデータが破損する可能性があります。PreparedStatementのストリーム入力APIには、setBinaryStream()、setAsciiStream()、setUnicodeStream()、setCharacterStream()およびsetObject()があります。

クライアント側ドライバを使用して一度に16以上の接続をオープンしようとすると、プログラムが異常終了することがあります。これは、JDBCドライバによる制限事項ではありません。プロセスごとのファイル記述子数の制限を超えることが原因と思われます。この問題を解決するには、上限を高くします。

サーバー側内部ドライバには、次の制限事項があります。

Java Virtual Machineがグリーンスレッド・モードで動作している場合は、SSL接続上のJDBC OCIドライバが停止します。回避策は、Java Virtual Machineをネイティブ・スレッド・モードで実行することです。

日時書式、通貨記号および小数点記号は、常にアメリカの表記規則で表されます。

OracleStatement.defineColumnType()を使用する場合、列の型としてデータベース内で宣言されているのと同じ型を定義する必要はありません。型が異なる場合は、取得された値がdefineColumnTypeに指定された値に変換されます。

注意: 妥当な変換のほとんどは機能しますが、すべてが機能するとはかぎりません。妥当と思われる変換が見つかっても機能しない場合は、オラクル社カスタマ・サポート・センターにTARを提供してください。

JSPのSystem.out.println()を標準出力にリダイレクトするために使用するdbms_java.set_outputまたはdbms_java.set_streamユーティリティは、JDBCトレースがオンになっているときには使用しないでください。これは、dbms_java.set_outputおよびset_streamの現行の実装では、出力を標準出力に書き込むためにJDBCが使用されるためです。この種のユーティリティを使用すると無限ループになります。

JDBC OCIドライバとJDBC Thinドライバは、バイナリ・ストリームを介してCHARデータを正常に読み取りません。つまり、getBinaryStream()を使用してCHARデータを取得すると、正しい結果が得られないことがあります。回避策は、かわりにgetCHAR()またはgetAsciiStream()を使用することです。その他にgetUnicodeStream()を使用する方法もありますが、このメソッドは廃止になっています。

JavaおよびObject型で実装されるトリガーには制限があります。クライアント側では、Javaを使用して実装されるIN引数タイプのトリガーにのみ影響します。この制限は、サーバー内部で実行されるJDBCプログラムには適用されません。Javaメソッドとして実装されたトリガーは、Oracle 8のObject型またはCollection型のIN引数を取ることができません。つまり、トリガーの実装に使用するJavaメソッドには、次の型の引数を使用できません。

スクロール可能な結果セットの実装には、次の制限があります。

サポート	タイプ	同時実行性
なし	TYPE_FORWARD_ONLY	CONCUR_READ_ONLY
なし	TYPE_FORWARD_ONLY	CONCUR_UPDATABLE
なし	TYPE_SCROLL_INSENSITIVE	CONCUR_READ_ONLY
あり	TYPE_SCROLL_INSENSITIVE	CONCUR_UPDATABLE
あり	TYPE_SCROLL_SENSITIVE	CONCUR_READ_ONLY
あり	TYPE_SCROLL_SENSITIVE	CONCUR_UPDATABLE

『Oracle Database JDBC開発者ガイドおよびリファレンス』の「CLOBデータの挿入および取出しのショートカット」項で、接続プロパティ「SetBigStringUseClob」を参照するよう記載がありますが、これらは正しくありません。「SetBigStringTryClob」接続プロパティ名を使用してください。

マルチスレッド設定でoracle.sql.TIMESTAMPTZとJDBC OCIドライバとを組み合せて使用した場合、JDKの不具合によりJavaコア・ダンプが出力される場合があります。これは、 64-bit Sparcマシンで64ビット版のJavaを使用した場合にのみ起こります。スレッドごとに異なる接続を使用する、あるいはoracle.sql.TIMESTAMPTZオブジェクトの作成時にスレッド間でタイムゾーン情報を共有しないことで回避できます。 Sun社のReview Id: 234589を参照してください。

Bug#1516862（リリース9.0.1以降）

Javaストアド・プロシージャの引数としてOPAQUE型を渡すと機能しません。

Bug#1542130（リリース9.0.1以降）

マルチスレッド環境でOciConnectionPoolを使用すると停止することがあります。

Bug#1640110（リリース9.0.1以降）

問合せ文字列に無効な二重引用符を含む問合せを実行すると、JDBC OCIドライバが停止することがあります。この問題が発生するのは、NLS_LANG環境変数が設定されている場合のみです。

新規の日時データ型へのアクセスは、JDK 1.2、1.3および1.4を使用する3つのJDBCドライバすべてでサポートされます。これらの日時データ型は、TIMESTAMP、TIMESTAMPTZおよびTIMESTAMPLTZです。また、PreparedStatement.setString()やResultset.getString()などのString APIは、これらのデータ型には機能しません。setTIMESTAMP*()およびgetTIMESTAMP*()を使用する必要があります。