Amazon RDS for Oracle 19cアダプタ制限事項

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

サポートする型

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

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

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

全処理共通

仕様制限

テーブル一覧の表示について
- グローバルリソースの[ユーザ名]に指定されたユーザのスキーマに属するテーブルが表示されます。
- シノニムは表示されませんが、[テーブル名]や[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: 行1、列7:
  PLS-00221: '<プロシージャ>' is not a procedure or is undefined
  ORA-06550: 行1、列7:
  PL/SQL: Statement ignored
  ]
BOOLEAN型などのPL/SQLの型には対応していません。

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

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

主な例外

例外名		原因	対策
java.sql.SQLException	ORA-01017: invalid username/password; logon denied	ユーザ名またはパスワードが不正です。	グローバルリソースの[ユーザ名]または[パスワード]を確認してください。
java.sql.SQLException	Listener refused the connection with the following error: ORA-12505, TNS:listener does not currently know of SID given in connect descriptor	SIDが不正です。	グローバルリソースの[SID]または[URL]を確認してください。
java.sql.SQLRecoverableException	The Network Adapter could not establish the connection	データベースに接続できません。	グローバルリソースの[ホスト名]または[ポート番号]を確認してください。
java.sql.SQLSyntaxErrorException	ORA-00942: 表またはビューが存在しません。	テーブルまたはビューが存在しないか、テーブルまたはビューの名前が、引用符で囲われていない可能性があります。	[テーブル名]で存在するテーブルまたはビューを指定してください。また、[テーブル名]で指定したテーブルまたはビューの名前が、引用符で囲われているか確認してください。