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 VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnalytics Platform System (PDW)
Important
SQL Server Native Client (SNAC) ile birlikte gönderilmez:
- SQL Server 2022 (16.x) ve sonraki sürümleri
- SQL Server Management Studio 19 ve sonraki sürümleri
YENI uygulama geliştirme için SQL Server Yerel İstemcisi (SQLNCLI veya SQLNCLI11) ve SQL Server için eski Microsoft OLE DB Sağlayıcısı (SQLOLEDB) önerilmez.
Yeni projeler için aşağıdaki sürücülerden birini kullanın:
SQL Server Veritabanı Altyapısı'nın (sürüm 2012 ile 2019 arasında) bir bileşeni olarak gelen SQLNCLI için, Destek Yaşam Döngüsü özel durumukonusuna bakın.
Bazı SQL Server Native Client API'leri, bağlantı özelliklerini belirtmek için bağlantı dizileri kullanır. Bağlantı dizileri anahtar kelime ve ilişkili değerler listeleridir; Her anahtar kelime belirli bir bağlantı özelliğini tanımlar.
Bilgi için, Using Connection String Keywords with OLE DB Driver for SQL Server bölümüne bakınız.
Note
SQL Server Native Client, bağlantı dizelerinde belirsizliğe izin verir ve geriye doğru uyumluluğu sürdürür (örneğin, bazı anahtar kelimeler birden fazla kez belirtilebilir ve çelişen anahtar kelimelerin konum veya önceliğe göre çözümle izin verilmesine izin verilebilir). Uygulamaları SQL Server Native Client kullanacak şekilde değiştirirken, bağlantı dizesi belirsizliğine olan bağımlılığı ortadan kaldırmak iyi bir uygulamadır.
Aşağıdaki bölümler, SQL Server Native Client OLE DB sağlayıcısı, SQL Server Native Client ODBC sürücüsü ve ActiveX Data Objects (ADO) ile SQL Server Native Client veri sağlayıcısı olarak kullanıldığında kullanılabilecek anahtar kelimeleri tanımlar.
ODBC Driver bağlantı dizesi anahtar kelimeleri
ODBC uygulamaları, bağlantı dizileri olarak SQLDriverConnect ve SQLBrowseConnect fonksiyonlarına parametre olarak kullanılır.
ODBC tarafından kullanılan bağlantı dizeleri aşağıdaki sözdizimine sahiptir:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=[{]attribute-value[}]
attribute-value ::= character-string
attribute-keyword ::= identifier
Özellik değerleri isteğe bağlı olarak braketlerle kaplanabilir ve bu iyi bir uygulamadır. Bu, öznitelik değerleri alfanumerik olmayan karakterler içerdiğinde sorunları önler. Değerdeki ilk kapanış destekçisinin değeri sonlandırdığı varsayılır, bu nedenle değerler kapanış destekli karakterler içeremez.
Aşağıdaki tablo, bir ODBC bağlantı dizesi ile kullanılabilecek anahtar kelimeleri açıklar.
| Keyword | Description |
|---|---|
| Adresi | "Adres" ile eşanlamlı. |
| Adres | 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 Yapılandırma Yöneticisi'da TCP/IP veya adlandırılmış kanallar protokollerinin etkinleştirildiğinden emin olun. SQL Server Native Client kullanıldığında, Address'in değeri, ODBC bağlantı dizislerinde Server'a iletilen 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. Ne protokol ne de Ağ anahtar kelimesi belirtilmemişse, SQL Server Native Client SQL Server Yapılandırma Yöneticisi'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. |
| AnsiNPW | "Evet" olduğunda, sürücü NULL karşılaştırmaları, karakter veri doldurma, uyarılar ve NULL birleştirme işlemleri için ANSI tanımlı davranışları kullanır. "Hayır" olduğunda, ANSI tanımlı davranışlar ortaya çıkmaz. ANSI NPW davranışları hakkında daha fazla bilgi için ISO Seçeneklerinin Etkileri sayfasına bakınız. |
| APP | SQLDriverConnect çağrısı yapan uygulamanın adı (isteğe bağlı). Belirtilirse, bu değer master.dbo.sysprocessessütununda program_name saklanır ve sp_who ile APP_NAME fonksiyonları tarafından döndürülür. |
| ApplicationIntent | Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite. Varsayılan ReadWrite'dır. Örneğin:ApplicationIntent=ReadOnlySQL Server Native Client'ın Always On erişilebilirlik grupları desteği hakkında daha fazla bilgi için SQL Server Native Client Support for High Availability, Disaster Recovery bölümüne bakınız. |
| AttachDBFileName | Bağlanabilir veritabanının birincil dosyasının adı. C karakter dizisi değişkeni kullanılıyorsa tam yolu ekleyin ve herhangi bir \ karakterden kaçın:AttachDBFileName=c:\\MyFolder\\MyDB.mdfBu veritabanı eklenir ve bağlantı için varsayılan veritabanı olur. AttachDBFileName kullanmak için veritabanı adını SQLDriverConnectDATABASE parametresinde veya SQL_COPT_CURRENT_CATALOG bağlantı özniteliğinde belirtmeniz gerekir. Veritabanı daha önce ekliyse, SQL Server onu yeniden bağlamaz; bağlantı için varsayılan olarak eklenmiş veritabanını kullanır. |
| Otomatik Çeviri | "Evet" olduğunda, istemci ile sunucu arasında gönderilen ANSI karakter dizileri, istemci ile sunucudaki kod sayfaları arasındaki genişletilmiş karakterlerin eşleştirilme sorunlarını en aza indirmek için Unicode üzerinden dönüştürülür. Bir SQL Server karakter,varchar veya metin değişkenine, parametresine veya sütununa gönderilen istemci SQL_C_CHAR verisi, istemci ANSI kod sayfası (ACP) kullanılarak karakterden Unicode'a dönüştürülür, ardından sunucunun ACP'si kullanılarak Unicode'dan karaktere dönüştürülür. SQL Server karakter,varcharveya metin verisi, istemci SQL_C_CHAR değişkenine gönderilen veriler, sunucu ACP kullanılarak karakterden Unicode'a, ardından ACP istemcisi kullanılarak Unicode'dan karaktere dönüştürülür. Bu dönüşümler, istemci üzerinde SQL Server Native Client ODBC sürücüsü tarafından gerçekleştirilir. Bu, sunucuda kullanılan aynı ANSI kod sayfasının (ACP) istemci üzerinde de kullanılabilir olmasını gerektirir. Bu ayarlar, bu transferlerde gerçekleşen dönüşümler üzerinde hiçbir etkisi yoktur: * Unicode SQL_C_WCHAR sunucudaki char, varchar veya metne gönderilen istemci verileri. * char,varchar veya metin sunucusu verileri, istemci üzerindeki bir Unicode SQL_C_WCHAR değişkenine gönderilir. * ANSI, sunucudaki Unicode nchar, nvarchar veya ntext'e gönderilen istemci verilerini SQL_C_CHAR. * Unicode nchar, nvarchar veya ntext sunucu verileri istemci üzerindeki ANSI SQL_C_CHAR değişkenine gönderilir. "Hayır" olduğunda karakter çevirisi yapılmaz. SQL Server Native Client ODBC sürücüsü, istemci ANSI karakteri SQL_C_CHAR sunucudaki char, varchar veya metin değişkenlerine, parametrelerine veya sütunlarına gönderilen verileri çevirmez. Sunucudan istemci üzerindeki SQL_C_CHAR değişkenlere gönderilen char, varchar veya metin verilerinde hiçbir çeviri yapılmaz. İstemci ve SQL Server farklı ACP'ler kullanıyorsa, genişletilmiş karakterler yanlış yorumlanabilir. |
| Veritabanı | Bağlantı için varsayılan SQL Server veritabanının adı. Veritabanı belirtilmemişse, giriş için tanımlanan varsayılan veritabanı kullanılır. ODBC veri kaynağından gelen varsayılan veritabanı, giriş için tanımlanan varsayılan veritabanını geçersiz kılmaktadır. Veritabanı, AttachDBFileName de belirtilmedikçe mevcut bir veritabanı olmalıdır. Eğer AttachDBFileName de belirtilmişse, işaret ettiği ana dosya eklenir ve veritabanı tarafından belirtilen veritabanı adı verilir. |
| Sürücü |
SQLDrivers tarafından geri gönderilen sürücünün adı. SQL Server Native Client ODBC sürücüsü için anahtar kelime değeri "{SQL Server Native Client 11.0}"'dir.
Driver belirtildiyse ve DriverCompletion SQL_DRIVER_NOPROMPT olarak ayarlanmışsa Server anahtar kelimesi gereklidir. Sürücü adları hakkında daha fazla bilgi için bkz. SQL Server Yerel İstemci Başlığı ve Kütüphane Dosyalarını Kullanmak. |
| DSN | Mevcut ODBC kullanıcı veya sistem veri kaynağının adı. Bu anahtar kelime, Sunucu, Ağ ve Adres anahtar kelimelerinde belirtilebilecek değerleri geçersiz kılmıştır. |
| Şifreleme | Verilerin ağ üzerinden gönderilmeden önce şifrelenip şifrelenmemesi gerektiğini belirtir. Olası değerler "evet"/"zorunlu"(18.0+), "hayır"/"isteğe bağlı" (18.0+) ve "kat" (18.0+)'dır. Varsayılan değer 18.0+ sürümünde "evet", önceki sürümlerde ise "hayır"dır. |
| Geri dönüş | Bu anahtar kelime kullanımdan kaldırılmıştır ve ayarı SQL Server Native Client ODBC sürücüsü tarafından göz ardı edilmiştir. |
| Failover_Partner | Birincil sunucuyla bağlantı kurulamadığında kullanılacak yük devretme ortağı sunucusunun adı. |
| FailoverPartnerSPN | Yük devretme iş ortağı için SPN. Varsayılan değer boş bir dizedir. Boş bir dizimiz, SQL Server Native Client'ın varsayılan sürücü tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| FileDSN | Mevcut ODBC dosyası veri kaynağının adı. |
| Language | SQL Server dil adı (isteğe bağlı). SQL Server, birden fazla dil için mesajları sysmessage'lerde depolayabilir. Birden fazla dille bir SQL Server'a bağlanıyorsanız, Language bağlantı için hangi mesaj setinin kullanılacağını belirler. |
| MARS_Connection | Bağlantıda birden çok etkin sonuç kümesini (MARS) etkinleştirir veya devre dışı bırakır. Tanınan değerler "evet" ve "hayır"dır. Varsayılan "hayır"dır. |
| MultiSubnetFailover | Bir SQL Server uygunluk grubunun veya bir SQL Server Failover Kümesi Örneği'nin erişilebilirlik grubu dinleyicisine bağlanırken her zaman multiSubnetFailover=Evet olarak belirtin.
multiSubnetFailover=Yes, SQL Server Native Client'ı (şu anda) aktif sunucunun daha hızlı tespitini ve bağlanmasını sağlamak için yapılandırır. Olası değerler Evet ve Hayır'dır. Varsayılan değer Hayır'dır. Örneğin:MultiSubnetFailover=YesSQL Server Native Client'ın Always On erişilebilirlik grupları desteği hakkında daha fazla bilgi için SQL Server Native Client Support for High Availability, Disaster Recovery bölümüne bakınız. |
| Net | "Ağ" ile eşanlamlı. |
| Network | Geçerli değerler dbnmpntw (adlandırılmış borular) ve dbmssocn (TCP/IP)'dir. Sunucu anahtar kelimesinde hem Network anahtar kelimesi için bir değer hem de protokol öneki belirtmek bir hatadır. |
| PWD | UID parametresinde belirtilen SQL Server giriş hesabının şifresi. Giriş şifresi NULL varsa veya Windows Kimlik Doğrulaması (Trusted_Connection = yes) kullanılırken PWD belirtilmesine gerek yok. |
| QueryLog_On | "Evet" olduğunda, bağlantıda uzun süreli sorgu verilerini kaydetmek etkinleştirilir. "Hayır" olduğunda, uzun süreli sorgu verileri kaydedilmez. |
| QueryLogFile | Uzun süre çalışan sorgularda verileri günlüğe kaydetmek için kullanılan dosyanın tam yolu ve dosya adı. |
| QueryLogTime | Uzun süre çalışan sorguların günlüğe kaydedilmesi için eşiği (milisaniye cinsinden) belirten rakam karakter dizesi. Belirtilen sürede yanıt alamayan herhangi bir sorgu, uzun süreli sorgu logu dosyasına yazılır. |
| QuotedId | Bağlantı için "evet" QUOTED_IDENTIFIER ON'a ayarlandığında, SQL Server SQL ifadelerinde tırnak işareti kullanımıyla ilgili ISO kurallarını kullanır. Yok olduğunda, QUOTED_IDENTIFIER bağlantı için KAPALı olarak ayarlanır. SQL Server daha sonra SQL ifadelerinde tırnak işareti kullanımıyla ilgili eski Transact-SQL kurallarına uyar. Daha fazla bilgi için ISO Seçeneklerinin Etkileri bölümüne bakınız. |
| Bölgesel | "Evet" olduğunda, SQL Server Native Client ODBC sürücüsü, para birimi, tarih ve zaman verilerini karakter verisine dönüştürürken istemci ayarlarını kullanır. Dönüşüm sadece tek yönlü; sürücü, tarih dizileri veya içindeki para birimi değerleri için ODBC dışı standart formatları tanımaz; örneğin, bir INSERT veya UPDATE ifadesinde kullanılan bir parametre. "Hayır" olduğunda, sürücü ODBC standart dizileri kullanarak para birimi, tarih ve zaman verilerini temsil eder ve bu veriler karakter verisine dönüştürülür. |
| SaveFile | Bağlantı başarılı olursa, geçerli bağlantının özniteliklerinin kaydedildiği ODBC veri kaynağı dosyasının adı. |
| Server | SQL Server örneğinin adı. Değer, ağdaki bir sunucunun adı, IP adresi veya SQL Server Yapılandırma Yöneticisi diğer adının adı olmalıdır. Address anahtar sözcüğü, Server anahtar sözcüğünü geçersiz kılar. Yerel sunucudaki varsayılan örneke aşağıdakilerden birini belirterek bağlanabilirsiniz: Sunucu=; Sunucu=.; Server=(local); Server=(local); Server=(localhost); Server=(localdb)\instancename; LocalDB desteği hakkında daha fazla bilgi için SQL Server Native Client Support for LocalDB bölümüne bakınız. 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 Yapılandırma Yöneticisi'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ğıda adlandırılmış bir boru belirtilme örneği verilmiştir: np:\\.\pipe\MSSQL$MYINST01\sql\queryBu satır, isimli boru protokolü, yerel makinedeki isimli boru ( \\.\pipe), SQL Server örneğinin adını (MSSQL$MYINST01), ve adlandırılmış borunun varsayılan adını (sql/query). belirtir.Bir protokol veya Network anahtar kelimesi belirtilmediyse, SQL Server Native Client SQL Server Yapılandırma Yöneticisi'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 Native Client kullanıldığında, ODBC bağlantı dizislerinde Server'a iletilen değerin başında boşluklar göz ardı edilir. |
| ServerSPN | Sunucu için SPN. Varsayılan değer boş bir dizedir. Boş bir dizimiz, SQL Server Native Client'ın varsayılan sürücü tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| StatsLog_On | "Evet" olduğunda, SQL Server Native Client ODBC sürücü performans verilerinin yakalanması mümkün olur. "Hayır" olduğunda, SQL Server Native Client ODBC sürücü performans verileri bağlantıda mevcut değildir. |
| StatsLogFile | SQL Server Native Client ODBC sürücüsünün performans istatistiklerini kaydetmek için kullanılan dosyanın tam yolu ve adı. |
| Trusted_Connection | "Evet" olduğunda, SQL Server Native Client ODBC sürücüsüne giriş doğrulaması için Windows Kimlik Doğrulama Modu kullanmasını talimat verir. Aksi takdirde, SQL Server Native Client ODBC sürücüsüne giriş doğrulaması için SQL Server kullanıcı adı ve şifresi kullanmasını ve UID ile PWD anahtar kelimelerinin belirtilmesi gerektiğini belirtir. |
| TrustServerCertificate | Encrypt ile kullanıldığında, kendi imzalı sunucu sertifikası kullanılarak şifreleme mümkün olur. |
| UID | Geçerli bir SQL Server giriş hesabı. Windows Kimlik Doğrulaması kullanılırken UID belirtilmesine gerek yoktur. |
| UseProcForPrepare | Bu anahtar kelime kullanımdan kaldırılmıştır ve SQL Server Native Client ODBC Driver tarafından göz ardı edilmiştir. |
| WSID | İş istasyonu kimliği. Genellikle, bu uygulamanın bulunduğu bilgisayarın ağ adıdır (isteğe bağlı). Belirtilirse, bu değer master.dbo.sysprocessessütun ana adında saklanır ve sp_who ile HOST_NAME fonksiyonu tarafından döndürülür. |
Note
Bölgesel dönüşüm ayarları para birimi, sayısal, tarih ve saat veri türlerine uygulanır. Dönüştürme ayarı yalnızca çıktı dönüşümü için geçerlidir ve yalnızca para birimi, sayısal, tarih veya zaman değerleri karakter dizelerine dönüştürüldüğünde görünürdür.
SQL Server Native Client ODBC sürücüsü, mevcut kullanıcı için yerel kayıt listesi ayarlarını kullanır. Sürücü, uygulama bağlantı sonrası örneğin SetThreadLocale çağırarak ayarlıyorsa, mevcut iş parçacığının konumunu onurlandırmaz.
Bir veri kaynağının bölgesel davranışını değiştirmek uygulama arızasına neden olabilir. Tarih dizelerini ayrıştıran ve tarih dizelerinin ODBC tarafından tanımlandığı şekilde görünmesini bekleyen bir uygulama, bu değerin değiştirilmesiyle olumsuz etkilenebilir.
OLE DB Provider Bağlantı Dizisi Anahtar Kelimeler
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.
Sağlayıcı dizislerinde DBPROP_INIT_PROVIDERSTRING değerlerle belirlenen Boolean özellikler, "evet" ve "hayır" değerleri kullanılarak ayarlanır. IDataInitialize::GetDataSource kullanılarak başlatma dizislerinde belirlenen boolean özellikler, "true" ve "false" değerleri kullanılarak ayarlanır.
IDataInitialize::GetDataSource kullanan uygulamalar, IDnitialize::Initialize tarafından kullanılan anahtar kelimeleri de kullanabilir, ancak yalnızca varsayılan değeri olmayan özellikler için. 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:GetDataSource bağlantı dizelerinde IDBInitialize::Initialize anahtar kelimelerini kullanmamaları şiddetle tavsiye edilir; çünkü bu davranış gelecekteki sürümlerde sürdürülmeyebilir.
Note
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, bağlantı dizesi Data Source=server1 olarak belirtirseniz; Sunucu=sunucu2, Veri Kaynağı bir özellik olarak ayarlanır, ancak Sunucu bir sağlayıcı dizisine girer.
Aynı sağlayıcıya özgü özelliğin birden çok örneğini belirtirseniz, ilk özelliğin ilk değeri kullanılır.
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-string
empty-string ::=
attribute ::= attribute-keyword=[{]attribute-value[}]
attribute-value ::= character-string
attribute-keyword ::= identifier
Özellik değerleri isteğe bağlı olarak braketlerle kaplanabilir ve bu iyi bir uygulamadır. Bu, öznitelik değerleri alfanumerik olmayan karakterler içerdiğinde sorunları önler. Değerdeki ilk kapanış destekçisinin değeri sonlandırdığı varsayılır, bu nedenle değerler kapanış destekli karakterler içeremez.
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.
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" ile eşanlamlı. |
| Adres | SSPROP_INIT_NETWORKADDRESS | Kuruluştaki bir SQL Server örneğinin ağ adresi. Geçerli adres sözdizimi hakkında daha fazla bilgi için, bu konunun ilerleyen bölümlerinde Address ODBC anahtar kelimesinin açıklamasına bakınız. |
| 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. Varsayılan ReadWrite'dır. SQL Server Native Client'ın Always On erişilebilirlik grupları desteği hakkında daha fazla bilgi için SQL Server Native Client Support for High Availability, Disaster Recovery bölümüne bakınız. |
| 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 bağlıysa, SQL Server onu yeniden bağlamaz (bağlantı için varsayılan olarak eklenmiş veritabanını kullanır). |
| Otomatik Çevir | SSPROP_INIT_AUTOTRANSLATE | "Otomatik Çeviri" ile eşanlamlı. |
| Otomatik Çeviri | SSPROP_INIT_AUTOTRANSLATE | OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler "evet" ve "hayır"dır. |
| 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 tipleri için "0" ve SQL Server 2000 veri tipleri için "80"dir. |
| Şifreleme | SSPROP_INIT_ENCRYPT | Verilerin ağ üzerinden gönderilmeden önce şifrelenip şifrelenmemesi gerektiğini belirtir. Olası değerler "evet" ve "hayır"dır. Varsayılan değer "hayır"dır. |
| 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 dizimiz, SQL Server Native Client'ın varsayılan, sağlayıcı tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| 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 "evet" ve "hayır"dır. Varsayılan değer "hayır"dır. |
| Net | SSPROP_INIT_NETWORKLIBRARY | "Ağ" ile eşanlamlı. |
| 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ğ" ile eşanlamlı. |
| PacketSize | SSPROP_INIT_PACKETSIZE | Ağ paketi boyutu. Varsayılan olarak 4096’dır. |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | "Evet" ve "hayır" dizelerini değer olarak kabul eder. "Hayır" olduğunda, veri kaynağı nesnesinin hassas kimlik doğrulama bilgilerini sürdürmesine izin verilmez |
| PWD | DBPROP_AUTH_PASSWORD | SQL Server oturum açma parolası. |
| Server | 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özdizimi hakkında daha fazla bilgi için, bu konudaki Server ODBC anahtar kelimesinin açıklamasına bakınız. |
| ServerSPN | SSPROP_INIT_SERVERSPN | Sunucu için SPN. Varsayılan değer boş bir dizedir. Boş bir dizimiz, SQL Server Native Client'ın varsayılan, sağlayıcı tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| Timeout | DBPROP_INIT_TIMEOUT | Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | "Evet" sesi olduğunda, SQL Server Native Client OLE DB sağlayıcısına giriş doğrulaması için Windows Kimlik Doğrulama Modu'nu kullanmasını talimatlandırır. Aksi takdirde, SQL Server Native Client OLE DB sağlayıcısına giriş doğrulaması için SQL Server kullanıcı adı ve şifresi kullanmasını ve UID ile PWD anahtar kelimelerinin belirtilmesi gerektiğini belirtir. |
| TrustServerCertificate | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | "Evet" ve "hayır" dizelerini değer olarak kabul eder. Varsayılan değer "hayır"dır, bu da sunucu sertifikasının doğrulanacağı anlamına gelir. |
| UID | DBPROP_AUTH_USERID | SQL Server oturum açma adı. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Bu anahtar kelime kullanımdan geçerlidir ve SQL Server Native Client OLE DB Provider tarafından göz ardı edilir. |
| WSID | SSPROP_INIT_WSID | İş istasyonu tanımlayıcısı. |
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-string
empty-string ::=
attribute ::= attribute-keyword=[quote]attribute-value[quote]
attribute-value ::= character-string
attribute-keyword ::= identifier
quote ::= " | '
Ö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ı veya sayılmış bir özellikten alıntı yapmaya çalışmak, "Bağlantı Dizisi OLE DB spesifikasyonuna uygun değil" hatasına yol açar.
Özellik değerleri isteğe bağlı olarak tek veya çift tırnak içinde eklenebilir ve bu iyi bir uygulamadır. Bu, değerlerin alfanumerik olmayan karakterler içerdiğinde yaşanan sorunları önler. Kullanılan tırnak karakteri, iki katına çıkarılması koşuluyla değerlerde de görünebilir.
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 | Açıklama |
|---|---|---|
| Uygulama Adı | SSPROP_INIT_APPNAME | Uygulamayı tanımlayan dize. |
| Uygulama Amacı | SSPROP_INIT_APPLICATIONINTENT (uygulama amacı) | "ApplicationIntent" ile eşanlamlı. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT (uygulama amacı) | Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite. Varsayılan ReadWrite'dır. SQL Server Native Client'ın Always On erişilebilirlik grupları desteği hakkında daha fazla bilgi için SQL Server Native Client Support for High Availability, Disaster Recovery bölümüne bakınız. |
| Otomatik Çevir | SSPROP_INIT_AUTOTRANSLATE | "Otomatik Çeviri" ile eşanlamlı. |
| Otomatik Çeviri | SSPROP_INIT_AUTOTRANSLATE | OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler "doğru" ve "yanlış"tır. |
| Bağlanma Zaman Aşımı | DBPROP_INIT_TIMEOUT | Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
| Geçerli Dil | SSPROP_INIT_GEÇERLİDİL | 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özdizimi hakkında daha fazla bilgi için, bu konunun ilerleyen bölümlerinde bulunan Server ODBC anahtar kelimesinin açıklamasına bakınız. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Kullanılacak veri türü işleme modunu belirtir. Tanınan değerler, sağlayıcı veri tipleri için "0" ve SQL Server 2000 (8.x) veri tipleri için "80"dir. |
| Yük Devretme İş Ortağı | SSPROP_INIT_FAILOVERPARTNER | Veritabanı yansıtmasında 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 dizimiz, SQL Server Native Client'ın varsayılan, sağlayıcı tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| İ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ı sağlayıcı dizisi DATABASE anahtar kelimesiyle belirtmeniz gerekir. Veritabanı daha önce bağlıysa, SQL Server onu yeniden bağlamaz (bağlantı için varsayılan olarak eklenmiş veritabanını kullanır). |
| Tümleşik Güvenlik | DBPROP_AUTH_INTEGRATED | Windows Kimlik Doğrulaması için "SSPI" değerini 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 "doğru" ve "yanlış"tır. Varsayılan "yanlış". |
| Ağ Adresi | SSPROP_INIT_NETWORKADDRESS | Kuruluştaki bir SQL Server örneğinin ağ adresi. Geçerli adres sözdizimi hakkında daha fazla bilgi için, bu konunun ilerleyen bölümlerinde Address ODBC anahtar kelimesinin açıklamasına bakınız. |
| 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 | Ağ paketi boyutu. Varsayılan olarak 4096’dır. |
| Parola | DBPROP_AUTH_PASSWORD | SQL Server oturum açma parolası. |
| Güvenlik Bilgilerini Sakla | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | "Doğru" ve "yanlış" dizelerini değer olarak kabul eder. "Yanlış" olduğunda, veri kaynağı nesnesinin hassas kimlik doğrulama bilgisini kalıcı olarak kullanmasına izin verilmez |
| Sağlayıcı | SQL Server Native Client için bu "SQLNCLI11" olmalıdır. | |
| Sunucu SPN'i | SSPROP_INIT_SERVERSPN | Sunucu için SPN. Varsayılan değer boş bir dizedir. Boş bir dizimiz, SQL Server Native Client'ın varsayılan, sağlayıcı tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| Güven Sunucusu Sertifikası | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | "Doğru" ve "yanlış" dizelerini değer olarak kabul eder. Varsayılan değer "yanlış"tır, yani sunucu sertifikası doğrulanacaktır. |
| Veri için Şifreleme Kullanın | SSPROP_INIT_ENCRYPT | Verilerin ağ üzerinden gönderilmeden önce şifrelenip şifrelenmemesi gerektiğini belirtir. Olası değerler "doğru" ve "yanlış"tır. Varsayılan değer "false"tur. |
| Kullanıcı Kimliği | DBPROP_AUTH_USERID | SQL Server oturum açma adı. |
| İş İstasyonu Kimliği | SSPROP_INIT_WSID | İş istasyonu tanımlayıcısı. |
Not bağlantı dizesi "Eski Şifre" özelliği SSPROP_AUTH_OLD_PASSWORD ayar, bu mevcut (muhtemelen süresi dolmuş) ve sağlayıcı dizisi özelliği aracılığıyla erişilemeyen şifredir.
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ı ayrıca OLE DB IDBInitialize::Initialize yönteminde kullanılan anahtar kelimeleri kullanabilir, ancak yalnızca varsayılan değeri olmayan özellikler için. 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 kelimelerini kullanmaları şiddetle tavsiye edilir.
ADO tarafından kullanılan bağlantı dizeleri aşağıdaki söz dizimine sahiptir:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=["]attribute-value["]
attribute-value ::= character-string
attribute-keyword ::= identifier
Özellik değerleri isteğe bağlı olarak çift tırnak içinde eklenebilir ve bu iyi bir uygulamadır. Bu, değerlerin alfanumerik olmayan karakterler içerdiğinde yaşanan sorunları önler. Özellik 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 | Açıklama |
|---|---|---|
| Uygulama Amacı | SSPROP_INIT_APPLICATIONINTENT (uygulama amacı) | "ApplicationIntent" ile eşanlamlı. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT (uygulama amacı) | Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite. Varsayılan ReadWrite'dır. SQL Server Native Client'ın Always On erişilebilirlik grupları desteği hakkında daha fazla bilgi için SQL Server Native Client Support for High Availability, Disaster Recovery bölümüne bakınız. |
| Uygulama Adı | SSPROP_INIT_APPNAME | Uygulamayı tanımlayan dize. |
| Otomatik Çevir | SSPROP_INIT_AUTOTRANSLATE | "Otomatik Çeviri" ile eşanlamlı. |
| Otomatik Çeviri | SSPROP_INIT_AUTOTRANSLATE | OEM/ANSI karakter çevirisini yapılandırır. Tanınan değerler "doğru" ve "yanlış"tır. |
| Bağlanma Zaman Aşımı | DBPROP_INIT_TIMEOUT | Veri kaynağı başlatma işleminin tamamlanmasını bekleme süresi (saniye cinsinden). |
| Geçerli Dil | SSPROP_INIT_GEÇERLİDİL | 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özdizimi hakkında daha fazla bilgi için, bu konudaki Server ODBC anahtar kelimesinin açıklamasına bakınız. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Kullanılacak veri türü işleme modunu belirtir. Tanınan değerler sağlayıcı veri tipleri için "0" ve SQL Server 2000 veri tipleri için "80"dir. |
| Yük Devretme İş Ortağı | SSPROP_INIT_FAILOVERPARTNER | Veritabanı yansıtmasında 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 dizimiz, SQL Server Native Client'ın varsayılan, sağlayıcı tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| İ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ı sağlayıcı dizisi DATABASE anahtar kelimesiyle belirtmeniz gerekir. Veritabanı daha önce bağlıysa, SQL Server onu yeniden bağlamaz (bağlantı için varsayılan olarak eklenmiş veritabanını kullanır). |
| Tümleşik Güvenlik | DBPROP_AUTH_INTEGRATED | Windows Kimlik Doğrulaması için "SSPI" değerini 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 "doğru" ve "yanlış"tır. Varsayılan "yanlış". |
| Ağ Adresi | SSPROP_INIT_NETWORKADDRESS | Kuruluştaki bir SQL Server örneğinin ağ adresi. Geçerli adres sözdizimi hakkında daha fazla bilgi için, bu konudaki Address ODBC anahtar kelimesinin açıklamasına bakınız. |
| 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 | Ağ paketi boyutu. Varsayılan olarak 4096’dır. |
| Parola | DBPROP_AUTH_PASSWORD | SQL Server oturum açma parolası. |
| Güvenlik Bilgilerini Sakla | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | "Doğru" ve "yanlış" dizelerini değer olarak kabul eder. "Yanlış" olduğunda, veri kaynağı nesnesinin hassas kimlik doğrulama bilgisini sürdürmesine izin verilmez. |
| Sağlayıcı | SQL Server Native Client için bu "SQLNCLI11" olmalıdır. | |
| Sunucu SPN'i | SSPROP_INIT_SERVERSPN | Sunucu için SPN. Varsayılan değer boş bir dizedir. Boş bir dizimiz, SQL Server Native Client'ın varsayılan, sağlayıcı tarafından oluşturulan SPN'yi kullanmasına neden olur. |
| Güven Sunucusu Sertifikası | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | "Doğru" ve "yanlış" dizelerini değer olarak kabul eder. Varsayılan değer "yanlış"tır, yani sunucu sertifikası doğrulanacaktır. |
| Veri için Şifreleme Kullanın | SSPROP_INIT_ENCRYPT | Verilerin ağ üzerinden gönderilmeden önce şifrelenip şifrelenmemesi gerektiğini belirtir. Olası değerler "doğru" ve "yanlış"tır. Varsayılan değer "false"tur. |
| Kullanıcı Kimliği | DBPROP_AUTH_USERID | SQL Server oturum açma adı. |
| İş İstasyonu Kimliği | SSPROP_INIT_WSID | İş istasyonu tanımlayıcısı. |
Note
bağlantı dizesi "Eski Şifre" özelliği SSPROP_AUTH_OLD_PASSWORD ayar, bu mevcut (muhtemelen süresi dolmuş) ve sağlayıcı dizisi özelliği aracılığıyla erişilemeyen şifredir.