COL_LENGTH(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

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

Transact-SQL 구문 표기 규칙

Syntax

COL_LENGTH ( 'table' , 'column' )

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

'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)