17.10 - setResultSet(ResultSet) - 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)

Sets an SQL 1-D ARRAY value designated by this Array object with values provided in the input ResultSet. Element values in the Array object are set starting from the lowest value of the first column to the highest.

  • This method supports 1-D arrays only.
  • Fewer than the maximum number of elements specified in the ResultSet may be set in the Array, in case the Array was constructed with fewer elements.

Syntax

void setResultSet(ResultSet  arrayResultSet)
                       throws SQLException

Syntax Elements

arrayResultSet
A ResultSet consisting of two columns, an index and an element value.
The result set passed as input must contain one row for each array element, with two columns in each row:
  • The first column is of type Integer and stores the index into the array for that element.
  • The second column stores the element value.
The rows are in ascending order corresponding to the order of the indices.

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 set Array elements with provided ResultSet>” is returned.