COLUMNPROPERTY (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseFelügyelt Azure SQL-példánySQL-adatbázis a Microsoft Fabricben

Ez a függvény oszlop- vagy paraméterinformációt ad vissza.

Transact-SQL szintaxis konvenciók

Szemantika

COLUMNPROPERTY ( id , column , property )   

Arguments

azonosító
Egy kifejezés , amely tartalmazza a tábla vagy eljárás azonosítóját (ID).

oszlop
Egy kifejezés, amely tartalmazza az oszlop vagy paraméter nevét.

ingatlan
Az id argumentum esetén a tulajdonság érve megadja az információtípust, amelyet a COLUMNPROPERTY függvény visszaad. A tulajdonság argumentumának bármelyike megkaphatja ezeket az értékeket:

Érték	Description	Visszaadott érték
AllowsNull	Null értékeket engedélyez.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
ColumnId	Az oszlopazonosító érték a sys.columns.column_id-nek felel meg.	Oszlopazonosító Jegyzet: Több oszlop lekérdezésekor résekbe kerülhetnek a Column ID értékek sorrendjében.
FullTextTypeColumn	A táblázatban található TYPE COLUMN, amely tartalmazza az oszlop dokumentumtípus-információit.	A teljes szöveges TYPE COLUMN azonosítója az oszlopnév kifejezéshez a függvény második paramétereként került át.
GeneratedAlwaysType	Oszlopérték-rendszer által generált. A sys.columns.generated_always_type	Az: SQL Server 2016 (13.x) és újabb verziókra vonatkozik. 0: Nem mindig generálódik 1: Mindig a sor elején generálódik 2: Mindig a sor végén generálnak
IsColumnSet	Az oszlop egy oszlopkészlet. További információkért lásd a Oszlopkészletek használatarészt.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
Is Computed	Az oszlop egy számított oszlop.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsCursorType	A eljárás paramétere CURSOR típusú.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsDeterminisztikus	Az oszlop determinisztika. Ez a tulajdonság csak a számított oszlopokra és nézetoszlopokra vonatkozik.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet. Nem egy számított oszlop vagy nézet oszlop.
IsFulltextIndexed	Az oszlop teljes szöveges indexelésre van regisztrálva.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
Rejtett	Oszlopérték-rendszer által generált. Megfelel sys.columns.is_hidden	Az: SQL Server 2016 (13.x) és újabb verziókra vonatkozik. 0: Nem rejtve 1: Rejtett
IsIdentity	Az oszlop az IDENTITY tulajdonságot használja.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsIdNotForRepl	Oszlopok ellenőrzése a IDENTITY_INSERT beállításra.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsIndexable	Az oszlop indexelhető.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsOutParam	Az eljárás paramétere egy kimeneti paraméter.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsPrecise	Az oszlop pontos. Ez a tulajdonság csak determinisztikus oszlopokra vonatkozik.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet. Nem determinisztikus oszlop
IsRowGuidCol	Az oszlop egyedi azonosító adattípusa van, és a ROWGUIDCOL tulajdonsággal van definiálva.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsSparse	Az oszlop egy ritka oszlop. További információ: Ritka oszlopok használata.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsSystemVerified	Az Adatbázis Motor képes ellenőrizni az oszlop determinizmusát és pontosságát. Ez a tulajdonság csak a számított oszlopokra és nézetek oszlopaira vonatkozik.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
IsXmlIndexable	Az XML oszlop használható XML indexben.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.
Precision	Az oszlop vagy paraméter adattípus hossza.	A megadott oszlop adattípusának hossza -1: xml vagy nagy értékű típusok NULL: érvénytelen bemenet.
Scale	Méretarány az oszlop- vagy paraméteradattípushoz.	A méretarány NULL: érvénytelen bemenet.
Statisztikai szemantika	Az oszlop szemantikai indexelésre engedélyezett.	1: IGAZ 0: HAMIS
SystemDataAccess	Az oszlop egy olyan függvényből származik, amely az SQL Server rendszerkatalógusában vagy virtuális rendszertáblázatában található adatokat éri el. Ez a tulajdonság csak a számított oszlopokra és nézetek oszlopaira vonatkozik.	1: TRUE (Csak olvasható hozzáférést jelez.) 0: HAMIS NULL: érvénytelen bemenet.
UserDataAccess	Az oszlop egy olyan függvényből származik, amely hozzáfér a felhasználói táblákban lévő adatokhoz, beleértve a nézeteket és ideiglenes táblákat, amelyeket az SQL Server helyi példányában tárolnak. Ez a tulajdonság csak a számított oszlopokra és nézetek oszlopaira vonatkozik.	1: TRUE (Csak olvasható hozzáférést jelez.) 0: HAMIS NULL: érvénytelen bemenet.
UsesAnsiTrim	ANSI_PADDING az asztalkészítés idején volt bekapcsolva. Ez a tulajdonság csak char vagyvarchar típusú oszlopokra vagy paraméterekre vonatkozik.	1: IGAZ 0: HAMIS NULL: érvénytelen bemenet.

Visszatérési típusok

int

Exceptions

Hibából vagy ha a hívónak nincs engedélye az objektum megtekintésére, NULL-t ad vissza.

A felhasználó csak azoknak a biztonságos adatoknak a metaadatait tekintheti meg, amelyek a felhasználó tulajdonában vannak, vagy amelyekhez a felhasználó engedélyt kapott. Ez azt jelenti, hogy metaadatokat kibocsátó, beépített funkciók, COLUMNPROPERTY például NULL-t adhatnak vissza, ha a felhasználónak nincs megfelelő engedélye az objektumra. További információért lásd a Metadata Visibility Configuration (Metadata Visibility Configuration ) oldalt.

Megjegyzések

Az oszlop determinisztikus tulajdonságának ellenőrzésekor először teszteljük, hogy az oszlop kiszámított oszlop-e. Az IsDeterminisztikus érv NULL-t ad vissza nem kiszámított oszlopokért. A számítási oszlopok indexoszlopként is meghatározhatók.

Példák

Ez a példa az oszlop hosszát LastName adja vissza.

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

Itt van az eredmények összessége.

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

Lásd még

Metaadatfüggvények (Transact-SQL)
TYPEPROPERTY (Transact-SQL)