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 (genellikle kısaltılmış SNAC) SQL Server 2022 (16.x) ve SQL Server Management Studio 19'dan (SSMS) kaldırılmıştır. Hem SQL Server Yerel İstemci OLE DB sağlayıcısı (SQLNCLI veya SQLNCLI11) hem de SQL Server için eski Microsoft OLE DB Sağlayıcısı (SQLOLEDB) yeni geliştirme için önerilmez. İleride SQL Server için yeni Microsoft OLE DB Sürücüsüne (MSOLEDBSQL) geçin.
SQL Server Native Client OLE DB sağlayıcısı, OLE DB başlatma ve yetkilendirme özelliklerini aşağıdaki şekilde yorumlar:
| Mülk Kimliği | Description |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | SQL Server Native Client OLE veritabanı sağlayıcısı, kimlik doğrulama bilgilerini önbelleklemez. SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | SQL Server Native Client OLE veritabanı sağlayıcısı, şifreleri gizlemek için standart Microsoft SQL Server güvenlik mekanizmaları kullanır. SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_AUTH_INTEGRATED | Eğer DBPROP_AUTH_INTEGRATED bir NULL işaretçi, null dizi veya 'SSPI' VT_BSTR değerine ayarlanmışsa, SQL Server Native Client OLE DB sağlayıcısı, DBPROP_INIT_DATASOURCE ve DBPROP_INIT_CATALOG özellikleriyle belirlenen SQL Server veritabanına kullanıcı erişimini yetkilendirmek için Kimlik Doğrulama Windows Modu kullanır. Eğer VT_EMPTY olarak ayarlanmışsa (varsayılan olarak), SQL Server güvenliği kullanılır. SQL Server giriş ve şifresi DBPROP_AUTH_USERID ve DBPROP_AUTH_PASSWORD özelliklerinde belirtilmiştir. |
| DBPROP_AUTH_MASK_PASSWORD | SQL Server Native Client OLE veritabanı sağlayıcısı, şifreleri gizlemek için standart SQL Server güvenlik mekanizmaları kullanır. SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_AUTH_PASSWORD | SQL Server girişine verilen şifre. Bu özellik, SQL Server veritabanına erişim yetkilendirmesi için SQL Server Authentication seçildiğinde kullanılır. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | SQL Server Native Client OLE veritabanı sağlayıcısı, kalıcı olduğunda kimlik doğrulama bilgilerini şifrelemez. SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | SQL Server Native Client OLE DB sağlayıcısı, istenirse kimlik doğrulama değerlerini, şifre görüntüsünü de dahil olmak üzere sürdürür. Şifreleme sağlanmaz. |
| DBPROP_AUTH_USERID | SQL Server girişi. Bu özellik, SQL Server veritabanına erişim yetkilendirmesi için SQL Server Authentication seçildiğinde kullanılır. |
| DBPROP_INIT_ASYNCH | SQL Server Native Client OLE veritabanı sağlayıcısı asenkron başlatmayı destekler. DBPROP_INIT_ASYNCH özelliğinde DBPROPVAL_ASYNCH_INITIALIZE biti ayarlandığında, IDBInitialize::Initialize girişiminin engellemesiz bir çağrı haline gelmesine neden olur. Daha fazla bilgi için bkz. Asenkron İşlemler Yapmak. |
| DBPROP_INIT_CATALOG | Bağlanmak için mevcut SQL Server veritabanının adı. |
| DBPROP_INIT_DATASOURCE | Microsoft SQL Server örneğini çalıştıran bir sunucunun ağ adı. Bilgisayarda çalışan birden fazla SQL Server örneği varsa, belirli bir SQL Server örneğine bağlanmak için DBPROP_INIT_DATASOURCE değeri \\ServerName\InstanceName olarak belirtilir. Kaçış dizisi \\ kendisi için geri kesik için kullanılır. |
| DBPROP_INIT_GENERALTIMEOUT | Veri kaynağı başlatma ve komut çalıştırma dışında bir isteğin zaman aşımı olmadan önceki saniye sayısını gösterir. 0 değeri sonsuz bir zaman aşımını gösterir. Ağ bağlantıları üzerinden veya dağıtık veya işlem senaryolarında çalışan sağlayıcılar, uzun süreli bir istek durumunda kayıtlı bir bileşene zaman aşımını bildirmek için bu özelliği destekleyebilir. Veri kaynağı başlatma ve komut yürütme zamanlamaları sırasıyla DBPROP_INIT_TIMEOUT ve DBPROP_COMMANDTIMEOUT ile yönetilir. DBPROP_INIT_GENERALTIMEOUT sadece okunabilir ve ayarlamaya çalışıldığında DBPROPSTATUS_NOTSETTABLE dwstatus hatası döner. |
| DBPROP_INIT_HWND | Windows işlemi çağrı uygulamasından gelir. Başlatma özellikleri için sorma izni verildiğinde görüntülenen başlatma diyalog kutusu için geçerli bir pencere kolu gereklidir. |
| DBPROP_INIT_IMPERSONATION_LEVEL | SQL Server Native Client OLE veritabanı sağlayıcısı, taklit seviyesi ayarlamasını desteklemez. SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_INIT_LCID | SQL Server Native Client OLE veritabanı sağlayıcısı, yerel kimliğini doğrular ve yerel kimlik desteklenmiyorsa veya istemciye yüklenmemişse hata döndürür. |
| DBPROP_INIT_LOCATION | SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_INIT_MODE | SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_INIT_PROMPT | SQL Server Native Client OLE veritabanı sağlayıcısı, veri kaynağı başlatma için tüm sorgu modlarını destekler. SQL Server Native Client OLE DB sağlayıcısı, mülk için varsayılan ayar olarak DBPROMPT_NOPROMPT'yi kullanır. |
| DBPROP_INIT_PROTECTION_LEVEL | SQL Server Native Client OLE veritabanı sağlayıcısı, SQL Server örneklerine bağlantılarda koruma seviyesini desteklemez. SQL Server Native Client OLE veritabanı sağlayıcısı, özellik değerini ayarlama girişiminde DB_S_ERRORSOCCURRED döndürür. DBPROP Yapısı'nın dwStatus üyesi DBPROPSTATUS_NOTSUPPORTED gösterir. |
| DBPROP_INIT_PROVIDERSTRING | Bu konunun ilerleyen bölümlerinde SQL Server Native Client OLE DB provider dizisine bakabilirsiniz. |
| DBPROP_INIT_TIMEOUT | SQL Server Native Client OLE DB sağlayıcısı, SQL Server örneğine bağlantı belirlenen saniye içinde kurulamazsa başlatma hatası döndürür. |
Sağlayıcıya özgü özellik kümesi DBPROPSET_SQLSERVERDBINIT'de, SQL Server Native Client OLE DB sağlayıcısı bu ek başlatma özelliklerini tanımlar.
| Mülk Kimliği | Description |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | Tip: VT_BSTR R/W: Yaz Varsayılan: VT_EMPTY Açıklama: Mevcut veya süresi dolmuş şifre. Daha fazla bilgi için Şifreleri Programatik Değiştirme bölümüne bakınız. |
| SSPROP_INIT_APPNAME | Tip: VT_BSTR R/W: Oku/Yaz Açıklama: İstemci uygulama adı. |
| SSPROP_INIT_AUTOTRANSLATE | Tip: VT_BOOL R/W: Oku/Yaz Varsayılan: VARIANT_TRUE Açıklama: OEM/ANSI karakter dönüşümü. VARIANT_TRUE: SQL Server Native Client OLE DB sağlayıcısı, istemci ile sunucu arasında gönderilen ANSI karakter dizilerini, istemci ile sunucu arasındaki genişletilmiş karakter eşleştirmedeki sorunları en aza indirmek için Unicode üzerinden çevirir: SQL Server char, varchar veya metin değişkeni, parametre veya sütununa gönderilen istemci DBTYPE_STR verisi, istemci ANSI kod sayfası (ACP) kullanılarak karakterden Unicode'a dönüştürülür ve ardından sunucunun ACP'si kullanılarak Unicode'dan karaktere dönüştürülür. SQL Server char, varcharveya metin verileri, istemci DBTYPE_STR değişkenine gönderilen veriler, sunucu ACP kullanılarak karakterden Unicode'a dönüştürülür ve ardından ACP ile Unicode'dan karaktere dönüştürülür. Bu dönüşümler, istemci üzerinde SQL Server Native Client OLE DB sağlayıcısı tarafından gerçekleştirilir. Bu, sunucuda kullanılan aynı ACP'nin istemci üzerinde de mevcut olmasını gerektirir. Bu ayarlar, bu transferlerde gerçekleşen dönüşümler üzerinde hiçbir etkisi yoktur: Unicode DBTYPE_WSTR sunucudaki char, varchar veya metne gönderilen istemci verileridir. istemci üzerindeki bir Unicode DBTYPE_WSTR değişkenine gönderilen char, varchar veya metin sunucusu verileri. ANSI, sunucuda Unicode nchar, nvarchar veya ntext'e gönderilen istemci verilerini DBTYPE_STR. Unicode char, varchar veya metin sunucusu verileri istemci üzerindeki ANSI DBTYPE_STR değişkenine gönderilir. VARIANT_FALSE: SQL Server Native Client OLE veritabanı sağlayıcısı karakter çevirisi yapmaz. SQL Server Native Client OLE DB sağlayıcısı, char,varchar veya metin değişkenlerine, parametrelerine veya sunucudaki sütunlara gönderilen ANSI karakteri DBTYPE_STR istemci verilerini çevirmez. Sunucudan istemci üzerindeki DBTYPE_STR değişkenlere gönderilen char, varchar veya metin verilerinde hiçbir çeviri yapılmaz. İstemci ve SQL Server örneği farklı ACP'ler kullanıyorsa, genişletilmiş karakterler yanlış yorumlanabilir. |
| SSPROP_INIT_GEÇERLİDİL | Tip: VT_BSTR R/W: Oku/Yaz Açıklama: Bir SQL Server dili adı. Sistem mesajı seçimi ve biçimlendirmesi için kullanılan dili tanımlar. Dil, SQL Server örneği çalıştıran bilgisayara yüklenmelidir, aksi takdirde veri kaynağı başlatma başarısız olur. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | Tip: VT_UI2 R/W: Oku/Yaz Varsayılan: 0 Açıklama: SQL Server ile ActiveX Data Object (ADO) uygulamaları arasında veri tipi uyumluluğunu etkinleştirir. Varsayılan 0 değeri kullanılırsa, veri tipi işleme sağlayıcının kullandığı değere göre varsayılan olarak kullanılır. 80 değeri kullanılırsa, veri tipi işleme yalnızca SQL Server 2000 (8.x) veri tiplerini kullanır. Daha fazla bilgi için bkz. SQL Server Native Client ile ADO'yu kullanmak. |
| SSPROP_INIT_ENCRYPT | Tip: VT_BOOL R/W: Okuma/Yazma Varsayılan: VARIANT_FALSE Açıklama: Ağ üzerinden giden verileri şifrelemek için SSPROP_INIT_ENCRYPT özelliği VARIANT_TRUE olarak ayarlanır. Protokol Şifrelemesini Etkinleştir (Enable Protocol Encryption) açıksa, şifreleme her zaman gerçekleşir, SSPROP_INIT_ENCRYPT ayarı ne olursa olsun. Eğer kapalıysa ve SSPROP_INIT_ENCRYPT VARIANT_TRUE olarak ayarlanmışsa, şifreleme gerçekleşir. Protokol Şifrelemesini Etkinleştir kapalıysa ve SSPROP_INIT_ENCRYPT VARIANT_FALSE olarak ayarlanmışsa, şifreleme gerçekleşmez. |
| SSPROP_INIT_FAILOVERPARTNER | Tip: VT_BSTR R/W: Oku/Yaz Açıklama: Veritabanı yansıtma için failover ortağının adını belirtir. Bu bir başlatma özelliğidir ve yalnızca başlatmadan önce ayarlanabilir. Başlatmadan sonra, varsa birincil sunucu tarafından geri dönen failover ortağını döndürür. Bu, akıllı bir uygulamanın en son belirlenen yedek sunucuyu önbellemesine olanak tanır, ancak bu uygulamalar bilginin yalnızca bağlantı ilk kurulduğunda güncellendiğini (veya havuza alındığında sıfırlandığını) ve uzun vadeli bağlantılar için güncel kalabileceğini bilmelidir. Bağlantı kurulduktan sonra, uygulama bu özniteliği sorgulayarak devre ortağının kimliğini belirleyebilir. Birincil sunucunun failover ortağı yoksa bu özellik boş bir diziyi döndürür. Daha fazla bilgi için Veritabanı Aynalaması Kullanımı'na bakınız. |
| SSPROP_INIT_FILENAME | Tip: VT_BSTR R/W: Oku/Yaz Açıklama: Eklenebilir bir veritabanının birincil dosya adını belirtir. Bu veritabanı eklenir ve bağlantı için varsayılan veritabanı olur. SSPROP_INIT_FILENAME kullanmak için, veritabanının adını başlatma özelliğinin değeri olarak belirtmeniz gerekir DBPROP_INIT_CATALOG. Veritabanı adı yoksa, SSPROP_INIT_FILENAME'de belirtilen birincil dosya adını arar ve DBPROP_INIT_CATALOG'de belirtilen isimle bu veritabanını ekler. Veritabanı daha önce bağlıysa, SQL Server onu yeniden bağlamaz. |
| SSPROP_INIT_MARSCONNECTION | Tip: VT_BOOL R/W: Oku/Yaz Varsayılan: VARIANT_FALSE Açıklama: Bağlantı için Çoklu Aktif Sonuç Kümelerinin (MARS) etkin olup olmadığını belirtir. Bu seçenek, veritabanına bağlantı kurulmadan önce doğru olarak ayarlanmalıdır. Daha fazla bilgi için bkz. Birden Çok Etkin Sonuç Kümesi (MARS) kullanma. |
| SSPROP_INIT_NETWORKADDRESS | Tip: VT_BSTR R/W: Oku/Yaz Açıklama: DBPROP_INIT_DATASOURCE özelliğiyle belirtilen SQL Server örneğini çalıştıran sunucunun ağ adresi. |
| SSPROP_INIT_NETWORKLIBRARY | Tip: VT_BSTR R/W: Oku/Yaz Açıklama: SQL Server örneğiyle iletişim kurmak için kullanılan ağ kütüphanesinin (DLL) adı. İsimde yol veya .dll dosya uzantısı yer almamalıdır. Varsayılan özellik, SQL Server Client Configuration Utility kullanılarak özelleştirilebilir. Not: Bu özellik yalnızca TCP ve Adlandırılmış Borular tarafından desteklenmektedir. Bu özelliği bir preek ile kullanırsanız, çift preek elde edersiniz ve bu da hata olur, çünkü bu özellik dahili olarak bir ön ek oluşturmak için kullanılır. |
| SSPROP_INIT_PACKETSIZE | Tür: VT_I4 R/W: Oku/Yaz Açıklama: Bayt cinsinden bir ağ paket boyutu. Paket boyutu özellik değeri 512 ile 32.767 arasında olmalıdır. Varsayılan SQL Server Native Client OLE DB sağlayıcı ağ paket boyutu 4.096'dır. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | Tür: BOOL R/W: Yaz Varsayılan: YANLIŞ Açıklama: Veritabanı güncellemesi sırasında sunucu tarafı imleçler kullanılırken kullanılır. Bu özellik, istemci üzerindeki kod sayfası yerine sunucudan elde edilen derleme bilgileriyle veriyi etiketler. Şu anda bu özellik yalnızca dağıtık sorgulama süreci tarafından kullanılır çünkü hedef verilerin derlenmesini bilir ve doğru şekilde dönüştürür. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Tip: VT_BOOL R/W: Oku/Yaz Varsayılan: VARIANT_FALSE Açıklama: Sunucu sertifikası doğrulamasını etkinleştirmek veya devre dışı bırakmak için kullanılır. Bu özellik okuma/yazma özelliğidir, ancak bağlantı kurulduktan sonra ayarlamaya çalışmak hataya yol açar. Bu özellik, istemci sertifika doğrulaması gerektirecek şekilde yapılandırılmışsa göz ardı edilir. Ancak, bir uygulama, istemci şifreleme gerektirmemiş ve istemci için herhangi bir sertifika sağlanmasa bile, sunucuya bağlantısının şifreli olmasını garanti etmek için SSPROP_INIT_ENCRYPT ile birlikte kullanabilir. İstemci uygulamaları, bağlantı açıldıktan sonra bu özelliği sorgulayarak kullanılan gerçek şifreleme ve doğrulama ayarlarını belirleyebilir. Not: Sertifika doğrulaması olmadan şifreleme kullanmak, paket koklamaya karşı kısmi koruma sağlar, ancak ortada adam saldırılarına karşı koruma sağlamaz. Sunucuya gönderilen giriş ve verilerin sunucu sertifikasını doğrulamadan şifrelenmesine izin verir. Daha fazla bilgi için bkz . Doğrulama Olmadan Şifreleme Kullanma. |
| SSPROP_INIT_USEPROCFORPREP | Tür: VT_I4 R/W: Oku/Yaz Varsayılan: SSPROPVAL_USEPROCFORPREP_ON Açıklama: SQL Server kayıtlı prosedür kullanımı. ICommandPrepare arayüzünü desteklemek için SQL Server geçici depolanmış prosedürlerinin kullanımını tanımlar. Bu özellik yalnızca SQL Server 6.5'e bağlandığında anlamlıydı. Bu özellik sonraki sürümlerde göz ardı edilmiştir. SSPROPVAL_USEPROCFORPREP_OFF: Bir komut hazırlandığında geçici bir depolanmış prosedür oluşturulmaz. SSPROPVAL_USEPROCFORPREP_ON: Bir komut hazırlandığında geçici bir depolanmış prosedür oluşturulur. Geçici olarak saklanan prosedürler, oturum yayınlandığında bırakılır. SSPROPVAL_USEPROCFORPREP_ON_DROP: Bir komut hazırlandığında geçici bir depolanmış prosedür oluşturulur. Komut ICommandPrepare::Unprepare ile hazırlıksız olduğunda, ICommandText::SetCommandText ile komut nesnesi için yeni bir komut belirtildiğinde veya komuta tüm uygulama referansları serbest bırakıldığında işlem düşürülür. |
| SSPROP_INIT_WSID | Tip: VT_BSTR R/W: Oku/Yaz Açıklama: İş istasyonunu tanımlayan bir dize. |
Sağlayıcıya özgü özellik kümesi DBPROPSET_SQLSERVERDATASOURCEINFO'de, SQL Server Native Client OLE DB sağlayıcısı ek özellikleri tanımlar; daha fazla bilgi için Veri Kaynağı Bilgi Özellikleri sayfasına bakınız.
SQL Server Yerel İstemci OLE DB Provider Dizisi
SQL Server Native Client OLE DB sağlayıcısı, sağlayıcı dizisi özellik değerlerinde ODBC benzeri bir sözdizimini tanır. Sağlayıcı dizisi özelliği, OLE DB veri kaynağına bağlantı kurulduğunda DBPROP_INIT_PROVIDERSTRING OLE DB başlatma özelliğinin değeri olarak sağlanır. Bu özellik, OLE DB veri kaynağına bağlantı uygulamak için gereken OLE DB sağlayıcıya özgü bağlantı verilerini belirtir. Dizide öğeler noktalı virgül kullanılarak sınırlandırılır. Dizinin son elemanı noktalı virgülle sonlandırılmalıdır. Her eleman bir anahtar kelime, eşit işaret karakteri ve başlatma sırasında aktarılan değerden oluşur. Örneğin:
Server=MyServer;UID=MyUserName;
SQL Server Native Client OLE DB sağlayıcısında, tüketicinin sağlayıcı dizisi özelliğini kullanmasına asla gerek kalmaz. Tüketici, sağlayıcı dizisinde yansıtılan herhangi bir başlatma özelliğini OLE DB veya SQL Server Native Client OLE DB sağlayıcıya özgü başlatma özellikleri kullanarak ayarlayabilir.
SQL Server Native Client OLE DB sağlayıcısında mevcut anahtar kelimelerin listesi için bkz. SQL Server Native Client ile Bağlantı Dizisi Anahtar Kelimelerini Kullanmak.