Oracle 21cアダプタ制限事項

Oracle 21cアダプタは販売およびサポートを終了しています。

サポートする型
全処理共通
テーブル読み取り処理
検索系SQL実行処理
テーブル書き込み処理
更新系SQL実行処理
ストアドプロシージャ実行処理
ローダによる書き込み処理
主な例外

サポートする型

本アダプタでサポートする型は以下の通りです。

型名	サポート	備考
CHAR型	△
NCHAR型	△
VARCHAR2型	○
NVARCHAR2型	△
LONG型	○
NUMBER型	△
FLOAT型	△
DATE型	△
TIMESTAMP型	△
TIMESTAMP WITH TIME ZONE型	△	Stringとしてデータを扱います。
TIMESTAMP WITH LOCAL TIME ZONE型	△	Stringとしてデータを扱います。
RAW型	○
LONG RAW型	○
BLOB型	○
CLOB型	○
NCLOB型	○
JSON型	×

○:サポートします。
△:サポートしますが、制限事項があります。
×:サポートしません。

全処理共通

仕様制限

テーブル一覧の表示について
- グローバルリソースの[ユーザ名]に指定されたユーザのスキーマに属するテーブルが表示されます。
- シノニムは表示されませんが、[テーブル名]や[SQL文]に直接入力することは可能です。

テーブル読み取り処理

仕様制限

テーブル名が引用符で囲われている場合、テーブル名の大文字小文字を区別します。

[フェッチサイズ]のデフォルト値は「100」です。

検索系SQL実行処理

仕様制限

NUMBER型、FLOAT型
- クエリ結果のPrecisionが0の場合、BigDecimalとしてデータを扱います。たとえば、SUM関数で指定している列にPrecisionが設定されていても結果として0が返ってくるので、SUM関数の結果はBigDecimalとしてデータを扱います。
ファンクションを使用したSQL文について
- SQLファンクションを使用したSQL文は実行可能です。
- ユーザ定義ファンクションを使用したSQL文は実行可能ですが、ファンクションで定義されているOUTパラメータの値は受け取ることはできません。
[フェッチサイズ]のデフォルト値は「100」です。

テーブル書き込み処理

仕様制限

CHAR型
- 更新を行う際、[スキーマ定義/キー]にチェックを入れた列がCHAR型の場合は、入力データのキー値が同じサイズにパディングされている必要があります。
テーブル名が引用符で囲われている場合、テーブル名の大文字小文字を区別します。

更新系SQL実行処理

仕様制限

CHAR型
- UPDATE文のWHERE句にCHAR型の列が指定されていて、その列の値をSQLパラメータで取得する場合は、入力データのキー値が同じサイズにパディングされている必要があります。
ファンクションを使用したSQL文について
- SQLファンクションを使用したSQL文は実行可能です。
- ユーザ定義ファンクションを使用したSQL文は実行可能ですが、ファンクションで定義されているOUTパラメータの値は受け取ることはできません。

ストアドプロシージャ実行処理

仕様制限

CHAR型
- CHAR型のOUTパラメータには、不要な半角スペースが付加される場合があります。
プロシージャの表記について
- パッケージ内に定義されているプロシージャは [パッケージ名].[プロシージャ名] で表記します。
- パッケージ名にドット(.)が含まれている場合、パッケージ名をダブルクォーテーション(")で囲います。
  例:パッケージ「SAMPLE.PACKAGE」で定義されてるプロシージャ「PROCEDURE」の場合
  - "SAMPLE.PACKAGE".PROCEDURE
- プロシージャ名にドット(.)が含まれている場合、プロシージャ名をダブルクォーテーション(")で囲います。
  例:パッケージ「PACKAGE」で定義されてるプロシージャ「SAMPLE.PROCEDURE」の場合
  - PACKAGE."SAMPLE.PROCEDURE"
[プロシージャ]にストアドファンクションを指定した場合、RETURN句の戻り値を出力パラメータとして取得できず、スクリプト実行時に以下のようなエラーが発生し、処理が失敗する場合があります。
- [exec_procedure]の処理に失敗しました。原因:[java.sql.SQLException: ORA-06550: '<プロシージャ>'がプロシージャではないか、または未定義です。]
BOOLEAN型などのPL/SQLの型には対応していません。

シノニムには対応していません。

グローバルリソースの[ユーザ名]に指定されたユーザのスキーマと異なるスキーマのプロシージャは使用できません。

ローダによる書き込み処理

仕様制限

NCHAR型、NVARCHAR2型
- カラムの長さは文字列長ではなくバイト長として扱います。
  ただし、Oracle Database ClientのキャラクタセットがUTF-16の場合は、文字列長として扱います。
DATE型
- あらかじめOracleの標準フォーマット[YYYY-MM-DD]に整形されている必要があります。
TIMESTAMP型
- あらかじめOracleの標準フォーマット[YYYY-MM-DD Hh24:MI:SS]に整形されている必要があります。
テーブル名が引用符で囲われている場合、テーブル名の大文字小文字を区別します。

主な例外

例外名		原因	対策
java.sql.SQLException	ORA-01017: ユーザー名/パスワードが無効です。ログオンは拒否されました。	ユーザ名またはパスワードが不正です。	グローバルリソースの[ユーザ名]または[パスワード]を確認してください。
java.sql.SQLRecoverableException	Listener refused the connection with the following error: ORA-12514, TNS:listener does not currently know of service requested in connect descriptor	サービス名が不正です。	グローバルリソースの[サービス名]または[URL]を確認してください。
java.sql.SQLRecoverableException	IOエラー: The Network Adapter could not establish the connection	データベースに接続できません。	グローバルリソースの[ホスト名]または[ポート番号]を確認してください。
java.sql.SQLSyntaxErrorException	ORA-00942: 表またはビューが存在しません。	テーブルまたはビューが存在しないか、テーブルまたはビューの名前が、引用符で囲われていない可能性があります。	[テーブル名]で存在するテーブルまたはビューを指定してください。また、[テーブル名]で指定したテーブルまたはビューの名前が、引用符で囲われているか確認してください。
oracle.jdbc.xa.OracleXAException		トランザクションが有効なスクリプトで、同一のデータベースを参照する複数のXAグローバルリソースを使用している可能性があります。	Oracle XA接続による複数の処理で同一のデータベースを参照する場合は、共通のグローバルリソースを使用してください。