COLUMNPROPERTY (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiMicrosoft Fabric'te SQL veritabanı

Bu fonksiyon sütun veya parametre bilgisini döndürür.

Transact-SQL söz dizimi kuralları

Sözdizimi

COLUMNPROPERTY ( id , column , property )   

Arguments

ID
Tablonun veya prosedürün tanımlayıcısını (ID) içeren bir ifade .

sütun
Sütunun veya parametrenin adını içeren bir ifade.

özellik
id argümanı için, özellik argümanı fonksiyonun COLUMNPROPERTY döndüreceği bilgi türünü belirtir. Özellik argümanı şu değerlerden herhangi birine sahip olabilir:

Değer	Description	Döndürülen değer
AllowsNull	Null değerlere izin verir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
ColumnId	Sütun ID değeri sys.columns.column_id'ye karşılık gelir.	Sütun Kimliği Not: Birden fazla sütun sorgulanırken, Column ID değerlerinin sırasında boşluklar çıkabilir.
FullTextTypeColumn	Tablodaki TYPE COLUMN, sütunun belge tipi bilgisini barındırır.	Sütun adı ifadesi için tam metin TYPE COLUMN'un kimliği, bu fonksiyonun ikinci parametresi olarak geçti.
GeneratedAlwaysType	Sütun değer sistemi tarafından oluşturulur. Karşılık sys.columns.generated_always_type	için geçerlidir: SQL Server 2016 (13.x) ve üzeri. 0: Her zaman üretilmez 1: Her zaman satır başında üretilir 2: Her zaman satır ucunda üretilir
IsColumnSet	Sütun bir sütun setidir. Daha fazla bilgi için bkz. Sütun Kümelerini Kullanma.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsComputed	Sütun, hesaplanan bir sütundur.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsCursorType	Prosedür parametresi CURSOR tipindendir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsDeterministic	Sütun deterministiktir. Bu özellik yalnızca hesaplanan sütunlar ve görünüm sütunları için geçerlidir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi. Hesaplanmış bir sütun ya da görünüm sütunu değil.
IsFulltextIndexed	Sütun tam metin indeksleme için kayıtlıdır.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsHidden (Gizli)	Sütun değer sistemi tarafından oluşturulur. Karşılık sys.columns.is_hidden	için geçerlidir: SQL Server 2016 (13.x) ve üzeri. 0: Gizli değil 1: Gizli
IsIdentity	Sütun, IDENTITY özelliğini kullanır.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsIdNotForRepl	IDENTITY_INSERT ayarı için sütun kontrolleri.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsIndexable	Sütun indekslenebilir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsOutParam	Prosedür parametresi bir çıkış parametresidir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsPrecise	Sütun kesin. Bu özellik yalnızca deterministik sütunlar için geçerlidir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi. Deterministik bir sütun değil
IsRowGuidCol	Sütun, benzersiz tanımlayıcı veri tipine sahiptir ve ROWGUIDCOL özelliğiyle tanımlanmıştır.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsSparse	Sütun seyrek bir sütundur. Daha fazla bilgi için bkz. Seyrek Sütunları Kullanma.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsSystemVerified	Veritabanı Motoru, sütunun determinizm ve hassasiyet özelliklerini doğrulayabilir. Bu özellik yalnızca hesaplanan sütunlar ve görünüm sütunları için geçerlidir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
IsXmlIndexable	XML sütunu bir XML indeksinde kullanılabilir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.
Kesinlik	Sütunun veya parametrenin veri tipi uzunluğu.	Belirtilen sütun veri türünün uzunluğu -1: XML veya büyük değer türleri NULL: geçersiz girdi.
Scale	Sütun veya parametre veri tipi için ölçek.	Ölçek değeri NULL: geçersiz girdi.
İstatistikSemantik	Sütun semantik indeksleme için etkinleştirilmiştir.	1: DOĞRU 0: YANLIŞ
SystemDataAccess	Column, SQL Server'ın sistem kataloglarındaki veya sanal sistem tablolarındaki verilere erişen bir fonksiyondan türetilir. Bu özellik yalnızca hesaplanan sütunlar ve görünüm sütunları için geçerlidir.	1: DOĞRU (Yalnızca okunabilir erişimi gösterir.) 0: YANLIŞ NULL: geçersiz girdi.
UserDataAccess	Column, SQL Server'ın yerel örneğinde saklanan görünümler ve geçici tablolar dahil olmak üzere kullanıcı tablolarındaki verilere erişen bir fonksiyondan türetilmiştir. Bu özellik yalnızca hesaplanan sütunlar ve görünüm sütunları için geçerlidir.	1: DOĞRU (Yalnızca okunabilir erişimi gösterir.) 0: YANLIŞ NULL: geçersiz girdi.
UsesAnsiTrim	ANSI_PADDING, masa oluşturulduğu anda AÇIKTI. Bu özellik yalnızca char veya varchar tipindeki sütunlar veya parametreler için geçerlidir.	1: DOĞRU 0: YANLIŞ NULL: geçersiz girdi.

Dönüş türleri

int

Exceptions

Hata durumunda veya bir arayan nesneyi görüntüleme iznine sahip değilse NULL döndürür.

Bir kullanıcı yalnızca kullanıcıya ait olan veya kullanıcıya izin verilen güvenli hale getirilebilir öğeler meta verilerini görüntüleyebilir. Bu, metaveri yayan, yerleşik fonksiyonların COLUMNPROPERTY , kullanıcının nesne üzerinde doğru iznine sahip değilse NULL döndürebileceği anlamına gelir. Daha fazla bilgi için Meta Veri Görünürlüğü Konfigürasyonu'na bakınız.

Açıklamalar

Bir sütunun deterministik özelliği kontrol edilirken, önce sütunun hesaplanan bir sütun olup olmadığını test edin. IsDeterministik argüman, hesaplanmamış sütunlar için NULL döndürür. Hesaplanan sütunlar indeks sütunları olarak belirtilebilir.

Örnekler

Bu örnek sütunun LastName uzunluğunu döndürür.

USE AdventureWorks2022;  
GO  
SELECT COLUMNPROPERTY( OBJECT_ID('Person.Person'),'LastName','PRECISION')AS 'Column Length';  
GO  

Sonuç kümesi aşağıdadır.

Column Length
-------------
50

Ayrıca bakınız

Meta Veri İşlevleri (Transact-SQL)
TYPEPROPERTY (Transact-SQL)