Example: Query a 2-D ARRAY Data Type and Table using ONEXT

Teradata Vantageā„¢ Data Types and Literals

brand
Software
Teradata Vantage
prodname
Teradata Database
Teradata Vantage NewSQL Engine
vrm_release
16.20
category
Programming Reference
featnum
B035-1143-162K

Consider the following 2-D ARRAY data type and table.

CREATE TYPE shot_ary AS VARRAY(1:50)(1:50) OF INTEGER;
CREATE TABLE seismic_table (
   id INTEGER,
   shots shot_ary);

The table is populated with the following values:

/* The first 2 elements are populated; the rest are uninitialized. */
INSERT INTO seismic_table VALUES (1, shot_ary(11, 12));
/* Empty ARRAY instance */
INSERT INTO seismic_table VALUES (2, shot_ary());
/* Update empty ARRAY instance such that element [1][3] is set to a value; Then elements [1][1] and [1][2] are set to NULL, the rest are uninitialized */
UPDATE seismic_table
SET shots[1][3] = 1133
WHERE id = 2;

The following query returns the subscript of the element subsequent to element [1][2] in the shots array.

SELECT id, shots.ONEXT(NEW arrayVec(1, 2))
FROM seismic_table;

The following is the result of the query.

ID          shots.ONEXT(NEW arrayVec(1, 2))
--          -------------------------------
 1           ?     (The element following element [1][2] is unpopulated)
 2           NEW arrayVec(1,3)

The following is the same query using function-style syntax.

SELECT id, ONEXT(shots, NEW arrayVec(1, 2))
FROM seismic_table;