SQLColumns
SQLColumns değerleri var olup olmadığını için SQL_SUCCESS verir...Katalogadı, TableName, or ColumnName parametreleri.SQLFetch Bu parametreler 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 SQL_SS_LENGTH_UNLIMITED değeriyle döndürülür.
SQLColumns imleç statik bir sunucu üzerinde çalıştırılabilir.yürütmek denemesi SQLColumns güncelleştirilebilir (dinamik veya anahtar kümesi) imlecin üzerinde imleç türü değişti gösteren SQL_SUCCESS_WITH_INFO döndürecektir.
The SQL Server Native istemci 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. x joker karakterler kullanılarak değil uygulamalarTableName, SQLColumns adları eşleşen tüm tabloları hakkında bilgi verir...TableName ve öğeler için geçerli kullanıcı tarafından sahip olunan.Geçerli kullanıcının adıyla eşleşen yok bir tabloda sahip olduğu, TableName parametresiSQLColumns tablo adı eşleşen başka kullanıcılara ait olan tüm tabloları hakkında bilgi verir...TableName parametresi.ODBC 2. x uygulamaları genel arama karakterleri kullanmaSQLColumns tüm tablo adları eşleşen verirTableName.ODBC 3. x uygulamaları SQLColumns tüm tablo adları eşleşen verirTableName sahibine veya joker karakterler kullanılıp ne olursa olsun.
Sonuç döndürülen sütunlar aşağıdaki tabloda listelenmiştir küme:
Sütun adı |
Açıklama |
|---|---|
data_type |
Verir, SQL_VARCHAR, SQL_VARBINARY veya SQL_WVARCHAR için varchar(max) veri türleri. |
type_name |
“ Varchar ”, “ varbinary ” veya “ nvarchar ” verir varchar(max), varbinary(max), and nvarchar(max) veri türleri. |
column_size |
SQL_SS_LENGTH_UNLIMITED için verir varchar(max) veri türlerini belirten sütun boyutu sınırsızdır. |
buffer_length |
SQL_SS_LENGTH_UNLIMITED için verir varchar(max) veri türlerini belirten arabelleğinin boyutu sınırsızdır. |
sql_data_type |
Verir, SQL_VARCHAR, SQL_VARBINARY veya SQL_WVARCHAR için varchar(max) veri türleri. |
char_octet_length |
Bir karakter veya ikili sütunun uzunluğu en fazla döndürür.Boyutunun sınırsız olduğunu belirtmek için 0 döndürür. |
ss_xml_schemacollection_catalog_name |
XML şema koleksiyon adı tanımlandığı katalog adını döndürür.Katalog adı bulunamıyor, daha sonra bu değişkeni, boş bir dize içerir. |
ss_xml_schemacollection_schema_name |
XML şema koleksiyon adı tanımlandığı şemasının adını döndürür.Şema adı bulunamıyor, daha sonra bu değişkeni, boş bir dize içerir. |
ss_xml_schemacollection_name |
Bir XML şema koleksiyon adını döndürür.Sonra adı bulunamazsa, bu değişken, boş bir dize içerir. |
ss_udt_catalog_name |
UDT (kullanıcı tanımlı tür) içeren bir katalog adı. |
ss_udt_schema_name |
UDT içeren şemanın adı. |
ss_udt_assembly_type_name |
UDT derleme nitelikli adı. |
UDTs için varolan TYPE_NAME sütun UDT adını belirtmek için kullanılır; bu nedenle ek hiçbir sütun için sonucu eklenmesi gereken küme, SQLColumns or SQLProcedureColumns.UDT sütun veya parametre DATA_TYPE SQL_SS_UDT ' dir.
Için UDT parametrelerinin olarak, almak için yukarıda tanımlanan bir yeni sürücüye özgü tanımlayıcıları kullanabilirsiniz veya küme ek meta veriler özellikleri bir UDT sunucu dönmek veya bu bilgilere gerek duyarlar.
Bir istemci için bağlandığında SQL Server ve çağrıları SQLColumns, diğer kataloglarından bilgileri katalog giriş parametresi döndürmez için NULL veya joker karakter kullanarak. Bunun yerine, yalnızca geçerli katalog bilgiler döndürülür.Istemci ilk çağırabilir SQLTables içinde istenen katalog belirlemek için tablo bulunur. Istemci daha sonra katalog değerini katalog giriş parametresi, bir SQLConfigDataSource çağrısında kullanabilirsiniz SQLColumns Bu tablodaki sütunlar hakkında bilgi almak için .
SQLColumns ve tablo biçiminde parametreleri
Döndürülen sonuç kümesi SQLColumns SQL_SOPT_SS_NAME_SCOPE ayarına bağlıdır. 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 |
Sütunu hesaplanan bir sütun için bir sütun içinde bir TABLE_TYPE bu SQL_TRUE ise tersi durumda, SQL_FALSE. |
ss_is_identity |
Smallint |
Sütun, kimlik sütunu ise SQL_TRUE aksi halde, SQL_FALSE. |
Tablo değerli parametreleri hakkında daha fazla bilgi için bkz: Tablo biçiminde Parametreler (ODBC).
Gelişmiş tarih ve saat özellikleri SQLColumns desteği
Tarih/saat türleri için döndürülen değerler hakkında daha fazla bilgi için bkz: Meta veriler katalog.
Daha fazla bilgi için bkz:Geliştirmeler'nı (ODBC) tarih/saat.
Büyük bir 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).
SQLColumns desteği ve seyrek sütunlar
Iki SQL Server Belirli sütunları, sonuç kümesi eklendi SQLColumns:
Sütun adı |
Veri türü |
Açıklama |
|---|---|---|
ss_is_sparse |
Smallint |
Seyrek sütun sütundur SQL_TRUE olur; aksi halde, SQL_FALSE. |
ss_is_column_set |
Smallint |
Sütun olup olmadığını column_set sütun, SQL_TRUE budur; aksi halde, SQL_FALSE. |
ODBC belirtimiyle Uygunluğu'de, önce eklenmiş olan sürücüye özgü tüm sütunları SS_IS_SPARSE ve SS_IS_COLUMN_SET görünür SQL Server sürüm tarihi SQL Server 2008sonra tüm sütunları ODBC tarafından mandated.
Döndürülen sonuç kümesi SQLColumns SQL_SOPT_SS_NAME_SCOPE ayarına bağlıdır. Daha fazla bilgi için bkz:SQLSetStmtAttr.
ODBC sparse sütunları hakkında daha fazla bilgi için bkz: Seyrek sütunlar destek (ODBC).