Makale
05/07/2010

SQLSetStmtAttr

The SQL Server Native istemci ODBC driver does not support the mixed (keyset/dynamic) imleç model. Değer kümesi, 0'a eşit değilse, SQL_ATTR_KEYSET_SIZE kullanarak anahtar kümesi boyutunu küme girişimleri başarısız olur.

Uygulama, döndürülen satırların sayısını bildirmek için tüm ifadeleri SQL_ATTR_ROW_ARRAY_SIZE ayarlar bir SQLFetch or SQLFetchScroll işlev çağrısı.Boyutunu belirlemek için bir sunucu imleç gösteren deyimlerini, sürücü SQL_ATTR_ROW_ARRAY_SIZE kullanır blok bir imleç getirme isteği karşılamak için sunucu satırları oluşturur.işlem yalıtım düzey tamamlanan hareketlerin yinelenebilir okuma emin olmak yeterli değilse, dinamik bir imleç'içinde blok boyutu satır üyelik ve sipariş giderilmiştir.imleç, bu değeri tarafından belirtilen bloğunun dışına tamamen dinamiktir.Sunucu imlecin blok boyutu tamamen dinamiktir ve getirme işlemi herhangi bir anda değiştirilebilir.

SQLSetStmtAttr ve tablo biçiminde parametreleri

SQLSetStmtAttr küme SQL_SOPT_SS_PARAM_FOCUS tanımlayıcısı parametresi tablo değerli sütun alanları erişmeden önce uygulama parametre tanımlayıcısı (APD) kullanılabilir.

Girişimi SQL_SOPT_SS_PARAM_FOCUS bir parametre sıra sayısı için küme yaptıysanız, tablo değerli bir parametre değil SQLSetStmtAttrSQL_ERROR ve Tanılama kayıt SQLSTATE ile oluşturulan fonksiyonu = HY024 ve "geçersiz bir öznitelik değeri" iletisi. SQL_ERROR döndüğünde SQL_SOPT_SS_PARAM_FOCUS değiştirilmedi.

SQL_SOPT_SS_PARAM_FOCUS tanımlayıcısı kayıtları 0 geri erişimi parametreleri ayarlama.

SQLSetStmtAttr küme SQL_SOPT_SS_NAME_SCOPE için de kullanılabilir.Daha fazla bilgi için bu konu bölümünde SQL_SOPT_SS_NAME_SCOPE bölümünde bakın.

Daha fazla bilgi için bkz:Prepared deyimleri için parametre meta veriler tablo biçiminde.

Tablo değerli parametreleri hakkında daha fazla bilgi için bkz: Tablo biçiminde Parametreler (ODBC).

SQLSetStmtAttr desteği ve seyrek sütunlar

SQLSetStmtAttr SQL_SOPT_SS_NAME_SCOPE ayarlamak için kullanılır.Daha fazla bilgi için bkz: bölüm, daha sonra bu topic.For sparse sütunları hakkında daha fazla bilgi için bkz: SQL_SOPT_SS_NAME_SCOPE Seyrek sütunlar destek (ODBC).

Tablo öznitelikleri

The SQL Server Native istemci ODBC driver also supports the following driver-specific deyim attributes.

sql_sopt_ss_cursor_options

SQL_SOPT_SS_CURSOR öznitelik sürücü, sürücüye özgü performans seçenekleri imleçler kullanıp kullanmayacağını belirtir.SQLGetData verilmez; bu seçenekler olduğunda küme.SQL_CO_OFF varsayılan ayardır.Bu seçenekler, yalnızca örneğine bağlı olduğunda geçerlidir SQL Server sürüm 7.0 veya sonrası. The ValuePtr value is of type SQLLEN.

ValuePtr value	Açıklama
sql_co_off	Varsayılan.Hızlı ileri yalnızca, salt okunur imleçler devre dışı bırakır ve autofetch, sağlar. SQLGetData ileriye - yalnızca, okuma - yalnızca imleçler üzerinde.SQL_SOPT_SS_CURSOR_OPTIONS olduğunda küme SQL_CO_OFF için imleç türü değişmez.Başka bir deyişle, hızlı yalnızca ilerleyen imleç hızlı yalnızca ilerleyen imleç kalır.Imleç türünü değiştirmek için , uygulama şimdi gerekir küme kullanarak farklı imleç türü SQLkümeStmtAttr/ SQL_ATTR_CURSOR_TYPE.
sql_co_ffo	Salt ileri, salt okunur imleçler devre dışı bırakır etkinleştirir hızlı SQLGetData ileriye - yalnızca, okuma - yalnızca imleçler üzerinde.
sql_co_af	Herhangi bir imleç türü autofetch seçeneği sağlar.Bu seçeneği olduğunda küme için bir deyim tanıtıcı SQLExecute or SQLExecDirect örtülü bir oluştururSQLFetchScroll (sql_first).Imleç açıldığında ve satırların ilk toplu iş, sunucuya tek bir gidiş dönüş döndürdü.
sql_co_ffo_af	Etkinleştirir autofetch seçeneği yalnızca ileri imleçlerle hızlı.SQL_CO_AF hem SQL_CO_FFO belirtildiği gibi aynı şeydir.

