SQLGetConnectAttr

Artigo
01/10/2024

Aplica-se a:SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System)

O driver ODBC SQL Server Native Client define atributos de conexão específicos do driver. Alguns dos atributos estão disponíveis a SQLGetConnectAttr, e a função é usada para informar as configurações atuais. Os valores informados em relação a esses atributos não são garantidos até que uma conexão seja estabelecida ou o atributo seja definido usando SQLSetConnectAttr.

Este tópico lista os atributos somente leitura. Para obter informações sobre as outras SQL Server Native Client atributos de conexão específicos do driver ODBC, consulte SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

O atributo SQL_COPT_SS_CONNECTION_DEAD informa o estado de uma conexão com um servidor. O driver consulta a rede quanto ao estado atual da conexão.

Observação

O atributo de conexão ODBC padrão SQL_ATTR_CONNECTION_DEAD retorna o estado mais recente da conexão. Esse talvez não seja o estado da conexão atual.

Valor	Descrição
SQL_CD_TRUE	A conexão com o servidor foi perdida.
SQL_CD_FALSE	A conexão está aberta e disponível ao processamento de instrução.

SQL_COPT_SS_CLIENT_CONNECTION_ID

O atributo SQL_COPT_SS_CLIENT_CONNECTION_ID recupera a ID de conexão de cliente, que pode ser usada para localizar:

Informações de diagnóstico no log de XEvents, quando habilitado.
As informações de erro de conexão no buffer de anéis de conexão.
As informações de diagnóstico nos logs de rastreamento de acesso a dados, quando habilitado.

Para obter mais informações, consulte Acessando informações de diagnóstico no log de eventos estendidos.

Valor	Descrição
SQL_ERROR	Falha na conexão.
SQL_SUCCESS	A conexão foi bem-sucedida. A ID de conexão de cliente será localizada no buffer de saída.

SQL_COPT_SS_PERF_DATA

O atributo SQL_COPT_SS_PERF_DATA retorna um ponteiro para uma estrutura SQLPERF que contém as estatísticas de desempenho do driver atuais. SQLGetConnectAttr retornará NULL se registro em log do desempenho não for habilitado. As estatísticas na estrutura SQLPERF não são atualizadas dinamicamente pelo driver. Chame SQLGetConnectAttr sempre que as estatísticas de desempenho precisarem ser atualizadas.

Valor	Descrição
NULO	O registro em log de desempenho não está habilitado.
Qualquer outro valor	Um ponteiro para uma estrutura SQLPERF.

SQL_COPT_SS_PERF_QUERY

O atributo SQL_COPT_SS_PERF_QUERY retorna TRUE caso o registro em log das consultas demoradas em execução esteja habilitado. A solicitação retorna FALSE caso registro em log da consulta não esteja ativo.

SQL_COPT_SS_USER_DATA

O atributo SQL_COPT_SS_USER_DATA recupera o ponteiro dos dados de usuário. Os dados de usuário são armazenados na memória do cliente e registrados por conexão. Caso o ponteiro de dados do usuário não seja definido, SQL_UD_NOTSET, um ponteiro NULL, é retornado.

Valor	Descrição
SQL_UD_NOTSET	Nenhum ponteiro de dados do usuário é definido.
Qualquer outro valor	Um ponteiro para os dados do usuário.

Suporte do SQLGetConnectAttr a SPNs (Nomes da Entidade de Serviço)

SQLGetConnectAttr pode ser usado para consultar o valor dos novos atributos de conexão SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption também pode ser usado para consultar esses valores.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD só está disponível para conexões abertas que usam a Autenticação do Windows.

Caso SQL_COPT_SS_SERVER_SPN ou SQL_COPT_SS_FAILOVER_PARTNER não tenha sido definido, será retornado o valor padrão (uma cadeia de caracteres vazia).

Para obter mais informações sobre SPNs, consulte SPNs (Nomes de Entidade de Serviço) em Conexões de Cliente (ODBC).

Consulte Também

Função SQLGetConnectAttr
ODBC API Implementation Details
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)