KOLOMEIGENSCHAP (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Deze functie geeft kolom- of parameterinformatie terug.

Transact-SQL syntaxis-conventies

Syntaxis

COLUMNPROPERTY ( id , column , property )   

Arguments

ID
Een expressie die de identificatie (ID) van de tabel of procedure bevat.

kolom
Een expressie met de naam van de kolom of parameter.

eigenschap
Voor het id-argument specificeert het eigenschapsargument het informatietype dat de COLUMNPROPERTY functie zal teruggeven. Het eigenschapsargument kan elk van deze waarden hebben:

Waarde	Description	Geretourneerde waarde
AllowsNull	Staat nullwaarden toe.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
ColumnId	Kolom-ID waarde overeenkomt met sys.columns.column_id.	Kolom-id Notitie: Bij het bevragen van meerdere kolommen kunnen er gaten verschijnen in de volgorde van kolom-ID-waarden.
FullTextTypeColumn	De TYPE-KOLOM in de tabel met de documenttype-informatie van de kolom.	ID van de full-text TYPE COLUMN voor de kolomnaamexpressie werd doorgegeven als de tweede parameter van deze functie.
GeneratedAlwaysType	Is kolomwaarde-systeemgegenereerd. Komt overeen met sys.columns.generated_always_type	Van toepassing op: SQL Server 2016 (13.x) en hoger. 0: Niet altijd gegenereerd 1: Altijd gegenereerd bij het begin van de rij 2: Altijd gegenereerd aan het einde van de rij
IsColumnSet	De kolom is een kolomset. Zie Gebruik kolomsetsvoor meer informatie.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsComputed	De kolom is een berekende kolom.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsCursorType	De procedureparameter is van het type CURSOR.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsDeterministisch	De kolom is deterministisch. Deze eigenschap geldt alleen voor berekende kolommen en weergavekolommen.	1: WAAR 0: ONWAAR NULL: ongeldige invoer. Geen berekende kolom of weergavekolom.
IsFulltextIndexed	De kolom is geregistreerd voor volledige tekstindexering.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
Verborgen is	Is kolomwaarde-systeemgegenereerd. Komt overeen met sys.columns.is_hidden	Van toepassing op: SQL Server 2016 (13.x) en hoger. 0: Niet verborgen 1: Verborgen
IsIdentity	Column gebruikt de eigenschap IDENTITY.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsIdNietForRepl	Kolomcontroleert de IDENTITY_INSERT instelling.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsIndexable	De kolom kan worden geïndexeerd.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsOutParam	Procedureparameter is een outputparameter.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsPrecies	De kolom is precies. Deze eigenschap geldt alleen voor deterministische kolommen.	1: WAAR 0: ONWAAR NULL: ongeldige invoer. Geen deterministische kolom
IsRowGuidCol	De kolom heeft het gegevenstype uniqueidentifier en wordt gedefinieerd met de eigenschap ROWGUIDCOL.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsSparse	De kolom is een schaars kolom. Zie Gebruik schaars kolommenvoor meer informatie.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsSystemVerified	De Database Engine kan de determinisme- en precisie-eigenschappen van de kolom verifiëren. Deze eigenschap geldt alleen voor berekende kolommen en kolommen met weergaven.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
IsXmlIndexable	De XML-kolom kan worden gebruikt in een XML-index.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.
Precision	Gegevenstypelengte van de kolom of parameter.	De lengte van het opgegeven kolomdatatype -1: XML- of grote waardetypen NULL: ongeldige invoer.
Scale	Schaal voor het type kolom of parameter.	De schaalwaarde NULL: ongeldige invoer.
Statistische Semantiek	De kolom is ingeschakeld voor semantische indexering.	1: WAAR 0: ONWAAR
SystemDataAccess	De kolom is afgeleid van een functie die gegevens benadert in de systeemcatalogi of virtuele systeemtabellen van SQL Server. Deze eigenschap geldt alleen voor berekende kolommen en kolommen met weergaven.	1: WAAR (Geeft alleen-lezen toegang aan.) 0: ONWAAR NULL: ongeldige invoer.
UserDataAccess	Column is afgeleid van een functie die data in gebruikerstabellen benadert, waaronder views en tijdelijke tabellen, opgeslagen in de lokale instantie van SQL Server. Deze eigenschap geldt alleen voor berekende kolommen en kolommen met weergaven.	1: WAAR (Geeft alleen-lezen toegang aan.) 0: ONWAAR NULL: ongeldige invoer.
UsesAnsiTrim	ANSI_PADDING stond AAN bij het maken van de tafel. Deze eigenschap geldt alleen voor kolommen of parameters van het type char of varchar.	1: WAAR 0: ONWAAR NULL: ongeldige invoer.

Retourtypen

int

Exceptions

Geeft NULL terug bij fout, of als een aanroeper geen toestemming heeft om het object te bekijken.

Een gebruiker kan alleen de metagegevens van beveiligbare items bekijken waarvan de gebruiker eigenaar is of waarvoor de gebruiker is gemachtigd. Dit betekent dat metadata-uitzendende, ingebouwde functies zoals COLUMNPROPERTY NULL kunnen teruggeven als de gebruiker niet de juiste toestemming voor het object heeft. Zie Metadata Visibility Configuration voor meer informatie.

Opmerkingen

Bij het controleren van de deterministische eigenschap van een kolom, test eerst of de kolom een berekende kolom is. Het IsDeterministische argument geeft NULL terug voor niet-berekende kolommen. Berekende kolommen kunnen worden gespecificeerd als indexkolommen.

Voorbeelden

Dit voorbeeld geeft de lengte van de LastName kolom terug.

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

Hier is het resultatenoverzicht.

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

Zie ook

Metagegevensfuncties (Transact-SQL)
TYPEPROPERTY (Transact-SQL)