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.

Nota

Para devolver el número de caracteres de una expresión de cadena, utilice la función LEN.To return the number of characters in a string expression, use the LEN function.

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 resulta muy útil cuando se usa con tipos de datos que pueden almacenar datos de longitud variable, como:DATALENGTH becomes really helpful when used with data types that can store variable-length data, such as:

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

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.

Nota

Use LEN para devolver el número de caracteres codificados en una expresión de cadena determinada y DATALENGTH para devolver el tamaño en bytes para una expresión de cadena determinada.Use the LEN to return the number of characters encoded into a given string expression, and DATALENGTH to return the size in bytes for a given string expression. Estos resultados pueden diferir en función del tipo de datos y del tipo de codificación utilizado en la columna.These outputs may differ depending on the data type and type of encoding used in the column. Para obtener más información sobre las diferencias de almacenamiento entre los distintos tipos de codificación, consulte Compatibilidad con la intercalación y Unicode.For more information on storage differences between different encoding types, see Collation and Unicode Support.

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:

USE AdventureWorks2016  
GO
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)