The following table lists the connection attributes and their associated values.
Connection Attributes | ValuePtr Contents |
---|---|
SQL_ATTR_TDATA_HOST_ID | An SQLUINTEGER value in which the logical host ID for the session is returned. |
SQL_ATTR_TDATA_SESSION_NUMBER | An SQLUINTEGER value in which the logical session number is returned. |
SQL_ATTR_TDATA_SESSION_CHARSET | A null-terminated character string containing the name of the session character set is returned. |
SQL_ATTR_AGKR | An SQLUINTEGER value that determines the result from requests that insert into identity columns (INSERT, INSERT ... SELECT, UPSERT, MERGE-INTO). These requests can optionally return a result set containing identity column values (also known as auto-generated keys) for the inserted rows. Values supported are as follows:
The acronym AGKR is defined as Auto-Generated Key Retrieval. This attribute can be set to SQL_AGKR_NO(0), SQL_AGKR_IDENTITY_COLUMN(1), or SQL_AGKR_WHOLE_ROW(2), meaning respectively that no keys are retrieved, only the identity column is retrieved, or the whole row is retrieved by ODBC Driver for Teradata after an insertion into a table containing an identity column. An error is returned if the application tries to enable the auto-generated key retrieval and the database does not support the feature. The error returned is SQL_ERROR with SQLSTATE HY024 and the message is: Invalid attribute value. |