Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Şunlar için geçerlidir:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitik Platform Sistemi (PDW)Microsoft Fabric'te SQL veritabanı
OLE DB sürücüsünü indirme
SQL Server için OLE DB Sürücüsündeki bazı API'ler bağlantı özniteliklerini belirtmek için bağlantı dizelerini kullanır. Bağlantı dizeleri, anahtar sözcük ve ilişkili değerlerin listesidir; her anahtar sözcük belirli bir bağlantı özniteliğini tanımlar.
Uyarı
SQL Server için OLE DB Sürücüsü, bağlantı dizelerinde geriye dönük uyumluluğu korumak için belirsizliğe izin verir (örneğin, bazı anahtar sözcükler birden çok kez belirtilebilir ve çakışan anahtar sözcüklere konuma veya önceliğe göre çözüme izin verilebilir). SQL Server için OLE DB Sürücüsünün gelecekteki sürümleri, bağlantı dizelerinde belirsizliğe izin vermeyebilir. Uygulamaları değiştirdiğinizde bağlantı dizesi belirsizliğine bağımlılığı ortadan kaldırmak amacıyla SQL Server için OLE DB Sürücüsü kullanmak uygun bir yaklaşımdır.
Aşağıdaki bölümlerde, SQL Server için OLE DB Sürücüsü ve veri sağlayıcısı olarak SQL Server için OLE DB Sürücüsü kullanılırken ActiveX Veri Nesneleri (ADO) ile kullanılabilecek anahtar sözcükler açıklanmaktadır.
OLE DB Sürücüsü bağlantı dizesi anahtar sözcükleri
OLE DB uygulamalarının veri kaynağı nesnelerini başlatmanın iki yolu vardır:
IDBInitialize::Initialize
IDataInitialize::GetDataSource
İlk durumda, DBPROPSET_DBINIT özellik kümesinde DBPROP_INIT_PROVIDERSTRING özelliği ayarlanarak bağlantı özelliklerini başlatmak için bir sağlayıcı dizesi kullanılabilir. İkinci durumda, bağlantı özelliklerini başlatmak için IDataInitialize::GetDataSource yöntemine bir başlatma dizesi geçirilebilir. Her iki yöntem de aynı OLE DB bağlantı özelliklerini başlatır, ancak farklı anahtar sözcük kümeleri kullanılır. IDataInitialize::GetDataSource tarafından kullanılan anahtar sözcük kümesi, başlatma özellik grubundaki özelliklerin en azından açıklamasıdır.
İlgili OLE DB özelliği bir varsayılan değere ayarlanmış veya açıkça bir değere ayarlanmış herhangi bir sağlayıcı dizesi ayarı, OLE DB özellik değeri sağlayıcı dizesindeki ayarı geçersiz kılar.
DBPROP_INIT_PROVIDERSTRING değerleri aracılığıyla sağlayıcı dizelerinde ayarlanan Boole özellikleri, yes ve no değerleri kullanılarak ayarlanır. IDataInitialize::GetDataSource kullanılarak başlatma dizelerinde ayarlanan Boole özellikleri, true ve false değerleri kullanılarak ayarlanır.
IDataInitialize::GetDataSource kullanan uygulamalar, IDBInitialize::Initialize tarafından kullanılan anahtar sözcükleri de kullanabilir, ancak yalnızca varsayılan değeri olmayan özellikler için kullanılabilir. Bir uygulama başlatma dizesinde hem IDataInitialize::GetDataSource anahtar sözcüğünü hem de IDBInitialize::Initialize anahtar sözcüğünü kullanıyorsa , IDataInitialize::GetDataSource anahtar sözcüğü ayarı kullanılır. Uygulamaların IDataInitialize::Initialize anahtar sözcüklerini IDataInitialize:GetDataSource bağlantı dizelerinde kullanmaması önerilir çünkü bu davranış gelecek sürümlerde korunmayabilir.
Uyarı
IDataInitialize::GetDataSource aracılığıyla geçirilen bir bağlantı dizesi özelliklere dönüştürülür ve IDBProperties::SetProperties aracılığıyla uygulanır. Bileşen hizmetleri IDBProperties::GetPropertyInfo'da özellik açıklamasını bulduysa, bu özellik tek başına özellik olarak uygulanır. Aksi takdirde, DBPROP_PROVIDERSTRING özelliği aracılığıyla uygulanır. Örneğin, Veri Kaynağı=sunucu1 bağlantı dizesini belirtirseniz; Server=server2, Veri Kaynağı bir özellik olarak ayarlanır, ancak Sunucu bir sağlayıcı dizesine gider.
Aynı sağlayıcıya özgü özelliğin birden çok örneğini belirtirseniz, ilk özelliğin ilk değeri kullanılır.
IDBInitialize::Initialize Yöntemini Kullanma
IDBInitialize::Initialize ile DBPROP_INIT_PROVIDERSTRING kullanan OLE DB uygulamaları tarafından kullanılan bağlantı dizeleri aşağıdaki söz dizimine sahiptir:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Öznitelik değerleri isteğe bağlı olarak ayraç içine alınabilir ve bunu yapmak iyi bir uygulamadır. Bu uygulama, öznitelik değerleri alfasayısal olmayan karakterler içerdiğinde sorunlardan kaçınıyor. Değerdeki ilk kapanış ayracında değerin sonlandırıldığı varsayılır, bu nedenle değerler kapanış ayracı karakterleri içeremez.
Bağlantı dizesi anahtar sözcüğünden sonraki = boşluk karakteri, değer tırnak içine alınmış olsa bile harfiyen yorumlanır.
Aşağıdaki tabloda, DBPROP_INIT_PROVIDERSTRING ile kullanılabilecek anahtar sözcükler açıklanmaktadır.
| Keyword | Başlatma özelliği | Description |
|---|---|---|
| Adresi | SSPROP_INIT_NETWORKADDRESS | Adres eş anlamlısı. |
| Adres | SSPROP_INIT_NETWORKADDRESS | SQL Server örneğini çalıştıran sunucunun ağ adresi.
Adres genellikle sunucunun ağ adıdır, ancak kanal, IP adresi veya TCP/IP bağlantı noktası ve yuva adresi gibi diğer adlar olabilir. Bir IP adresi belirtirseniz, SQL Server Configuration Manager'da TCP/IP veya adlandırılmış kanallar protokollerinin etkinleştirildiğinden emin olun. ADRES değeri, SQL Server için OLE DB Sürücüsü kullanılırken bağlantı dizelerinde Sunucu'ya geçirilen değerden önceliklidir. Ayrıca, Address=; anahtar sözcüğünde belirtilen sunucuya bağlanılacağını, ancak , Address= ;, Address=.;ve Address=localhost; tümünün yerel sunucuya bir bağlantıya neden olduğunu unutmayınAddress=(local);.Address anahtar sözcüğü için tam söz dizimi aşağıdaki gibidir: [protokol:]Adres[,bağlantı noktası |\pipe\pipename] protokol tcp ( TCP /IP), lpc (paylaşılan bellek) veya np (adlandırılmış kanallar) olabilir. Protokoller hakkında daha fazla bilgi için bkz. İstemci Protokollerini Yapılandırma. Protokol veya Ağ anahtar sözcüğü belirtilmezse, SQL Server için OLE DB Sürücüsü SQL Server Configuration Manager'da belirtilen protokol sırasını kullanır. bağlantı noktası , belirtilen sunucuda bağlanacak bağlantı noktasıdır. Varsayılan olarak, SQL Server 1433 numaralı bağlantı noktasını kullanır. |
| APP | SSPROP_INIT_APPNAME | Uygulamayı tanımlayan dize. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT (uygulama amacı) | Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite şeklindedir.Varsayılan değer: ReadWrite. SQL Server'ın Always On kullanılabilirlik grupları desteği için OLE DB Sürücüsü hakkında daha fazla bilgi için bkz. SQL Server Yüksek Kullanılabilirlik için OLE DB Sürücüsü, Olağanüstü Durum Kurtarma. |
| AttachDBFileName | SSPROP_INIT_FILENAME | Eklenebilir veritabanının birincil dosyasının adı (tam yol adını içerir). AttachDBFileName kullanmak için veritabanı adını Database anahtar sözcüğü sağlayıcı dizesiyle de belirtmeniz gerekir. Veritabanı daha önce eklenmişse, SQL Server veritabanını yeniden bağlamaz (bağlantı için varsayılan olarak ekli veritabanını kullanır). |
| Kimlik Doğrulaması1 | SSPROP_AUTH_MODE | Kullanılan SQL veya Microsoft Entra kimlik doğrulamasını belirtir. Geçerli değerler şunlardır:
NOT: Anahtar ActiveDirectoryIntegrated sözcüğü, SQL Server'da Windows kimlik doğrulaması için de kullanılabilir.
Integrated Security (veya Trusted_Connection) kimlik doğrulama anahtar sözcüklerini değiştirir. (veya ) anahtar sözcüklerini veya ilgili özelliklerini kullanan Integrated Security uygulamaların yeni şifreleme ve sertifika doğrulama davranışını etkinleştirmek için Trusted_Connection anahtar sözcüğün Authentication değerini (veya buna karşılık gelen özelliğini) olarak ayarlaması ActiveDirectoryIntegrated.NOT: Kimlik doğrulaması kullanan uygulamaların SQL Server etkinleştirmek için Authentication anahtar sözcüğün SqlPassword değerini (veya buna karşılık gelen özelliğini) olarak ayarlaması önerilir. |
| Otomatik Çevir | SSPROP_INIT_AUTOTRANSLATE | AutoTranslate eş anlamlısı. |
| Otomatik Çeviri | SSPROP_INIT_AUTOTRANSLATE | OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler yes ve no'dir. |
| ConnectRetryCount | SSPROP_INIT_CONNECT_RETRY_COUNT | Bağlantı kesilirse yeniden bağlanma denemelerinin sayısını denetler. Geçerli değerler 0 ile 255 arasında değişir. Varsayılan değer şudur: 1. 0 değeri yeniden bağlanma girişimine neden olmaz. Daha fazla bilgi için bkz . Boşta Bağlantı Dayanıklılığı. |
| ConnectRetryInterval | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Bağlantı kaybolursa her bağlantı yeniden deneme girişimi arasındaki saniye sayısını belirtir. Geçerli değerler 1 ile 60 arasında değişir. Varsayılan değer şudur: 10. Daha fazla bilgi için bkz . Boşta Bağlantı Dayanıklılığı. |
| Veritabanı | DBPROP_INIT_CATALOG | Veritabanı adı. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Kullanılacak veri türü işleme modunu belirtir. Tanınan değerler sağlayıcı veri türlerine ve 0 SQL Server 2000 veri türlerine yöneliktir80. |
| Şifrele1 | SSPROP_INIT_ENCRYPT | Verilerin ağ üzerinden gönderilmeden önce şifrelenip şifrelenmemesi gerektiğini belirtir. Olası değerler Optional, Mandatoryve Strict. Varsayılan değer şudur: Mandatory. 18.x.x sürümleri için bkz. MSOLEDBSQL ana sürüm farklılıkları. |
| Yedekleme Ortağı | SSPROP_INIT_FAILOVERPARTNER | Veritabanı yansıtmasında kullanılan yük devretme sunucusunun adı. |
| FailoverPartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | Yük devretme iş ortağı için SPN. Varsayılan değer boş bir dizedir. Boş bir dize, SQL Server için OLE DB Sürücüsünün sağlayıcı tarafından oluşturulan varsayılan SPN'yi kullanmasına neden olur. |
| HostNameInCertificate | SSPROP_INIT_HOST_NAME_CERTIFICATE | SQL Server TLS/SSL sertifikasının doğrulanmasında kullanılacak ana bilgisayar adı.
HostNameInCertificate anahtar sözcüğü ayarlanmamışsa, sürücü SQL Server TLS/SSL sertifikasını doğrulamak için ana bilgisayar adı olarak bağlantı URL'sinde Sunucu anahtar sözcüğü değerini kullanır. NOT: Sunucu sertifikası güvenilirse bu özellik yoksayılır. Şifrele olarak ayarlanırsa Strict, sertifika her zaman doğrulanır. |
| Language | SSPROP_INIT_GEÇERLİDİL | SQL Server dili. |
| MarsConn | SSPROP_INIT_MARSCONNECTION | Sunucu SQL Server 2005 (9.x) veya üzeriyse, bağlantıda birden çok etkin sonuç kümesini (MARS) etkinleştirir veya devre dışı bırakır. Olası değerler yes ve no şeklindedir. Varsayılan değer şudur: no. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Bir SQL Server kullanılabilirlik grubunun veya SQL Server Yük Devretme Kümesi Örneğinin kullanılabilirlik grubu dinleyicisine bağlanırken her zaman MultiSubnetFailover=Yes değerini belirtin.
MultiSubnetFailover=Evet , (şu anda) etkin sunucuya daha hızlı algılama ve bağlantı sağlamak üzere SQL Server için OLE DB Sürücüsünü yapılandırır. Olası değerler Yes ve No şeklindedir. Varsayılan değer: No. Örneğin:MultiSubnetFailover=YesSQL Server'ın Always On kullanılabilirlik grupları desteği için OLE DB Sürücüsü hakkında daha fazla bilgi için bkz. SQL Server Yüksek Kullanılabilirlik için OLE DB Sürücüsü, Olağanüstü Durum Kurtarma. |
| Net | SSPROP_INIT_NETWORKLIBRARY | Ağ eş anlamlısı. |
| Network | SSPROP_INIT_NETWORKLIBRARY | Kuruluştaki bir SQL Server örneğine bağlantı kurmak için kullanılan ağ kitaplığı. |
| Ağ Kitaplığı | SSPROP_INIT_NETWORKLIBRARY | Ağ için eşanlamlı. |
| PacketSize | SSPROP_INIT_PACKETSIZE | Tablosal Veri Akışı (TDS) paket boyutu. Varsayılan değer 0'dır (gerçek değer sunucu tarafından belirlenir). |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
yes ve no dizelerini değer olarak kabul eder.
no kullanıldığında, veri kaynağı nesnesinin hassas kimlik doğrulama bilgilerini kalıcı olarak tutmasına izin verilmez. |
| PWD | DBPROP_AUTH_PASSWORD | SQL Server oturum açma parolası. |
| Sunucu | DBPROP_INIT_DATASOURCE | SQL Server örneğinin adı. Değer, ağdaki bir sunucunun adı, IP adresi veya SQL Server Configuration Manager diğer adının adı olmalıdır. Belirtilmediğinde, yerel bilgisayardaki varsayılan örneğe bir bağlantı yapılır. Address anahtar sözcüğü, Server anahtar sözcüğünü geçersiz kılar. Aşağıdaki seçeneklerden birini belirterek yerel sunucudaki varsayılan örneğe bağlanabilirsiniz: Sunucu=; Sunucu=.; Server=(local); Server=(local); Server=(localhost); Server=(localdb)\instancename; LocalDB desteği hakkında daha fazla bilgi için bkz. LocalDB için SQL Server Desteği için OLE DB Sürücüsü. SQL Server'ın adlandırılmış bir örneğini belirtmek için \. Hiçbir sunucu belirtilmediğinde, yerel bilgisayardaki varsayılan örneğe bir bağlantı yapılır. Bir IP adresi belirtirseniz, SQL Server Configuration Manager'da TCP/IP veya adlandırılmış kanallar protokollerinin etkinleştirildiğinden emin olun. Server anahtar sözcüğü için tam söz dizimi aşağıdaki gibidir: Sunucu=[protokol:]Sunucu[,bağlantı noktası] protokol tcp ( TCP /IP), lpc (paylaşılan bellek) veya np (adlandırılmış kanallar) olabilir. Aşağıdaki örnek adlandırılmış bir kanal belirtir: np:\\.\pipe\MSSQL$MYINST01\sql\queryYukarıdaki satır adlandırılmış kanal protokollerini ( np ), yerel makinede adlandırılmış bir kanalı ()\\.\pipe, SQL Server örneğinin adını ()MSSQL$MYINST01 ve adlandırılmış kanalın varsayılan adını (sql/query) belirtir.Bir protokol veya Ağ anahtar sözcüğü belirtilmezse, SQL Server için OLE DB Sürücüsü SQL Server Configuration Manager'da belirtilen protokol sırasını kullanır. bağlantı noktası , belirtilen sunucuda bağlanacak bağlantı noktasıdır. Varsayılan olarak, SQL Server 1433 numaralı bağlantı noktasını kullanır. SQL Server için OLE DB Sürücüsü kullanılırken bağlantı dizelerinde Server değişkenine geçirilen değerin başındaki boşluklar yoksayılır. |
| ServerCertificate | SSPROP_INIT_SERVER_CERTIFICATE | SQL Server TLS/SSL sertifikasıyla eşleşecek bir sertifika dosyasının yolunu belirtir. Bu seçenek yalnızca şifreleme etkinleştirildiğinde Strict kullanılabilir. Kabul edilen sertifika biçimleri PEM, DER ve CER'tir. Belirtilirse, sağlanan sertifikanın tam olarak eşleşip eşleşmediği denetlenerek SQL Server sertifikası denetlenir. |
| ServerSPN | SSPROP_INIT_SERVERSPN | Sunucu için SPN. Varsayılan değer boş bir dizedir. Boş bir dize, SQL Server için OLE DB Sürücüsünün sağlayıcı tarafından oluşturulan varsayılan SPN'yi kullanmasına neden olur. |
| Timeout | DBPROP_INIT_TIMEOUT | Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Ana bilgisayar adının ilk çözümlenen IP'sinin yanıt vermemesi ve konak adıyla ilişkilendirilmiş birden çok IP olması bağlantı sırasını etkiler. TNIR, farklı bağlantı dizileri sağlamak için MultiSubnetFailover ile etkileşim kurar. Olası değerler Yes ve No şeklindedir. Varsayılan değer şudur: Yes. Daha fazla bilgi için bkz. Saydam Ağ IP Çözümlemesini Kullanma. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | olduğunda yes, bu seçenek SQL Server için OLE DB Sürücüsüne oturum açma doğrulaması için Windows Kimlik Doğrulaması'nı kullanmasını belirtir. Aksi takdirde, SQL Server için OLE DB Sürücüsü oturum açma doğrulaması için bir SQL Server kullanıcı adı ve parolası kullanır ve UID ve PWD anahtar sözcükleri belirtilmelidir. |
| TrustServerCertificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
yes ve no dizelerini değerler olarak kabul eder. Varsayılan değer olan no, sunucu sertifikasının doğrulanacağı anlamına gelir. |
| UID | DBPROP_AUTH_USERID | SQL Server oturum açma adı. |
| UseFMTONLY | SSPROP_INIT_USEFMTONLY | SQL Server 2012 (11.x) ve daha yeni sürümlere bağlanırken meta verilerin nasıl alınıp alınyacağını denetler. Olası değerler yes ve no şeklindedir. Varsayılan değer şudur: no.Varsayılan olarak, SQL Server için OLE DB Sürücüsü meta verileri almak için sp_describe_first_result_set ve sp_describe_undeclared_parameters saklı yordamları kullanır. Bu saklı yordamların bazı sınırlamaları vardır (örneğin, geçici tablolarda çalışırken başarısız olurlar). UseFMTONLY ayarını yes olarak ayarlamak, sürücüye meta veri almak için SET FMTONLY kullanmasını talimat verir. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Bu anahtar kelime artık kullanılmamaktadır ve ilgili ayarı SQL Server için OLE DB Sürücüsü tarafından yoksayılmaktadır. |
| WSID | SSPROP_INIT_WSID | İş istasyonu tanımlayıcısı. |
[1]: Güvenliği geliştirmek için Kimlik Doğrulaması veya Erişim Belirteci başlatma özellikleri veya ilgili bağlantı dizesi anahtar sözcükleri kullanılırken şifreleme ve sertifika doğrulama davranışı değiştirilir. Daha fazla bilgi için bkz . Şifreleme ve sertifika doğrulama.
IDataInitialize::GetDataSource Kullanma
OLE DB uygulamaları tarafından IDataInitialize::GetDataSource kullanılarak kullanılan bağlantı dizeleri aşağıdaki söz dizimine sahiptir:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
Özellik kullanımı, kapsamı dahilinde izin verilen söz dizimine uygun olmalıdır. Örneğin, WSID küme ayraçlarını ({}) tırnak karakterlerinin yerine kullanır, Uygulama Adı ise tek (') veya çift (") tırnak karakterleri kullanır. Yalnızca dize özellikleri alıntılanabilir. Bir tamsayıyı veya numaralandırılmış özelliği alıntı yapmaya çalışmak hataya Connection String doesn't conform to OLE DB specification neden olur.
Öznitelik değerleri isteğe bağlı olarak tek veya çift tırnak içine alınabilir ve bunu yapmak iyi bir uygulamadır. Bu uygulama, değerler alfasayısal olmayan karakterler içerdiğinde sorunlardan kaçınıyor. Kullanılan tırnak içinde gösterilen karakter, çift tırnak içindeyse değerlerde de görüntülenebilir.
Bir bağlantı dizesi anahtar sözcüğünde, = işaretinden sonraki boşluk karakteri, değer tırnak içinde olsa bile sabit bir değer olarak yorumlanır.
Bir bağlantı dizesi aşağıdaki tabloda listelenen özelliklerden birden fazlasına sahipse, son özelliğin değeri kullanılır.
Aşağıdaki tabloda IDataInitialize::GetDataSource ile kullanılabilecek anahtar sözcükler açıklanmaktadır:
| Keyword | Başlatma özelliği | Description |
|---|---|---|
| Erişim Belirteci1 | SSPROP_AUTH_ACCESS_TOKEN | Microsoft Entra Id'de kimlik doğrulaması yapmak için kullanılan erişim belirteci. NOT: Bu anahtar sözcüğün ve ayrıca , UID, PWDveya bağlantı dizesi anahtar sözcüklerinin ya da Trusted_ConnectionAuthentication bunlara karşılık gelen özelliklerin/anahtar sözcüklerin belirtilmesi bir hatadır. |
| Uygulama Adı | SSPROP_INIT_APPNAME | Uygulamayı tanımlayan dize. |
| Uygulama Amacı | SSPROP_INIT_APPLICATIONINTENT (uygulama amacı) | Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite şeklindedir.Varsayılan değer: ReadWrite. SQL Server'ın Always On kullanılabilirlik grupları desteği için OLE DB Sürücüsü hakkında daha fazla bilgi için bkz. SQL Server Yüksek Kullanılabilirlik için OLE DB Sürücüsü, Olağanüstü Durum Kurtarma. |
| Kimlik Doğrulaması1 | SSPROP_AUTH_MODE | Kullanılan SQL veya Microsoft Entra kimlik doğrulamasını belirtir. Geçerli değerler şunlardır:
NOT: Anahtar ActiveDirectoryIntegrated sözcüğü, SQL Server'da Windows kimlik doğrulaması için de kullanılabilir.
Integrated Security (veya Trusted_Connection) kimlik doğrulama anahtar sözcüklerini değiştirir. (veya ) anahtar sözcüklerini veya ilgili özelliklerini kullanan Integrated Security uygulamaların yeni şifreleme ve sertifika doğrulama davranışını etkinleştirmek için Trusted_Connection anahtar sözcüğün Authentication değerini (veya buna karşılık gelen özelliğini) olarak ayarlaması ActiveDirectoryIntegrated.NOT: Kimlik doğrulaması kullanan uygulamaların SQL Server etkinleştirmek için Authentication anahtar sözcüğün SqlPassword değerini (veya buna karşılık gelen özelliğini) olarak ayarlaması önerilir. |
| Otomatik Çevir | SSPROP_INIT_AUTOTRANSLATE | OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler true ve false'dir. |
| Bağlanma Zaman Aşımı | DBPROP_INIT_TIMEOUT | Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
| Yeniden Bağlanma Deneme Sayısı | SSPROP_INIT_CONNECT_RETRY_COUNT | Bağlantı kesilirse yeniden bağlanma denemelerinin sayısını denetler. Geçerli değerler 0 ile 255 arasında değişir. Varsayılan değer şudur: 1. 0 değeri yeniden bağlanma girişimine neden olmaz. Daha fazla bilgi için bkz . Boşta Bağlantı Dayanıklılığı. |
| Bağlantı Yeniden Deneme Aralığı | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Bağlantı kaybolursa her bağlantı yeniden deneme girişimi arasındaki saniye sayısını belirtir. Geçerli değerler 1 ile 60 arasında değişir. Varsayılan değer şudur: 10. Daha fazla bilgi için bkz . Boşta Bağlantı Dayanıklılığı. |
| Geçerli Dil | SSPROPT_INIT_CURRENTLANGUAGE | SQL Server dil adı. |
| Veri Kaynağı | DBPROP_INIT_DATASOURCE | Kuruluştaki bir SQL Server örneğinin adı. Belirtilmediğinde, yerel bilgisayardaki varsayılan örneğe bir bağlantı yapılır. Geçerli adres söz dizimi hakkında daha fazla bilgi için bu makaledeki Sunucu anahtar sözcüğü açıklamasına bakın. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Kullanılacak veri türü işleme modunu belirtir. Tanınan değerler 0 sağlayıcı veri türlerine ve 80 SQL Server 2000 (8.x) veri türlerine yöneliktir. |
| Yük Devretme İş Ortağı | SSPROP_INIT_FAILOVERPARTNER | Veritabanı yansıtması için kullanılan yük devretme sunucusunun adı. |
| Yük Devretme İş Ortağı SPN | SSPROP_INIT_FAILOVERPARTNERSPN | Yük devretme iş ortağı için SPN. Varsayılan değer boş bir dizedir. Boş bir dize, SQL Server için OLE DB Sürücüsünün sağlayıcı tarafından oluşturulan varsayılan SPN'yi kullanmasına neden olur. |
| Sertifikadaki ana bilgisayar adı | SSPROP_INIT_SUNUCU_ADI_SERTIFIKASI | SQL Server TLS/SSL sertifikasının doğrulanmasında kullanılacak ana bilgisayar adı.
Sertifikadaki Ana Bilgisayar Adı anahtar sözcüğü ayarlanmamışsa, sürücü SQL Server TLS/SSL sertifikasını doğrulamak için ana bilgisayar adı olarak bağlantı URL'sindeki Veri Kaynağı anahtar sözcük değerini kullanır. NOT: Sunucu sertifikası güvenilirse bu özellik yoksayılır. Veriler için Şifreleme Kullan olarak ayarlanırsa Strict, sertifika her zaman doğrulanır. |
| İlk Katalog | DBPROP_INIT_CATALOG | Veritabanı adı. |
| İlk Dosya Adı | SSPROP_INIT_FILENAME | Eklenebilir veritabanının birincil dosyasının adı (tam yol adını içerir). AttachDBFileName kullanmak için veritabanı adını DATABASE anahtar sözcüğü sağlayıcı dizesiyle de belirtmeniz gerekir. Veritabanı daha önce eklenmişse, SQL Server veritabanını yeniden bağlamaz (bağlantı için varsayılan olarak ekli veritabanını kullanır). |
| Tümleşik Güvenlik | DBPROP_AUTH_INTEGRATED | Windows Kimlik Doğrulaması değerini SSPI kabul eder. |
| MARS Bağlantısı | SSPROP_INIT_MARSCONNECTION | Bağlantıda birden çok etkin sonuç kümesini (MARS) etkinleştirir veya devre dışı bırakır. Tanınan değerler true ve false'dir. Varsayılan değer: false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Bir SQL Server kullanılabilirlik grubunun veya SQL Server Yük Devretme Kümesi Örneğinin kullanılabilirlik grubu dinleyicisine bağlanırken her zaman MultiSubnetFailover=True değerini belirtin.
MultiSubnetFailover=True , (şu anda) etkin sunucuya daha hızlı algılama ve bağlantı sağlamak üzere SQL Server için OLE DB Sürücüsünü yapılandırır. Olası değerler True ve False şeklindedir. Varsayılan değer: False. Örneğin:MultiSubnetFailover=TrueSQL Server'ın Always On kullanılabilirlik grupları desteği için OLE DB Sürücüsü hakkında daha fazla bilgi için bkz. SQL Server Yüksek Kullanılabilirlik için OLE DB Sürücüsü, Olağanüstü Durum Kurtarma. |
| Ağ Adresi | SSPROP_INIT_NETWORKADDRESS | Kuruluştaki bir SQL Server örneğinin ağ adresi. Geçerli adres söz dizimi hakkında daha fazla bilgi için bu makaledeki Adres anahtar sözcüğü açıklamasına bakın. |
| Ağ Kitaplığı | SSPROP_INIT_NETWORKLIBRARY | Kuruluştaki bir SQL Server örneğine bağlantı kurmak için kullanılan ağ kitaplığı. |
| Paket Boyutu | SSPROP_INIT_PACKETSIZE | Tablosal Veri Akışı (TDS) paket boyutu. Varsayılan değer 0'dır (gerçek değer sunucu tarafından belirlenir). |
| Parola | DBPROP_AUTH_PASSWORD | SQL Server oturum açma parolası. |
| Güvenlik Bilgilerini Sakla | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
true ve false dizelerini değer olarak kabul eder.
false olduğunda, veri kaynağı nesnesine hassas kimlik doğrulama bilgilerini kalıcı hale getirme izni verilmez. |
| Sağlayıcı | SQL Server için OLE DB Sürücüsü için bu değer "MSOLEDBSQL19" veya "MSOLEDBSQL" olmalıdır. | |
| Sunucu Sertifikası | SSPROP_INIT_SERVER_CERTIFICATE | SQL Server TLS/SSL sertifikasıyla eşleşecek bir sertifika dosyasının yolunu belirtir. Bu seçenek yalnızca şifreleme etkinleştirildiğinde Strict kullanılabilir. Kabul edilen sertifika biçimleri PEM, DER ve CER'tir. Belirtilirse, sağlanan sertifikanın tam olarak eşleşip eşleşmediği denetlenerek SQL Server sertifikası denetlenir. |
| Sunucu SPN'i | SSPROP_INIT_SERVERSPN | Sunucu için SPN. Varsayılan değer boş bir dizedir. Boş bir dize, SQL Server için OLE DB Sürücüsünün sağlayıcı tarafından oluşturulan varsayılan SPN'yi kullanmasına neden olur. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Ana bilgisayar adının ilk çözümlenen IP'sinin yanıt vermemesi ve konak adıyla ilişkilendirilmiş birden çok IP olması bağlantı sırasını etkiler. TNIR, farklı bağlantı dizileri sağlamak için MultiSubnetFailover ile etkileşim kurar. Olası değerler True ve False şeklindedir. Varsayılan değer şudur: True. Daha fazla bilgi için bkz. Saydam Ağ IP Çözümlemesini Kullanma. |
| Güven Sunucusu Sertifikası1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
true ve false dizelerini değer olarak kabul eder. Varsayılan değer olan false, sunucu sertifikasının doğrulanacağı anlamına gelir. |
| Veri için Şifreleme Kullan1 | SSPROP_INIT_ENCRYPT | Verilerin ağ üzerinden gönderilmeden önce şifrelenip şifrelenmemesi gerektiğini belirtir. Olası değerler Optional, Mandatoryve Strict. Varsayılan değer şudur: Mandatory. 18.x.x sürümleri için bkz. MSOLEDBSQL ana sürüm farklılıkları. |
| FMTONLY kullanma | SSPROP_INIT_USEFMTONLY | SQL Server 2012 (11.x) ve daha yeni sürümlere bağlanırken meta verilerin nasıl alınıp alınyacağını denetler. Olası değerler true ve false şeklindedir. Varsayılan değer şudur: false.Varsayılan olarak, SQL Server için OLE DB Sürücüsü meta verileri almak için sp_describe_first_result_set ve sp_describe_undeclared_parameters saklı yordamları kullanır. Bu saklı yordamların bazı sınırlamaları vardır (örneğin, geçici tablolarda çalışırken başarısız olurlar). FmTONLY kullan ayarının ayarlanması, sürücüye true meta veri almak için SET FMTONLY kullanmasını bildirir. |
| Kullanıcı Kimliği | DBPROP_AUTH_USERID | SQL Server oturum açma adı. |
| İş İstasyonu Kimliği | SSPROP_INIT_WSID | İş istasyonu tanımlayıcısı. |
[1]: Güvenliği geliştirmek için, Kimlik Doğrulaması/Erişim Belirteci başlatma özellikleri veya ilgili bağlantı dizesi anahtar sözcükleri kullanılırken şifreleme ve sertifika doğrulama davranışı değiştirilir. Ayrıntılar için bkz . Şifreleme ve sertifika doğrulama.
Uyarı
Bağlantı dizesinde, Old Password özelliği, sağlayıcı dizesi özelliği aracılığıyla kullanılamayan mevcut (süresi dolmuş olabilir) parola olan SSPROP_AUTH_OLD_PASSWORD'ı ayarlar.
ActiveX Veri Nesneleri (ADO) Bağlantı Dizesi Anahtar Sözcükleri
ADO uygulamaları, ADODBConnection nesnelerinin ConnectionString özelliğini ayarlar veya ADODBConnection nesnelerinin Open yöntemine parametre olarak bir bağlantı dizesi sağlar.
ADO uygulamaları, OLE DB IDBInitialize::Initialize yöntemi tarafından kullanılan anahtar sözcükleri de kullanabilir, ancak yalnızca varsayılan değeri olmayan özellikler için kullanılabilir. Uygulama hem ADO anahtar sözcüklerini hem de IDBInitialize::Initialize anahtar sözcüklerini başlatma dizesinde kullanıyorsa, ADO anahtar sözcüğü ayarı kullanılır. uygulamaların yalnızca ADO bağlantı dizesi anahtar sözcüklerini kullanması önerilir.
ADO tarafından kullanılan bağlantı dizeleri aşağıdaki söz dizimine sahiptir:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Öznitelik değerleri isteğe bağlı olarak çift tırnak içine alınabilir ve bunu yapmak iyi bir uygulamadır. Bu uygulama, değerler alfasayısal olmayan karakterler içerdiğinde sorunlardan kaçınıyor. Öznitelik değerleri çift tırnak içeremez.
Aşağıdaki tabloda ADO bağlantı dizesiyle kullanılabilecek anahtar sözcükler açıklanmaktadır:
| Keyword | Başlatma özelliği | Description |
|---|---|---|
| Erişim Belirteci1 | SSPROP_AUTH_ACCESS_TOKEN | Microsoft Entra Id'de kimlik doğrulaması yapmak için kullanılan erişim belirteci. NOT: Bu anahtar sözcüğün ve ayrıca , UID, PWDveya bağlantı dizesi anahtar sözcüklerinin ya da Trusted_ConnectionAuthentication bunlara karşılık gelen özelliklerin/anahtar sözcüklerin belirtilmesi bir hatadır. |
| Uygulama Amacı | SSPROP_INIT_APPLICATIONINTENT (uygulama amacı) | Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite şeklindedir.Varsayılan değer: ReadWrite. SQL Server'ın Always On kullanılabilirlik grupları desteği için OLE DB Sürücüsü hakkında daha fazla bilgi için bkz. SQL Server Yüksek Kullanılabilirlik için OLE DB Sürücüsü, Olağanüstü Durum Kurtarma. |
| Uygulama Adı | SSPROP_INIT_APPNAME | Uygulamayı tanımlayan dize. |
| Kimlik Doğrulaması1 | SSPROP_AUTH_MODE | Kullanılan SQL veya Microsoft Entra kimlik doğrulamasını belirtir. Geçerli değerler şunlardır:
NOT: Anahtar ActiveDirectoryIntegrated sözcüğü, SQL Server'da Windows kimlik doğrulaması için de kullanılabilir.
Integrated Security (veya Trusted_Connection) kimlik doğrulama anahtar sözcüklerini değiştirir. (veya ) anahtar sözcüklerini veya ilgili özelliklerini kullanan Integrated Security uygulamaların yeni şifreleme ve sertifika doğrulama davranışını etkinleştirmek için Trusted_Connection anahtar sözcüğün Authentication değerini (veya buna karşılık gelen özelliğini) olarak ayarlaması ActiveDirectoryIntegrated.NOT: Kimlik doğrulaması kullanan uygulamaların SQL Server etkinleştirmek için Authentication anahtar sözcüğün SqlPassword değerini (veya buna karşılık gelen özelliğini) olarak ayarlaması önerilir. |
| Otomatik Çevir | SSPROP_INIT_AUTOTRANSLATE | OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler true ve false'dir. |
| Bağlanma Zaman Aşımı | DBPROP_INIT_TIMEOUT | Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
| Yeniden Bağlanma Deneme Sayısı | SSPROP_INIT_CONNECT_RETRY_COUNT | Bağlantı kesilirse yeniden bağlanma denemelerinin sayısını denetler. Geçerli değerler 0 ile 255 arasında değişir. Varsayılan değer şudur: 1. 0 değeri yeniden bağlanma girişimine neden olmaz. Daha fazla bilgi için bkz . Boşta Bağlantı Dayanıklılığı. |
| Bağlantı Yeniden Deneme Aralığı | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Bağlantı kaybolursa her bağlantı yeniden deneme girişimi arasındaki saniye sayısını belirtir. Geçerli değerler 1 ile 60 arasında değişir. Varsayılan değer şudur: 10. Daha fazla bilgi için bkz . Boşta Bağlantı Dayanıklılığı. |
| Geçerli Dil | SSPROPT_INIT_CURRENTLANGUAGE | SQL Server dil adı. |
| Veri Kaynağı | DBPROP_INIT_DATASOURCE | Kuruluştaki bir SQL Server örneğinin adı. Belirtilmediğinde, yerel bilgisayardaki varsayılan örneğe bir bağlantı yapılır. Geçerli adres söz dizimi hakkında daha fazla bilgi için bu makaledeki Sunucu anahtar sözcüğü açıklamasına bakın. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Kullanılacak veri türü işleme modunu belirtir. Tanınan değerler sağlayıcı veri türlerine ve 0 SQL Server 2000 veri türlerine yöneliktir80. |
| Yük Devretme İş Ortağı | SSPROP_INIT_FAILOVERPARTNER | Veritabanı yansıtması için kullanılan yük devretme sunucusunun adı. |
| Yük Devretme İş Ortağı SPN | SSPROP_INIT_FAILOVERPARTNERSPN | Yük devretme iş ortağı için SPN. Varsayılan değer boş bir dizedir. Boş bir dize, SQL Server için OLE DB Sürücüsünün sağlayıcı tarafından oluşturulan varsayılan SPN'yi kullanmasına neden olur. |
| Sertifikadaki ana bilgisayar adı | SSPROP_INIT_SUNUCU_ADI_SERTIFIKASI | SQL Server TLS/SSL sertifikasının doğrulanmasında kullanılacak ana bilgisayar adı.
Sertifikadaki Ana Bilgisayar Adı anahtar sözcüğü ayarlanmamışsa, sürücü SQL Server TLS/SSL sertifikasını doğrulamak için ana bilgisayar adı olarak bağlantı URL'sindeki Veri Kaynağı anahtar sözcük değerini kullanır. NOT: Sunucu sertifikası güvenilirse bu özellik yoksayılır. Veriler için Şifreleme Kullan olarak ayarlanırsa Strict, sertifika her zaman doğrulanır. |
| İlk Katalog | DBPROP_INIT_CATALOG | Veritabanı adı. |
| İlk Dosya Adı | SSPROP_INIT_FILENAME | Eklenebilir veritabanının birincil dosyasının adı (tam yol adını içerir). AttachDBFileName kullanmak için veritabanı adını DATABASE anahtar sözcüğü sağlayıcı dizesiyle de belirtmeniz gerekir. Veritabanı daha önce eklenmişse, SQL Server veritabanını yeniden bağlamaz (bağlantı için varsayılan olarak ekli veritabanını kullanır). |
| Tümleşik Güvenlik | DBPROP_AUTH_INTEGRATED | Windows Kimlik Doğrulaması değerini SSPI kabul eder. |
| MARS Bağlantısı | SSPROP_INIT_MARSCONNECTION | Sunucu SQL Server 2005 (9.x) veya üzeriyse, bağlantıda birden çok etkin sonuç kümesini (MARS) etkinleştirir veya devre dışı bırakır. Tanınan değerler true ve false'dir. Varsayılan değer: false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Bir SQL Server kullanılabilirlik grubunun veya SQL Server Yük Devretme Kümesi Örneğinin kullanılabilirlik grubu dinleyicisine bağlanırken her zaman MultiSubnetFailover=True değerini belirtin.
MultiSubnetFailover=True , (şu anda) etkin sunucuya daha hızlı algılama ve bağlantı sağlamak üzere SQL Server için OLE DB Sürücüsünü yapılandırır. Olası değerler True ve False şeklindedir. Varsayılan değer: False. Örneğin:MultiSubnetFailover=TrueSQL Server'ın Always On kullanılabilirlik grupları desteği için OLE DB Sürücüsü hakkında daha fazla bilgi için bkz. SQL Server Yüksek Kullanılabilirlik için OLE DB Sürücüsü, Olağanüstü Durum Kurtarma. |
| Ağ Adresi | SSPROP_INIT_NETWORKADDRESS | Kuruluştaki bir SQL Server örneğinin ağ adresi. Geçerli adres söz dizimi hakkında daha fazla bilgi için bu makaledeki Adres anahtar sözcüğü açıklamasına bakın. |
| Ağ Kitaplığı | SSPROP_INIT_NETWORKLIBRARY | Kuruluştaki bir SQL Server örneğine bağlantı kurmak için kullanılan ağ kitaplığı. |
| Paket Boyutu | SSPROP_INIT_PACKETSIZE | Tablosal Veri Akışı (TDS) paket boyutu. Varsayılan değer 0'dır (gerçek değer sunucu tarafından belirlenir). |
| Parola | DBPROP_AUTH_PASSWORD | SQL Server oturum açma parolası. |
| Güvenlik Bilgilerini Sakla | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
true ve false dizelerini değer olarak kabul eder.
false olduğunda, veri kaynağı nesnesine hassas kimlik doğrulama bilgilerini kalıcı hale getirme izni verilmez. |
| Sağlayıcı | SQL Server'ın OLE DB Sürücüsü için değer MSOLEDBSQL19 veya MSOLEDBSQL olabilir. |
|
| Sunucu Sertifikası | SSPROP_INIT_SERVER_CERTIFICATE | SQL Server TLS/SSL sertifikasıyla eşleşecek bir sertifika dosyasının yolunu belirtir. Bu seçenek yalnızca şifreleme etkinleştirildiğinde Strict kullanılabilir. Kabul edilen sertifika biçimleri PEM, DER ve CER'tir. Belirtilirse, sağlanan sertifikanın tam olarak eşleşip eşleşmediği denetlenerek SQL Server sertifikası denetlenir. |
| Sunucu SPN'i | SSPROP_INIT_SERVERSPN | Sunucu için SPN. Varsayılan değer boş bir dizedir. Boş bir dize, SQL Server için OLE DB Sürücüsünün sağlayıcı tarafından oluşturulan varsayılan SPN'yi kullanmasına neden olur. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Ana bilgisayar adının ilk çözümlenen IP'sinin yanıt vermemesi ve konak adıyla ilişkilendirilmiş birden çok IP olması bağlantı sırasını etkiler. TNIR, farklı bağlantı dizileri sağlamak için MultiSubnetFailover ile etkileşim kurar. Olası değerler True ve False şeklindedir. Varsayılan değer şudur: True. Daha fazla bilgi için bkz. Saydam Ağ IP Çözümlemesini Kullanma. |
| Güven Sunucusu Sertifikası1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
true ve false dizelerini değer olarak kabul eder. Varsayılan değer olan false, sunucu sertifikasının doğrulanacağı anlamına gelir. |
| Veri için Şifreleme Kullan1 | SSPROP_INIT_ENCRYPT | Verilerin ağ üzerinden gönderilmeden önce şifrelenip şifrelenmemesi gerektiğini belirtir. Olası değerler Optional, Mandatoryve Strict. Varsayılan değer şudur: Mandatory. 18.x.x sürümleri için bkz. MSOLEDBSQL ana sürüm farklılıkları. |
| FMTONLY kullanma | SSPROP_INIT_USEFMTONLY | SQL Server 2012 (11.x) ve daha yeni sürümlere bağlanırken meta verilerin nasıl alınıp alınyacağını denetler. Olası değerler true ve false şeklindedir. Varsayılan değer şudur: false.Varsayılan olarak, SQL Server için OLE DB Sürücüsü meta verileri almak için sp_describe_first_result_set ve sp_describe_undeclared_parameters saklı yordamları kullanır. Bu saklı yordamların bazı sınırlamaları vardır (örneğin, geçici tablolarda çalışırken başarısız olurlar). FmTONLY kullan ayarının ayarlanması, sürücüye true meta veri almak için SET FMTONLY kullanmasını bildirir. |
| Kullanıcı Kimliği | DBPROP_AUTH_USERID | SQL Server oturum açma adı. |
| İş İstasyonu Kimliği | SSPROP_INIT_WSID | İş istasyonu tanımlayıcısı. |
[1]: Güvenliği geliştirmek için, Kimlik Doğrulaması/Erişim Belirteci başlatma özellikleri veya ilgili bağlantı dizesi anahtar sözcükleri kullanılırken şifreleme ve sertifika doğrulama davranışı değiştirilir. Ayrıntılar için bkz . Şifreleme ve sertifika doğrulama.
Uyarı
Bağlantı dizesinde, sağlayıcı dizesi özelliği üzerinden kullanılamayan SSPROP_AUTH_OLD_PASSWORD'i ayarlayan "Eski Parola" özelliği, geçerli (muhtemelen süresi dolmuş) parolayı belirtir.