目的
このArrayオブジェクトによって指定されたSQL ARRAY値の部分を取得します。これは指定されたindexで始まり、 SQL配列のcountまでの連続要素が含まれています。
- Teradataは標準マッピングのみをサポートします。呼び出しで指定されたカスタム マップは無視されます。
- このメソッドは1-D ARRAYでのみサポートされます。
構文規則
Object getArray(long index, int count, Map<String,Class<?>> map) throws SQLException
パラメータ
- index
- 取得する最初の要素の配列インデックス。最初の要素はインデックス1です。
- count
- 取得する一連のSQL配列要素の数。
- map
- Javaプログラミング言語のSQL型名とクラスを含む、これらのマッピング先となるjava.util.Mapオブジェクト。
戻り値
SQL ARRAY値のcountまでの連続要素を含む配列。要素indexで始まります。
このルーチンは、countより少ない配列の要素数を返す場合があります。配列内の初期化されていない要素は返されません。
例外
次の場合にSQLExceptionをスルーします:
- メソッドはN-D配列に対して呼び出されます。データベース固有コード"9743(ERRUDFJAVARRAY)< <Method> cannot be called for N-D Arrays >"が返されます。
- 配列にアクセスしようとするとエラーが発生します。データベース固有コード"9743 (ERRUDFJAVARRAY)<Failed to retrieve elements of the array>"が返されます。