아티클
04/01/2012

COL_LENGTH(Transact-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 AdventureWorks2008R2;
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;

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