SQLSetConnectAttr

SQL_COPT_SS_ANSI_NPW

SQL_COPT_SS_ANSI_NPW habilita ou desabilita o uso de manuseio ISO de NULL em comparações e concatenação, preenchimento do tipo de dados caractere e advertências. Para obter mais informações, consulte SET ANSI_NULLS, SET ANSI_PADDING, SET ANSI_WARNINGS e SET CONCAT_NULL_YIELDS_NULL.

Se você usar pool de conexões, SQL_COPT_SS_ANSI_NPW deverá ser definido na cadeia de conexão, em vez de usar SQLSetConnectAttr. Depois que uma conexão for feita, qualquer tentativa para alterar este atributo falhará em modo silencioso quando o pool de conexões for usado.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME especifica o nome do arquivo primário de um banco de dados anexável. Esse banco de dados é anexado e torna-se o banco de dados padrão da conexão. Para usar SQL_COPT_SS_ATTACHDBFILENAME, você deve especificar o nome do banco de dados como valor do atributo de conexão SQL_ATTR_CURRENT_CATALOG ou no parâmetro DATABASE = de um SQLDriverConnect. Se o banco de dados tiver sido anexado previamente, SQL Server não o anexará novamente.

SQL_COPT_SS_BCP

SQL_COPT_SS_BCP habilita funções de cópia em massa em uma conexão. Para obter mais informações, consulte Funções de cópia em massa.

SQL_COPT_SS_BROWSE_CONNECT

Este atributo é usado para personalizar o conjunto de resultados retornado por SQLBrowseConnect. SQL_COPT_SS_BROWSE_CONNECT habilita ou desabilita o retorno de informações adicionais de uma instância enumerada de SQL Server. Isto pode incluir informações como se o servidor é um cluster, nomes de instâncias diferentes e o número de versão.

SQL_COPT_SS_BROWSE_SERVER

Este atributo é usado para personalizar o conjunto de resultados retornado por SQLBrowseConnect. SQL_COPT_SS_BROWSE_SERVER especifica o nome do servidor cujas informações SQLBrowseConnect passa como retorno.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL habilita ou desabilita o uso de manuseio ISO de NULL ao concatenar cadeias. Para obter mais informações, consulte SET CONCAT_NULL_YIELDS_NULL.

SQL_COPT_SS_ENCRYPT

Controla a criptografia de uma conexão.

A criptografia usa o certificado no servidor. Isto deve ser verificado por uma autoridade de certificação, a menos que o atributo da conexão SQL_COPT_SS_TRUST_SERVER_CERTIFICATE seja definido como SQL_TRUST_SERVER_CERTIFICATE_YES ou a cadeia de conexão contenha "TrustServerCertificate=yes". Se qualquer uma destas condições for verdadeira, um certificado gerado e assinado pelo servidor poderá ser usado para criptografar a conexão se não houver nenhum certificado no servidor.

SQL_COPT_SS_ENLIST_IN_DTC

O cliente chama o método ITransactionDispenser::BeginTransaction do OLE DB do MS DTC (Coordenador de Transações Distribuídas da Microsoft): para iniciar uma transação do MS DTC e criar um objeto de transação do MS DTC que representa a transação. Em seguida, o aplicativo chama SQLSetConnectAttr com a opção de SQL_COPT_SS_ENLIST_IN_DTC para associar o objeto de transação com a conexão ODBC. Todas as atividades de banco de dados relacionadas serão executadas sob a proteção da transação do MS DTC. O aplicativo chama SQLSetConnectAttr com SQL_DTC_DONE para encerrar a associação de DTC da conexão. Para obter mais informações, consulte Transações distribuídas MS DTC.

SQL_COPT_SS_ENLIST_IN_XA

Para iniciar uma transação XA com um TP (Processador de Transações) compatível com XA, o cliente chama a função tx_begin do Open Group. Em seguida, o aplicativo chama SQLSetConnectAttr com um parâmetro SQL_COPT_SS_ENLIST_IN_XA com valor TRUE para associar a transação XA com a conexão ODBC. Todas as atividades de banco de dados relacionadas serão executadas sob a proteção da transação XA. Para encerrar uma associação de XA com uma conexão ODBC, o cliente deve chamar SQLSetConnectAttr com um parâmetro SQL_COPT_SS_ENLIST_IN_XA com valor FALSE. Para obter mais informações, consulte a documentação do MS DTC.

