SQLSetConnectAttr

SQL_COPT_SS_ANSI_NPW

SQL_COPT_SS_ANSI_NPW abilita o disabilita l'utilizzo della gestione ISO di valori NULL nei confronti e nella concatenazione, nella spaziatura dei tipi di dati character e negli avvisi. Per ulteriori informazioni, vedere SET ANSI_NULLS, SET ANSI_PADDING, SET ANSI_WARNINGS e SET CONCAT_NULL_YIELDS_NULL.

Se si utilizza un pool di connessioni, SQL_COPT_SS_ANSI_NPW deve essere impostato nella stringa di connessione anziché con SQLSetConnectAttr. Una volta stabilita una connessione, qualsiasi tentativo di modifica di questo attributo avrà esito negativo senza generare alcun avviso quando si utilizza un pool di connessioni.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME specifica il nome del file primario di un database collegabile. Questo database viene collegato e diventa il database predefinito per la connessione. Per utilizzare SQL_COPT_SS_ATTACHDBFILENAME, è necessario specificare il nome del database come valore dell'attributo di connessione SQL_ATTR_CURRENT_CATALOG o nel parametro DATABASE = di una funzione SQLDriverConnect. Se il database è stato collegato in precedenza, non viene ricollegato in SQL Server.

SQL_COPT_SS_BCP

SQL_COPT_SS_BCP consente funzioni di copia bulk in una connessione. Per ulteriori informazioni, vedere Funzioni di copia bulk.

SQL_COPT_SS_BROWSE_CONNECT

Questo attributo viene utilizzato per personalizzare il set di risultati restituito da SQLBrowseConnect. SQL_COPT_SS_BROWSE_CONNECT abilita o disabilita la restituzione di informazioni aggiuntive da un'istanza enumerata di SQL Server. Tali informazioni possono includere l'indicazione che il server è o non è un cluster, i nomi di diverse istanze e il numero di versione.

SQL_COPT_SS_BROWSE_SERVER

Questo attributo viene utilizzato per personalizzare il set di risultati restituito da SQLBrowseConnect. SQL_COPT_SS_BROWSE_SERVER specifica il nome del server per cui SQLBrowseConnect restituisce le informazioni.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL abilita o disabilita l'utilizzo della gestione ISO di valori NULL per il concatenamento delle stringhe. Per ulteriori informazioni, vedere SET CONCAT_NULL_YIELDS_NULL.

SQL_COPT_SS_ENCRYPT

Controlla la crittografia per una connessione.

Per la crittografia viene utilizzato il certificato del server. Tale certificato deve essere verificato da un autorità di certificazione, a meno che l'attributo di connessione SQL_COPT_SS_TRUST_SERVER_CERTIFICATE venga impostato su SQL_TRUST_SERVER_CERTIFICATE_YES o la stringa di connessione contenga "TrustServerCertificate=yes". Se si verifica una di queste condizioni, un certificato generato e firmato dal server può essere utilizzato per crittografare la connessione se nel server non è presente alcun certificato.

SQL_COPT_SS_ENLIST_IN_DTC

Il client chiama il metodo OLE DB ITransactionDispenser::BeginTransaction di Microsoft Distributed Transaction Coordinator (MS DTC) per iniziare una transazione MS DTC e creare un oggetto transazione MS DTC che rappresenta la transazione. L'applicazione chiama quindi SQLSetConnectAttr con l'opzione SQL_COPT_SS_ENLIST_IN_DTC per associare l'oggetto transazione alla connessione ODBC. Tutte le attività del database correlate verranno eseguite sotto la protezione della transazione MS DTC. L'applicazione chiama SQLSetConnectAttr con SQL_DTC_DONE per terminare l'associazione DTC della connessione. Per ulteriori informazioni, vedere Transazioni distribuite MS DTC.

SQL_COPT_SS_ENLIST_IN_XA

Per iniziare una transazione XA con un processore di transazioni conforme a XA, il client chiama la funzione Open Group tx_begin. L'applicazione chiama quindi SQLSetConnectAttr con un parametro SQL_COPT_SS_ENLIST_IN_DTC impostato su TRUE per associare la transazione XA alla connessione ODBC. Tutte le attività del database correlate verranno eseguite sotto la protezione della transazione XA. Per terminare un'associazione XA con una connessione ODBC, il client deve chiamare SQLSetConnectAttr con un parametro SQL_COPT_SS_ENLIST_IN_XA impostato su FALSE. Per ulteriori informazioni, vedere la documentazione di Microsoft Distributed Transaction Coordinator.