Bu seçenek belirlendiğinde, sunucu son satırın getirilen saptadığında, imleç otomatik olarak kapatır.Uygulama hala çağırmalısınız SQLFreeStmt (SQL_CLOSE) veya SQLCloseCursorsunucuya kapatma bildirim göndermek, ancak sürücü yok.

Seçim listesi içeriyorsa, bir Text, ntext, or Image bir dinamik imleç ve sütun, hızlı yalnızca ilerleyen imleç dönüştürülür..SQLGetData izin verilir.

sql_sopt_ss_defer_prepare

SQL_SOPT_SS_DEFER_PREPARE öznitelik deyim hemen hazırlıklı veya kadar ertelenmiş olup olmadığını belirler. SQLExecute, SQLDescribeCol or SQLDescribeParam yürütülür.Içinde SQL Server 7.0 ve önceki sürümleri, bu özellik yoksayılır (no ertelenmiş hazırlık). The ValuePtr value is of type SQLLEN.

ValuePtr value	Açıklama
sql_dp_on	Varsayılan.Sonra arama SQLPreparedeyim hazırlık kadar ertelenmişSQLExecute adında veya metaproperty işlemi (SQLDescribeCol or 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üştürme deyim düzeyinde belirlemek için kullanılır.Öznitelik, istemci yerel ayar ayar ayarı, tarih, saat ve para birimi değerleri için karakter dizeleri dönüştürürken dikkate almak için sürücünün neden olur.Ise dönüştürme SQL Server yerel veri türleri için karakter dizeleri.

The ValuePtr value is of type SQLLEN.

ValuePtr value	Açıklama
sql_re_off	Varsayılan.Sürücü, karakter için tarih, saat ve para birimi veri dönüştürmez dize istemci yerel ayar ayar ayarı kullanarak veri.
sql_re_on	Sürücü, tarih, saat ve para birimi veri karakter dizesi veri dönüştürme sırasında istemci yerel ayar ayar ayarı kullanır.

Bölgesel dönüştürme ayarlarını, para birimi, sayısal, tarih ve saat veri türleri için geçerlidir.Dönüştürme ayarı yalnızca karakter dizeleri için para birimi, sayı, tarih veya saat değeri dönüştürüldüğünde, dönüşümler çıkış için geçerlidir.

Not

Deyim seçeneği SQL_SOPT_SS_REGIONALIZE açık olduğunda, sürücü, yerel ayar ayar kayıt defteri ayarları geçerli kullanıcı için kullanır.Uygulamayı kullanarak, örneğin, arama ayarlar, sürücünün geçerli iş parçacığı yerel ayar ayar oluşuyor değil SetThreadLocale.

Bölgesel veri davranışını değiştirme kaynak uygulamanın başarısız olmasına neden olabilir.Tarih dizeleri ayrıştırma ve tarih dizelerinin görüntülenmesini bekler bir uygulama ODBC tarafından tanımlanan olumsuz bu değeri değiştirerek etkilenebilir.

sql_sopt_ss_textptr_logging

SQL_SOPT_SS_TEXTPTR_LOGGING özniteliği içeren sütunlar işlemlerini günlüğe geçiş yapar. Text or Image veri.The ValuePtr value is of type SQLLEN.

ValuePtr value	Açıklama
sql_tl_off	Üzerinde gerçekleştirilen operasyonların günlüğe kaydedilmesini devre dışı bırakır Text and Image veri.
sql_tl_on	Varsayılan.Üzerinde gerçekleştirilen operasyonların günlüğe kaydedilmesini etkinleştirir Text and Image veri.

sql_sopt_ss_hidden_columns

SQL_SOPT_SS_HIDDEN_COLUMNS özniteliği sunar, sonuçta küme, sütunlar, gizli bir SQL Server FOR BROWSE deyim. Sürücü, varsayılan olarak bu sütunları göstermiyor.The ValuePtr value is of type SQLLEN.

ValuePtr value	Açıklama
sql_hc_off	Varsayılan.Sonuç IÇIN GÖZATMA sütunları gizli küme.
sql_hc_on	Sütunları, BROWSE FOR gösterir.

sql_sopt_ss_querynotification_msgtext

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT öznitelik bildirim sorgusu isteği için ileti metni verir.

sql_sopt_ss_querynotification_options

SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS öznitelik bildirim sorgusu isteği için kullanılan seçenekleri belirtir.Bu dize ile belirtilir name=value Sözdizimi aşağıda belirtildiği gibi. Uygulama hizmet oluşturuluyor ve sıra dışı bildirimleri okuma sorumludur.

Bildirimleri seçenekleri sorgu dizesi sözdizimi aşağıdaki gibidir:

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 öznitelik sorgu bildirimdir etkin kalmasını saniye sayısını belirtir.432000 Saniye (5 gün) varsayılan değerdir.The ValuePtr value is of type SQLLEN.

sql_sopt_ss_param_focus

SQL_SOPT_SS_PARAM_FOCUS öznitelik için odak belirtir sonraki SQLBindParameter, SQLGetDescField, SQLSetDescField, SQLGetDescRec, ve SQLSetDescRec çağrılar.

SQL_SOPT_SS_PARAM_FOCUS için SQLULEN türüdür.

Varsayılan, başka bir deyişle bu çağrı, karşılık gelen SQL deyimindeki bir parametre imleyicileri parametreleri adres 0 ' dır.Zaman küme tablo değerli bir parametre parametre sayısı için bu çağrılar sütunlar tablo değerli bu parametrenin adres.Zaman küme tablo değerli bir parametre sayısı parametresi olmayan bir değer bu çağrıları IM020 hata döndürür: "Tablo değerli bir parametre için parametre odağı göstermiyor".

sql_sopt_ss_name_scope

SQL_SOPT_SS_NAME_SCOPE özniteliği işlev çağrıları sonraki katalog adı kapsamını belirtir.Döndürülen sonuç kümesi SQLColumns SQL_SOPT_SS_NAME_SCOPE ayarına bağlıdır.

SQL_SOPT_SS_NAME_SCOPE için SQLULEN türüdür.

ValuePtr value	Açıklama
sql_ss_name_scope_table	Varsayılan. Döndürülmesi gereken gerçek bir tablo için tablo değerli parametrelerini kullanarak, bu meta veriler gösterir. Seyrek sütun özelliği kullanılırken SQLColumns the sparse üyesi olmayan 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şlevlerini tablo türleri için meta veriler döndürmesi gerekir).Uygulama tablo değerli parametresi TYPE_NAME geçirmeden TableName Parametre.
sql_ss_name_scope_extended	Seyrek sütun özelliği kullanılırken SQLColumns ne olursa olsun, tüm sütunlar döndürür. column_set üyeliği.
sql_ss_name_scope_sparse_column_set	Seyrek sütun özelliği kullanılırken SQLColumns the sparse üye 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ılan CatalogName ve SchemaName parametreleri, sırasıyla katalog ve tablo değerli parametresi için bir şema tanımlamak için. Bir uygulama tablo değerli parametreler için meta veriler alma tamamlandığında geri SQL_SS_NAME_SCOPE_TABLE olan varsayılan değerine küme SQL_SOPT_SS_NAME_SCOPE gerekir.

