COL_LENGTH(Transact-SQL)

아티클
03/07/2014

열의 정의된 길이(바이트)를 반환합니다.

적용 대상: SQL Server(SQL Server 2008 - current version), Windows Azure SQL 데이터베이스(최초 릴리스 - 현재 릴리스)

구문

COL_LENGTH ( 'table' , 'column' )

인수

' table '
열 길이 정보를 확인할 테이블의 이름입니다. table는 nvarchar 형식의 식이며,
' column '
길이를 확인할 열의 이름입니다. column은 nvarchar 형식의 식입니다.

반환 형식

smallint

예외

오류가 발생하거나 호출자가 개체를 볼 수 있는 권한을 갖고 있지 않으면 NULL을 반환합니다.

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

주의

max 지정자(varchar(max))로 선언된 varchar 형식의 열에서는 COL_LENGTH가 값 -1을 반환합니다.

예

다음 예에서는 varchar(40) 형식의 열과 nvarchar(40) 형식의 열에 대한 반환 값을 보여 줍니다.

USE AdventureWorks2012;
GO
CREATE TABLE t1(c1 varchar(40), c2 nvarchar(40) );
GO
SELECT COL_LENGTH('t1','c1')AS 'VarChar',
      COL_LENGTH('t1','c2')AS 'NVarChar';
GO
DROP TABLE t1;

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