다음을 통해 공유

COL_LENGTH(Transact-SQL)

  • 아티클

업데이트: 2006년 7월 17일

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

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

COL_LENGTH ( 'table' , 'column' )

인수

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

반환 유형

smallint

예외

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

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

주의

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

예

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

USE AdventureWorks;
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;

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

VarChar     NVarChar
40          80

참고 항목

참조

식(Transact-SQL)
메타데이터 함수(Transact-SQL)
COL_NAME(Transact-SQL)
COLUMNPROPERTY(Transact-SQL)

관련 자료

열 속성 수정

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스 내역

2006년 7월 17일
새로운 내용
  • "예외" 섹션을 추가했습니다.