SQL_SOPT_SS_NAME_SCOPE SQL_SS_NAME_SCOPE_TABLE için ayarladığınızda, bağlı sunuculara sorguları başarısız.Çağrı SQLColumns veya SQLPrimaryKeys bir sunucu içeren bir katalog ile bileşen başarısız olur.

Geçersiz bir değere küme SQL_SOPT_SS_NAME_SCOPE çalışırsanız, SQL_ERROR döndürülür ve Tanılama kayıt SQLSTATE HY024 ve "geçersiz bir öznitelik değeri" iletisi ile oluşturulur.

Katalog, işlev diğer then SQLTables, SQLColumns, veya SQLPrimaryKeys SQL_SOPT_SS_NAME_SCOPE SQL_SS_NAME_SCOPE_TABLE, SQL_ERROR döndürülen dışında bir değer olduğunda denir. Bir tanılama kaydı, SQLSTATE HY010 ve (SQL_SOPT_SS_NAME_SCOPE SQL_SS_NAME_SCOPE_TABLE için ayarlı değil) "İşlev sırası hatası" iletisi oluşturulur.

Değişiklik Geçmişi

Güncelleştirilmiş içerik
Türü SQL_SOPT_SS_NAME_SCOPE ve SQL_SOPT_SS_PARAM_FOCUS şimdi SQLULEN için güncelleştirildi.

Aracılığıyla paylaş