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. |