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, por exemplo, se o pool de conexões é 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 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, confira Atributos de conexão.

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

Além dos atributos definidos pelo ODBC, um driver pode definir os próprios atributos de conexão e instrução. Os atributos que o driver define devem ser registrados no Open Group para garantir que dois fornecedores de drivers 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, confira SQLSetEnvAttr, SQLSetConnectAttr e SQLSetStmtAttr. A maioria dos atributos também é descrita na descrição da função ODBC que eles afetam.