다음을 통해 공유

COL_LENGTH(Transact-SQL)

  • 아티클

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance

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

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 AdventureWorks2022;  
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)