SQLSetConnectAttr

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformní systém (PDW)

Ovladač ODBC pro nativní klient SQL Server ignoruje nastavení SQL_ATTR_CONNECTION_TIMEOUT.

SQL_ATTR_TRANSLATE_LIB je také ignorováno; Specifikace jiné překladové knihovny není podporována. Aby bylo možné snadno přenést aplikace na Microsoft ODBC ovladač pro SQL Server, jakákoli hodnota nastavená s SQL_ATTR_TRANSLATE_LIB bude zkopírována do a z bufferu ve Správci ovladačů.

Nativní klientský ODBC ovladač SQL Server implementuje opakovatelnou izolaci transakcí čtení jako serializovatelnou.

SQL Server roce 2005 (9.x) byla zavedena podpora nového atributu pro izolaci transakcí, SQL_COPT_SS_TXN_ISOLATION. Nastavení SQL_COPT_SS_TXN_ISOLATION na SQL_TXN_SS_SNAPSHOT znamená, že transakce proběhne pod úrovní izolace snímku.

Propagace atributů výroku ODBC na atributy spojení může mít nechtěné důsledky. Atributy příkazů, které požadují serverové kurzory pro zpracování výsledků, mohou být povýšeny na spojení. Například nastavení atributu příkazu ODBC SQL_ATTR_CONCURRENCY na hodnotu přísnější než výchozí SQL_CONCUR_READ_ONLY řídí ovladač používat dynamické kurzory pro všechny příkazy zadané na spojení. Spuštění katalogové funkce ODBC na základě příkazu o spojení vrátí SQL_SUCCESS_WITH_INFO a diagnostický záznam, který indikuje, že chování kurzoru bylo změněno na pouze pro čtení. Pokus o spuštění příkazu SELECT Transact-SQL obsahujícího klauzuli COMPUTE na stejném spojení selže.

Nativní klientský ODBC ovladač SQL Server podporuje řadu specifických rozšíření pro ODBC připojení definovaných v sqlncli.h. Nativní klientský ODBC ovladač SQL Server může vyžadovat, aby byl atribut nastaven před připojením, nebo může atribut ignorovat, pokud je již nastaven. Následující tabulka uvádí omezení.

Použití atributu pro předpřipojení a ekvivalentního Transact-SQL příkazu pro stejnou relaci, databázi nebo SQL Server stav může vyvolat neočekávané chování. Příklad:

SQLSetConnectAttr(SQL_COPT_SS_QUOTED_IDENT, SQL_QI_ON) // turn ON via attribute  
SQLDriverConnect(...);  
SQLExecDirect("SET QUOTED_IDENTIFIER OFF") // turn OFF via Transact-SQL  
SQLSetConnectAttr(SQL_ATTR_CURRENT_CATALOG, ...) // restores to pre-connect attribute value  

SQL_COPT_SS_ANSI_NPW

SQL_COPT_SS_ANSI_NPW umožňuje nebo zakazuje použití ISO zpracování NULL při porovnávání a konkatenaci, vycpávání typů znaků a varováních. Pro více informací viz SETSET ANSI_NULLS,SET ANSI_PADDINGSET , ,SET ANSI_WARNINGSSET a .SETSET CONCAT_NULL_YIELDS_NULL

Pokud používáte pooling spojení, mělo by SQL_COPT_SS_ANSI_NPW nastaveno v připojovací řetězec, ne v SQLSetConnectAttr. Po navázání spojení jakýkoli pokus o změnu tohoto atributu při použití poolingu spojení tiše selže.

SQL_COPT_SS_APPLICATION_INTENT

Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou pouze pro čtení a ReadWrite. Příklad:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_APPLICATION_INTENT, TEXT("Readonly"), SQL_NTS)  

Výchozí je ReadWrite. Pro více informací o podpoře skupiny Always On Availability Group ze strany SQL Server Native klienta viz SQL Server Native Client Support for High Availability, Disaster Recovery.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME specifikuje název primárního souboru připojitelné databáze. Tato databáze je připojena a stává se výchozí databází pro připojení. Pro použití SQL_COPT_SS_ATTACHDBFILENAME musíte zadat název databáze jako hodnotu atributu spojení SQL_ATTR_CURRENT_CATALOG nebo v parametru DATABASE = v SQLDriverConnect. Pokud byla databáze dříve připojena, SQL Server ji znovu nepřipojí.

SQL_COPT_SS_BCP

SQL_COPT_SS_BCP umožňuje hromadné kopírovaní na spojení. Pro více informací viz Funkce hromadného kopírovaní.

SQL_COPT_SS_BROWSE_CONNECT

Tento atribut se používá k přizpůsobení sady výsledků vrácené pomocí SQLBrowseConnect. SQL_COPT_SS_BROWSE_CONNECT umožňuje nebo zakáže návrat dalších informací z enumerované instance SQL Server. To může zahrnovat informace jako zda je server cluster, názvy různých instancí a číslo verze.

SQL_COPT_SS_BROWSE_SERVER

