COLUMNPROPERTY(Transact-SQL)COLUMNPROPERTY (Transact-SQL)

적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions) 예Azure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions) 예Azure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database

이 함수는 열 또는 매개 변수 정보를 반환합니다.This function returns column or parameter information.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax

COLUMNPROPERTY ( id , column , property )   

참고

SQL Server 2014 이전 버전의 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조하세요.To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

인수Arguments

idid
테이블 또는 프로시저의 식별자(ID)가 포함된 입니다.An expression containing the identifier (ID) of the table or procedure.

columncolumn
열 또는 매개 변수의 이름이 포함된 식입니다.An expression containing the name of the column or parameter.

propertyproperty
id 인수를 사용하는 경우 property 인수는 COLUMNPROPERTY 함수에서 반환할 정보 유형을 지정합니다.For the id argument, the property argument specifies the information type that the COLUMNPROPERTY function will return. property 인수에는 다음 값 중 하나가 있을 수 있습니다.The property argument can have any one of these values:

Value DescriptionDescription 반환 값Value returned
AllowsNullAllowsNull Null 값을 허용합니다.Allows null values. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
ColumnIdColumnId sys.columns.column_id에 해당하는 열 ID 값입니다.Column ID value corresponding to sys.columns.column_id. 열 IDColumn ID

참고: 여러 열을 쿼리할 때 열 ID 값의 시퀀스에 간격이 나타날 수 있습니다.Note: When querying multiple columns, gaps may appear in the sequence of Column ID values.
FullTextTypeColumnFullTextTypeColumn 의 문서 종류 정보를 보관하는 테이블의 TYPE COLUMN입니다.The TYPE COLUMN in the table holding the document type information of the column. 이 함수의 두 번째 매개 변수로 전달된 열 이름 식에 대한 전체 텍스트 TYPE COLUMN의 ID입니다.ID of the full-text TYPE COLUMN for the column name expression passed as the second parameter of this function.
GeneratedAlwaysTypeGeneratedAlwaysType 시스템에서 생성된 열 값입니다.Is column value system-generated. sys.columns.generated_always_type에 해당합니다.Corresponds to sys.columns.generated_always_type 적용 대상: SQL Server 2016(13.x)SQL Server 2016 (13.x) 이상Applies to: SQL Server 2016(13.x)SQL Server 2016 (13.x) and later.

0 = 항상 생성되지 않음0: Not generated always

1 = 항상 행 시작에 생성됨1: Generated always at row start

2 - 항상 행 끝에 생성됨2: Generated always at row end
IsColumnSetIsColumnSet 열이 열 집합입니다.Column is a column set. 자세한 내용은 열 집합 사용을 참조하세요.For more information, see Use Column Sets. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsComputedIsComputed 열이 계산 열입니다.Column is a computed column. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsCursorTypeIsCursorType 프로시저 매개 변수가 CURSOR 형식입니다.Procedure parameter is of type CURSOR. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsDeterministicIsDeterministic 열이 결정적입니다.Column is deterministic. 이 속성은 계산 열과 뷰 열에만 적용됩니다.This property applies only to computed columns and view columns. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input. 계산 열 또는 뷰 열이 아닙니다.Not a computed column or view column.
IsFulltextIndexedIsFulltextIndexed 열이 전체 텍스트 인덱싱을 위해 등록됩니다.Column is registered for full-text indexing. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsHiddenIsHidden 시스템에서 생성된 열 값입니다.Is column value system-generated. sys.columns.is_hidden에 해당합니다.Corresponds to sys.columns.is_hidden 적용 대상: SQL Server 2019 (15.x)SQL Server 2019 (15.x) 이상Applies to: SQL Server 2019 (15.x)SQL Server 2019 (15.x) and later.

0 = 숨기지 않음0: Not hidden

