SQLDescribeCol

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse Analytics

Yürütülen ifadeler için, SQL Server Native Client ODBC sürücüsü, bir sonuç kümesindeki sütunları tanımlamak için sunucuyu sorgulamak zorunda değildir. Bu durumda, SQLDescribeCol sunucu gidiş-dönüş anlamına gelmez. SQLColAttribute ve SQLNumResultCols gibi, hazırlanmış ama çalıştırılmamış ilemelerde SQLDescribeCol çağrısı sunucu roundtrip oluşturur.

Bir Transact-SQL ifadesi veya ifade toplu birden fazla sonuç satır kümesi döndürdüğünde, ordinal ile referans verilen bir sütunun ayrı bir tablodan çıkması veya sonuç kümesinde tamamen farklı bir sütuna atıfta bulunması mümkündür. Her küme için SQLDescribeCol çağrılmalıdır. Sonuç seti değiştiğinde, uygulama satır sonuçlarını getirmeden önce veri değerlerini yeniden bağlamalıdır. Birden fazla sonuç kümesi iadelerinin işlenmesiyle ilgili daha fazla bilgi için SQLMoreResults'a bakınız.

Sütun öznitelikleri, hazırlanmış bir SQL ifadesi grubu tarafından birden fazla sonuç kümesi oluşturulduğunda, yalnızca ilk sonuç seti için raporlanır.

Büyük değerli veri tipleri için DataTypePtr'de geri dönen değer SQL_VARCHAR, SQL_VARBINARY veya SQL_NVARCHAR'dir. ColumnSizePtr içindeki SQL_SS_LENGTH_UNLIMITED değeri, boyutun "sınırsız" olduğunu gösterir.

SQL Server 2012 (11.x) ile başlayan veritabanı motorundaki iyileştirmeler, SQLDescribeCol'un beklenen sonuçların daha doğru açıklamalarını elde etmesini sağlar. Bu daha doğru sonuçlar, önceki SQL Server sürümlerinde SQLDescribeCol tarafından verilen değerlerden farklı olabilir. Daha fazla bilgi için bakınız: Meta Veri Keşfi.

Gelişmiş Tarih ve Saat Özellikleri için SQLDescribeCol Desteği

Tarih/saat türleri için geri dönen değerler şunlardır:

Özellik DataTypePtr ColumnSizePtr DecimalDigitsPtr
tarih/zaman SQL_TYPE_TIMESTAMP 23 3
smalldatetime SQL_TYPE_TIMESTAMP 16 0
date SQL_TYPE_DATE 10 0
time SQL_SS_TIME2 8, 10..16 0..7
datetime2 SQL_TYPE_TIMESTAMP 19, 21..27 0..7
datetimeoffset SQL_SS_TIMESTAMPOFFSET 26, 28..34 0..7

Daha fazla bilgi için bkz. Tarih ve Saat Geliştirmeleri (ODBC).

Büyük CLR UDT'ler için SQLDescribeCol Desteği

SQLDescribeCol , büyük CLR kullanıcı tanımlı türleri (UDT'ler) destekler. Daha fazla bilgi için bkz. Büyük CLR User-Defined Türleri (ODBC).