17.10 - getResultSet(long,int) - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL External Routine Programming

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Release Date
July 2021
Content Type
Programming Reference
Publication ID
B035-1147-171K
Language
English (United States)

Retrieves a result set holding the elements of the subarray that starts at index and contains up to count successive elements.

  • Teradata only supports standard mapping.
  • This method only supports 1-D arrays.

A ResultSet object containing up to countconsecutive elements of the SQL array designated by this Array object, starting at index.

The result set has one row for each element of the SQL array with the first row containing the element at index. The result set has up to count rows in ascending order based on the indices. Each row has two columns:
  • The first column stores the index into the array for that element.
  • The second column stores the element value.

Note that this routine may return less than count number of elements in the array. Any uninitialized elements in the array are not returned.

Syntax

ResultSet getResultSet(long  index,
                       int  count)
                       throws SQLException

Syntax Elements

index
The array index of the first element to retrieve. The first element is at index 1.
count
The number of successive SQL array elements to retrieve.

Exceptions

Throws SQLException in the following cases:

  • The method is called for an N-D array. A database specific code “9743(ERRUDFJAVARRAY)< <Method> cannot be called for N-D Arrays >” is returned.
  • An error occurs while attempting to access the array. A database specific code “9743 (ERRUDFJAVARRAY)<Failed to retrieve result set of Array elements>” is returned.