SQLSetConnectAttr

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

A SQL Server Native Client ODBC drivere figyelmen kívül hagyja a SQL_ATTR_CONNECTION_TIMEOUT beállítását.

SQL_ATTR_TRANSLATE_LIB is figyelmen kívül hagyják; Más fordítási könyvtár megadása nem támogatott. Ahhoz, hogy az alkalmazásokat könnyen átportolják Microsoft ODBC illesztőprogramra SQL Server számára, bármilyen SQL_ATTR_TRANSLATE_LIB-vel beállított értéket bemásolnak és ki a Driver Manager pufferéből.

Az SQL Server Native Client ODBC illesztőgép megismételhető olvasási tranzakciós izolációt valósít meg serializálhatóként.

2005-SQL Server (9.x) bevezette az új tranzakciós izolációs attribútumot, a SQL_COPT_SS_TXN_ISOLATION-t. Ha SQL_COPT_SS_TXN_ISOLATION SQL_TXN_SS_SNAPSHOT-re állítjuk be, az azt jelzi, hogy a tranzakció a snapshot izolációs szint alatt fog megtörténni.

Note

SQL_ATTR_TXN_ISOLATION használható az összes többi izolációs szint beállítására, kivéve SQL_TXN_SS_SNAPSHOT. Ha snapshot izolációt akarsz használni, be kell állítanod SQL_TXN_SS_SNAPSHOT SQL_COPT_SS_TXN_ISOLATION-en. Azonban az izolációs szintet vissza lehet szerezni SQL_ATTR_TXN_ISOLATION vagy SQL_COPT_SS_TXN_ISOLATION használatával.

Az ODBC állítás attribútumainak kapcsolati attribútumokra való előállítása nem kívánt következményekkel járhat. Azok a mondattribútumok, amelyek szerver kurzorokat kérnek eredményhalmaz feldolgozásához, előléptethetők a kapcsolatra. Például, ha az ODBC utasítás attribútumát SQL_ATTR_CONCURRENCY egy olyan értékre állítjuk, amely korlátozóbb az alapértelmezett SQL_CONCUR_READ_ONLY-nál, az illesztőprogramot arra irányítja, hogy dinamikus kurzorokat használjon az összes kapcsolaton beküldött utasításhoz. Egy ODBC katalógusfüggvény végrehajtása egy adott utasításon a kapcsolaton SQL_SUCCESS_WITH_INFO és egy diagnosztikai rekordot ad vissza, amely jelzi, hogy a kurzor viselkedése csak olvashatóvá változott. Egy Transact-SQL SELECT utasítás végrehajtásának kísérlete, amely COMPUTE záradékot tartalmaz ugyanazon a kapcsolaton, sikertelen.

Az SQL Server Native Client ODBC illezőprogram számos illesztő-specifikus kiterjesztést támogat az ODBC kapcsolat attribútumokhoz, amelyeket a sqlncli.h definiált meg. Az SQL Server Native Client ODBC illezőgépe megkövetelheti, hogy az attribútumot a csatlakozás előtt be kell állítani, vagy figyelmen kívül hagyhatja az attribútumot, ha már be van állítva. Az alábbi táblázat a korlátozásokat sorolja fel.

SQL Server attribútum	Beállítás a szerverhez való csatlakozás előtt vagy után
SQL_COPT_SS_ANSI_NPW	Előtte
SQL_COPT_SS_APPLICATION_INTENT	Előtte
SQL_COPT_SS_ATTACHDBFILENAME	Előtte
SQL_COPT_SS_BCP	Előtte
SQL_COPT_SS_BROWSE_CONNECT	Előtte
SQL_COPT_SS_BROWSE_SERVER	Előtte
SQL_COPT_SS_CONCAT_NULL	Előtte
SQL_COPT_SS_CONNECTION_DEAD	Utána
SQL_COPT_SS_ENCRYPT	Előtte
SQL_COPT_SS_ENLIST_IN_DTC	Utána
SQL_COPT_SS_ENLIST_IN_XA	Utána
SQL_COPT_SS_FALLBACK_CONNECT	Előtte
SQL_COPT_SS_FAILOVER_PARTNER	Előtte
SQL_COPT_SS_INTEGRATED_SECURITY	Előtte
SQL_COPT_SS_MARS_ENABLED	Előtte
SQL_COPT_SS_MULTISUBNET_FAILOVER	Előtte
SQL_COPT_SS_OLDPWD	Előtte
SQL_COPT_SS_PERF_DATA	Utána
SQL_COPT_SS_PERF_DATA_LOG	Utána
SQL_COPT_SS_PERF_DATA_LOG_NOW	Utána
SQL_COPT_SS_PERF_QUERY	Utána
SQL_COPT_SS_PERF_LEKÉRDEZÉSI_IDŐKÖZ	Utána
SQL_COPT_SS_PERF_QUERY_LOG	Utána
SQL_COPT_SS_PRESERVE_CURSORS	Előtte
SQL_COPT_SS_QUOTED_IDENT	Bármelyik
SQL_COPT_SS_TRANSLATE	Bármelyik
SQL_COPT_SS_TRUST_SERVER_CERTIFICATE	Előtte
SQL_COPT_SS_TXN_ISOLATION	Bármelyik
SQL_COPT_SS_USE_PROC_FOR_PREP	Bármelyik
SQL_COPT_SS_USER_DATA	Bármelyik
SQL_COPT_SS_WARN_ON_CP_ERROR	Előtte

