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 Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analitik 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ü, geriye dönük uyumluluğu korumak için bağlantı dizelerinde 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 verilebiliyor olabilir). 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::InitializeIDataInitialize::GetDataSource
İlk durumda, özellik kümesindeki özelliği DBPROP_INIT_PROVIDERSTRINGDBPROPSET_DBINIT ayarlayarak 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. tarafından IDataInitialize::GetDataSource kullanılan anahtar sözcük kümesi, başlatma özellik grubu içindeki ö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.
Sağlayıcı dizelerinde DBPROP_INIT_PROVIDERSTRING değerleri kullanılarak ayarlanan Boole özellikleri, yes ve no değerleri ile ayarlanır. Başlatma dizelerinde IDataInitialize::GetDataSource kullanılarak ayarlanan Boole özellikleri, true ve false değerleri kullanılarak ayarlanır.
IDataInitialize::GetDataSource kullanan uygulamalar, yalnızca varsayılan değeri olmayan özellikler için, IDBInitialize::Initialize tarafından kullanılan anahtar sözcükleri de kullanabilir. Başlatma dizesinde bir uygulama IDataInitialize::GetDataSource anahtar sözcüğünü ve IDBInitialize::Initialize anahtar sözcüğünü kullanıyorsa, IDataInitialize::GetDataSource anahtar sözcük ayarı kullanılır. Bu davranış gelecek sürümlerde korunmayabileceği için uygulamaların bağlantı dizelerinde IDBInitialize::Initialize anahtar sözcükler kullanmaması IDataInitialize:GetDataSource önerilir.
Uyarı
IDataInitialize::GetDataSource ile 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 içinde özellik açıklamasını bulduysa, bu özellik bağımsız bir özellik olarak uygulanır. Aksi takdirde, DBPROP_PROVIDERSTRING özelliği üzerinden uygulanır. Örneğin, bağlantı dizesini Data Source=server1;Server=server2Data Source belirtirseniz, bir özellik olarak ayarlanır, ancak Server 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
DBPROP_INIT_PROVIDERSTRING ile IDBInitialize::Initialize kullanan OLE DB uygulamalarının kullandığı bağlantı dizgeleri aşağıdaki yapıya 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 ile DBPROP_INIT_PROVIDERSTRINGkullanılabilecek anahtar sözcükler açıklanmaktadır.
| Keyword | Başlatma özelliği | Description |
|---|---|---|
Addr |
SSPROP_INIT_NETWORKADDRESS |
Address için eş anlamlı. |
Address |
SSPROP_INIT_NETWORKADDRESS |
SQL Server örneğini çalıştıran sunucunun ağ adresi.
Address 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. OLE DB Sürücüsü SQL Server için kullanılırken, bağlantı dizelerinde Server'ye geçirilen değerden Address'nin değeri önceliklidir.
Address=; anahtar sözcüğünde Server belirtilen sunucuya bağlanırken Address= ;, Address=.;, Address=localhost;ve Address=(local); tümü yerel sunucuya bir bağlantıya neden olur.Anahtar sözcüğün Address tam söz dizimi aşağıdaki gibidir:[protokol:]Adres[,port|\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 Network anahtar sözcük 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 bağlantı noktasını 1433kullanır. |
APP |
SSPROP_INIT_APPNAME |
Uygulamayı tanımlayan dize. |
ApplicationIntent |
SSPROP_INIT_APPLICATIONINTENT |
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 belirtmeniz de 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). |
Authentication
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 Integrated Security) anahtar sözcüklerini veya ilgili özelliklerini kullanan Trusted_Connection uygulamalar, yeni şifreleme ve sertifika doğrulama davranışını etkinleştirmek için Authentication anahtar sözcüğün ActiveDirectoryIntegrated (veya ilgili özelliğinin) değerini olarak ayarlamalıdır.Not: SQL Server kimlik doğrulaması kullanan uygulamalar Authentication etkinleştirmek için SqlPassword anahtar sözcüğün değerini (veya buna karşılık gelen özelliğini) olarak ayarlamalıdır. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
AutoTranslate için eş anlamlı. |
AutoTranslate |
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. değeri 0 yeniden bağlanma girişimine neden olmaz. Daha fazla bilgi için bkz . OLE DB Sürücüsünde 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 . OLE DB Sürücüsünde boşta bağlantı dayanıklılığı. |
Database |
DBPROP_INIT_CATALOG |
Veritabanı adı. |
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. |
Encrypt
1 |
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ı. |
FailoverPartner |
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ük ayarlanmamışsa, sürücü SQL Server TLS/SSL sertifikasını Server doğrulamak için ana bilgisayar adı olarak bağlantı URL'sinde anahtar sözcük değerini kullanır.Not: Sunucu sertifikasına güveniliyorsa bu özellik yoksayılır. olarak ayarlanırsa EncryptStrict, sertifika her zaman doğrulanır. |
Language |
SSPROP_INIT_CURRENTLANGUAGE |
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 |
SQL Server kullanılabilirlik grubu dinleyicisine ya da bir SQL Server Yük Devretme Kümesi Örneğine bağlanırken her zaman MultiSubnetFailover=Yes ifadesini belirtin.
MultiSubnetFailover=Yes , (ş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 |
Network için eş anlamlısı. |
Network |
SSPROP_INIT_NETWORKLIBRARY |
Kuruluştaki bir SQL Server örneğine bağlantı kurmak için kullanılan ağ kitaplığı. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
için Networkeş anlamlı. |
PacketSize |
SSPROP_INIT_PACKETSIZE |
Tablosal Veri Akışı (TDS) paket boyutu. Varsayılan değerdir 0 (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ı. |
Server |
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 kelimesi, Server anahtar kelimesini geçersiz kılar.Aşağıdaki seçeneklerden birini belirterek yerel sunucudaki varsayılan örneğe bağlanabilirsiniz: Server=;Server=.;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 öğesini ekleyin \<InstanceName>.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. Anahtar sözcüğün Server tam söz dizimi aşağıdaki gibidir:[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 Network anahtar sözcük 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 bağlantı noktasını 1433kullanır.SQL Server için OLE DB Sürücüsü kullanılırken bağlantı dizelerinde geçirilen Server değerinin 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. |
TrustServerCertificate
1 |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
yes ve no dizelerini değer 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). ayarı UseFMTONLY , sürücüye yes meta veri almak için SET FMTONLY kullanmasını bildirir. |
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 Kimlik Doğrulaması veya Erişim Belirteci başlatma özellikleri veya ilgili bağlantı dizesi anahtar sözcükleri kullanılırken güvenliği geliştirmek için şifreleme ve sertifika doğrulama davranışı değiştirilir. Daha fazla bilgi için bkz . Şifreleme ve sertifika doğrulama.
IDataInitialize::GetDataSource yöntemini kullanın
kullanan OLE DB uygulamaları IDataInitialize::GetDataSource 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=[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 parantezleri ({}) tırnak işareti olarak kullanılır ve Application Name tek (') veya çift (") tırnak işareti 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 ile IDataInitialize::GetDataSourcekullanılabilecek anahtar sözcükler açıklanmaktadır:
| Keyword | Başlatma özelliği | Description |
|---|---|---|
Access Token
1 |
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. |
Application Name |
SSPROP_INIT_APPNAME |
Uygulamayı tanımlayan dize. |
Application Intent |
SSPROP_INIT_APPLICATIONINTENT |
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. |
Authentication
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 Integrated Security) anahtar sözcüklerini veya ilgili özelliklerini kullanan Trusted_Connection uygulamalar, yeni şifreleme ve sertifika doğrulama davranışını etkinleştirmek için Authentication anahtar sözcüğün ActiveDirectoryIntegrated (veya ilgili özelliğinin) değerini olarak ayarlamalıdır.Not: SQL Server kimlik doğrulaması kullanan uygulamalar Authentication etkinleştirmek için SqlPassword anahtar sözcüğün değerini (veya buna karşılık gelen özelliğini) olarak ayarlamalıdır. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler true ve false'dir. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
Connect Retry Count |
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. değeri 0 yeniden bağlanma girişimine neden olmaz. Daha fazla bilgi için bkz . OLE DB Sürücüsünde boşta bağlantı dayanıklılığı. |
Connect Retry Interval |
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 . OLE DB Sürücüsünde boşta bağlantı dayanıklılığı. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
SQL Server dil adı. |
Data Source |
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 anahtar sözcüğün Server 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. |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
Veritabanı yansıtmasında kullanılan yük devretme sunucusunun adı. |
Failover Partner 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. |
Host Name In Certificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
SQL Server TLS/SSL sertifikasının doğrulanmasında kullanılacak ana bilgisayar adı.
Host Name In Certificate Anahtar sözcük ayarlanmamışsa, sürücü SQL Server TLS/SSL sertifikasını Data Source doğrulamak için ana bilgisayar adı olarak bağlantı URL'sinde anahtar sözcük değerini kullanır.Not: Sunucu sertifikasına güveniliyorsa bu özellik yoksayılır. olarak ayarlanırsa Use Encryption for DataStrict, sertifika her zaman doğrulanır. |
Initial Catalog |
DBPROP_INIT_CATALOG |
Veritabanı adı. |
Initial File Name |
SSPROP_INIT_FILENAME |
Eklenebilir veritabanının birincil dosyasının adı (tam yol adını içerir). kullanmak AttachDBFileNameiçin, sağlayıcı dizesi DATABASE anahtar sözcüğüyle veritabanı adını da 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). |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Windows Kimlik Doğrulaması değerini SSPI kabul eder. |
MARS Connection |
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 |
SQL Server kullanılabilirlik grubu dinleyicisine ya da bir SQL Server Yük Devretme Kümesi Örneğine bağlanırken her zaman MultiSubnetFailover=True ifadesini 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. |
Network Address |
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 anahtar sözcüğün Address açıklamasına bakın. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
Kuruluştaki bir SQL Server örneğine bağlantı kurmak için kullanılan ağ kitaplığı. |
Packet Size |
SSPROP_INIT_PACKETSIZE |
Tablosal Veri Akışı (TDS) paket boyutu. Varsayılan değerdir 0 (gerçek değer sunucu tarafından belirlenir). |
Password |
DBPROP_AUTH_PASSWORD |
SQL Server oturum açma parolası. |
Persist Security Info |
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. |
Provider |
SQL Server'ın OLE DB Sürücüsü için değer MSOLEDBSQL19 veya MSOLEDBSQL olabilir. |
|
Server Certificate |
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. |
Server SPN |
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. |
Trust Server Certificate
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. |
Use Encryption for Data
1 |
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ı. |
Use FMTONLY |
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). ayarı Use FMTONLY , sürücüye true meta veri almak için SET FMTONLY kullanmasını bildirir. |
User ID |
DBPROP_AUTH_USERID |
SQL Server oturum açma adı. |
Workstation ID |
SSPROP_INIT_WSID |
İş istasyonu tanımlayıcısı. |
1 Kimlik Doğrulaması/Erişim Belirteci başlatma özellikleri veya ilgili bağlantı dizesi anahtar sözcükleri kullanılırken güvenliği geliştirmek için şifreleme ve sertifika doğrulama davranışı değiştirilir. Ayrıntılar için bkz . Şifreleme ve sertifika doğrulama.
Uyarı
Bağlantı dizesinde, bir sağlayıcı dizesi özelliği aracılığıyla kullanılamayan, mevcut (süresi dolmuş olabilir) parola olan SSPROP_AUTH_OLD_PASSWORD özelliğini 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ğere sahip olmayan özellikler için kullanılabilir. Bir uygulama hem ADO anahtar sözcüklerini IDBInitialize::Initialize hem de başlatma dizesindeki anahtar sözcükleri 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 |
|---|---|---|
Access Token
1 |
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. |
Application Intent |
SSPROP_INIT_APPLICATIONINTENT |
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. |
Application Name |
SSPROP_INIT_APPNAME |
Uygulamayı tanımlayan dize. |
Authentication
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 Integrated Security) anahtar sözcüklerini veya ilgili özelliklerini kullanan Trusted_Connection uygulamalar, yeni şifreleme ve sertifika doğrulama davranışını etkinleştirmek için Authentication anahtar sözcüğün ActiveDirectoryIntegrated (veya ilgili özelliğinin) değerini olarak ayarlamalıdır.Not: SQL Server kimlik doğrulaması kullanan uygulamalar Authentication etkinleştirmek için SqlPassword anahtar sözcüğün değerini (veya buna karşılık gelen özelliğini) olarak ayarlamalıdır. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler true ve false'dir. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
Connect Retry Count |
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. değeri 0 yeniden bağlanma girişimine neden olmaz. Daha fazla bilgi için bkz . OLE DB Sürücüsünde boşta bağlantı dayanıklılığı. |
Connect Retry Interval |
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 . OLE DB Sürücüsünde boşta bağlantı dayanıklılığı. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
SQL Server dil adı. |
Data Source |
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 anahtar sözcüğün Server 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. |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
Veritabanı yansıtmasında kullanılan yük devretme sunucusunun adı. |
Failover Partner 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. |
Host Name In Certificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
SQL Server TLS/SSL sertifikasının doğrulanmasında kullanılacak ana bilgisayar adı.
Host Name In Certificate Anahtar sözcük ayarlanmamışsa, sürücü SQL Server TLS/SSL sertifikasını Data Source doğrulamak için ana bilgisayar adı olarak bağlantı URL'sinde anahtar sözcük değerini kullanır.Not: Sunucu sertifikasına güveniliyorsa bu özellik yoksayılır. olarak ayarlanırsa Use Encryption for DataStrict, sertifika her zaman doğrulanır. |
Initial Catalog |
DBPROP_INIT_CATALOG |
Veritabanı adı. |
Initial File Name |
SSPROP_INIT_FILENAME |
Eklenebilir veritabanının birincil dosyasının adı (tam yol adını içerir). Kullanmak için AttachDBFileName, veritabanı adını sağlayıcı dizesi DATABASE anahtar sözcüğü ile 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). |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Windows Kimlik Doğrulaması değerini SSPI kabul eder. |
MARS Connection |
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 |
SQL Server kullanılabilirlik grubu dinleyicisine ya da bir SQL Server Yük Devretme Kümesi Örneğine bağlanırken her zaman MultiSubnetFailover=True ifadesini 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. |
Network Address |
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 anahtar sözcüğün Address açıklamasına bakın. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
Kuruluştaki bir SQL Server örneğine bağlantı kurmak için kullanılan ağ kitaplığı. |
Packet Size |
SSPROP_INIT_PACKETSIZE |
Tablosal Veri Akışı (TDS) paket boyutu. Varsayılan değerdir 0 (gerçek değer sunucu tarafından belirlenir). |
Password |
DBPROP_AUTH_PASSWORD |
SQL Server oturum açma parolası. |
Persist Security Info |
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. |
Provider |
SQL Server'ın OLE DB Sürücüsü için değer MSOLEDBSQL19 veya MSOLEDBSQL olabilir. |
|
Server Certificate |
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. |
Server SPN |
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. |
Trust Server Certificate
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. |
Use Encryption for Data
1 |
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ı. |
Use FMTONLY |
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). Bu ayar Use FMTONLY, sürücüye true yerine meta veri almak için SET FMTONLY kullanması talimatını verir. |
User ID |
DBPROP_AUTH_USERID |
SQL Server oturum açma adı. |
Workstation ID |
SSPROP_INIT_WSID |
İş istasyonu tanımlayıcısı. |
1 Kimlik Doğrulaması/Erişim Belirteci başlatma özellikleri veya ilgili bağlantı dizesi anahtar sözcükleri kullanılırken güvenliği geliştirmek için şifreleme ve sertifika doğrulama davranışı değiştirilir. Ayrıntılar için bkz . Şifreleme ve sertifika doğrulama.
Uyarı
Bağlantı dizesinde, "Eski Parola" özelliği, bir sağlayıcı dizesi özelliği aracılığıyla kullanılamayan geçerli (muhtemelen süresi dolmuş) parola olan öğesini ayarlar SSPROP_AUTH_OLD_PASSWORD.