Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Şunlar için geçerlidir:
SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnalytics Platform System (PDW)
SQLColumns , CatalogName, TableName veya ColumnName parametreleri için değerlerin var olup olmadığını SQL_SUCCESS döndürür. SQLFetch , bu parametrelerde geçersiz değerler kullanıldığında SQL_NO_DATA döndürür.
Note
Büyük değer türleri için tüm uzunluk parametreleri SQL_SS_LENGTH_UNLIMITED değerle döner.
SQLColumn'lar statik bir sunucu imlecinde çalıştırılabilir. Güncellenebilir (dinamik veya tuş seti) bir imleçte SQLColumn'ları çalıştırma girişiminde, imleç türünün değiştirildiğini gösteren SQL_SUCCESS_WITH_INFO döner.
SQL Server Native Client ODBC sürücüsü, bağlı sunuculardaki tablolar için bilgi raporlamayı destekler; CatalogName parametresi için iki parçalı bir isim kabul eder: Linked_Server_Name.Catalog_Name.
ODBC 2 için. TableName'de joker kart kullanmayan x uygulamaları, SQLColumns, TableName ile eşleşen ve mevcut kullanıcıya ait olan tüm tablolar hakkında bilgi sağlar. Mevcut kullanıcı, adı TableName parametresiyle eşleşen bir tabloya sahip değilse, SQLColumns , tablo adı TableName parametresiyle eşleşen diğer kullanıcılara ait tablolar hakkında bilgi döndürür. ODBC 2 için. joker kart kullanan x uygulamaları, SQLColumnsisimleri TableName ile eşleşen tüm tabloları döndürür. ODBC 3 için. x applications SQLColumns, sahibi veya joker kart kullanılıp kullanılmadığı bağımsız olarak isimleri TableName ile eşleşen tüm tabloları döndürür.
Aşağıdaki tablo, sonuç kümesi tarafından döndürülen sütunları listeler:
| Sütun adı | Description |
|---|---|
| VERİ_TİPİ | Varchar(max) veri tipleri için SQL_VARCHAR, SQL_VARBINARY veya SQL_WVARCHAR döndürür. |
| TYPE_NAME | Varchar(max), varbinary(max) ve nvarchar(max) veri türleri için "varchar", "varbinary" veya "nvarchar" döndürür. |
| KOLON_BOYUTU | Varchar(max) veri tipleri için SQL_SS_LENGTH_UNLIMITED döndürür, bu da sütunun boyutunun sınırsız olduğunu gösterir. |
| BUFFER UZUNLUĞU | Varchar(max) veri tipleri için SQL_SS_LENGTH_UNLIMITED döndürür, bu da tamponun boyutunun sınırsız olduğunu gösterir. |
| SQL_DATA_TYPE (SQL veri tipi) | Varchar(max) veri tipleri için SQL_VARCHAR, SQL_VARBINARY veya SQL_WVARCHAR döndürür. |
| CHAR_OCTET_LENGTH (Karakter Oktet Uzunluğu) | Bir karakter veya ikili sütunun maksimum uzunluğunu döndürür. Boyutun sınırsız olduğunu göstermek için 0 döndürür. |
| SS_XML_SCHEMACOLLECTION_CATALOG_NAME | XML şema koleksiyonu adının tanımlandığı kataloğun adını döndürür. Katalog adı bulunamazsa, bu değişken boş bir dizi içerir. |
| SS_XML_SCHEMACOLLECTION_SCHEMA_NAME | XML şema koleksiyonu adının tanımlandığı şemanın adını döndürür. Şema adı bulunamazsa, bu değişken boş bir dizi içerir. |
| SS_XML_SCHEMACOLLECTION_NAME | Bir XML şema koleksiyonunun adını döndürür. İsim bulunamazsa, bu değişken boş bir dizi içerir. |
| SS_UDT_CATALOG_NAME | UDT'yi (kullanıcı tanımlı tip) içeren kataloğun adı. |
| SS_UDT_SCHEMA_NAME | UDT'yi içeren şemanın adı. |
| SS_UDT_ASSEMBLY_TYPE_NAME | UDT'nin meclis nitelikli adı. |
UDT'ler için, mevcut TYPE_NAME sütunu UDT'nin adını belirtmek için kullanılır; bu nedenle, SQLColumns veya SQLProcedureColumns sonuç kümesine ek bir sütun eklenmemelidir. Bir UDT sütunu veya parametresi için DATA_TYPE SQL_SS_UDT.
Parametrelerin UDT'si için, yukarıda tanımlanmış yeni sürücüye özgü tanımlayıcıları kullanarak sunucu bu bilgiyi döndürmesi veya zorunluluğu durumunda bir UDT'nin ek meta veri özelliklerini elde edebilir veya ayarlayabilirsiniz.
Bir istemci SQL Server'a bağlanıp SQLColumns çağırdığında, katalog giriş parametresi için NULL veya wild card değerleri kullanmak diğer kataloglardan bilgi geri getirmez. Bunun yerine, yalnızca mevcut katalogla ilgili bilgiler geri gönderilecektir. İstemci önce SQLTables'ı çağırarak istenen tablonun hangi katalogda bulunduğunu belirleyebilir. İstemci, bu katalog değerini SQLColumns çağrısında katalog giriş parametresi için kullanabilir ve tablodaki sütunlar hakkında bilgi alabilir.
SQLColumns ve Table-Valued Parametreleri
SQLColumns tarafından verilen sonuç kümesi, SQL_SOPT_SS_NAME_SCOPE ayarına bağlıdır. Daha fazla bilgi için SQLSetStmtAttr adresine bakınız. Tablo değerli parametreler için aşağıdaki sütunlar eklenmiştir:
| Sütun adı | Veri türü | İçeriği |
|---|---|---|
| SS_IS_COMPUTED | Smallint | Bir TABLE_TYPE'daki bir sütun için, bu SQL_TRUE eğer sütun hesaplanmış bir sütunsa; aksi takdirde SQL_FALSE. |
| SS_IS_IDENTITY | Smallint | SQL_TRUE sütun bir kimlik sütunuysa; aksi takdirde SQL_FALSE. |
Tablo değerli parametreler hakkında daha fazla bilgi için bkz. Table-Valued Parametreler (ODBC).
SQLColumns Geliştirilmiş Tarih ve Saat Özellikleri Desteği
Tarih/saat türleri için döneri değerler hakkında bilgi için Katalog Metadata'sına bakınız.
Daha fazla bilgi için bkz. Tarih ve Saat Geliştirmeleri (ODBC).
SQLColumns Büyük CLR UDT'ler için Destek
SQLColumns, büyük CLR kullanıcı tanımlı tipleri (UDT'leri) destekler. Daha fazla bilgi için bkz. Büyük CLR User-Defined Türleri (ODBC).
SQLColumns Support for Sparse Columns
SQLColumn'lar için sonuç setine iki SQL Server'a özgü sütun eklenmiştir:
| Sütun adı | Veri türü | Description |
|---|---|---|
| SS_IS_SPARSE | Smallint | Sütun seyrek bir sütunsa, bu SQL_TRUE; aksi takdirde SQL_FALSE. |
| SS_IS_COLUMN_SET | Smallint | Eğer sütun column_set sütunsa, bu SQL_TRUE; aksi takdirde SQL_FALSE. |
ODBC spesifikasyonuna uygun olarak, SS_IS_SPARSE ve SS_IS_COLUMN_SET SQL Server 2008 (10.0.x) öncesinde SQL Server sürümlerine eklenen tüm sürücüye özgü sütunların önünde ve ODBC tarafından zorunlu kılılan tüm sütunların ardından görünür.
SQLColumns tarafından verilen sonuç kümesi, SQL_SOPT_SS_NAME_SCOPE ayarına bağlıdır. Daha fazla bilgi için SQLSetStmtAttr adresine bakınız.
ODBC'deki seyrek sütunlar hakkında daha fazla bilgi için Seyrek Sütunlar Desteği (ODBC) sayfasına bakınız.