SQLColumns
SQLColumns sql_success değerler mevcut olup olmadığını döndürür CatalogName, 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 SQL_SS_LENGTH_UNLIMITED değeri ile döner.
SQLColumns statik sunucu imleç üzerinde çalıştırılabilir. Yürütme denemesi SQLColumns güncelleştirilebilir bir (dinamik veya anahtar kümesi) imleç imleç türü değiştirildi gösteren SQL_SUCCESS_WITH_INFO döndürür.
SQL ServerYerel istemci odbc sürücüsü destekler raporlama bilgilerini bağlantılı sunucularda tablolar için iki bölümü adı için kabul ederek CatalogName parametresi: Linked_Server_Name.Catalog_Name.
odbc için 2. x içinde joker karakter kullanmayan uygulamalar TableName, SQLColumns hakkında herhangi bir bilgi tabloları olan adlarının eşleşme döndürür TableName ve geçerli kullanıcının sahip olduğu. Geçerli kullanıcı adı ile eşleşen hiçbir tablonun sahibi eğer TableName parametresi SQLColumns tablo adı eşleştiği diğer kullanıcılara ait tüm tabloları hakkında bilgi verir TableName parametresi. odbc için 2. x joker karakterleri kullanarak uygulamaları SQLColumns tüm tabloları olan adlarını eşleştirme verir TableName. odbc için 3. x uygulamaları SQLColumns tüm tabloları olan adlarını eşleştirme verir TableName sahibi veya joker karakterler kullanılıp bakılmaksızın.
Aşağıdaki tabloda, sonuç kümesi tarafından döndürülen sütunları listeler:
Sütun adı |
Açıklama |
|---|---|
DATA_TYPE |
Döner sql_varchar, SQL_VARBINARY veya sql_wvarchar için varchar(max) veri türü. |
TYPE_NAME |
Döner "varchar", "varbinary" ya da "nvarchar" için varchar(max), varbinary(max), ve nvarchar(max) veri türü. |
COLUMN_SIZE |
Döner için SQL_SS_LENGTH_UNLIMITED varchar(max) veri türü sütun boyutunun sınırsız olduğunu belirten. |
BUFFER_LENGTH |
Döner için SQL_SS_LENGTH_UNLIMITED varchar(max) veri türü arabellek boyutunun sınırsız olduğunu belirten. |
SQL_DATA_TYPE |
Döner sql_varchar, SQL_VARBINARY veya sql_wvarchar için varchar(max) veri türü. |
CHAR_OCTET_LENGTH |
Bir karakter veya ikili sütunun uzunluğu en fazla verir. Boyutunun sınırsız olduğunu belirtmek için 0 döndürür. |
SS_XML_SCHEMACOLLECTION_CATALOG_NAME |
Bir xml şema koleksiyonu adı tanımlandığı katalog adını döndürür. Katalog adı bulunamazsa, bu değişkeni boş bir dize içerir. |
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME |
Bir xml şema koleksiyonu adı tanımlandığı şema adını döndürür. Şema adı bulunamazsa, bu değişkeni boş bir dize içerir. |
SS_XML_SCHEMACOLLECTION_NAME |
xml şema koleksiyonu adını döndürür. 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 için varolan type_name sütun udt adını belirtmek için kullanılır; Bu nedenle bunun için hiçbir ek sütun için sonuç kümesi eklenmelidir SQLColumns veya SQLProcedureColumns. udt sütun veya parametre için data_type sql_ss_udt olduğunu.
İçin udt parametrelerinin alın veya sunucu dönmek veya bu bilgilere gereksinim duyan bir udt ek meta veri özelliklerini ayarlamak için yukarıda tanımlanan yeni sürücüye özgü tanımlayıcıları kullanabilirsiniz.
Bir istemci bağlandığında SQL Serverve SQLColumns, null veya joker karakter değerleri kullanarak katalog giriş parametresi diğer katalog bilgileri döndürmez. Bunun yerine, yalnızca geçerli Kataloğu hakkında bilgi döner. İstemci ilk arayabilirsiniz SQLTableshangi kataloğunda istediğiniz tablonun bulunduğunu belirlemek için. İstemci daha sonra onun çağrısına Katalog Giriş parametresi için katalog değeri kullanabilirsiniz SQLColumnsBu tablodaki sütunları hakkında bilgi almak için.
SQLColumns ve tablo Valued Parametreler
Tarafından döndürülen sonuç kümesi SQLColumnssql_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 |
Eğer sütun hesaplanan bir sütun için bir sütun içinde bir table_type SQL_TRUE; 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 Valued Parametreler (odbc).
Gelişmiş tarih ve saat özellikleri için SQLColumns desteği
Tarih ve 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 destek
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 Serverbelirli sütunlar için sonuç kümesi eklenen SQLColumns:
Sütun adı |
Veri türü |
Açıklama |
|---|---|---|
SS_IS_SPARSE |
Smallint |
Sütun seyrek sütun ise SQL_TRUE; Aksi takdirde, sql_false. |
SS_IS_COLUMN_SET |
Smallint |
Sütun ise column_setsütununda; SQL_TRUE Aksi takdirde, sql_false. |
odbc belirtimi ile uyumluluk içinde görünür SS_IS_SPARSE ve SS_IS_COLUMN_SET için eklenen tüm sürücüye özgü sütunları önce SQL Serversürümleri daha erken SQL Server 2008ve sonra tüm sütunları, kendisini odbc tarafından görevlendirilmiş.
Tarafından döndürülen sonuç kümesi SQLColumnssql_sopt_ss_name_scope ayarına bağlıdır. Daha fazla bilgi için, bkz. SQLSetStmtAttr.
ODBC seyrek sütunları hakkında daha fazla bilgi için bkz: Seyrek sütunlar destek (odbc).