17.00 - 17.05 - getArray(long, int) - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL外部ルーチン プログラミング

Product
Advanced SQL Engine
Teradata Database
Release Number
17.00
17.05
Published
2020年6月
Content Type
プログラミング リファレンス
Publication ID
B035-1147-170K-JPN
Language
日本語 (日本)

目的

このArrayオブジェクトによって指定されたSQL ARRAY値の部分を取得します。これは指定されたindexで始まり、 SQL配列のcountまでの連続要素が含まれています。
  • Teradataは標準マッピングのみをサポートします。
  • このメソッドは1-D ARRAYでのみサポートされます。

構文規則

Object getArray(long  index,
                int  count)
                throws SQLException

パラメータ

index
取得する最初の要素の配列インデックス。最初の要素はインデックス1です。
count
取得する一連のSQL配列要素の数。

戻り値

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>"が返されます。