SQL_COPT_SS_FALLBACK_CONNECT

Questo attributo non è più supportato perché SQL Server Native Client non supporta la connessione a SQL Server 6.5.

SQL_COPT_SS_FAILOVER_PARTNER

Consente di specificare o recuperare il nome del partner di failover utilizzato per il mirroring del database in SQL Server. Si tratta di una stringa di caratteri con terminazione Null che deve essere impostata prima dell'esecuzione iniziale della connessione a SQL Server.

Una volta stabilita la connessione, l'applicazione può eseguire una query su questo attributo utilizzando SQLGetConnectAttr per determinare l'identità del partner di failover. Se il server primario non dispone di partner di failover, la proprietà restituirà una stringa vuota. In questo modo, un'applicazione smart può memorizzare nella cache il server di backup determinato più di recente, benché con tali applicazioni sia necessario tenere conto del fatto che le informazioni vengono aggiornate solo quando la connessione viene stabilita per la prima volta (o reimpostata, se in pool) e possono diventare obsolete nel caso di connessioni prolungate.

Per ulteriori informazioni, vedere Utilizzo del mirroring del database.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY forza l'utilizzo dell'autenticazione di Windows per la convalida dell'accesso in fase di connessione al server. Quando viene utilizzata l'autenticazione di Windows, il driver ignora i valori di ID utente e password forniti come parte dell'elaborazione di SQLConnect, SQLDriverConnect o SQLBrowseConnect.

SQL_COPT_SS_MARS_ENABLED

Questo attributo abilita o disabilita MARS (Multiple Active Result Set). Per impostazione predefinita, MARS è disabilitato. Questo attributo deve essere impostato prima di stabilire una connessione a SQL Server. Una volta aperta la connessione a SQL Server, il servizio MARS rimarrà abilitato o disabilitato per tutta la durata della connessione.

Per ulteriori informazioni su MARS, vedere Utilizzo di MARS (Multiple Active Result Set).

SQL_COPT_SS_OLDPWD

In SQL Server 2005 è stata introdotta la scadenza della password per l'autenticazione di SQL Server. L'attributo SQL_COPT_SS_OLDPWD è stato aggiunto per consentire al client di fornire sia la vecchia password che la nuova per la connessione. Quando questa proprietà è impostata, il provider non utilizzerà il pool di connessioni per la prima connessione o per le connessioni successive, in quanto la stringa di connessione conterrà la password precedente che è stata modificata.

Per ulteriori informazioni, vedere Modifica delle password a livello di programmazione.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA avvia o interrompe la registrazione dei dati relativi alle prestazioni. Il nome del file di log deve essere impostato prima di avviare la registrazione dei dati. Vedere SQL_COPT_SS_PERF_DATA_LOG di seguito.

Per ulteriori informazioni, vedere SQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG assegna il nome del file di log utilizzato per registrare i dati relativi alle prestazioni. Il nome del file di log è una stringa ANSI o Unicode con terminazione Null che dipende dalla compilazione dell'applicazione. L'argomento StringLength deve essere SQL_NTS.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW indica al driver di scrivere una voce del log delle statistiche sul disco. L'argomento StringLength deve essere SQL_NTS.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY avvia o interrompe la registrazione delle query con esecuzione prolungata. Il nome del file di log delle query deve essere specificato prima di avviare la registrazione. L'applicazione può definire l'esecuzione prolungata impostando l'intervallo per la registrazione.

Per ulteriori informazioni, vedere SQLGetConnectAttr.

SQL_COPT_SS_PERF_QUERY_INTERVAL

