DSN ve Bağlantı Dizesi Anahtar Sözcükleri ve Öznitelikleri

Bu sayfada bağlantı dizeleri ve DSN'ler için anahtar sözcükler ile SQL Server için ODBC Sürücüsü'nde bulunan SQLSetConnectAttr ve SQLGetConnectAttr için bağlantı öznitelikleri listelenir.

Desteklenen DSN/Bağlantı Dizesi Anahtar Sözcükleri ve Bağlantı Öznitelikleri

Aşağıdaki tabloda her platform için kullanılabilir anahtar sözcükler ve öznitelikler listeılmaktadır (L: Linux; M: macOS; W: Windows). Daha fazla ayrıntı için anahtar sözcüğü veya özniteliği seçin.

DSN / Bağlantı Dizesi Anahtar Sözcüğü	Bağlantı Özniteliği	Platform
Adresi		LMW
Adres		LMW
AnsiNPW	SQL_COPT_SS_ANSI_NPW	LMW
APP		LMW
ApplicationIntent	SQL_COPT_SS_APPLICATION_INTENT	LMW
AttachDBFileName	SQL_COPT_SS_ATTACHDBFILENAME	LMW
Kimlik Doğrulaması	SQL_COPT_SS_AUTHENTICATION	LMW
Otomatik Çeviri	SQL_COPT_SS_TRANSLATE	LMW
ClientCertificate		LMW
İstemci Anahtarı		LMW
ColumnEncryption	SQL_COPT_SS_COLUMN_ENCRYPTION	LMW
ConnectRetryCount	SQL_COPT_SS_CONNECT_RETRY_COUNT	LMW
ConnectRetryInterval	SQL_COPT_SS_CONNECT_RETRY_INTERVAL	LMW
Veritabanı	SQL_ATTR_CURRENT_CATALOG	LMW
Açıklama		LMW
Sürücü		LMW
DSN		LMW
Şifrelemek	SQL_COPT_SS_ENCRYPT	LMW
Failover_Partner	SQL_COPT_SS_FAILOVER_PARTNER	W
FailoverPartnerSPN	SQL_COPT_SS_FAILOVER_PARTNER_SPN	W
FileDSN		LMW
GetDataExtensions (v18.0+)	SQL_COPT_SS_GETDATA_EXTENSIONS	LMW
HostnameInCertificate (v18.0+)		LMW
IpAddressPreference (v18.1+)		LMW
KeepAlive (v17.4+; DSN yalnızca 17.8'in öncesinde)		LMW
KeepAliveInterval (v17.4+; DSN yalnızca 17.8'in öncesinde)		LMW
KeystoreAuthentication		LMW
KeystorePrincipalId		LMW
KeystoreSecret		LMW
Language		LMW
LongAsMax (v18.0+)	SQL_COPT_SS_LONGASMAX	LMW
MARS_Connection	SQL_COPT_SS_MARS_ENABLED	LMW
MultiSubnetFailover	SQL_COPT_SS_MULTISUBNET_FAILOVER	LMW
Net		LMW
Network		LMW
PWD		LMW
QueryLog_On	SQL_COPT_SS_PERF_QUERY	W
QueryLogFile	SQL_COPT_SS_PERF_QUERY_LOG	W
QueryLogTIme	SQL_COPT_SS_PERF_QUERY_INTERVAL	W
QuotedId	SQL_COPT_SS_QUOTED_IDENT	LMW
Bölgesel		LMW
Replication		LMW
RetryExec (18.1+)		LMW
SaveFile		LMW
Sunucu		LMW
ServerCertificate (v18.1+)		LMW
ServerSPN	SQL_COPT_SS_SERVER_SPN	LMW
StatsLog_On	SQL_COPT_SS_PERF_DATA	W
StatsLogFile	SQL_COPT_SS_PERF_DATA_LOG	W
TransparentNetworkIPResolution	SQL_COPT_SS_TNIR	LMW
Trusted_Connection	SQL_COPT_SS_INTEGRATED_SECURITY	LMW
TrustServerCertificate	SQL_COPT_SS_TRUST_SERVER_CERTIFICATE	LMW
UID		LMW
UseFMTONLY		LMW
WSID		LMW
	SQL_ATTR_ACCESS_MODE (SQL_ACCESS_MODE)	LMW
	SQL_ATTR_ASYNC_DBC_EVENT	W
	SQL_ATTR_ASYNC_DBC_FUNCTIONS_ENABLE	W
	SQL_ATTR_ASYNC_DBC_PCALLBACK	W
	SQL_ATTR_ASYNC_DBC_PCONTEXT	W
	SQL_ATTR_ASYNC_ENABLE	W
	SQL_ATTR_AUTO_IPD	LMW
	SQL_ATTR_AUTOCOMMIT (SQL_AUTOCOMMIT)	LMW
	SQL_ATTR_CONNECTION_DEAD	LMW
	SQL_ATTR_CONNECTION_TIMEOUT	LMW
	SQL_ATTR_DBC_INFO_TOKEN	LMW
	SQL_ATTR_LOGIN_TIMEOUT (SQL_LOGIN_TIMEOUT)	LMW
	SQL_ATTR_METADATA_ID	LMW
	SQL_ATTR_ODBC_CURSORS (SQL_ODBC_CURSORS)	LMW
	SQL_ATTR_PACKET_SIZE (SQL_PACKET_SIZE)	LMW
	SQL_ATTR_QUIET_MODE (SQL_QUIET_MODE)	LMW
	SQL_ATTR_RESET_CONNECTION (SQL_COPT_SS_RESET_CONNECTION)	LMW
	SQL_ATTR_TRACE (SQL_OPT_TRACE)	LMW
	SQL_ATTR_TRACEFILE (SQL_OPT_TRACEFILE)	LMW
	SQL_ATTR_TRANSLATE_LIB (SQL_TRANSLATE_DLL)	LMW
	SQL_ATTR_TRANSLATE_OPTION (SQL_TRANSLATE_OPTION)	LMW
	SQL_ATTR_TXN_ISOLATION (SQL_TXN_ISOLATION)	LMW
	SQL_COPT_SS_ACCESS_TOKEN	LMW
	SQL_COPT_SS_ANSI_OEM	W
	SQL_COPT_SS_AUTOBEGINTXN	LMW
	SQL_COPT_SS_BCP	LMW
	SQL_COPT_SS_BROWSE_CACHE_DATA	LMW
	SQL_COPT_SS_BROWSE_CONNECT	LMW
	SQL_COPT_SS_BROWSE_SERVER	LMW
	SQL_COPT_SS_CEKEYSTOREDATA	LMW
	SQL_COPT_SS_CEKEYSTOREPROVIDER	LMW
	SQL_COPT_SS_CLIENT_CONNECTION_ID	LMW
	SQL_COPT_SS_CONCAT_NULL	LMW
	SQL_COPT_SS_CONNECTION_DEAD	LMW
	SQL_COPT_SS_DATACLASSIFICATION_VERSION (v17.4.2+)	LMW
	SQL_COPT_SS_ENLIST_IN_DTC	W
	SQL_COPT_SS_ENLIST_IN_XA	LMW
	SQL_COPT_SS_FALLBACK_CONNECT	LMW
	SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD	LMW
	SQL_COPT_SS_MUTUALLY_AUTHENTICATED	LMW
	SQL_COPT_SS_OLDPWD	LMW
	SQL_COPT_SS_PERF_DATA_LOG_NOW	W
	SQL_COPT_SS_PRESERVE_CURSORS	LMW
	SQL_COPT_SS_SPID (v17.5+)	LMW
	SQL_COPT_SS_TXN_ISOLATION	LMW
	SQL_COPT_SS_USER_DATA	LMW
	SQL_COPT_SS_WARN_ON_CP_ERROR	LMW

Sql Server Native Client, SQLSetConnectAttr ve SQLSetConnectAttr İşleviile Bağlantı Dizesi Anahtar Sözcüklerini Kullanma bölümünde belgelenmemiş bazı bağlantı dizesi anahtar sözcükleri ve bağlantı öznitelikleri aşağıdadır.

Description

Veri kaynağını açıklamak için kullanılır.

SQL_COPT_SS_ANSI_OEM

ANSI'yi OEM'e veri dönüştürmeyi denetler.

Öznitelik değeri	Description
SQL_AO_OFF	(Varsayılan) Çeviri yapılmaz.
SQL_AO_ON	Çeviri tamamlandı.

SQL_COPT_SS_AUTOBEGINTXN

Sürüm 17.6+ Otomatik komut kapalıyken, ROLLBACK veya COMMIT sonrasında otomatik BEGIN TRANSACTION'i denetler.

Öznitelik değeri	Description
SQL_AUTOBEGINTXN_ON	(Varsayılan) GERI ALMA veya İŞLEME işleminden sonra otomatik BEGIN TRANSACTION.
SQL_AUTOBEGINTXN_OFF	GERI ALMA veya İŞLEME işleminden sonra otomatik BEGIN TRANSACTION yok.

SQL_COPT_SS_FALLBACK_CONNECT

SQL Server Geri Dönüş Bağlantılarının kullanımını denetler. Bu artık desteklenmiyor.

Öznitelik değeri	Description
SQL_FB_OFF	(Varsayılan) Geri dönüş bağlantıları devre dışı bırakıldı.
SQL_FB_ON	Geri dönüş bağlantıları etkinleştirilir.

Yeni Bağlantı Dizesi Anahtar Sözcükleri ve Bağlantı Öznitelikleri

Kimlik Doğrulaması - SQL_COPT_SS_AUTHENTICATION

SQL Server'a bağlanırken kullanılacak kimlik doğrulama modunu ayarlar. Daha fazla bilgi için bkz. Microsoft Entra Id kullanma.

Anahtar Sözcük Değeri	Öznitelik değeri	Description
	SQL_AU_NONE	(Varsayılan) Ayarlanmadı. Diğer özniteliklerin birleşimi kimlik doğrulama modunu belirler.
SqlPassword	SQL_AU_PASSWORD	Kullanıcı adı ve parola ile SQL Server kimlik doğrulaması.
ActiveDirectoryIntegrated	SQL_AU_AD_INTEGRATED	Microsoft Entra tümleşik kimlik doğrulaması.
ActiveDirectoryPassword	SQL_AU_AD_PASSWORD	Microsoft Entra parola kimlik doğrulaması.
ActiveDirectoryInteractive	SQL_AU_AD_INTERACTIVE	Microsoft Entra Interactive kimlik doğrulaması.
ActiveDirectoryMsi	SQL_AU_AD_MSI	Microsoft Entra yönetilen kimlik kimlik doğrulaması. Kullanıcı tarafından atanan kimlik için UID, kullanıcı kimliğinin nesne kimliğine ayarlanır.
ActiveDirectoryServicePrincipal	SQL_AU_AD_SPA	Microsoft Entra hizmet sorumlusu kimlik doğrulaması. UID, hizmet sorumlusunun istemci kimliğine ayarlanır. PWD, istemci gizli dizisine ayarlanır.
	SQL_AU_RESET	Unset. Herhangi bir DSN veya bağlantı dizesi ayarını geçersiz kılar.

Uyarı

Anahtar sözcük veya öznitelik kullanırken Authentication , bağlantı dizesinde / DSN / bağlantı özniteliğinde istenen değere ayarı açıkça belirtin Encrypt . Ayrıntılar için SQL Server Yerel İstemcisi ile Bağlantı Dizesi Anahtar Sözcüklerini Kullanma konusuna bakın.

ColumnEncryption - SQL_COPT_SS_COLUMN_ENCRYPTION

Saydam sütun şifrelemeyi (Always Encrypted) denetler. Daha fazla bilgi için bkz . Always Encrypted (ODBC) kullanma.

Anahtar Sözcük Değeri	Öznitelik değeri	Description
Etkinleştirildi	SQL_CE_ENABLED	Always Encrypted'i etkinleştirir.
Disabled	SQL_CE_DISABLED	(Varsayılan) Always Encrypted'ı devre dışı bırakır.
	SQL_CE_RESULTSETONLY	Yalnızca şifre çözmeyi etkinleştirir (sonuçlar ve dönüş değerleri).

Şifrelemek

Bağlantıların ağ üzerinden TLS şifrelemesi kullanıp kullanmadığını belirtir. Olası değerler şunlardıryes/mandatory: (18.0+),optionalno/ (18.0+) ve strict(18.0+). Varsayılan değer 18.0+ sürümünde ve no önceki sürümlerdediryes.

ayarından Encryptbağımsız olarak, sunucu oturum açma kimlik bilgileri (kullanıcı adı ve parola) her zaman şifrelenir.

Encrypt, TrustServerCertificateve sunucu tarafı Force Encryption ayarları, bağlantıların ağ üzerinden şifrelenip şifrelenmediği konusunda bir rol oynar. Aşağıdaki tablolarda bu ayarların etkisi gösterilmektedir.

ODBC Sürücüsü 18 ve daha yenisi

Ayarı Şifrele	Sunucu Sertifikasına Güven	Sunucu Zorlamalı Şifreleme	Sonuç
Hayı	Hayı	Hayı	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenmez.
Hayı	Yes	Hayı	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenmez.
Yes	Hayı	Hayı	Sunucu sertifikası denetlenir. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Yes	Yes	Hayı	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Hayı	Hayı	Yes	Sunucu sertifikası denetlenir. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Hayı	Yes	Yes	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Yes	Hayı	Yes	Sunucu sertifikası denetlenir. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Yes	Yes	Yes	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Sıkı	-	-	TrustServerCertificate yoksayılır. Sunucu sertifikası denetlenir. İstemci ve sunucu arasında gönderilen veriler şifrelenir.

Uyarı

Strict yalnızca TDS 8.0 bağlantılarını destekleyen sunucularda kullanılabilir.

ODBC Sürücüsü 17 ve üzeri

Ayarı Şifrele	Sunucu Sertifikasına Güven	Sunucu Zorlamalı Şifreleme	Sonuç
Hayı	Hayı	Hayı	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenmez.
Hayı	Yes	Hayı	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenmez.
Yes	Hayı	Hayı	Sunucu sertifikası denetlenir. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Yes	Yes	Hayı	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Hayı	Hayı	Yes	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Hayı	Yes	Yes	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Yes	Hayı	Yes	Sunucu sertifikası denetlenir. İstemci ve sunucu arasında gönderilen veriler şifrelenir.
Yes	Yes	Yes	Sunucu sertifikası denetlenmiyor. İstemci ve sunucu arasında gönderilen veriler şifrelenir.

TransparentNetworkIPResolution - SQL_COPT_SS_TNIR

Daha hızlı yeniden bağlanma girişimlerine izin vermek için MultiSubnetFailover ile etkileşim kuran Saydam Ağ IP Çözümleme özelliğini denetler. Daha fazla bilgi için bkz. Saydam Ağ IP Çözümlemesini Kullanma.

Anahtar Sözcük Değeri	Öznitelik değeri	Description
Etkinleştirildi	SQL_IS_ON	(Varsayılan) Saydam Ağ IP Çözümlemesini etkinleştirir.
Disabled	SQL_IS_OFF	Saydam Ağ IP Çözümlemesini devre dışı bırakır.

UseFMTONLY

SQL Server 2012 ve daha yeni sürümlere bağlanırken meta veriler için SET FMTONLY kullanımını denetler.

Anahtar Sözcük Değeri	Description
Hayı	(Varsayılan) Varsa meta veriler için sp_describe_first_result_set kullanın.
Yes	Meta veriler için SET FMTONLY kullanın.

Replication

ODBC Sürücüsü sürüm 17.8 ve daha yeni sürümlerde çoğaltma oturum açma işleminin kullanımını belirtir.

Anahtar Sözcük Değeri	Description
Hayı	(Varsayılan) Çoğaltma oturum açma bilgileri kullanılmaz.
Yes	Seçeneği olan NOT FOR REPLICATION tetikleyiciler bağlantıda tetiklenmiyor.

RetryExec

Yapılandırılabilir yeniden deneme mantığı sürüm 18.1'den itibaren kullanılabilir. Yapılandırılabilir koşullara göre belirli ODBC işlev çağrılarını otomatik olarak yeniden yürütür. Bu özellik, yeniden deneme kurallarının listesiyle birlikte RetryExec anahtar sözcüğü kullanılarak bağlantı dizesi aracılığıyla etkinleştirilebilir. Her yeniden deneme kuralının üç iki nokta üst üste ayrılmış bileşeni vardır: hata eşleşmesi, yeniden deneme ilkesi ve sorgu eşleşmesi.

Sorgu eşleşmesi, belirli bir yürütme için kullanılacak yeniden deneme kuralını belirler ve gelen komut metni (SQLExecDirect) veya deyimi nesnesindeki (SQLExecute) hazırlanmış komut metniyle eşleşir. Birden fazla kural eşleşiyorsa, listedeki ilk eşleşen kural kullanılır. Bu davranış, genelliği artırmak için kuralların listelenmesine olanak tanır. Hiçbir kural eşleşmiyorsa, yeniden deneme uygulanmaz.

Yürütme bir hatayla sonuçlandığında ve geçerli bir yeniden deneme kuralı olduğunda, yürütmenin yeniden denenip denenmemesi gerektiğini belirlemek için hata eşleşmesi kullanılır.

RetryExec anahtar sözcüğün değeri noktalı virgülle ayrılmış yeniden deneme kurallarının listesidir.
RetryExec={rule1;rule2}

Yeniden deneme kuralı aşağıdaki gibidir: <errormatch>:<retrypolicy>:<querymatch>

Hata Eşleşmesi: Hata kodlarının virgülle ayrılmış listesi. Örneğin, yeniden denemek istediğiniz hata kodları 1000.2000 belirtilebilir.

Yeniden Deneme İlkesi: Sonraki yeniden denemeye kadar olan gecikmeyi belirtir. İlk parametre, yeniden deneme sayısı, ikinci parametre ise gecikme olacaktır. Örneğin, 3,10+7, 10'dan başlayarak 3 deneme olur ve aşağıdaki her yeniden deneme 7 saniye artar. +7 belirtilmezse, aşağıdaki her yeniden deneme üstel olarak ikiye katlanır.

Sorgu Eşleşmesi: Eşleştirmek istediğiniz sorguyu belirtir. Hiçbir şey belirtilmezse tüm sorgular için geçerli olur. SELECT belirtilmesi, select ile başlayan tüm sorgular için anlamına gelir.

Yukarıdaki üç bileşenin de bir bağlantı dizesinde kullanılacak şekilde birleştirilmesi şu şekilde olabilir:

RetryExec={1000,2000:3,10+7:SELECT}

Bu da şu anlama gelir: "SELECT ile başlayan bir sorguda 1000 ve 2000 hataları için. İlk gecikme süresi 10 saniye ve sonraki her deneme için 7 saniye ekleyerek iki kez yeniden deneyin"

Examples

40501,40540:4,5

40501 ve 40540 hataları için, başlangıç gecikmesi 5 saniye ve her yeniden deneme arasında üstel iki katına çıkararak en fazla dört kez yeniden deneyin. Bu kural tüm sorgular için geçerlidir.

49919:2,10+:CREATE

CREATE ile başlayan bir sorguda 49919 hatası için, başlangıçta 10 saniye ve ardından 20 saniye sonra en fazla iki kez yeniden deneyin.

49918,40501,10928:5,10+5:SELECT c1

SELECT c1 ile başlayan sorgularda 49918, 40501 ve 10928 hataları için beş kereye kadar yeniden deneyin, ilk yeniden denemede 10 saniye bekleyin ve ardından beklemeyi 5 saniye artırın.

Yukarıdaki üç kural, bağlantı dizesinde aşağıdaki gibi birlikte belirtilebilir:

RetryExec={49918,40501,10928:5,10+5:SELECT c1;49919:2,10+:CREATE;40501,40540:4,5}

En genel (tümünü eşleştir) kuralı, önce iki özel kuralın kendi sorgularıyla eşleşmesine izin vermek için sona yerleştirilir.

Müşteri Sertifikası

Geri döngü bağlantıları ile kimlik doğrulaması için kullanılacak sertifikayı belirtir (yalnızca Linux üzerinde SQL Server'da kullanılabilir). Seçenekler şunlardır:

Seçenek Değeri	Description
sha1:<hash_value>	ODBC sürücüsü, Windows Sertifika Deposu'ndaki bir sertifikayı bulmak için SHA1 karması kullanır
subject:<subject>	ODBC sürücüsü, Windows Sertifika Deposu'ndaki bir sertifikayı bulmak için tabi kullanır
file:<file_location>[,password:<password>]	ODBC sürücüsü bir sertifika dosyası kullanır.

Sertifika PFX biçimindeyse ve PFX sertifikasının içindeki özel anahtar parola korumalıysa parola anahtar sözcüğü gereklidir. PEM ve DER biçimlerindeki sertifikalar için ClientKey özniteliği gereklidir

İstemci Anahtarı

clientCertificate özniteliği tarafından belirtilen veya DER sertifikalar için PEM özel anahtarın dosya konumunu belirtir. Biçim:

Seçenek Değeri	Description
file:<file_location>[,password:<password>]	Özel anahtar dosyasının konumunu belirtir.

Özel anahtar dosyasının parola korumalı olması durumunda parola anahtar sözcüğü gereklidir. Parolada herhangi bir , karakter varsa, her birinin hemen arkasına fazladan , bir karakter eklenir. Örneğin, parola ise a,b,c, bağlantı dizesinde bulunan kaçış parolası olur a,,b,,c.

HostnameInCertificate

Şifreleme anlaşması yapıldığında sunucunun sertifikasında, Addr/Address/Server'dan türetilen varsayılan değerden farklıysa, konak adının bekleneceğini belirtir. ServerCertificate seçeneği kullanılırken HostnameInCertificate seçeneği yoksayılır.

IpAddressPreference

Sürüm 18.1'den itibaren kullanılabilir olan bu seçenek, kullanıcının bağlantılar için önceliklendirmek istediği IP Adresi türünü belirtmesine olanak tanır. Olası seçenekler şunlardır: "IpAddress= [ IPv4First | IPv6First | UsePlatformDefault]." UsePlatformDefault, sunucu adını çözümlemek için sistem çağrısı tarafından sağlanan sırayla adreslere bağlanır. Varsayılan değer, önceki sürümlerdeki davranışa karşılık gelen IPv4First değeridir.

ServerCertificate

Sürüm 18.1'den itibaren kullanılabilir, bu seçenek katı şifreleme moduyla kullanılabilir. ServerCertificate anahtar sözcüğü, SQL Server TLS/SSL sertifikasıyla eşleşecek bir sertifika dosyasının yolunu belirtmek için kullanılır. Eşleştirme, standart sertifika doğrulaması yerine yapılır (süre sonu, ana bilgisayar adı, güven zinciri vb.) Kabul edilen sertifika biçimleri PEM, DER ve CER'tir. Belirtilirse, sağlanan ServerCertificate'in tam eşleşme olup olmadığını görmek için SQL Server sertifikası denetlenir.

SQL_COPT_SS_ACCESS_TOKEN

Kimlik doğrulaması için Microsoft Entra erişim belirtecinin kullanılmasına izin verir. Daha fazla bilgi için bkz. Microsoft Entra Id kullanma.

Öznitelik değeri	Description
null	(Varsayılan) Erişim belirteci sağlanmadı.
ACCESSTOKEN*	Erişim belirtecinin işaretçisi.

SQL_COPT_SS_CEKEYSTOREDATA

Yüklü bir anahtar deposu sağlayıcı kitaplığıyla iletişim kurar. Bkz. Saydam sütun şifrelemeyi denetler (Always Encrypted). Bu özniteliğin varsayılan değeri yok. Daha fazla bilgi için bkz. Özel Anahtar Deposu Sağlayıcıları.

Öznitelik değeri	Description
CEKEYSTOREDATA *	Anahtar deposu sağlayıcı kitaplığı için iletişim veri yapısı

SQL_COPT_SS_CEKEYSTOREPROVIDER

Always Encrypted için bir anahtar deposu sağlayıcı kitaplığı yükler veya yüklenen anahtar deposu sağlayıcı kitaplıklarının adlarını alır. Daha fazla bilgi için bkz. Özel Anahtar Deposu Sağlayıcıları. Bu özniteliğin varsayılan değeri yok.

Öznitelik değeri	Description
Char*	Anahtar deposu sağlayıcı kitaplığının yolu

SQL_COPT_SS_ENLIST_IN_XA

XA uyumlu İşlem İşlemcisi (TP) ile XA işlemlerini etkinleştirmek için uygulamanın SQLSetConnectAttr'ı SQL_COPT_SS_ENLIST_IN_XA ve nesne XACALLPARAM işaretçisiyle çağırması gerekir. Bu seçenek Windows (17.3+), Linux ve macOS'ta desteklenir.

SQLSetConnectAttr(hdbc, SQL_COPT_SS_ENLIST_IN_XA, param, SQL_IS_POINTER);  // XACALLPARAM *param

Bir XA işlemini yalnızca ODBC bağlantısıyla ilişkilendirmek için çağrısı SQLSetConnectAttryaparken işaretçi yerine TRUE veya FALSE SQL_COPT_SS_ENLIST_IN_XA sağlayın. Bu ayar yalnızca Windows'ta geçerlidir ve bir istemci uygulaması aracılığıyla XA işlemlerini belirtmek için kullanılamaz.

SQLSetConnectAttr(hdbc, SQL_COPT_SS_ENLIST_IN_XA, (SQLPOINTER)TRUE, 0);

Değer	Description	Platform
XACALLPARAM nesnesi*	Nesne işaretçisi XACALLPARAM .	Windows, Linux ve macOS
TRUE	XA işlemini ODBC bağlantısıyla ilişkilendirir. tüm ilgili veritabanı etkinlikleri XA işleminin koruması altında gerçekleştirilir.	Windows
FALSE	İşlemi ODBC bağlantısıyla ilişkilendirmez.	Windows

XA işlemleri hakkında daha fazla bilgi için bkz. XA İşlemlerini Kullanma.

SQL_COPT_SS_LONGASMAX

Uzun tür verilerinin sunuculara maksimum tür verisi olarak gönderilmesine izin verir.

Öznitelik değeri	Description
Hayı	(Varsayılan) Gönderirken uzun türleri maksimum türe dönüştürmeyin.
Yes	Gönderirken verileri uzun türlerden en fazla türe dönüştürür.

SQL_COPT_SS_SPID

Bağlantının oturum kimliğini alır. Bu özellik T-SQL @@SPID değişkenine eşdeğerdir, ancak sunucuya fazladan gidiş dönüşe neden olmaz.

Öznitelik değeri	Description
DWORD - 32 bitlik sayı	SPID