getResultSet() - 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

Retrieves a result set that contains the elements of the SQL ARRAY value designated by this Array object.

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

Syntax

ResultSet getResultSet()
                       throws SQLException

Return Value

A ResultSet object containing one row for each of the elements in the array designated by this Array object.

The result set contains 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, with the first array element being at index 1.
  • 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 retrieve result set of Array elements>” is returned.