Row Objects

A row object retrieved from a ResultSet contains the columns specified in the select list of a query. Each row object retrieved from a ResultSet must be closed when it is no longer needed. A row object contains the methods to find out the data type of each of its columns, whether a column has a value, and the methods to retrieve a column's value by its data type.

The label of a column in the select list is used to access the data for each column. The columns of a row are accessed by using the label specified for the column in the select list using ActiveSpaces. For example,

SELECT col1 AS myname FROM table1
where myname is used as the column label.

If a label was not specified for a column in the select list, the column's name from the table is used as the label. For example,

SELECT col1 FROM table1
where col1 is used as the column label.

If a label was not specified and the column of the select list is an expression, the expression string is used as the label. For example,

SELECT col1, date('now') FROM table1 WHERE col1 <= 10
where the expression string, date('now'), is used as the column label.

When a label is specified for a column, or the column is an expression, the label or expression must be used exactly as it was specified in the original query string and is case-sensitive. If a label was not specified for a column and the column is from the table, the label is not case-sensitive.

Related concepts