SQLSetStmtAttr
SQL ServerYerel istemci odbc sürücüsü, karışık (anahtar kümesi/dinamik) imleç modeli desteklemiyor. Değer kümesi 0'a eşit değilse, SQL_ATTR_KEYSET_SIZE kullanarak anahtar kümesi boyutunu ayarlamak için girişimleri başarısız olur.
Uygulama SQL_ATTR_ROW_ARRAY_SIZE üzerinde döndürülen satırların sayısını bildirmek için tüm deyimleri ayarlar bir SQLFetch veya SQLFetchScroll işlev çağrısı. Gösteren sunucu imleç deyimleri üzerinde sürücü SQL_ATTR_ROW_ARRAY_SIZE boyutunu belirlemek için kullandığı satır bloğunu sunucu imleç GETIRME talebi karşılamak için oluşturur. Hareket yalıtım düzeyini yinelenebilir okuma kaydedilmiş hareketlerini sağlamak için yeterli ise dinamik bir imleç içinde blok boyutu, satır üyelik ve sipariş sabitlenir. İmleci, bu değeri tarafından belirtilen blok dışında tamamen dinamiktir. Sunucu imleç bloğu boyutu tamamen dinamik ve getirme işlem herhangi bir noktada değiştirebilirsiniz.
SQLSetStmtAttr ve tablo Valued Parametreler
SQLSetStmtAttrsql_sopt_ss_param_focus tablo değerli parametresi sütunları tanımlayıcısı alanları erişmeden önce uygulama parametresi tanımlayıcısı (apd) ayarlamak için kullanılır.
sql_sopt_ss_param_focus tablo değerli bir parametre değil bir parametre sıra sayısı ayarlamak için bir girişimde yaptıysanız SQLSetStmtAttrsql_error ve tanılama kaydı sqlstate ile oluşturulan döndürür = HY024 ve "geçersiz öznitelik değeri" mesajı. Ne zaman sql_error döner sql_sopt_ss_param_focus değiştirilmez.
sql_sopt_ss_param_focus tanımlayıcı kayıtları 0 geri yüklemeler erişim parametreleri ayarlama.
SQLSetStmtAttrAyrıca sql_sopt_ss_name_scope ayarlamak için kullanılabilir. Daha fazla bilgi için bu konunun ilerleyen bölümlerinde sql_sopt_ss_name_scope bölümüne bakın.
Daha fazla bilgi için, bkz. Tablo Valued parametre meta veri Prepared deyimleri için.
Tablo değerli parametreleri hakkında daha fazla bilgi için bkz: Tablo Valued Parametreler (odbc).
Seyrek sütunlar için SQLSetStmtAttr desteği
SQLSetStmtAttrsql_sopt_ss_name_scope ayarlamak için kullanılabilir. Daha fazla bilgi için bu konunun ilerleyen bölümlerinde sql_sopt_ss_name_scope bölümüne bakın.Seyrek sütunları hakkında daha fazla bilgi için bkz: Seyrek sütunlar destek (odbc).
Deyimi öznitelikleri
SQL ServerYerel istemci odbc sürücüsü, sürücüye özgü deyimi aşağıdaki öznitelikleri de destekler.
SQL_SOPT_SS_CURSOR_OPTIONS
sql_sopt_ss_cursor özniteliği, sürücü imleçler sürücüye özgü performans seçeneklerini kullanıp kullanmayacağını belirtir. SQLGetData bu seçenekleri ayarlandığında izin verilmez. sql_co_off varsayılan ayardır. ValuePtrDeğer türüdür sqllen.
ValuePtr değer |
Açıklama |
|---|---|
SQL_CO_OFF |
Varsayılan. Hızlı yalnızca ileri, salt okunur imleçler ve autofetch devre dışı bırakır, sağlayan SQLGetData salt ileri, salt okunur imleçler üzerinde. SQL_SOPT_SS_CURSOR_OPTIONS sql_co_off için ayarlandığında, imleç türünü değiştirmez. Başka bir deyişle, salt ileri hızlı imleç salt ileri hızlı imleç kalacaktır. İmleç türünü değiştirmek için uygulama şimdi farklı imleç türünü kullanarak ayarlamak gerekir SQLSetStmtAttr/sql_attr_cursor_type. |
SQL_CO_FFO |
Hızlı yalnızca ileri, salt okunur imleçler, devre dışı bırakır sağlar SQLGetData salt ileri, salt okunur imleçler üzerinde. |
SQL_CO_AF |
Herhangi bir imleç türü autofetch seçeneğini etkinleştirir. Ekstre handle için bu seçenek ayarlandığında SQLExecute veya SQLExecDirect bir örtülü oluşturacak SQLFetchScroll (SQL_FIRST). İmleç açıldığında ve satırları ilk toplu bir tek gidiş dönüş sunucuya gönderilir. |
SQL_CO_FFO_AF |
Autofetch seçeneğini yalnızca ileri imleçler sağlar hızlı. Hem sql_co_af hem de sql_co_ffo olarak belirtilirse bu aynıdır. |
Bu seçenek belirlendiğinde, sunucu son satırı getirilen algıladığında imleç otomatik olarak kapatır. Uygulama hala çağırmalısınız SQLFreeStmt (sql_close) veya SQLCloseCursor, ancak sürücü yakın bildirimi sunucusuna göndermek zorunda değildir.
Seçim listesi içeriyorsa, bir metin, ntext, veya Resim sütunu, salt ileri hızlı imleç için dinamik bir imleç dönüştürülür ve SQLGetData izin verilir.
SQL_SOPT_SS_DEFER_PREPARE
sql_sopt_ss_defer_prepare öznitelik bildirimi hemen hazır veya kadar ertelenmiş olup olmadığını belirler SQLExecute, SQLDescribeCol veya SQLDescribeParam yürütülür. De SQL Server7.0 ve önceki sürümlerinde, bu özellik yoksayılır (no ertelenmiş Hazırlık). ValuePtrDeğer türüdür sqllen.
ValuePtr değer |
Açıklama |
|---|---|
SQL_DP_ON |
Varsayılan. Sonra arama SQLPrepare işlevi, deyim hazırlanması kadar ertelenen SQLExecute denir ya da metaproperty işlem (SQLDescribeCol veya SQLDescribeParam) yürütülür. |
SQL_DP_OFF |
Deyim hazır olarak SQLPrepare yürütülür. |
SQL_SOPT_SS_REGIONALIZE
SQL_SOPT_SS_REGIONALIZE özniteliği, veri dönüştürme deyimi düzeyinde belirlemek için kullanılır. Öznitelik karakter dizeleri için Tarih, Saat ve para birimi değerlerini dönüştürürken istemci yerel ayarı saygı sürücü neden olur. Dönüşüm olduğunu SQL ServerYerel veri türleri karakter dizeleri sadece.
ValuePtrDeğer türüdür sqllen.
ValuePtr değer |
Açıklama |
|---|---|
SQL_RE_OFF |
Varsayılan. Sürücü Tarih, Saat ve para birimi verileri istemci yerel ayarı kullanarak karakter dize verileri dönüştürmek değildir. |
TARİHLER |
Sürücü, Tarih, Saat ve para birimi verileri karakter dize verileri dönüştürürken istemci yerel ayarı kullanır. |
Bölgesel dönüştürme ayarları, para birimi, sayısal, Tarih ve Saat veri türleri için geçerlidir. Dönüştürme ayarı yalnızca para birimi, sayısal, Tarih veya saat değeri, karakter dizeleri için dönüştürüldüğünde dönüşümleri çıkış için geçerlidir.
[!NOT]
SQL_SOPT_SS_REGIONALIZE deyimi seçeneği açık olduğunda, sürücü yerel kayıt defteri ayarları geçerli kullanıcı için kullanır. Sürücü değil onur geçerli iş parçacığının yerel uygulama tarafından örneğin, calling ayarlarsa SetThreadLocale.
Veri kaynağı bölgesel davranışını değiştiren, uygulamanın başarısız olmasına neden olabilir. Tarih dizeleri ayrıştırma ve Tarih dizeleri görünmesini bekliyor bir uygulama odbc tarafından tanımlandığı gibi olumsuz bu değeri değiştirerek etkilenebilir.
SQL_SOPT_SS_TEXTPTR_LOGGING
SQL_SOPT_SS_TEXTPTR_LOGGING özniteliği içeren sütunlar üzerinde işlem günlüğünü kapatır metin veya Resim verileri. ValuePtrDeğer türüdür sqllen.
ValuePtr değer |
Açıklama |
|---|---|
SQL_TL_OFF |
Gerçekleştirilen işlemleri günlüğe kaydedilmesini devre dışı bırakır metin ve Resim verileri. |
SQL_TL_ON |
Varsayılan. Gerçekleştirilen işlem günlüğünü etkinleştirir metin ve Resim verileri. |
SQL_SOPT_SS_HIDDEN_COLUMNS
SQL_SOPT_SS_HIDDEN_COLUMNS özniteliği ortaya çıkarır, sonuç kümesinde sütun gizli bir SQL Serverdeyimi GÖZATMAK seçin. Sürücü bu sütunlar varsayılan olarak göstermiyor. ValuePtrDeğer türüdür sqllen.
ValuePtr değer |
Açıklama |
|---|---|
SQL_HC_OFF |
Varsayılan. Tara, sonuç kümesinden sütunlar gizlenir. |
SQL_HC_ON |
Sütunları for browse sunar. |
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT özniteliği için sorgu bildirim isteği ileti metni döndürür.
SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS
SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS özniteliği, sorgu bildirim isteği için kullanılan seçenekleri belirtir. Bunlar bir dize ile belirtilen name=valuesözdizimi aşağıda belirtildiği gibi. Uygulama hizmeti oluşturma ve sıra dışı bildirimlerini okuma sorumludur.
Sorgu bildirimleri seçenekleri dizesi sözdizimi şöyledir:
service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]
Örneğin:
service=mySSBService;local database=mydb
SQL_SOPT_SS_QUERYNOTIFICATION_TIMEOUT
SQL_SOPT_SS_QUERYNOTIFICATION_TIMEOUT özniteliği, sorgu bildirimdir etkin kalmasını saniye sayısını belirtir. 432000 Saniye (5 gün) varsayılan değerdir. ValuePtrDeğer türüdür sqllen.
SQL_SOPT_SS_PARAM_FOCUS
sql_sopt_ss_param_focus özniteliği için odağı belirtir sonraki SQLBindParameter, SQLGetDescField, SQLSetDescField, SQLGetDescRec, ve SQLSetDescRecçağrı.
İçin sql_sopt_ss_param_focus sqlulen türüdür.
Varsayılan bu çağrıların sql deyiminde parametre imleyicileri karşılık gelen parametreleri adresi anlamına gelir 0 ' dır. Tablo değerli bir parametre için parametre sayısı ayarlandığında, bu tablo değerli parametresi sütunları bu çağrıların adres. Parametre tablo değerli bir parametre değil bir değere ayarlandığında, bu aramalar dönmek hata IM020: "parametre odak değil başvurmak için tablo değerli bir parametre".
SQL_SOPT_SS_NAME_SCOPE
sql_sopt_ss_name_scope özniteliği sonraki Katalog işlev çağrıları adı kapsamını belirtir. Tarafından döndürülen sonuç kümesi SQLColumnssql_sopt_ss_name_scope ayarına bağlıdır.
sqlulen sql_sopt_ss_name_scope için türüdür.
ValuePtr değer |
Açıklama |
|---|---|
SQL_SS_NAME_SCOPE_TABLE |
Varsayılan. Gerçek tablo döndürülmelidir için tablo değerli parametreleri kullanılırken, bu meta verileri gösterir. Seyrek sütunları özelliğini kullanırken SQLColumnsolmayan üyesi seyrek sütunlar döndürür column_set. |
SQL_SS_NAME_SCOPE_TABLE_TYPE |
Uygulama gerçek bir tablo yerine tablo türü için meta veri gerektirdiğini gösterir (Katalog işlevler tablo türleri için meta verileri dönmek). Uygulama daha sonra Tablo valued parametre olarak type_name geçer TableNameparametresi. |
SQL_SS_NAME_SCOPE_EXTENDED |
Seyrek sütunları özelliğini kullanırken SQLColumnsbakılmaksızın tüm sütunları döndürür column_setüyelik. |
SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET |
Seyrek sütunları özelliğini kullanırken SQLColumnsüyesi seyrek sütunlar döndürür column_set. |
SQL_SS_NAME_SCOPE_DEFAULT |
sql_ss_name_scope_table eşit. |
ss_type_catalog_name ve ss_type_schema_name ile kullanılır CatalogNameve SchemaNameparametreleri, sırasıyla Katalog ve şema tablo değerli parametre tanımlamak için. Tablo valued parametre meta veri alma uygulama tamamlandığında, sql_sopt_ss_name_scope geri sql_ss_name_scope_table, varsayılan değerine ayarlamanız gerekir.
sql_sopt_ss_name_scope sql_ss_name_scope_table için ayarlandığında, bağlantılı sunucularda sorguları başarısız. Aramalar için SQLColumnsveya SQLPrimaryKeyssunucusu içeren bir katalogla bileşen başarısız.
sql_sopt_ss_name_scope geçersiz bir değere ayarlama girişimi sql_error döner ve tanılama kaydı sqlstate HY024 ve "geçersiz öznitelik değeri" iletisi ile oluşturulur.
Katalog sonra diğer işlevi ise SQLTables, SQLColumns, ya SQLPrimaryKeyssql_ss_name_scope_table, sql_error döner dışında sql_sopt_ss_name_scope değeri olduğunda denir. Tanılama kaydı sqlstate HY010 ve (sql_sopt_ss_name_scope için sql_ss_name_scope_table ayarlı değil) "İşlev sırası hatası" iletisi ile oluşturulur.