Атрибуты заявления

Атрибуты инструкции — это характеристики инструкции. Например, следует ли использовать закладки и какой тип курсора использовать с результирующим набором инструкции, являются атрибутами инструкции.

Атрибуты инструкции задаются с помощью SQLSetStmtAttr и их текущих параметров, полученных с помощью SQLGetStmtAttr. Не требуется, чтобы приложение установило какие-либо атрибуты инструкции; Все атрибуты инструкции имеют значения по умолчанию, некоторые из которых относятся к драйверу.

Возможность установки атрибута инструкции зависит от самого атрибута. Перед выполнением инструкции необходимо задать атрибуты SQL_ATTR_CONCURRENCY, SQL_ATTR_CURSOR_TYPE, SQL_ATTR_SIMULATE_CURSOR и SQL_ATTR_USE_BOOKMARKS инструкции. Атрибуты инструкции SQL_ATTR_ASYNC_ENABLE и SQL_ATTR_NOSCAN можно задать в любое время, но не применяются, пока инструкция не будет использоваться снова. Атрибуты выражений SQL_ATTR_MAX_LENGTH, SQL_ATTR_MAX_ROWS и SQL_ATTR_QUERY_TIMEOUT можно устанавливать в любое время, но применение их до повторного использования выражения зависит от драйвера. Остальные атрибуты инструкции можно задать в любое время.

Замечание

Возможность задавать атрибуты инструкции на уровне подключения путем вызова SQLSetConnectAttr устарела в ODBC 3. x. ODBC 3. Приложения x никогда не должны задавать атрибуты инструкции на уровне подключения. ODBC 3.x драйверы должны поддерживать эту функцию только в том случае, если они должны работать с ODBC 2.x приложениями. Дополнительные сведения см. в разделе «Сопоставление SQLSetConnectOption» в приложении G: Рекомендации по драйверам для обратной совместимости.

Исключением из этого является SQL_ATTR_METADATA_ID и SQL_ATTR_ASYNC_ENABLE атрибуты, которые являются атрибутами подключения и атрибутами инструкции и могут быть заданы на уровне подключения или на уровне инструкции.

Ни один из атрибутов инструкции, введенных в ODBC 3.x (за исключением SQL_ATTR_METADATA_ID), нельзя задать на уровне подключения.

Дополнительные сведения см. в описании функции SQLSetStmtAttr .