Atributos da declaração

Os atributos da declaração são características da declaração. Por exemplo, se deve usar marcadores e que tipo de cursor utilizar com o conjunto de resultados da declaração são atributos da declaração.

Os atributos das instruções são definidos com SQLSetStmtAttr e as suas definições atuais recuperadas com SQLGetStmtAttr. Não existe qualquer requisito de que uma aplicação defina quaisquer atributos de instrução; Todos os atributos da instrução têm valores predefinidos, alguns dos quais são específicos do driver.

Quando um atributo de instrução pode ser definido depende do próprio atributo. Os atributos da instrução SQL_ATTR_CONCURRENCY, SQL_ATTR_CURSOR_TYPE, SQL_ATTR_SIMULATE_CURSOR e SQL_ATTR_USE_BOOKMARKS devem ser definidos antes de a instrução ser executada. Os atributos das instruções SQL_ATTR_ASYNC_ENABLE e SQL_ATTR_NOSCAN podem ser definidos a qualquer momento, mas não são aplicados até que a instrução seja usada novamente. SQL_ATTR_MAX_LENGTH, SQL_ATTR_MAX_ROWS e SQL_ATTR_QUERY_TIMEOUT atributos das instruções podem ser definidos a qualquer momento, mas depende do driver se são aplicados antes de a instrução ser usada novamente. Os atributos restantes da instrução podem ser definidos a qualquer momento.

Observação

A capacidade de definir atributos de instrução ao nível da ligação chamando SQLSetConnectAttr foi obsoleta no ODBC 3. x. Aplicações ODBC 3.x nunca devem definir atributos de instrução ao nível da ligação. Os drivers ODBC 3.x só necessitam de oferecer esta funcionalidade se tiverem que funcionar com aplicações ODBC 2.x. Para mais informações, consulte o mapeamento SQLSetConnectOption no Apêndice G: Diretrizes de Drivers para Retrocompatibilidade.

Uma exceção a isto são os atributos SQL_ATTR_METADATA_ID e SQL_ATTR_ASYNC_ENABLE, que são ambos atributos de ligação e atributos de instrução e podem ser definidos tanto ao nível da ligação como ao nível da instrução.

Nenhum dos atributos da declaração introduzidos no ODBC 3. x (exceto SQL_ATTR_METADATA_ID) pode ser definido ao nível da ligação.

Para mais informações, consulte a descrição da função SQLSetStmtAttr .