Atributos de conexão

Atributos de conexão são características da conexão. Por exemplo, como as transações ocorrem no nível da conexão, o nível de isolamento da transação é um atributo de conexão. Da mesma forma, o tempo limite de logon ou o número de segundos a aguardar ao tentar se conectar antes do tempo limite é um atributo de conexão.

Os atributos de conexão são definidos com SQLSetConnectAttr e suas configurações atuais recuperadas com SQLGetConnectAttr. Se SQLSetConnectAttr for chamado antes do driver ser carregado, o Gerenciador de Driver armazenará os atributos em sua estrutura de conexão e os definirá no driver como parte do processo de conexão. Não há nenhum requisito de que um aplicativo defina atributos de conexão; todos os atributos de conexão têm padrões, alguns dos quais são específicos do driver.

Um atributo de conexão pode ser definido antes ou depois da conexão, ou seja, dependendo do atributo e do driver. O tempo limite de logon (SQL_ATTR_LOGIN_TIMEOUT) se aplica ao processo de conexão e é eficaz somente se definido antes de se conectar. Os atributos que especificam o uso da biblioteca de cursores ODBC (SQL_ATTR_ODBC_CURSORS) e o tamanho do pacote da rede (SQL_ATTR_PACKET_SIZE) devem ser definidos antes da conexão, pois a biblioteca de cursores ODBC reside entre o Gerenciador de Driver e o driver e, portanto, ela deve ser carregada antes do driver.

Os atributos para especificar se uma fonte de dados é somente leitura ou leitura/gravação (SQL_ATTR_ACCESS_MODE) e o catálogo atual (SQL_ATTR_CURRENT_CATALOG) podem ser definidos antes ou depois de se conectar, dependendo do driver. No entanto, aplicativos interoperáveis os definem antes de se conectarem porque alguns drivers não dão suporte a alterá-los após a conexão.

Alguns atributos de conexão têm um padrão antes da conexão ser feita, enquanto outros não. Aqueles que fazem isso são SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE e SQL_ATTR_TRACEFILE.

Os atributos de conexão de tradução (SQL_ATTR_TRANSLATE_DLL e SQL_ATTR_TRANSLATE_OPTION) devem ser definidos após a conexão.

Todos os outros atributos de conexão podem ser definidos a qualquer momento. Para obter mais informações, consulte a descrição da função SQLSetConnectAttr . (Os atributos de conexão não podem ser definidos no nível do ambiente por uma chamada para SQLSetEnvAttr.)