Egy előcsatlakozási attribútum és az ekviviális Transact-SQL parancs használata ugyanazon az ülésen, adatbázisban vagy SQL Server állapotban váratlan viselkedést eredményezhet. Például,

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 lehetővé teszi vagy letiltja a NULL ISO kezelését összehasonlítások, összekötés, karakteradat-típus kiegészítés, valamint figyelmeztetések esetén. További információért lásd SETSET ANSI_NULLS,SET ANSI_PADDINGSET , SETSET ANSI_WARNINGS, és .SETSET CONCAT_NULL_YIELDS_NULL

Value	Description
SQL_AD_ON	Default. A kapcsolat ANSI alapértelmezett viselkedést használ a NULL összehasonlítások, kitöltések, figyelmeztetések és NULL összekötések kezelésére.
SQL_AD_OFF	A kapcsolat az SQL Server által definiált NULL kezelést, karakter adattípusok kiegészítését és figyelmeztetéseket használja.

Ha a kapcsolat poolinget használod, SQL_COPT_SS_ANSI_NPW a kapcsolati karakterlánc-ben kell beállítani, nem SQLSetConnectAttr-rel. Miután kapcsolatot létrehoztak, bármilyen kísérlet ennek az attribútumnak a megváltoztatására némán kudarcot vall, ha kapcsolat poolinget használnak.

SQL_COPT_SS_APPLICATION_INTENT

Deklarálja az alkalmazás számítási feladatainak típusát a kiszolgálóhoz való csatlakozáskor. Lehetséges értékek a Readonly és a ReadWrite. Például:

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

Az alapértelmezett a ReadWrite. További információért az SQL Server Native Client támogatásáról a Always On elérhetőségi csoportok AG-i számára az SQL Server Native Client Support for High Availability, Disaster Recovery oldalon olvasd.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME megadja egy csatolható adatbázis elsődleges fájljának nevét. Ez az adatbázis csatlakozik, és az alapértelmezett adatbázissá válik a kapcsolathoz. A SQL_COPT_SS_ATTACHDBFILENAME használatához meg kell adnod az adatbázis nevét a kapcsolat attribútumának értékeként SQL_ATTR_CURRENT_CATALOG vagy DATABASE az SQLDriverConnect = paraméterében. Ha az adatbázis korábban csatlakoztatva volt, az SQL Server nem fogja újra csatlakoztatni.

Value	Description
SQLPOINTER egy karakterkarakter stringhez	A string tartalmazza az adatbázis által csatolható elsődleges fájl nevét. Add fel a fájl teljes útnevét.

SQL_COPT_SS_BCP

SQL_COPT_SS_BCP lehetővé teszi a nagy mennyiségű másolási funkciót egy kapcsolaton. További információért lásd: Tömeges másolási függvények.

Value	Description
SQL_BCP_OFF	Default. A kapcsolaton nem elérhetők tömeges másolati funkciók.
SQL_BCP_ON	A kapcsolaton tömeges másolati funkciók is elérhetők.

SQL_COPT_SS_BROWSE_CONNECT

Ez az attribútum az SQLBrowseConnect által visszaadott eredményhalmaz testreszabására szolgál. SQL_COPT_SS_BROWSE_CONNECT lehetővé teszi vagy letiltja a felsorolt SQL Server példányból származó további információk visszaküldését. Ez magában foglalhatja az információkat, például hogy a szerver klaszter-e, különböző példányok nevei és a verziószám.