SQL_COPT_SS_FALLBACK_CONNECT

Não é mais dado suporte a este atributo porque o SQL Server Native Client não dá suporte à conexão ao SQL Server 6.5.

SQL_COPT_SS_FAILOVER_PARTNER

Usado para especificar ou recuperar o nome do parceiro de failover usado para espelhamento de banco de dados no SQL Server. É uma cadeia de caracteres com terminação null que deve ser definida antes que a conexão ao SQL Server seja feita inicialmente.

Depois de fazer a conexão, o aplicativo pode consultar este atributo usando SQLGetConnectAttr para determinar a identidade do parceiro de failover. Se o servidor primário não tiver nenhum parceiro de failover, esta propriedade retornará uma cadeia de caracteres vazia. Isto permite que um aplicativo inteligente armazene em cache o servidor de backup determinado mais recentemente, mas tais aplicativos devem estar cientes de que as informações serão atualizadas somente depois que a conexão for estabelecida ou redefinida, se estiver em pool, e poderão ficar desatualizadas em conexões de longo prazo.

Para obter mais informações, consulte Usando o espelhamento de banco de dados.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY força o uso da autenticação do Windows para validação de acesso no logon do servidor. Quando a autenticação de Windows é usada, o driver ignora os valores do identificador de usuário e da senha fornecidos como parte do processamento de SQLConnect, SQLDriverConnect ou SQLBrowseConnect.

SQL_COPT_SS_MARS_ENABLED

Este atributo habilita ou desabilita MARS (Vários Conjuntos de Resultados Ativos). Por padrão, MARS está desabilitado. Este atributo deve ser definido antes de fazer uma conexão com SQL Server. Depois que a conexão com SQL Server é aberta, o MARS permanecerá habilitado ou desabilitado durante toda a duração da conexão.

Para obter mais informações sobre MARS, consulte Usando MARS (vários conjuntos de resultados ativos).

SQL_COPT_SS_OLDPWD

A expiração de senha para Autenticação do SQL Server foi introduzida no SQL Server 2005. O atributo SQL_COPT_SS_OLDPWD foi adicionado para permitir que o cliente forneça tanto a senha antiga quanto a nova para a conexão. Quando esta propriedade está definida, o provedor não usará o pool de conexões para a primeira conexão, nem para as conexões seguintes, visto que a cadeia de conexão irá conter a “senha antiga”, que agora mudou.

Para obter mais informações, consulte Alterando senhas programaticamente.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA inicia ou pára log de dados de desempenho. O nome do arquivo de log de dados deve ser definido antes de iniciar o log de dados. Consulte SQL_COPT_SS_PERF_DATA_LOG, a seguir.

Para obter mais informações, consulte SQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG atribui o nome do arquivo de log usado para registrar dados de desempenho. O nome de arquivo de log é uma cadeia de caracteres ANSI ou Unicode terminada por null, dependendo da compilação do aplicativo. O argumento StringLength deve ser SQL_NTS.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW instrui o driver a gravar uma entrada de log de estatística em disco. O argumento StringLength deve ser SQL_NTS.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY inicia ou pára de gerar logs para consultas de longa execução. O nome do arquivo de log da consulta deve ser fornecido antes de iniciar a geração de log. O aplicativo pode definir o que é “longa execução” definindo o intervalo para geração de log.

Para obter mais informações, consulte SQLGetConnectAttr.

SQL_COPT_SS_PERF_QUERY_INTERVAL

SQL_COPT_SS_PERF_QUERY_INTERVAL define o limite de log de consultas em milissegundos. Consultas que não são resolvidas dentro do limite são registradas no arquivo de log de consultas de longa execução. Não há nenhum limite superior para o limite de consulta. Um valor de limite de consulta igual a zero faz todas as consultas serem registradas no log.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG atribui o nome de um arquivo de log para registrar dados de consultas de longa execução. O nome de arquivo de log é uma cadeia de caracteres ANSI ou Unicode terminada por null, dependendo da compilação do aplicativo. O argumento StringLength deve ser SQL_NTS.

SQL_COPT_SS_PRESERVE_CURSORS

