sp_columns (Transact-sql)

Makale
10/29/2012

Geçerli çevreyi sorgulanabilen belirli nesneler için sütun bilgilerini döndürür.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

sp_columns [ @table_name = ] object  [ , [ @table_owner = ] owner ] 
     [ , [ @table_qualifier = ] qualifier ] 
     [ , [ @column_name = ] column ] 
     [ , [ @ODBCVer = ] ODBCVer ]

Bağımsız değişkenler

**@table_name=**object
Katalog bilgileri döndürmek için kullanılan nesnenin adıdır. objectbir tablo, görünüm veya tablo değerli işlevler gibi sütunlar sahip başka bir nesneyi olabilir. objectise nvarchar(384), hiçbir varsayılan ile. Joker karakter deseniyle eşleşen desteklenir.
**@table_owner=**owner
Katalog bilgileri döndürmek için kullanılan nesne nesne sahibi. ownerise nvarchar(384), null varsayılan. Joker karakter deseniyle eşleşen desteklenir. Eğer ownerbelirtilmemişse, varsayılan nesnenin görünürlük kurallar, temel alınan dbms.

Geçerli kullanıcının belirtilen ada sahip bir nesne sahipse, o nesnenin sütunları döndürülür. Eğer ownerbelirtilen ve geçerli kullanıcının belirtilen bir nesne kendi değil object, sp_columns ile belirtilen nesne arar objectveritabanı sahibi tarafından sahip olunan. Varsa, o nesnenin sütunları döndürülür.
**@ TABLE_QUALIFIER=qualifier
Nesne niteleyicisi adıdır. qualifierise sysname, null varsayılan. Üç bölümlü adlandırma için çeşitli dbms ürünleri desteği (qualifier.owner.**name). De SQL Server, bu sütun veritabanı adını temsil eder. Bazı ürünlerde, bu nesnenin veritabanı ortamında sunucu adını temsil eder.
**@column_name=**column
Tek bir sütun olduğunu ve yalnızca bir sütun Katalog bilgi istediğinde kullanılır. columnise nvarchar(384), null varsayılan. Eğer columnolduğu belirtilen değil, tüm sütunları döndürülen. De SQL Server, columnnda listelenen sütun adını gösteren syscolumns tablosu. Joker karakter deseniyle eşleşen desteklenir. En fazla birlikte çalışabilirlik için ağ geçidi istemci (% ve _ joker karakter) yalnızca sql-92 standart desen eşleştirme varsaymalıdır.
**@ODBCVer=**ODBCVer
Kullanılan odbc sürümüdür. ODBCVerise int, 2 varsayılan. Bu odbc sürüm 2 gösterir. 2 Veya 3 geçerli değerlerdir. Sürüm 2 ve 3 arasındaki davranış farklılıkları için bkz: odbc SQLColumns belirtimi.

Dönüş Kodu Değerleri

Hiçbiri

Sonuç Kümeleri

Sp_columns katalog depolanan yordamı eşdeğerdir SQLColumns ODBC. Döndürülen sonuçları tarafından sipariş edilen TABLE_QUALIFIER, table_owner, ve table_name.

Sütun adı	Veri türü	Açıklama
TABLE_QUALIFIER	sysname	Nesne niteleyicisi adı. Bu alan boş olabilir.
TABLE_OWNER	sysname	Nesnenin sahibi adı. Bu alan her zaman bir değer döndürür.
TABLE_NAME	sysname	Nesne adı. Bu alan her zaman bir değer döndürür.
COLUMN_NAME	sysname	Her sütun için sütun adı table_name döndü. Bu alan her zaman bir değer döndürür.
DATA_TYPE	smallint	odbc veri türü tamsayı kod. Bu bir odbc türü eşlenemez veri türü ise, null olur. Yerel veri türü adı iade type_name sütun.
TYPE_NAME	sysname	Bir veri türünü temsil eden dize. Temel alınan dbms, bu veri türü adı sunar.
HASSAS	int	Basamak sayısı. Dönüş değeri hassas sütundur temel 10'da.
LENGTH	int	Verilerin boyutunu aktarın.1
ÖLÇEK	smallint	Ondalık ayırıcının sağındaki basamak sayısı.
RADIX	smallint	Sayısal veri türleri için temel.
NULL OLABİLECEK	smallint	Nullability belirtir. 1 = null mümkündür. 0 = NULL.
AÇIKLAMALAR	varchar(254)	Bu alan her zaman null döndürüyor.
COLUMN_DEF	nvarchar(4000)	Sütunun varsayılan değeri.
SQL_DATA_TYPE	smallint	Tanımlayıcısı türü alanında göründüğü gibi sql veri türü değeri. Bu sütunda aynı olan data_type sütunu, dışında datetime ve sql-92 Aralık veri türleri. Bu sütun, her zaman bir değer döndürür.
SQL_DATETIME_SUB	smallint	Kodu subtype datetime ve sql-92 Aralık veri türü. Diğer veri türleri için bu sütun null döndürür.
CHAR_OCTET_LENGTH	int	Maksimum uzunluğu bayt karakter veya tamsayı veri sütuna yazın. Tüm diğer veri tipleri için bu sütun null döndürür.
ORDINAL_POSITION	int	Sütunu sıralı konumunu nesne. Nesneyi ilk sütun 1'dir. Bu sütun, her zaman bir değer döndürür.
IS_NULLABLE	varchar(254)	Nesne Sütun nullability. Nullability belirlemek için ISO kuralları izler. ISO sql uyumlu bir dbms, boş bir dize döndüremez. Evet = sütun null içerebilir. Hayır = sütun boş değerlere dahil olamaz. Bu sütun, nullability bilinmiyorsa, sıfır uzunluklu bir dize döndürür. Bu sütun için döndürülen değer farklı olduğu için döndürülen değer nullable sütun.
SS_DATA_TYPE	tinyint	SQL Serververi türü tarafından kullanılan genişletilmiş saklı yordamları. Daha fazla bilgi için, bkz. Veri Türleri (Transact-SQL).

1 Daha fazla bilgi için Microsoft odbc belgelerine bakın.

İzinler

Şema select izni gerektirir.

Açıklamalar

sp_columns sınırlandırılmış tanımlayıcıları için gereksinimleri aşağıdaki gibidir. Daha fazla bilgi için, bkz. Veritabanı tanımlayıcıları.

Örnekler

Aşağıdaki örnek, belirtilen tablo için sütun bilgilerini döndürür.

USE AdventureWorks2012;
GO
EXEC sp_columns @table_name = N'Department',
   @table_owner = N'HumanResources';

USE AdventureWorks2012;
GO
EXEC sp_columns @table_name = N'Department',
   @table_owner = N'HumanResources';