다음을 통해 공유

DATALENGTH(Transact-SQL)

  • 아티클

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

이 함수에서는 식을 표시하는 데 사용된 바이트 수를 반환합니다.

참고

문자열 식의 문자 수를 반환하려면 LEN 함수를 사용합니다.

Transact-SQL 구문 표기 규칙

구문

DATALENGTH ( expression )

인수

expression
임의 데이터 형식의 식입니다.

반환 형식

expression의 데이터 형식이 nvarchar(max), varbinary(max) 또는 varchar(max)이면 bigint이고, 그렇지 않으면 int입니다.

설명

DATALENGTH는 다음과 같이 가변 길이 데이터를 저장할 수 있는 데이터 형식과 함께 사용할 때 매우 유용합니다.

  • image
  • ntext
  • nvarchar
  • text
  • varbinary
  • varchar

DATALENGTH는 NULL 값에 대해 NULL을 반환합니다.

참고

반환되는 값은 호환성 수준에 따라 달라질 수 있습니다. 호환성 수준에 대한 자세한 내용은 ALTER DATABASE 호환성 수준(Transact-SQL)을 참조하세요.

참고

지정된 문자열 식으로 인코딩된 문자 수를 반환하려면 LEN을 사용하고, 지정된 문자열 식의 크기(바이트)를 반환하려면 DATALENGTH를 사용합니다. 이러한 출력은 열에 사용되는 인코딩 유형 및 데이터 형식에 따라 다를 수 있습니다. 서로 다른 인코딩 유형의 스토리지 차이점에 대해 자세히 알아보려면 데이터 정렬 및 유니코드 지원을 참조하세요.

예

이 예에서는 Name 테이블에서 Product 열의 길이를 찾아냅니다.

USE AdventureWorks2022  
GO
SELECT length = DATALENGTH(EnglishProductName), EnglishProductName  
FROM dbo.DimProduct  
ORDER BY EnglishProductName;  
GO

참고 항목

LEN(Transact-SQL)
CAST 및 CONVERT(Transact-SQL)
데이터 형식(Transact-SQL)
시스템 함수(Transact-SQL)