DATALENGTH (Transact-SQL)DATALENGTH (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database síAzure SQL Data Warehouse síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Esta función devuelve el número de bytes usados para representar cualquier expresión.This function returns the number of bytes used to represent any expression.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

DATALENGTH ( expression )   

ArgumentosArguments

expressionexpression
Una expression de cualquier tipo de datos.An expression of any data type.

Tipos de valores devueltosReturn types

bigint si expression tiene el tipo de datos nvarchar(max) , varbinary(max) o varchar(max) ; en caso contrario, int.bigint if expression has an nvarchar(max), varbinary(max), or varchar(max) data type; otherwise int.

NotasRemarks

DATALENGTH es muy útil cuando se usa con tipos de datosDATALENGTH becomes really helpful when used with

  • imagenimage
  • ntextntext
  • nvarcharnvarchar
  • textotext
  • varbinaryvarbinary
  • varcharvarchar

porque estos tipos de datos pueden almacenar datos de longitud variable.data types, because these data types can store variable-length data.

Para un valor NULL, DATALENGTH devuelve NULL.For a NULL value, DATALENGTH returns NULL.

Nota

Los niveles de compatibilidad pueden afectar a los valores devueltos.Compatibility levels can affect return values. Vea Nivel de compatibilidad de ALTER DATABASE (Transact-SQL) para más información sobre los niveles de compatibilidad.See ALTER DATABASE Compatibility Level (Transact-SQL) for more information about compatibility levels.

EjemplosExamples

En este ejemplo se busca la longitud de la columna Name en la tabla Product:This example finds the length of the Name column in the Product table:

-- Uses AdventureWorks  
  
SELECT length = DATALENGTH(EnglishProductName), EnglishProductName  
FROM dbo.DimProduct  
ORDER BY EnglishProductName;  
GO  

Vea tambiénSee also

LEN (Transact-SQL)LEN (Transact-SQL)
CAST y CONVERT (Transact-SQL)CAST and CONVERT (Transact-SQL)
Tipos de datos (Transact-SQL)Data Types (Transact-SQL)
Funciones del sistema (Transact-SQL)System Functions (Transact-SQL)