17.10 - setResultSet_nD(ResultSet) - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL External Routine Programming

Advanced SQL Engine
Teradata Database
Release Number
Release Date
July 2021
Content Type
Programming Reference
Publication ID
English (United States)

Sets an SQL N-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 (according to row-major order) to the highest.

  • This method supports N-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.


void setResultSet_nD(ResultSet  arrayResultSet) 
                                    throws SQLException

Syntax Elements

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 List<Integer>, where the list contains n coordinates corresponding to a particular element.
  • The second column stores the element value.
The rows are in ascending order corresponding to the order of the indices.


Throws SQLException in the following cases:
  • The method is called for a 1-D array. A database specific code “9743 (ERRUDFJAVARRAY)< <Method> cannot be called for 1-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.