KOLUMNEGENSKAP (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-databas i Microsoft Fabric

Denna funktion returnerar kolumn- eller parameterinformation.

Transact-SQL syntaxkonventioner

Syntax

COLUMNPROPERTY ( id , column , property )   

Arguments

ID
Ett uttryck som innehåller identifieraren (ID) för tabellen eller proceduren.

kolumn
Ett uttryck som innehåller namnet på kolumnen eller parametern.

egenskap
För id-argumentet specificerar egenskapsargumentet vilken informationstyp funktionen COLUMNPROPERTY kommer att returnera. Egenskapsargumentet kan ha vilket som helst av dessa värden:

Värde Description Returnerat värde
AllowsNull Tillåter nollvärden. 1: SANT

0: FALSKT

NULL: ogiltig input.
ColumnId Kolumn-ID-värde som motsvarar sys.columns.column_id. Kolumn-ID

Not: När man frågar flera kolumner kan luckor uppstå i sekvensen av kolumn-ID-värden.
FullTextTypeColumn TYPKOLUMNEN i tabellen som innehåller dokumenttypinformationen för kolumnen. ID:t för fulltexten TYP COLUMN för kolumnnamnsuttrycket passerade som den andra parametern för denna funktion.
GeneratedAlwaysType Är kolumnvärdes-systemgenererat. Motsvarar sys.columns.generated_always_type gäller för: SQL Server 2016 (13.x) och senare.

0: Genereras inte alltid

1: Genereras alltid vid radstart

2: Genereras alltid vid radens slut
IsColumnSet Kolumn är en kolumnmängd. Mer information finns i Använda kolumnuppsättningar. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsComputed Kolumnen är en beräknad kolumn. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsCursorType Procedurparametern är av typen CURSOR. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsDeterministisk Kolumnen är deterministisk. Denna egenskap gäller endast beräknade kolumner och vykolumner. 1: SANT

0: FALSKT

NULL: ogiltig input. Inte en beräknad kolumn eller vykolumn.
IsFulltextIndexed Kolumnen är registrerad för fulltextindexering. 1: SANT

0: FALSKT

NULL: ogiltig input.
Är gömd Är kolumnvärdes-systemgenererat. Motsvarar sys.columns.is_hidden gäller för: SQL Server 2016 (13.x) och senare.

0: Inte dold

1: Dold
IsIdentity Kolumnen använder egenskapen IDENTITY. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsIdNotForRepl Kolumnkontroller för IDENTITY_INSERT inställningen. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsIndexable Kolumnen kan indexeras. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsOutParam Procedurparameter är en utgångsparameter. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsPrecise Kolumnen är precis. Denna egenskap gäller endast deterministiska kolumner. 1: SANT

0: FALSKT

NULL: ogiltig input. Inte en deterministisk kolumn
IsRowGuidCol Kolumnen har den unika identifierardatatypen och definieras med egenskapen ROWGUIDCOL. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsSparse Kolumnen är en gles kolumn. För mer information, se Använda glesa kolumner. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsSystemVerified Databasmotorn kan verifiera kolumnens determinism och precisionsegenskaper. Denna egenskap gäller endast för beräknade kolumner och kolumner med vyer. 1: SANT

0: FALSKT

NULL: ogiltig input.
IsXmlIndexable XML-kolumnen kan användas i ett XML-index. 1: SANT

0: FALSKT

NULL: ogiltig input.
Precision Datatyplängd för kolumnen eller parametern. Längden på den specificerade kolumndatatypen

-1: XML eller stora värdetyper

NULL: ogiltig input.
Scale Skala för kolumn- eller parameterdatatypen. Skalvärdet

NULL: ogiltig input.
Statistisk semantik Kolumnen är aktiverad för semantisk indexering. 1: SANT

0: FALSKT
SystemDataAccess Kolumn härleds från en funktion som får åtkomst till data i systemkataloger eller virtuella systemtabeller i SQL Server. Denna egenskap gäller endast för beräknade kolumner och kolumner med vyer. 1: SANT (Indikerar skrivskyddad åtkomst.)

0: FALSKT

NULL: ogiltig input.
UserDataAccess Kolumn härleds från en funktion som får åtkomst till data i användartabeller, inklusive vyer och temporära tabeller, lagrade i den lokala instansen av SQL Server. Denna egenskap gäller endast för beräknade kolumner och kolumner med vyer. 1: SANT (Indikerar skrivskyddad åtkomst.)

0: FALSKT

NULL: ogiltig input.
UsesAnsiTrim ANSI_PADDING var PÅ vid tidpunkten för bordsskapandet. Denna egenskap gäller endast kolumner eller parametrar av typen char eller varchar. 1: SANT

0: FALSKT

NULL: ogiltig input.

Returtyper

int

Exceptions

Returnerar NULL vid fel, eller om en anropare inte har behörighet att visa objektet.

En användare kan bara visa metadata för skyddsbara filer som användaren äger eller som användaren har beviljats behörighet för. Detta innebär att inbyggda funktioner som COLUMNPROPERTY sänder metadata kan returnera NULL om användaren inte har rätt behörighet på objektet. Se Metadata Visibility Configuration för mer information.

Anmärkningar

När du kontrollerar den deterministiska egenskapen hos en kolumn, testa först om kolumnen är en beräknad kolumn. IsDeterministiska argumentet returnerar NULL för icke-beräknade kolumner. Beräknade kolumner kan specificeras som indexkolumner.

Examples

Detta exempel returnerar kolumnens LastName längd.

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

Här är resultatet.

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

Se även

Metadata functions (Transact-SQL)
TYPEEGENSKAP (Transact-SQL)