SQL_COPT_SS_PERF_QUERY_INTERVAL imposta la soglia di registrazione delle query in millisecondi. Le query che non vengono risolte entro la soglia vengono registrate nel file di log delle query con esecuzione prolungata. Non sussiste alcun limite per la soglia massima di query. Un valore di soglia pari a zero comporta la registrazione di tutte le query.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG assegna il nome di un file di log per la registrazione dei dati delle query con esecuzione prolungata. Il nome del file di log è una stringa ANSI o Unicode con terminazione Null che dipende dalla compilazione dell'applicazione. L'argomento StringLength deve essere SQL_NTS.

SQL_COPT_SS_PRESERVE_CURSORS

Questo attributo consente di eseguire query per determinare se la connessione manterrà i cursori durante il commit o il rollback di una transazione e di impostare o meno tale comportamento. L'impostazione è SQL_PC_ON o SQL_PC_OFF. Il valore predefinito è SQL_PC_OFF. Questa impostazione determina se il driver chiuderà o meno i cursori quando si chiama SQLEndTran (o SQLTransact).

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT consente la presenza di identificatori tra virgolette in istruzioni ODBC e Transact-SQL eseguite nella connessione. Tramite l'immissione di identificatori tra virgolette, il driver ODBC di SQL Server Native Client consente la presenza di nomi di oggetto altrimenti non validi, ad esempio "Tabella personale", che contengono un carattere di spazio nell'identificatore. Per ulteriori informazioni, vedere SET QUOTED_IDENTIFIER.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE fa in modo che il driver converta caratteri tra le tabelle codici del client e del server durante lo scambio di dati MBCS. L'attributo influisce solo su dati archiviati nelle colonne char, varchar e text di SQL Server.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE fa in modo che il driver abiliti o disabiliti la convalida del certificato quando si utilizza la crittografia. Questo attributo è un valore di lettura/scrittura, ma non ha alcun effetto se lo si imposta una volta stabilita una connessione.

Le applicazioni client possono eseguire query su questa proprietà dopo l'apertura di una connessione per determinare le effettive impostazioni di crittografia e convalida in uso.

SQL_COPT_SS_TXN_ISOLATION

SQL_COPT_SS_TXN_ISOLATION imposta l'attributo di isolamento dello snapshot specifico di SQL Server. Non è possibile impostare l'isolamento dello snapshot utilizzando SQL_ATTR_TXN_ISOLATION, in quanto il valore è specifico di SQL Server. Tale valore può tuttavia essere recuperato utilizzando SQL_ATTR_TXN_ISOLATION o SQL_COPT_SS_TXN_ISOLATION.

Per ulteriori informazioni sull'isolamento dello snapshot, vedere Utilizzo dell'isolamento dello snapshot.

SQL_COPT_SS_USE_PROC_FOR_PREP

Questo attributo non è più supportato perché SQL Server Native Client non supporta la connessione a SQL Server 6.5.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA imposta il puntatore ai dati dell'utente. I dati dell'utente vengono registrati nella memoria di proprietà del client per ogni connessione.

Per ulteriori informazioni, vedere SQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Quando questo attributo è impostato su SQL_WARN_YES, viene visualizzato un avviso che indica una perdita di dati durante la conversione di una tabella codici. Si applica solo ai dati provenienti dal server.

SQL_WARN_NOdisabilita l'avviso.

Supporto di SQLSetConnectAttr per nomi SPN (Service Principal Name)

SQLSetConnectAttr può essere utilizzato per impostare il valore dei nuovi attributi di connessione SQL_COPT_SS_SERVER_SPN e SQL_COPT_SS_FAILOVER_PARTNER_SPN. Tali attributi non possono essere impostati quando una connessione è aperta; se si tenta di impostare questi attributi quando una connessione è aperta, viene restituito l'errore HY011 con il messaggio "Operazione correntemente non valida". Per impostare questi valori è possibile utilizzare anche SQLSetConnectOption.

Per ulteriori informazioni sui nomi SPN, vedere Nomi SPN (Service Principal Name) nelle connessioni client (ODBC).

SQL_COPT_SS_CONNECTION_DEAD

Attributo di sola lettura.

Per ulteriori informazioni su SQL_COPT_SS_CONNECTION_DEAD, vedere SQLGetConnectAttr e Connessione a un'origine dati (ODBC).

Esempio

In questo esempio vengono registrati i dati relativi alle prestazioni.

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...

Cronologia modifiche

Vedere anche

Riferimento

Concetti

Altre risorse