setResultSet(ResultSet) - Advanced SQL Engine - Teradata Database

SQL External Routine Programming

Product
Advanced SQL Engine
Teradata Database
Release Number
17.05
17.00
Published
June 2020
Language
English (United States)
Last Update
2021-01-24
dita:mapPath
qwr1571437338192.ditamap
dita:ditavalPath
lze1555437562152.ditaval
dita:id
B035-1147
lifecycle
previous
Product Category
Teradata Vantage™

Purpose

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

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