Value	Leírás
SQL_MORE_INFO_NO	Default. A kiszolgálók listáját adja vissza.
SQL_MORE_INFO_YES	Az SQLBrowseConnect egy kiterjesztett szerver tulajdonságok sorozatot ad vissza.

SQL_COPT_SS_BROWSE_SERVER

Ez az attribútum az SQLBrowseConnect által visszaadott eredményhalmaz testreszabására szolgál. SQL_COPT_SS_BROWSE_SERVER megadja a szerver nevét, amelyhez az SQLBrowseConnect visszaadja az információt.

Value	Leírás
computername	Az SQLBrowseConnect egy listát ad az adott számítógépen található SQL Server példányokról. Dupla visszaperdőlatokat (\\) nem szabad használni a szerver nevéhez (például a \\MyServer helyett a MyServer használatát).
NULL	Default. Az SQLBrowseConnect minden szerverről visszaadja az adatokat a domainben.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL lehetővé teszi vagy letiltja az ISO NULL kezelését a láncok összekapcsolásakor. További információért lásd SET CONCAT_NULL_YIELDS_NULL.

Value	Leírás
SQL_CN_ON	Default. A kapcsolat ISO alapértelmezett viselkedést alkalmaz a NULL értékek kezelésére a stringek összekötésekor.
SQL_CN_OFF	A kapcsolat SQL Server által definiált viselkedést használ a NULL értékek kezelésére a stringek összekapcsolásakor.

SQL_COPT_SS_ENCRYPT

A kapcsolat titkosítását szabályozza.

A titkosítás a szerveren lévő tanúsítványt használja. Ezt egy tanúsító hatóságnak kell ellenőriznie, kivéve, ha a SQL_COPT_SS_TRUST_SERVER_CERTIFICATE kapcsolati attribútumot SQL_TRUST_SERVER_CERTIFICATE_YES-re állították, vagy a kapcsolati karakterlánc tartalmazza a "TrustServerCertificate=yes" (TrustServerCertificate=yes) címet. Ha bármelyik feltétel igaz, a szerver által generált és aláírt tanúsítvány titkosítható a kapcsolat titkosítására, ha nincs tanúsítvány a szerveren.

Value	Leírás
SQL_EN_ON	A kapcsolat titkosított lesz.
SQL_EN_OFF	A kapcsolat nem lesz titkosítva. Ez az alapértelmezett beállítás.

SQL_COPT_SS_ENLIST_IN_DTC

Az ügyfél a Microsoft Distributed Transaction Coordinator (MS DTC) OLE DB ITransactionDispenser::BeginTransaction metódumust hívja, hogy elindítson egy MS DTC tranzakciót, és létrehozza egy MS DTC tranzakció objektumot, amely a tranzakciót képviseli. Az alkalmazás ezután az SQLSetConnectAttr-t hívja SQL_COPT_SS_ENLIST_IN_DTC opcióval, hogy a tranzakciós objektumot az ODBC kapcsolathoz társítsa. Minden kapcsolódó adatbázis-tevékenységet az MS DTC tranzakció védelme alatt végeznek. Az alkalmazás az SQLSetConnectAttr-t hívja SQL_DTC_DONE-vel, hogy véget vezessen a kapcsolat DTC assosiációjának.

Value	Leírás
DTC objektum*	Az MS DTC OLE tranzakció objektum, amely meghatározza az export tranzakciót az SQL Server-re.
SQL_DTC_DONE	Kijelöli a DTC tranzakció végét.

SQL_COPT_SS_ENLIST_IN_XA

Az XA-kompatibilis Transaction Processzorral (TP) indítandó XA tranzakció indításához az ügyfél az Open Group tx_begin funkciót hívja. Az alkalmazás ezután az SQLSetConnectAttr-t hívja egy SQL_COPT_SS_ENLIST_IN_XA TRUE paraméterrel, hogy az XA tranzakciót az ODBC kapcsolathoz társítsa. Minden kapcsolódó adatbázis-tevékenység az XA tranzakció védelme alatt történik. Az ODBC kapcsolattal való XA asszociáció megszüntetéséhez a kliensnek meg kell hívnia az SQLSetConnectAttr-t egy SQL_COPT_SS_ENLIST_IN_XA FALSE paraméterrel. További információért lásd a Microsoft Distributed Transaction Coordinator dokumentációját.