Tento atribut se používá k přizpůsobení sady výsledků vrácené pomocí SQLBrowseConnect. SQL_COPT_SS_BROWSE_SERVER specifikuje název serveru, pro který SQLBrowseConnect vrací informace.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL umožňuje nebo zakazuje použití ISO zpracování NULL při spojování řetězců. Další informace najdete na webu SET CONCAT_NULL_YIELDS_NULL.

SQL_COPT_SS_ENCRYPT

Řídí šifrování připojení.

Šifrování využívá certifikát na serveru. To musí ověřit certifikační autorita, pokud není atribut spojení SQL_COPT_SS_TRUST_SERVER_CERTIFICATE nastaven na SQL_TRUST_SERVER_CERTIFICATE_YES nebo připojovací řetězec neobsahuje "TrustServerCertificate=yes". Pokud je splněna některá z těchto podmínek, může být k zašifrování spojení použit certifikát vytvořený a podepsaný serverem, pokud na serveru není žádný certifikát.

SQL_COPT_SS_ENLIST_IN_DTC

Klient volá metodu služba MS DTC (Microsoft Distributed Transaction Coordinator) (MS DTC) OLE DB ITransactionDispenser::BeginTransaction k zahájení transakce MS DTC a vytvoření transakčního objektu MS DTC, který transakci reprezentuje. Aplikace poté volá SQLSetConnectAttr s možností SQL_COPT_SS_ENLIST_IN_DTC přiřazení transakčního objektu k připojení ODBC. Veškerá související databázová aktivita bude prováděna pod ochranou transakce MS DTC. Aplikace volá SQLSetConnectAttr s SQL_DTC_DONE ukončí DTC asociaci spojení.

SQL_COPT_SS_ENLIST_IN_XA

Pro zahájení XA transakce s XA-kompatibilním Transaction Processorem (TP) klient volá funkci Open Group tx_begin . Aplikace pak volá SQLSetConnectAttr s parametrem SQL_COPT_SS_ENLIST_IN_XA TRUE, aby přiřadila XA transakci k ODBC spojení. Veškerá související databázová aktivita bude prováděna pod ochranou transakce XA. Pro ukončení XA asociace s ODBC spojením musí klient zavolat SQLSetConnectAttr s parametrem SQL_COPT_SS_ENLIST_IN_XA FALSE. Pro více informací viz dokumentace služba MS DTC (Microsoft Distributed Transaction Coordinator).

SQL_COPT_SS_FALLBACK_CONNECT

Tento atribut již není podporován.

SQL_COPT_SS_FAILOVER_PARTNER

Používá se ke specifikaci nebo získání názvu failover partnera používaného pro zrcadlení databází v SQL Server a je to řetězec znaků ukončený null, který musí být nastaven před prvním připojením ke SQL Server.

Po navázání spojení může aplikace dotazovat tento atribut pomocí SQLGetConnectAttr a určit identitu failover partnera. Pokud primární server nemá partnera pro failover, tato vlastnost vrátí prázdný řetězec. To umožňuje chytré aplikaci uložit do mezipaměti nejnověji určený záložní server, ale takové aplikace by měly vědět, že informace se aktualizují pouze při navázání spojení, nebo při obnovení, pokud je spojení do poolu, a mohou zastarat pro dlouhodobá spojení.

Pro více informací viz Používání zrcadlení databází.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY nutí používat Windows autentizaci pro ověření přístupu při přihlášení na server. Při použití Windows Authentication ovladač ignoruje uživatelské identifikátory a hesla poskytnuté v rámci zpracování SQLConnect, SQLDriverConnect nebo SQLBrowseConnect.

SQL_COPT_SS_MARS_ENABLED

Tento atribut umožňuje nebo deaktivuje více aktivních sad výsledků (MARS). Ve výchozím nastavení je MARS vypnutý. Tento atribut by měl být nastaven před připojením ke SQL Server. Jakmile je SQL Server otevřen spojení, MARS zůstane po celou dobu trvání spojení povolen nebo vypnutý.

Pro více informací o MARS viz Použití více aktivních výsledkových sad (MARS).

SQL_COPT_SS_MULTISUBNET_FAILOVER

Pokud se vaše aplikace připojuje ke skupině dostupnosti Always On (AG) na různých podsítích, tato vlastnost připojení konfiguruje SQL Server Native Client tak, aby poskytovala rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Příklad:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_MULTISUBNET_FAILOVER, SQL_IS_ON, SQL_IS_INTEGER)  

Pro více informací o podpoře skupiny Always On Availability Group ze strany SQL Server Native klienta viz SQL Server Native Client Support for High Availability, Disaster Recovery.

SQL_COPT_SS_OLDPWD

Vypršení platnosti hesla pro autentizaci SQL Server bylo zavedeno v SQL Server 2005 (9.x). Atribut SQL_COPT_SS_OLDPWD byl přidán, aby klient mohl zadat jak staré, tak nové heslo pro připojení. Když je tato vlastnost nastavena, poskytovatel nepoužije connection pool pro první spojení ani pro další spojení, protože připojovací řetězec bude obsahovat "staré heslo", které se nyní změnilo.

Pro více informací viz Programová změna hesel.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA spouští nebo zastavuje záznamy výkonových dat. Název souboru datového logu musí být nastaven před zahájením datového logování. Viz SQL_COPT_SS_PERF_DATA_LOG níže.