Este atributo permite consultar e definir se a conexão preservará o(s) cursor(es) quando você confirmar/reverter uma transação. A configuração é SQL_PC_ON ou SQL_PC_OFF. O valor padrão é SQL_PC_OFF. Esta configuração controla se o driver fechará o(s) cursor(es) para você quando você chamar SQLEndTran (ou SQLTransact).

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT permite identificadores entre aspas em instruções de ODBC e Transact-SQL enviadas na conexão. Fornecendo identificadores entre aspas, o driver ODBC do SQL Server Native Client permite nomes de objetos que seriam inválidos de outras formas, como "My Table", que contém um caractere de espaço no identificador. Para obter mais informações, consulte SET QUOTED_IDENTIFIER.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE faz o driver traduzir caracteres entre as páginas de código de cliente e de servidor à medida que os dados de MBCS são trocados. O atributo afeta somente dados armazenados em colunas char, varchar e de text do SQL Server.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE faz o driver habilitar ou desabilitar a validação de certificado ao usar criptografia. Este atributo é um valor de leitura/gravação, mas defini-lo depois que uma conexão é estabelecida não tem nenhum efeito.

Aplicativos cliente podem consultar esta propriedade depois que uma conexão foi aberta para determinar as configurações efetivas de criptografia e validação em uso.

SQL_COPT_SS_TXN_ISOLATION

SQL_COPT_SS_TXN_ISOLATION define o atributo de isolamento de instantâneo específico do SQL Server. O isolamento de instantâneo não pode ser definido usando SQL_ATTR_TXN_ISOLATION porque o valor é específico do SQL Server. Entretanto, ele pode ser recuperado usando SQL_ATTR_TXN_ISOLATION ou SQL_COPT_SS_TXN_ISOLATION.

Para obter mais informações sobre isolamento de instantâneo, consulte Trabalhando com isolamento de instantâneo.

SQL_COPT_SS_USE_PROC_FOR_PREP

Não é mais dado suporte a este atributo porque o SQL Server Native Client não dá suporte à conexão ao SQL Server 6.5.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA define o ponteiro de dados do usuário. Os dados do usuário são uma memória de propriedade do cliente registrada para cada conexão.

Para obter mais informações, consulte SQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Quando este atributo está definido como SQL_WARN_YES, você será advertido se houver uma perda de dados durante uma conversão de página de código. Isto se aplica somente a dados que vêm do servidor.

O SQL_WARN_NO desabilita o aviso.

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

O SQLSetConnectAttr pode ser usado para definir o valor dos novos atributos de conexão SQL_COPT_SS_SERVER_SPN e SQL_COPT_SS_FAILOVER_PARTNER_SPN. Estes atributos não podem ser definidos quando uma conexão estiver aberta; se você tentar definir estes atributos quando uma conexão estiver aberta, o erro HY011 será passado como retorno, com a mensagem "Operação inválida neste momento". (SQLSetConnectOption também pode ser usado para definir estes valores).

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

SQL_COPT_SS_CONNECTION_DEAD

Este é um atributo somente leitura.

Para obter mais informações sobre SQL_COPT_SS_CONNECTION_DEAD, consulte SQLGetConnectAttr e Conectando-se a uma fonte de dados (ODBC).

Exemplo

Este exemplo faz o log de dados de desempenho.

SQLPERF*     pSQLPERF;
SQLINTEGER   nValue;

// See if you are already logging. SQLPERF* will be NULL if not.
SQLGetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA, &pSQLPERF,
    sizeof(SQLPERF*), &nValue);

if (pSQLPERF == NULL)
    {
    // Set the performance log file name.
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG,
        (SQLPOINTER) "\\My LogDirectory\\MyServerLog.txt", SQL_NTS);

    // Start logging...
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,
        (SQLPOINTER) SQL_PERF_START, SQL_IS_INTEGER);
    }
else
    {
    // Take a snapshot now so that your performance statistics are discernible.
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);
    }

    // ...perform some action...

// ...take a performance data snapshot...
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);

    // ...perform more actions...

// ...take another snapshot...
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);

// ...and disable logging.
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,
    (SQLPOINTER) SQL_PERF_STOP, SQL_IS_INTEGER);

// Continue on...

Histórico de alterações

Consulte também

Referência

Conceitos

Outros recursos