Tablo değerli parametresi tanımlayıcısı alanlar
Tablo değerli parametreleri destekler yeni SQL Server-özel alanları odbc uygulama parametresi tanımlayıcısı (APDs) ve uygulama parametresi tanımlayıcısı (IPDs).
Açıklamalar
Ad |
Konum |
Tür |
Açıklama |
|---|---|---|---|
SQL_CA_SS_TYPE_NAME |
IPD |
SQLTCHAR * |
Tablo değerli parametresi sunucu türü adı. Ne zaman bir tablo değerli parametre türü adı belirtilen tarih aramak için SQLBindParameter, her zaman Unicode değeri, hatta ANSI uygulamaları oluşturulan uygulamalar olarak belirtilmelidir. Parametre için kullanılan değeri StrLen_or_IndPtrsql_nts veya sizeof(WCHAR) tarafından çarpılan adı dize uzunluğu olmalıdır. Ne zaman bir tablo değerli parametre türü adı belirtilen yolu ile SQLSetDescField, bunu kullanarak uygulama yolu uyan bir sabit inşa edilmiştir belirtilebilir. odbc Sürücü Yöneticisi'nin gerekli herhangi bir Unicode dönüşüm gerçekleştirir. |
sql_ca_ss_type_catalog_name (salt okunur) |
IPD |
SQLTCHAR * |
Katalog türü burada tanımlanır. |
SQL_CA_SS_TYPE_SCHEMA_NAME |
IPD |
SQLTCHAR * |
Şema türü burada tanımlanır. |
Uygulamalar sql_ca_ss_type_catalog_name için tablo değerli parametreleri ayarlamanız gerekir değil. Böylece bir sql_error döndürür ve tanılama kaydı sqlstate ile oturum = HY091 ve "geçersiz tanımlayıcı alan belirteci" mesajı.
Tablo değerli bir parametre için parametre odağı olarak ayarlandığında aşağıdaki deyimi öznitelikleri ve tanımlayıcısı üstbilgi alanları tablo değerli parametreler için geçerlidir:
Ad |
Konum |
Tür |
Açıklama |
|---|---|---|---|
SQL_ATTR_PARAMSET_SIZE (Bu SQL_DESC_ARRAY_SIZE apd içinde eşdeğerdir.) |
APD |
SQLUINTEGER |
Tablo değerli bir parametre için arabellek dizi dizi boyutu. Bu arabellekleri karşılayacak satır sayısı veya satır arabelleklerinin boyutu olduğunu; arabellekleri sığmayacak kadar çok daha fazla veya daha az sayıda satır tablo valued parametre değeri olabilir. Varsayılan 1'dir. .gif "Not") Not
sql_sopt_ss_param_focus 0 varsayılan değerine ayarlı ise, SQL_ATTR_PARAMSET_SIZE ifadesine başvuruyor ve parametre kümesi sayısını belirtir.sql_sopt_ss_param_focus tablo değerli bir parametre sıra sayısı için ayarlanmışsa, tablo değerli parametre başvurur ve parametre tablo değerli parametresi için ayarlanan başına satır sayısını belirtir.
|
SQL_ATTR_PARAM _BIND_TYPE |
APD |
SQLINTEGER |
SQL_PARAM_BIND_BY_COLUMN varsayılandır. Row-Wise bağlama seçmek için bu alanı yapısını veya tablo valued parametre satır kümesi için bağlanacak arabellek örneği ayarlanır. Bu süre için ilişkili sütunların tümünü ve herhangi bir dolgu yapısı veya arabellek alanı eklemeniz gerekir. Bu, ilişkili sütun adresi ile belirtilen süre artırılır ne zaman sonuç aynı sütunda bir sonraki satırın başlangıcına işaret eder sağlar. Kullanırken sizeofoperatör ANSI c, bu davranış garanti. |
SQL_ATTR_PARAM_BIND_OFFSET_PTR |
APD |
SQLINTEGER * |
Bir null işaretçi varsayılandır. Bu alan boş olmayan ise, sürücü işaretçiyi dereferences, her birine (sql_desc_data_ptr, SQL_DESC_INDICATOR_PTR ve sql_desc_octet_length_ptr) tanımlayıcısı kayıttaki ertelenmiş alanlar dereferenced değeri ekler ve yeni işaretçi değerlerine erişim veri değerlerini kullanır. |
Bu alanlar, yalnızca tablo değerli parametrelerle geçerlidir ve diğer veri türleri için dikkate alınmaz.
sql_ca_ss_type_name saklı yordam çağrıları için isteğe bağlıdır. sql deyimleri için yordam çağrıları tablo valued parametre türü belirlemek için sunucuyu etkinleştirmek için değildir belirtilmelidir.
Tür adı reqired ve tablo türü tablo değerli parametresi için saklı yordam daha farklı bir şema tanımlanır, sql_ca_ss_type_schema_name uygulama parametresi tanımlayıcısı (IPD) belirtilmelidir. Eğer doğru değilse, sunucu tablo değerli parametre türü belirlemek mümkün olmayacaktır. Görüşme sırasında bu hatayla sonuçlanır SQLExecuteya SQLExecDirect. Hata-ecek-si olmak sqlstate 07006 ve mesaj "yasak veri türü özniteliği ihlali" =.
Tablo değerli parametresi sütunları column-wise veya row-wise bağlama kullanabilirsiniz. Varsayılan column-wise bağlama. Row-Wise bağlama, SQL_ATTR_PARAM_BIND_TYPE ve sql_attr_ PARAM_BIND_OFFSET_PTR ayarlayarak belirtilebilir. Bu row-wise bağlama sütunları ve parametreleri için benzerdir.
sql_ca_ss_type_catalog_name ve sql_ca_ss_type_schema_name Katalog ve clr türü kullanıcı tanımlı parametreleri ile ilgili şema almak için de kullanılabilir. Bu varolan türü özel Katalog şema öznitelikleri bu türleri için alternatifler vardır.