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

Teradata Vantage™ - SQL External Routine Programming

Product
Advanced SQL Engine
Teradata Database
Release Number
16.20
Release Date
April 2020
Content Type
Programming Reference
Publication ID
B035-1147-162K
Language
English (United States)

Purpose

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.

Syntax

void setResultSet_nD(ResultSet  arrayResultSet) 
                                    throws SQLException

Parameters

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 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.

Exceptions

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.