COLUMNPROPERTY(Transact-SQL)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

이 함수는 열 또는 매개 변수 정보를 반환합니다.

Transact-SQL 구문 표기 규칙

Syntax

COLUMNPROPERTY ( id , column , property )   

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

id
테이블 또는 프로시저의 식별자(ID)가 포함된 식입니다.

column
열 또는 매개 변수의 이름이 포함된 식입니다.

property
id 인수를 사용하는 경우 property 인수는 COLUMNPROPERTY 함수에서 반환할 정보 유형을 지정합니다. property 인수에는 다음 값 중 하나가 있을 수 있습니다.

값	Description	반환 값
AllowsNull	Null 값을 허용합니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
ColumnId	sys.columns.column_id에 해당하는 열 ID 값입니다.	열 ID 참고: 여러 열을 쿼리할 때 열 ID 값의 시퀀스에 간격이 나타날 수 있습니다.
FullTextTypeColumn	열의 문서 종류 정보를 보관하는 테이블의 TYPE COLUMN입니다.	이 함수의 두 번째 매개 변수로 전달된 열 이름 식에 대한 전체 텍스트 TYPE COLUMN의 ID입니다.
GeneratedAlwaysType	시스템에서 생성된 열 값입니다. sys.columns.generated_always_type에 해당합니다.	적용 대상: SQL Server 2016(13.x) 이상 0 = 항상 생성되지 않음 1 = 항상 행 시작에 생성됨 2 - 항상 행 끝에 생성됨
IsColumnSet	열이 열 집합입니다. 자세한 내용은 열 집합 사용을 참조하세요.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsComputed	열이 계산 열입니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsCursorType	프로시저 매개 변수가 CURSOR 형식입니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsDeterministic	열이 결정적입니다. 이 속성은 계산 열과 뷰 열에만 적용됩니다.	1: TRUE 0: FALSE NULL = 잘못된 입력 계산 열 또는 뷰 열이 아닙니다.
IsFulltextIndexed	열이 전체 텍스트 인덱싱을 위해 등록됩니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsHidden	시스템에서 생성된 열 값입니다. sys.columns.is_hidden에 해당합니다.	적용 대상: SQL Server 2016(13.x) 이상 0 = 숨기지 않음 1 = 숨김
IsIdentity	IDENTITY 속성을 사용하는 열입니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsIdNotForRepl	IDENTITY_INSERT 설정을 확인하는 열입니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsIndexable	열을 인덱싱할 수 있습니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsOutParam	프로시저 매개 변수가 출력 매개 변수입니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsPrecise	열이 정확합니다. 이 속성은 확정적인 열에만 적용할 수 있습니다.	1: TRUE 0: FALSE NULL = 잘못된 입력 확정적인 열이 아닙니다.
IsRowGuidCol	열이 uniqueidentifier 데이터 형식이며, ROWGUIDCOL 속성으로 정의됩니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsSparse	열이 스파스 열입니다. 자세한 내용은 스파스 열 사용을 참조하세요.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsSystemVerified	데이터베이스 엔진에서 열의 결정성과 전체 자릿수 속성을 확인할 수 있습니다. 이 속성은 계산 열과 뷰 열에만 적용됩니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
IsXmlIndexable	XML 인덱스에서 XML 열을 사용할 수 있습니다.	1: TRUE 0: FALSE NULL = 잘못된 입력
정밀도	열 또는 매개 변수의 데이터 형식 길이입니다.	지정한 열 데이터 형식의 길이 -1 = xml 또는 큰 값 형식 NULL = 잘못된 입력
크기 조정	열 또는 매개 변수 데이터 형식에 대한 소수 자릿수입니다.	소수 자릿수 값 NULL = 잘못된 입력
StatisticalSemantics	열에 의미 체계 인덱싱을 사용하도록 설정되어 있습니다.	1: TRUE 0: FALSE
SystemDataAccess	SQL Server의 시스템 카탈로그나 가상 시스템 테이블에 있는 데이터에 액세스하는 함수에서 열이 파생됩니다. 이 속성은 계산 열과 뷰 열에만 적용됩니다.	1 = TRUE(읽기 전용 액세스를 나타냄) 0: FALSE NULL = 잘못된 입력
UserDataAccess	뷰와 임시 테이블을 포함하여 SQL Server 로컬 인스턴스에 저장된 사용자 테이블의 데이터에 액세스하는 함수에서 열이 파생됩니다. 이 속성은 계산 열과 뷰 열에만 적용됩니다.	1 = TRUE(읽기 전용 액세스를 나타냄) 0: FALSE NULL = 잘못된 입력
UsesAnsiTrim	테이블을 만들 때 ANSI_PADDING이 ON으로 설정되었습니다. 이 속성은 char 또는 varchar 형식의 열 또는 매개 변수에만 적용됩니다.	1: TRUE 0: FALSE NULL = 잘못된 입력

반환 형식

int

예외

오류가 발생하거나 호출자에게 개체를 볼 수 있는 권한이 없으면 NULL을 반환합니다.

사용자는 소유하고 있거나 사용 권한을 부여 받은 보안 개체의 메타데이터만 볼 수 있습니다. 즉, 사용자에게 개체에 대한 올바른 권한이 없으면 COLUMNPROPERTY와 같은 메타데이터 내보내기 기본 제공 함수에서 NULL을 반환할 수 있습니다. 자세한 내용은 메타데이터 표시 유형 구성을 참조하세요.

설명

열의 결정적 속성을 확인하는 경우 먼저 해당 열이 계산 열인지 확인하세요. IsDeterministic 인수는 계산되지 않은 열에 대해 NULL을 반환합니다. 계산 열을 인덱스 열로 지정할 수 있습니다.

예

다음 예제에서는 LastName 열의 길이를 반환합니다.

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

결과 집합은 다음과 같습니다.

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

참고 항목

메타데이터 함수(Transact-SQL)
TYPEPROPERTY(Transact-SQL)