SQL_COPT_SS_FALLBACK_CONNECT

Ez az attribútum már nem támogatott.

SQL_COPT_SS_FAILOVER_PARTNER

Az SQL Server-ben adatbázis tükrözéséhez használt failover partner nevének megadására vagy visszakeresésére használják, és egy null végű karakterlánc, amelyet be kell állítani, mielőtt először csatlakoznának az SQL Server-hez.

A kapcsolat létrehozása után az alkalmazás SQLGetConnectAttr segítségével lekérdezheti ezt az attribútumot, hogy megállapítsa a failover partner identitását. Ha az elsődleges szervernek nincs failover partnere, ez a tulajdonság üres stringet ad vissza. Ez lehetővé teszi, hogy egy okos alkalmazás gyorsgyorsatárban tárolja a legutóbb meghatározott biztonsági mentési szervert, de ezeknek az alkalmazásoknak tudniuk kell, hogy az információk csak a kapcsolat létrejöttekor frissülnek, vagy újraindulnak, ha csoportosítják, és hosszú távú kapcsolatok esetén elavulhat.

További információért lásd: Adatbázis-tükrözés használata.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY kényszeríti Windows hitelesítést a szerver bejelentkezési ellenőrzésére való hozzáférés ellenőrzésére. Amikor Windows hitelesítést használnak, az illesztőprogram figyelmen kívül hagyja a felhasználói azonosítót és jelszóértékeket, amelyeket az SQLConnect, SQLDriverConnect vagy SQLBrowseConnect feldolgozás részeként biztosít.

Value	Leírás
SQL_IS_OFF	Default. Az SQL Server hitelesítést használják a felhasználói azonosító és jelszó hitelesítésére bejelentkezéskor.
SQL_IS_ON	A Windows hitelesítési módot a felhasználó hozzáférési jogainak érvényesítésére használják az SQL Server-hez.

SQL_COPT_SS_MARS_ENABLED

Ez az attribútum lehetővé teszi vagy tiltja le a Több Aktív Eredményhalmazt (MARS). Alapértelmezés szerint a MARS le van tiltva. Ezt az attribútumot be kell állítani, mielőtt csatlakoznál az SQL Server-hez. Miután megnyitják az SQL Server kapcsolatot, a MARS a kapcsolat élettartama alatt engedélyezett vagy letiltott marad.

Value	Leírás
SQL_MARS_ENABLED_NO	Default. A többszörös aktív eredményhalmazok (MARS) le van tiltva.
SQL_MARS_ENABLED_YES	A MARS be van kapcsolva.

További információért a MARS-ról lásd: Több aktív eredményhalmaz (MARS) használata.

SQL_COPT_SS_MULTISUBNET_FAILOVER

Ha az alkalmazásod egy Always On rendelkezésre állási csoportok elérhetőségi csoportjához (AG) csatlakozik különböző alhálózatokon, ez a kapcsolati tulajdonság konfigurálja az SQL Server Native Client-et, hogy gyorsabb felismerést és kapcsolatot biztosítson a (jelenleg) aktív szerverrel. Például:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_MULTISUBNET_FAILOVER, SQL_IS_ON, SQL_IS_INTEGER)  

További információért az SQL Server Native Client támogatásáról a Always On elérhetőségi csoportok AG-i számára az SQL Server Native Client Support for High Availability, Disaster Recovery oldalon olvasd.

Value	Leírás
SQL_IS_ON	Az SQL Server Native Client gyorsabb újracsatlakozást biztosít, ha failover történik.
SQL_IS_OFF	Az SQL Server Native Client nem biztosít gyorsabb újracsatlakozást, ha failover történik.

SQL_COPT_SS_OLDPWD

Az SQL Server hitelesítéshez szükséges jelszó lejárati időszakát az SQL Server 2005 (9.x) verzióban vezették be. A SQL_COPT_SS_OLDPWD attribútumot hozzáadták, hogy a kliens megadhassa a kapcsolathoz mind a régi, mind az új jelszót. Amikor ez a tulajdonság be van állítva, a szolgáltató nem használja a kapcsolati poolt az első vagy a későbbi kapcsolatokhoz, mivel a kapcsolati karakterlánc tartalmazza a most megváltozott "régi jelszót".

További információért lásd: Programozott jelszóváltás.

