Atributos de ambiente, conexão e instrução

O ODBC define vários atributos associados a ambientes, conexões ou instruções.

Os atributos de ambiente afetam todo o ambiente, como se o pool de conexões está habilitado. Os atributos de ambiente são definidos com SQLSetEnvAttr e recuperados com SQLGetEnvAttr.

Os atributos de conexão afetam cada conexão individualmente, como por quanto tempo um driver deve esperar ao tentar se conectar a uma fonte de dados antes de atingir o tempo limite. Os atributos de conexão são definidos com SQLSetConnectAttr e recuperados com SQLGetConnectAttr. Para obter mais informações sobre atributos de conexão, consulte Atributos de Conexão.

Atributos de instrução afetam cada instrução individualmente, como se uma instrução deve ser executada de forma assíncrona. Os atributos de instrução são definidos com SQLSetStmtAttr e recuperados com SQLGetStmtAttr. Alguns atributos de declaração são somente leitura e não podem ser definidos. Por exemplo, o atributo da instrução SQL_ATTR_ROW_NUMBER, que é usado para recuperar o número da linha atual no cursor, é de somente leitura. Para obter mais informações sobre atributos da instrução, consulte Atributos da Instrução.

Além dos atributos definidos pelo ODBC, um driver pode definir seus próprios atributos de conexão e instrução. Os atributos definidos pelo driver devem ser registrados no Open Group para garantir que dois fornecedores de driver não atribuam o mesmo valor inteiro a atributos proprietários diferentes. Confira Tipos de dados específicos do driver, tipos de descritor, tipos de informações, tipos de diagnóstico e atributos para obter mais informações.

Para obter uma lista completa de atributos, consulte SQLSetEnvAttr, SQLSetConnectAttr e SQLSetStmtAttr. A maioria dos atributos também é descrita na descrição da função ODBC que eles afetam.