1 = 숨김1: Hidden
IsIdentityIsIdentity IDENTITY 속성을 사용하는 열입니다.Column uses the IDENTITY property. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsIdNotForReplIsIdNotForRepl IDENTITY_INSERT 설정을 확인하는 열입니다.Column checks for the IDENTITY_INSERT setting. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsIndexableIsIndexable 열을 인덱싱할 수 있습니다.Column can be indexed. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsOutParamIsOutParam 프로시저 매개 변수가 출력 매개 변수입니다.Procedure parameter is an output parameter. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsPreciseIsPrecise 열이 정확합니다.Column is precise. 이 속성은 확정적인 열에만 적용할 수 있습니다.This property applies only to deterministic columns. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input. 확정적인 열이 아닙니다.Not a deterministic column
IsRowGuidColIsRowGuidCol 열이 uniqueidentifier 데이터 형식이며, ROWGUIDCOL 속성으로 정의됩니다.Column has the uniqueidentifier data type, and is defined with the ROWGUIDCOL property. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsSparseIsSparse 열이 스파스 열입니다.Column is a sparse column. 자세한 내용은 스파스 열 사용을 참조하세요.For more information, see Use Sparse Columns. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsSystemVerifiedIsSystemVerified 데이터베이스 엔진Database Engine에서 열의 결정성과 전체 자릿수 속성을 확인할 수 있습니다.The 데이터베이스 엔진Database Engine can verify the determinism and precision properties of the column. 이 속성은 계산 열과 뷰 열에만 적용됩니다.This property applies only to computed columns and columns of views. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
IsXmlIndexableIsXmlIndexable XML 인덱스에서 XML 열을 사용할 수 있습니다.The XML column can be used in an XML index. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
정밀도Precision 열 또는 매개 변수의 데이터 형식 길이입니다.Data type length of the column or parameter. 지정한 열 데이터 형식의 길이The length of the specified column data type

-1 = xml 또는 큰 값 형식-1: xml or large value types

NULL = 잘못된 입력NULL: invalid input.
규모Scale 열 또는 매개 변수 데이터 형식에 대한 소수 자릿수입니다.Scale for the column or parameter data type. 소수 자릿수 값The scale value

NULL = 잘못된 입력NULL: invalid input.
StatisticalSemanticsStatisticalSemantics 열에 의미 체계 인덱싱을 사용하도록 설정되어 있습니다.Column is enabled for semantic indexing. 1: TRUE1: TRUE

0: FALSE0: FALSE
SystemDataAccessSystemDataAccess SQL ServerSQL Server의 시스템 카탈로그나 가상 시스템 테이블에 있는 데이터에 액세스하는 함수에서 열이 파생됩니다.Column is derived from a function that accesses data in the system catalogs or virtual system tables of SQL ServerSQL Server. 이 속성은 계산 열과 뷰 열에만 적용됩니다.This property applies only to computed columns and columns of views. 1 = TRUE(읽기 전용 액세스를 나타냄)1: TRUE (Indicates read-only access.)

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
UserDataAccessUserDataAccess 뷰와 임시 테이블을 포함하여 SQL ServerSQL Server 로컬 인스턴스에 저장된 사용자 테이블의 데이터에 액세스하는 함수에서 열이 파생됩니다.Column is derived from a function that accesses data in user tables, including views and temporary tables, stored in the local instance of SQL ServerSQL Server. 이 속성은 계산 열과 뷰 열에만 적용됩니다.This property applies only to computed columns and columns of views. 1 = TRUE(읽기 전용 액세스를 나타냄)1: TRUE (Indicates read-only access.)

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.
UsesAnsiTrimUsesAnsiTrim 테이블을 만들 때 ANSI_PADDING이 ON으로 설정되었습니다.ANSI_PADDING was set ON at time of table creation. 이 속성은 char 또는 varchar 형식의 열 또는 매개 변수에만 적용됩니다.This property applies only to columns or parameters of type char or varchar. 1: TRUE1: TRUE

0: FALSE0: FALSE

NULL = 잘못된 입력NULL: invalid input.

반환 형식Return types

intint

예외Exceptions

오류가 발생하거나 호출자에게 개체를 볼 수 있는 권한이 없으면 NULL을 반환합니다.Returns NULL on error, or if a caller does not have permission to view the object.

사용자는 소유하고 있거나 사용 권한을 부여 받은 보안 개체의 메타데이터만 볼 수 있습니다.A user can only view the metadata of securables that the user owns or on which the user has been granted permission. 즉, 사용자에게 개체에 대한 올바른 권한이 없으면 COLUMNPROPERTY와 같은 메타데이터 내보내기 기본 제공 함수에서 NULL을 반환할 수 있습니다.This means that metadata-emitting, built-in functions such as COLUMNPROPERTY might return NULL, if the user does not have correct permission on the object. 자세한 내용은 메타데이터 표시 유형 구성을 참조하세요.See Metadata Visibility Configuration for more information.

설명Remarks

열의 결정적 속성을 확인하는 경우 먼저 해당 열이 계산 열인지 확인하세요.When checking the deterministic property of a column, first test whether the column is a computed column. IsDeterministic 인수는 계산되지 않은 열에 대해 NULL을 반환합니다.The IsDeterministic argument returns NULL for noncomputed columns. 계산 열을 인덱스 열로 지정할 수 있습니다.Computed columns can be specified as index columns.

Examples

다음 예제에서는 LastName 열의 길이를 반환합니다.This example returns the length of the LastName column.

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

결과 집합은 다음과 같습니다.Here is the result set.

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

참고 항목See also

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