SQLSetStmtAttr
The SQL Server Native Client ODBC driver does not support the mixed (keyset/dynamic) cursor model.Değer küme 0'a eşit değilse, SQL_ATTR_KEYSET_SIZE kullanarak anahtar küme boyutunu küme girişimleri başarısız olur.
Uygulama üzerinde döndürülen satırların sayısını bildirmek için tüm ifadeleri SQL_ATTR_ROW_ARRAY_SIZE ayarlar bir SQLFetch veya SQLFetchScroll işlev çağrısı.Gösteren sunucu imleci deyimleri üzerinde sürücüsünün SQL_ATTR_ROW_ARRAY_SIZE boyutunu belirlemek için kullandığı blok bir imleç getirme isteği karşılamak için sunucu satırlarını oluşturur.Dinamik imleç bloğu boyutu içinde satır üyelik ve sipariş, sabit işlem yalıtım düzey yinelenebilir okuma kaydedilmiş hareketlerin emin olmak yeterlidir.imleç bu değeriyle belirtilen blok dışında tamamen dinamiktir.Sunucu imleç blok boyutu tamamen dinamik ve getirme işlemi herhangi bir anda değiştirilebilir.
SQLSetStmtAttr ve tablo değerli parametreleri
SQLSetStmtAttr kullanılabilir küme sql_sopt_ss_param_focus açıklayıcı alanlar için parametre tablo değerli sütun erişirken önce uygulama parametresi tanımlayıcısı (apd) içinde.
İçin bir girişimde yaptıysanız küme sql_sopt_ss_param_focus tablo değerli bir parametre değil bir parametre sıra sayısı için SQLSetStmtAttr SQL_ERROR hatası ve tanılama kaydı sqlstate ile oluşturulan döndürür = HY024 ve "geçersiz öznitelik değeri" iletisini.sql_sopt_ss_param_focus SQL_ERROR hatası döndürüldüğünde değiştirilmez.
sql_sopt_ss_param_focus tanımlayıcısı kayıtlara 0 geri yüklemeler erişim için parametreleri ayarlama.
SQLSetStmtAttr Ayrıca kullanılabilir küme sql_sopt_ss_name_scope.Daha fazla bilgi için bu konunun ilerleyen bölümlerindeki sql_sopt_ss_name_scope bölümüne bakın.
Daha fazla bilgi için bkz: Tablo değerli parametre meta veri Prepared deyimleri için.
Tablo değerli parametreleri hakkında daha fazla bilgi için bkz: Tablo değerli parametreleri (odbc).
Seyrek sütunlar için SQLSetStmtAttr desteği
SQLSetStmtAttr kullanılabilir küme sql_sopt_ss_name_scope.Daha fazla bilgi için bu konunun ilerleyen bölümlerindeki 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
The SQL Server Native Client ODBC driver also supports the following driver-specific statement attributes.
SQL_SOPT_SS_CURSOR_OPTIONS
sql_sopt_ss_cursor öznitelik sürücü imleçler sürücüye özgü performans seçeneklerini kullanıp kullanmayacağını belirtir.U bu seçenekler olduğunda izin verilir küme.sql_co_off varsayılan ayardır.Bu seçenekler yalnızca bağlandığında geçerli bir örnek , SQL Server sürüm 7.0 veya daha yeni.The ValuePtr value is of type SQLLEN.
ValuePtr değer |
Açıklama |
|---|---|
SQL_CO_OFF |
Varsayılan.Hızlı yalnızca ileri, salt okunur İmleçler ve autofetch devre dışı bırakır, verir u salt ileri, salt okunur imleçler üzerinde.SQL_SOPT_SS_CURSOR_OPTIONS olduğunda küme sql_co_off için imleç türü değişmez.Diğer bir deyişle, hızlı yalnızca ilerleyen imleç hızlı kalır yalnızca ilerleyen imleç.İmleç türünü değiştirmek için uygulamayı şimdi gerekir küme farklı imleç türünü kullanarak sqlkümeStmtAttr/sql_attr_cursor_type. |
SQL_CO_FFO |
Hızlı yalnızca ileri, salt okunur imleçler devre dışı bırakır sağlar u salt ileri, salt okunur imleçler üzerinde. |
SQL_CO_AF |
Herhangi bir imleç türü autofetch seçeneğini etkinleştirir.Ne zaman bu seçenek, küme bir deyim kullanımı için SQLExecute veya SQLExecDirect bir örtülü oluşturacak olan SQLFetchScroll (SQL_FIRST).imleç açıldığında ve ilk toplu iş iş satırların sunucuya tek bir gidiş içinde döndürülür. |
SQL_CO_FFO_AF |
Autofetch seçeneği salt ileri imleçler sağlar hızlı.Hem sql_co_af hem de sql_co_ffo olarak belirtilirse bu aynıdır. |
Bu seçenekler olduğunda küme, son satırı getirilen algıladığı sunucu imleç otomatik olarak kapatır.Uygulama hala çağırması gerekir SQLFreeStmt (sql_close) veya SQLCloseCursor, ancak sürücünün sunucuya Kapat bildirim göndermek zorunda.
Seçim listesi içeriyorsa, bir metin, ntext, veya Görüntü sütun, hızlı yalnızca ilerleyen imleç dinamik bir imleç dönüştürülür ve u izin verilir.
SQL_SOPT_SS_DEFER_PREPARE
sql_sopt_ss_defer_prepare öznitelik deyim hemen hazır veya kadar ertelenmiş belirler SQLExecute, SQLDescribeCol veya SQLDescribeParam yürütülür.De SQL Server 7.0 ve önceki sürümlerinde, bu özellik yoksayılır (no ertelenmiş hazırlık).The ValuePtr value is of type SQLLEN.
ValuePtr değer |
Açıklama |
|---|---|
SQL_DP_ON |
Varsayılan.Sonra arama SQLPrepare, deyim hazırlık kadar ertelenmiş SQLExecute verilir veya 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 öznitelik veri dönüşümü belirlemek için kullanılan deyim düzeyi.Öznitelik karakter dizeleri için tarih, saat ve para birimi değerlerini dönüştürürken istemci yerel ayar ayar ayarı dikkate sürücü olur.Dönüştürme olduğunu SQL Server yerel veri türleri karakter dizeleri için.
The ValuePtr value is of type SQLLEN.
ValuePtr değer |
Açıklama |
|---|---|
SQL_RE_OFF |
Varsayılan.Sürücü için karakter tarih, saat ve para birimi veri dönüştürme dize istemci yerel ayar ayar ayarı kullanarak veri. |
SQL_RE_ON |
Tarih, saat ve para birimi veri karakteri dönüştürürken istemci yerel ayar ayar ayarı sürücüsünü kullanan dize veri. |
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ı, tarih veya saat değerlerini karakter dizeleri dönüştürüldüğünde dönüştürmeleri çıktısını almak için geçerlidir.
Not
SQL_SOPT_SS_REGIONALIZE deyim seçeneği açık olduğunda, sürücü yerel ayar ayar kayıt defteri ayarları geçerli kullanıcı için kullanır.Uygulamasını kullanarak, örneğin, arama ayarlar, geçerli iş parçacığı parçacığının yerel ayar ayar sürücü dikkate almaz SetThreadLocale.
Bir veri kaynak bölgesel davranışını değiştirme uygulamanın başarısız olmasına neden olabilir.Tarih dizeleri ayrıştırma ve tarih dizeleri görüntülenmesini bekler bir uygulama odbc tarafından tanımlandığı gibi olumsuz bu değer değiştirme tarafından etkilenebilir.
SQL_SOPT_SS_TEXTPTR_LOGGING
SQL_SOPT_SS_TEXTPTR_LOGGING öznitelik içeren sütunlar üzerinde işlem günlüğünü değiştirir metin veya Görüntü veri.Bu işlemler (sql_tl_on) oturum açmak için varsayılan davranıştır.The ValuePtr value is of type SQLLEN.
ValuePtr değer |
Açıklama |
|---|---|
SQL_TL_OFF |
Üzerinde gerçekleştirilen işlemler günlüğe kaydedilmesini devre dışı bırakır metin ve Görüntü veri. |
SQL_TL_ON |
Varsayılan.Gerçekleştirilen işlem günlüğü etkinleştirir metin ve Görüntü veri. |
SQL_SOPT_SS_HIDDEN_COLUMNS
SQL_SOPT_SS_HIDDEN_COLUMNS öznitelik ortaya çıkarır, sonuç küme içinde gizli sütunlar bir SQL Server SEÇMEK için Gözat deyim.Sürücü bu sütunlar varsayılan olarak göstermiyor.The ValuePtr value is of type SQLLEN.
ValuePtr değer |
Açıklama |
|---|---|
SQL_HC_OFF |
Varsayılan.Gözat sonuç küme sütun gizlidir. |
SQL_HC_ON |
Sütunları sergiler için göz atın. |
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT öznitelik sorgu bildirim isteği için ileti metni döndürür.
SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS
SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS öznitelik sorgu bildirim isteği için kullanılan seçenekleri belirtir.Bu dize ile belirtilen name=value Sözdizimi aşağıda belirtildiği gibi.Uygulama hizmet oluşturma ve sıra dışı bildirimlerini okuma sorumludur.
Sorgu bildirimleri seçenekleri sözdizimi dize ise:
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_querybildirim_TIMEOUT öznitelik saniye sayısını belirtir, sorgu bildirim etkin kalmasını sağlamaktır.432000 Saniye (5 gün) varsayılan değerdir.The ValuePtr value is of type SQLLEN.
SQL_SOPT_SS_PARAM_FOCUS
Odak için sql_sopt_ss_param_focus öznitelik belirtir sonraki SQLBindParameter, SQLGetDescField, SQLSetDescField, SQLGetDescRec, ve SQLSetDescRec çağrıları.
sql_sopt_ss_param_focus sqlulen türüdür.
Başka bir deyişle bu aramalar parametreleri parametre imleyicileri içinde karşılık gelen adres 0'dır ve varsayılan SQL deyim.Zaman küme parametre sayısı tablo değerli bir parametre için bu tablo değerli parametresi sütunları bu aramalar adres.Zaman küme parametresi tablo değerli parametresi olmayan bir değere, bu aramalar hata IM020 döndürür: "Tablo değerli bir parametre için parametre odağı göstermiyor".
SQL_SOPT_SS_NAME_SCOPE
sql_sopt_ss_name_kapsam öznitelik adını belirtir kapsam sonraki katalog işlev çağrıları için.Tarafından döndürülen sonuç küme SQLColumns ayarına bağlıdırsql_sopt_ss_name_scope.
sql_sopt_ss_name_scope sqlulen türüdür.
ValuePtr değer |
Açıklama |
|---|---|
SQL_SS_NAME_SCOPE_TABLE |
Varsayılan. Gerçek tablo iade edilmesi için tablo değerli parametreleri kullanarak, bu meta veriler gösterir. Seyrek sütunları özelliğini kullanırken, SQLColumns yalnızca üyesi değilse seyrek olan sütunlar döndürür column_set. |
SQL_SS_NAME_SCOPE_TABLE_TYPE |
Uygulama gerçek bir tablo yerine bir tablo türü için meta veri gerektirdiğini gösterir (katalog işlevlerinde return tablo türleri için meta veriler).Uygulama type_name tablo değerli parametresi geçen TableName parametresi. |
SQL_SS_NAME_SCOPE_EXTENDED |
Seyrek sütunları özelliğini kullanırken, SQLColumns ne olursa olsun 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 sadece seyrek üyeleri olan 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 kullanılan ile CatalogName ve SchemaName parametreleri, sırasıyla katalog ve şema için tablo değerli parametre tanımlamak içinTablo değerli parametreler için meta veriler alma uygulama sona erdiğinde, gereken küme sql_sopt_ss_name_scope, varsayılan değer olan sql_ss_name_scope_table dön.
sql_sopt_ss_name_scope olduğunda küme sql_ss_name_scope_table için bağlantılı sunucuları sorguları başarısız.Çağrıları SQLColumns veya SQLPrimaryKeys sunucu bileşenini içeren bir katalog ile will fail.
sql_sopt_ss_name_scope geçersiz bir değere küme girişimi SQL_ERROR hatası döndürülür ve sqlstate HY024 ve "geçersiz öznitelik değeri" iletisi ile Tanılama kaydı oluşturulur.
Katalog, işlev sonra da diğer SQLTables, SQLColumns, veya SQLPrimaryKeys sql_ss_name_scope_table, SQL_ERROR hatası döndürülür dışında sql_sopt_ss_name_scope değeri olduğunda denir.Tanılama kaydı sqlstate HY010 ve ileti ile oluşturulan "işlev sırası hatası (sql_sopt_ss_name_scope değil küme sql_ss_name_scope_table için)".