Alocar um identificador de conexão

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Antes de o aplicativo poder se conectar a uma fonte de dados ou driver, ele deve alocar um identificador de conexão. Isso é feito chamando SQLAllocHandle com o parâmetro HandleType definido como SQL_HANDLE_DBC e InputHandle apontando para um identificador de ambiente inicializado.

As características da conexão são controladas pela definição dos atributos de conexão. Por exemplo, pelo fato de as transações ocorrerem no nível da conexão, o nível de isolamento da transação é um atributo de conexão. De modo semelhante, o tempo limite de logon, ou número de segundos para esperar durante uma tentativa de conexão antes de atingir o tempo limite, é um atributo de conexão.

Os atributos de conexão são definidos com SQLSetConnectAttr e suas configurações atuais são recuperadas com SQLGetConnectAttr. Se SQLSetConnectAttr for chamado antes de uma tentativa de conexão, o Gerenciador de Driver ODBC armazenará os atributos em sua estrutura de conexão e os definirá no driver como parte do processo de conexão. Alguns atributos de conexão devem ser definidos antes da tentativa de conexão do aplicativo; outros podem ser definidos depois de estabelecida a conexão. Por exemplo, SQL_ATTR_ODBC_CURSORS deve ser definido antes de se estabelecer a conexão, mas SQL_ATTR_AUTOCOMMIT pode ser definido após o estabelecimento da conexão.

Às vezes, os aplicativos executados no SQL Server versão 7.0 ou posterior podem melhorar seu desempenho redefinindo o tamanho do pacote de rede TDS (fluxo de dados tabulares). O tamanho de pacote padrão é definido no servidor como 4 KB. Um tamanho de pacote de 4 KB a 8 KB geralmente oferece um desempenho melhor. Se, na prática, constatar-se que o desempenho melhora com um tamanho de pacote diferente, o aplicativo poderá redefinir o tamanho do pacote. Os aplicativos ODBC podem fazer isso antes de se conectarem chamando SQLSetConnectAttr com a opção SQL_ATTR_PACKET_SIZE. Alguns aplicativos apresentam um desempenho melhor com um tamanho de pacote maior, mas, em geral, os aprimoramentos de desempenho são mínimos em se tratando de tamanhos de pacote maiores que 8 KB.

O driver ODBC do SQL Server Native Client tem vários atributos de conexão estendidos que um aplicativo pode usar para aumentar sua funcionalidade. Alguns desses atributos controlam as mesmas opções que podem ser especificadas em fontes de dados e usadas para substituir qualquer opção definida em uma fonte de dados. Por exemplo, se um aplicativo usa identificadores entre aspas, ele pode definir o atributo específico de driver SQL_COPT_SS_QUOTED_IDENT como SQL_QI_ON para garantir que essa opção seja sempre definida independentemente da definição de qualquer fonte de dados.

Confira também

Comunicando-se com o SQL Server (ODBC)