DATALENGTH(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

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

참고

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

Transact-SQL 구문 표기 규칙

Syntax

DATALENGTH ( expression )

참고 항목

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

인수

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)