Pro více informací viz SQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG přiřazuje název logu používanému k zaznamenávání výkonových dat. Název logu je ANSI nebo Unicode, s null-termined řetězcem v závislosti na kompilaci aplikace. Argument StringLength by měl být SQL_NTS.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW instruuje ovladač, aby zapsal statistiku na disk. Argument StringLength by měl být SQL_NTS.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY spouští nebo ukončuje logování u dlouho běžících dotazů. Název souboru dotazovacího logu musí být zadán před zahájením logování. Aplikace může definovat "dlouhý běh" nastavením intervalu pro logování.

Pro více informací viz SQLGetConnectAttr.

SQL_COPT_SS_PERF_QUERY_INTERVAL

SQL_COPT_SS_PERF_QUERY_INTERVAL nastavuje práh pro logování dotazů v milisekundách. Dotazy, které nejsou vyřešeny v rámci prahu, jsou zaznamenány v dlouhotrvajícím souboru dotazovacího záznamu. Neexistuje horní hranice prahu dotazu. Hodnota prahu dotazu nula způsobuje logování všech dotazů.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG přiřazuje název logu pro zaznamenávání dlouho běžících dotazovacích dat. Název logu je ANSI nebo Unicode, s null-termined řetězcem v závislosti na kompilaci aplikace. Argument StringLength by měl být SQL_NTS nebo délka řetězce v bajtech.

SQL_COPT_SS_PRESERVE_CURSORS

Tento atribut vám umožňuje dotazovat a nastavit, zda spojení zachová kurzor při commitu/rollbacku transakce. Děj je buď SQL_PC_ON, nebo SQL_PC_OFF. Výchozí hodnota je SQL_PC_OFF. Toto nastavení ovlivní, zda ovladač zavře kurzor za vás, když voláte SQLEndTran (nebo SQLTransact).

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT umožňuje citované identifikátory v ODBC a Transact-SQL výkazy zadané na spojení. Poskytnutím citovaných identifikátorů umožňuje nativní klientský ODBC ovladač SQL Server používat jinak neplatné názvy objektů, jako je "My Table", které obsahují mezeru v identifikátoru. Další informace najdete na webu SET QUOTED_IDENTIFIER.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE způsobuje, že ovladač překládá znaky mezi klientskou a serverovou kódovou stránkou při výměně MBCS dat. Tento atribut ovlivňuje pouze data uložená v SQL Serverchar, varchar a textových sloupcích.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE způsobí, že ovladač při použití šifrování povolí nebo zakáže validaci certifikátu. Tento atribut je hodnota pro čtení/zápis, ale nastavení po navázání spojení nemá žádný efekt.

Klientské aplikace mohou tuto vlastnost dotazovat po otevření připojení, aby zjistily skutečná pravidla šifrování a validace, která se používají.

SQL_COPT_SS_TXN_ISOLATION

SQL_COPT_SS_TXN_ISOLATION nastavuje SQL Server specifický atribut izolace snímku. Izolaci snímků nelze nastavit pomocí SQL_ATTR_TXN_ISOLATION, protože hodnota je SQL Server specifická. Nicméně lze jej získat buď pomocí SQL_ATTR_TXN_ISOLATION, nebo SQL_COPT_SS_TXN_ISOLATION.

Pro více informací o izolaci snímků viz Práce s izolací snímků.

SQL_COPT_SS_USE_PROC_FOR_PREP

Tento atribut již není podporován.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA nastavuje ukazatel uživatelských dat. Uživatelská data jsou paměť vlastněná klientem, zaznamenaná na každé připojení.

Pro více informací viz SQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Tento atribut určuje, zda dostanete varování, pokud dojde ke ztrátě dat během konverze kódové stránky. To platí pouze pro data přicházející ze serveru.

SQLSetConnectAttr Podpora pro názvy hlavních služeb (SPN)

SQLSetConnectAttr lze použít k nastavení hodnoty nových atributů spojení SQL_COPT_SS_SERVER_SPN a SQL_COPT_SS_FAILOVER_PARTNER_SPN. Tyto atributy nelze nastavit, když je spojení otevřené; pokud se pokusíte nastavit tyto atributy při otevřeném spojení, chyba HY011 se zobrazí zprávou "Operace v tomto okamžiku neplatná". (SQLSetConnectOption lze také použít k nastavení těchto hodnot.)

Pro více informací o SPN viz Názvy principálů služeb (SPN) v Client Connections (ODBC).

SQL_COPT_SS_CONNECTION_DEAD

Jedná se o atribut pouze pro čtení.

Pro více informací o SQL_COPT_SS_CONNECTION_DEAD viz SQLGetConnectAttr a Connecting to a Data Source (ODBC).

Example

Tento příklad zaznamenává výkonnostní data.

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

Viz také

SQLSetConnectAttr – funkce
Podrobnosti implementace rozhraní ODBC API
Hromadné kopírovací funkce
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
SET CONCAT_NULL_YIELDS_NULL (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
Funkce SQLPrepare
Sqlgetinfo