Value	Leírás
SQL_COPT_SS_OLD_PASSWORD	SQLPOINTER egy karakterláncra, amely tartalmazza a régi jelszót. Ez az érték csak írásra alkalmas, és a szerverhez való csatlakozás előtt be kell állítani.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA elindítja vagy állítja le a teljesítményadatok naplózását. Az adatnapló fájl nevét be kell állítani az adatnaplózás megkezdése előtt. Lásd SQL_COPT_SS_PERF_DATA_LOG lentebb.

Value	Leírás
SQL_PERF_START	Indítja el a meghajtó teljesítményadatait mintavételezés.
SQL_PERF_STOP	Megakadályozza, hogy a számlálók mintavételezést végezzenek teljesítmény adatokkal.

További információért lásd: SQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG hozzárendeli a teljesítményadatok rögzítéséhez használt naplófájl nevét. A naplófájl neve ANSI vagy Unicode, null-terminált string, az alkalmazás fordításától függően. A StringLength érvnek SQL_NTS kell lennie.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW utasítja a drivert, hogy írjon statisztikai naplóbejegyzést a lemezre. A StringLength érvnek SQL_NTS kell lennie.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY elindítja vagy szünteti a naplózást hosszú futós lekérdezésekhez. A lekérdezésnaplófájl nevét meg kell adni a naplózás megkezdése előtt. Az alkalmazás definiálhatja a "hosszú futást" azzal, hogy beállítja a naplózás intervallumát.

Value	Leírás
SQL_PERF_START	Hosszú ideig futtató lekérdezésnaplózást indít.
SQL_PERF_STOP	Megállítja a hosszú ideig futó lekérdezések naplózását.

További információért lásd: SQLGetConnectAttr.

SQL_COPT_SS_PERF_LEKÉRDEZÉSI_IDŐKÖZ

SQL_COPT_SS_PERF_QUERY_INTERVAL ezredmásodpercekben állítja be a lekérdezési naplózási küszöböt. Azok a lekérdezések, amelyek nem oldódnak meg a küszöbön belül, a hosszú ideig futó lekérdezésnapló fájlba kerülnek. Nincs felső korlát a lekérdezési küszöbértéknek. Egy nulla lekérdezési küszöbérték minden lekérdezés naplózását okozza.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG egy naplófájl nevét adja a hosszú futó lekérdezési adatok rögzítéséhez. A naplófájl neve ANSI vagy Unicode, null-terminált string, az alkalmazás fordításától függően. A StringLength érvelés SQL_NTS vagy a string hossza bájtokban kell lenne.

SQL_COPT_SS_PRESERVE_CURSORS

Ez az attribútum lehetővé teszi, hogy lekérdezést kérj és beállítsd, hogy a kapcsolat megőrzi-e a kurzor(okat) a tranzakció megkötésekor/visszatekerésekor. A helyszín vagy SQL_PC_ON, vagy SQL_PC_OFF. Az alapértelmezett érték SQL_PC_OFF. Ez a beállítás szabályozza, hogy az illesztőprogram bezárja-e helyetted a kurzorokat, amikor az SQLEndTran (vagy SQLTransact) hívása alatt áll.

Value	Leírás
SQL_PC_OFF	Default. A kurzorok záródnak, amikor a tranzakciót SQLEndTran segítségével kötelezik vagy visszahúzzák.
SQL_PC_ON	A kurzorok nem záródnak le, amikor a tranzakciót SQLEndTran segítségével kötelezik el vagy visszafordítják, kivéve, ha statikus vagy kulcskészlet kurzort használnak aszinkron módban. Ha visszafordítást adnak ki, miközben a kurzor populációja még nem teljes, akkor a kurzor zárva van.

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT lehetővé teszi az ODBC-ben idézett azonosítókat és a kapcsolaton benyújtott Transact-SQL kijelentéseket. Az idézőjeles azonosítók biztosításával az SQL Server Native Client ODBC driver lehetővé teszi az egyébként érvénytelen objektumneveket, mint például a "My Table", amely egy szóköz karaktert tartalmaz az azonosítóban. További információért lásd SET QUOTED_IDENTIFIER.

Value	Leírás
SQL_QI_OFF	Az SQL Server kapcsolat nem engedélyezi idézett azonosítókat a benyújtott Transact-SQL-ben.
SQL_QI_ON	Default. A kapcsolat lehetővé teszi az idézett azonosítókat a benyújtott Transact-SQL-ben.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE arra készteti az illesztőprogramot, hogy az ügyfél és a szerver kódoldalak között fordítson karaktereket az MBCS adatok cseréje. Az attribútum csak az SQL Server char, varchar és szövegoszlopokban tárolt adatokat érinti.

