SQLColumns
SQLColumns sql_success değerler mevcut olup olmadığını döndürür katalogadı, TableName, veya ColumnName parametreleri.SQLFetch bu parametrelerde geçersiz değerler kullanıldığında sql_no_data döndürür.
Not
Büyük bir değer türleri için tüm uzunluğu parametreleri ile SQL_SS_LENGTH_UNLIMITED değeri döndürülür.
SQLColumns bir statik sunucu imleci yapılabilecek.yürütmek denemesi SQLColumns güncellenebilir (dinamik veya anahtar kümesi) imlecin üzerinde imleç türü değiştirildi gösteren SQL_SUCCESS_WITH_INFO döndürür.
The SQL Server Native Client ODBC driver supports reporting information for tables on linked servers by accepting a two-part name for the CatalogName parameter: Linked_Server_Name.Catalog_Name.
odbc 2 için.x joker karakter kullanmayan uygulamalar TableName, SQLColumns tabloları, adları eşleşen herhangi hakkında bilgi verir TableName ve geçerli kullanıcı tarafından sahip olunan.Geçerli kullanıcı adıyla eşleşen hiçbir tablo sahibi, TableName parametresi SQLColumns tablo adıyla eşleştiği başka kullanıcılara ait tüm tabloları hakkında bilgi verir TableName parametresi.odbc 2 için.x joker karakterleri kullanarak uygulamaları SQLColumns , adları eşleşen tabloların tamamı döner TableName.odbc 3 için.x uygulamaları SQLColumns , adları eşleşen tabloların tamamı döner TableName sahibi veya joker karakterler kullanılıp bakılmaksızın.
Aşağıdaki tablo sonuç küme tarafından döndürülen sütunları listeler:
Sütun adı |
Açıklama |
|---|---|
DATA_TYPE |
sql_varchar, SQL_VARBINARY veya sql_wvarchar için verir varchar(max) veri türleri. |
TYPE_NAME |
"Varchar", "varbinary" veya "nvarchar" işlevi için varchar(max), varbinary(max), ve nvarchar(max) veri türleri. |
COLUMN_SIZE |
Döner SQL_SS_LENGTH_UNLIMITED için varchar(max) veri türü sütun boyutunun sınırsız olduğunu gösteren. |
BUFFER_LENGTH |
Döner SQL_SS_LENGTH_UNLIMITED için varchar(max) veri türü arabellek boyutunun sınırsız olduğunu gösteren. |
SQL_DATA_TYPE |
sql_varchar, SQL_VARBINARY veya sql_wvarchar için verir varchar(max) veri türleri. |
CHAR_OCTET_LENGTH |
En fazla uzunluğu karakter veya ikili verir sütun.Boyutunun sınırsız olduğunu belirtmek için 0 döndürür. |
SS_XML_SCHEMACOLLECTION_CATALOG_NAME |
Bir xml şeması burada Katalog adını döndürür koleksiyon ad tanımlanır.Daha sonra katalog adı bulunamazsa, bu değişkeni boş bir dize içerir. |
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME |
Bir xml şeması burada şema adını döndürür koleksiyon ad tanımlanır.Sonra şema adı bulunamazsa, bu değişkeni boş bir dize içerir. |
SS_XML_SCHEMACOLLECTION_NAME |
Bir xml şema adını döndürür koleksiyon.Daha sonra adı bulunamazsa, bu değişkeni boş bir dize içerir. |
SS_UDT_CATALOG_NAME |
udt (kullanıcı tanımlı tür) içeren katalog adı. |
SS_UDT_SCHEMA_NAME |
udt içeren şema adı. |
SS_UDT_ASSEMBLY_TYPE_NAME |
udt derleme nitelikli adı. |
UDTs, varolan type_name için sütun ; udt adını belirtmek için kullanılır Bu nedenle onun için hiçbir ek sütun eklenmesi gereken sonuç küme , SQLColumns veya SQLProcedureColumns.udt sütun veya parametre için data_type sql_ss_udt olur.
İçin udt parametrelerinin elde etmek için yukarıda tanımlanan yeni sürücüye özgü tanımlayıcıları kullanabilirsiniz ya da küme ek meta veriler özelliklerine bir udt sunucu dönmek veya bu bilgilere gereksinim duyan.
Zaman bir istemci bağlanır SQL Server ve SQLColumns, katalog giriş parametresi null veya joker karakter değerleri kullanarak değil iade bilgileri diğer katalogları.Bunun yerine, yalnızca geçerli Kataloğu hakkında bilgileri döndürülür.istemci ilk çağırabilir SQLTables hangi Kataloğu'nda istenen tablo bulunduğunu belirlemek için.istemci bu katalog değeri çağrısında, katalog giriş parametresi için kullanabilir SQLColumns sütunlarında hakkında bilgi almak içinBu tablo.
SQLColumns ve tablo değerli parametreleri
Tarafından döndürülen sonuç küme SQLColumns ayarına bağlıdırsql_sopt_ss_name_scope. Daha fazla bilgi için bkz: SQLSetStmtAttr.Aşağıdaki sütunlar için tablo değerli parametreleri eklenmiştir:
Sütun adı |
Veri türü |
İçindekiler |
|---|---|---|
SS_IS_COMPUTED |
Smallint |
Değişkenindeki table_type bir sütun için bu sütunu hesaplanan sütun ise sql_true olur; Aksi takdirde, sql_false. |
SS_IS_IDENTITY |
Smallint |
Kimlik sütunu sütun ise sql_true; Aksi takdirde, sql_false. |
Tablo değerli parametreleri hakkında daha fazla bilgi için bkz: Tablo değerli parametreleri (odbc).
Gelişmiş tarih ve saat özellikleri için SQLColumns desteği
Tarih/saat türleri için döndürülen değerler hakkında daha fazla bilgi için bkz: Meta veri katalog.
Daha fazla bilgi için bkz: Tarih/saat (odbc) geliştirmeleri.
Büyük clr UDTs SQLColumns desteği
SQLColumns büyük clr kullanıcı tanımlı türler (UDTs) destekler.Daha fazla bilgi için bkz: Büyük clr kullanıcı tanımlı türler (odbc).
Seyrek sütunlar için SQLColumns desteği
İki SQL Server için belirli sütunları eklendi sonuç küme için SQLColumns:
Sütun adı |
Veri türü |
Açıklama |
|---|---|---|
SS_IS_SPARSE |
Smallint |
Sütun seyrek sütun ise sql_true olmasıdır; Aksi takdirde, sql_false. |
SS_IS_COLUMN_SET |
Smallint |
Sütun ise column_set , sütun sql_true; Bu, Aksi takdirde, sql_false. |
SS_IS_SPARSE ve SS_IS_COLUMN_SET için eklenen tüm sürücüye özgü sütunları önce odbc belirtimi ile uyumluluk içinde görünür SQL Server sürümleri daha önceki SQL Server 2008ve sonra tüm sütunları odbc tarafından standardıyla.
Tarafından döndürülen sonuç küme SQLColumns ayarına bağlıdırsql_sopt_ss_name_scope. Daha fazla bilgi için bkz: SQLSetStmtAttr.
odbc seyrek sütunları hakkında daha fazla bilgi için bkz: Seyrek sütunlar destek (odbc).