Value	Leírás
SQL_XL_OFF	Az illesztőprogram nem fordítja le a karaktereket egyik kódlapról a másikra, a kliens és a szerver között cserélt karakteradatokban.
SQL_XL_ON	Default. Az illesztőprogram egyik kódlapról a másikra fordítja a karaktereket a kliens és a szerver között cserélt karakteradatokban. Az illesztőprogram automatikusan konfigurálja a karakterfordítást, meghatározva a szerveren telepített kódoldalt és az ügyfél által használt kódoldalt.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE a meghajtó titkosítás esetén engedélyezi vagy letiltja a tanúsítvány ellenőrzését. Ez az attribútum olvasási/írási érték, de a kapcsolat létrehozása után beállítva nem számít.

Az ügyfélalkalmazások a kapcsolat megnyitása után is lekérdezhetik ezt a tulajdonságot, hogy meghatározzák a tényleges titkosítási és érvényesítési beállításokat.

Value	Leírás
SQL_TRUST_SERVER_CERTIFICATE_NO	Default. A tanúsítvány ellenőrzése nélküli titkosítás nem engedélyezett.
SQL_TRUST_SERVER_CERTIFICATE_YES	A tanúsítvány ellenőrzés nélküli titkosítás engedélyezett.

SQL_COPT_SS_TXN_ISOLATION

SQL_COPT_SS_TXN_ISOLATION beállítja a SQL Server specifikus snapshot izolációs attribútumot. A snapshot izoláció nem állítható be SQL_ATTR_TXN_ISOLATION használatával, mert az érték SQL Server specifikus. Azonban SQL_ATTR_TXN_ISOLATION vagy SQL_COPT_SS_TXN_ISOLATION segítségével is visszaszerezhető.

Value	Leírás
SQL_TXN_SS_SNAPSHOT	Ez azt jelzi, hogy egy tranzakcióból nem látod a változásokat, amelyek más tranzakciókban történtek, és még újralekérdezés közben sem látod a változásokat.

További információért a snapshot izolációról lásd: Working with Snapshot Isolation.

SQL_COPT_SS_USE_PROC_FOR_PREP

Ez az attribútum már nem támogatott.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA beállítja a felhasználói adatmutatót. A felhasználói adatok kliens-tulajdonban lévő memóriák, amelyeket minden kapcsolaton rögzítenek.

További információért lásd: SQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Ez az attribútum határozza meg, hogy kapsz-e figyelmeztetést, ha adatvesztés történik a kódlap-átalakítás során. Ez csak a szerverről érkező adatokra vonatkozik.

Value	Leírás
SQL_WARN_YES	Riasztások generálása, amikor adatvesztés tapasztalható kódlap-konvertálás során.
SQL_WARN_NO	(Alapértelmezett) Ne generáljon figyelmeztetést, ha adatvesztés tapasztalható kódlap-átalakítás során.

SQLSetConnectAttr Szolgáltatásfőnevek (SPN-ek) támogatása

Az SQLSetConnectAttr segítségével beállíthatjuk az új kapcsolati attribútumok értékét, SQL_COPT_SS_SERVER_SPN és SQL_COPT_SS_FAILOVER_PARTNER_SPN. Ezek az attribútumok nem állíthatók be, ha egy kapcsolat nyitva van; ha megpróbálod ezeket az attribútumokat beállítani, amikor egy kapcsolat nyitva van, a HY011 hibát kapod vissza a "Művelet pontatlan jelenleg" üzenettel. (Az SQLSetConnectOption is használható ezeknek az értékeknek a beállítására.)

További információért az SPN-ekről lásd: Szolgáltatásfő nevek (SPN-ek) a Klienskapcsolatok (ODBC) részben.

SQL_COPT_SS_CONNECTION_DEAD

Ez egy csak olvasható attribútum.

További információkért SQL_COPT_SS_CONNECTION_DEAD lásd: SQLGetConnectAttr és Connecting to a Data Source (ODBC).

Example

Ez a példa teljesítményadatokat naplóz.

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

Lásd még

SQLSetConnectAttr függvény
ODBC API implementáció részletei
Tömeges másolati funkciók
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)
SQLPrepare függvény
SQLGetInfo