DATALENGTH (Transact-SQL)

返回用于表示任何表达式的字节数。

适用范围:SQL Server(SQL Server 2008 至当前版本),Windows Azure SQL Database(初始版本至当前版本)。

主题链接图标 Transact-SQL 语法约定

语法

DATALENGTH ( expression ) 

参数

  • expression
    任何数据类型的表达式

返回类型

如果 expression 的数据类型为 varchar(max)、nvarchar(max) 或 varbinary(max) 数据类型,则返回 bigint;否则返回 int。

注释

对于 varchar、varbinary、text、image、nvarchar 和 ntext 数据类型,DATALENGTH 尤其有用,因为这些数据类型可以存储长度可变的数据。

NULL 的 DATALENGTH 的结果是 NULL。

备注

兼容级别可能影响返回值。有关兼容级别的详细信息,请参阅 ALTER DATABASE 兼容性级别 (Transact-SQL)

示例

下面的示例查找 Product 表中的 Name 列的长度。

USE AdventureWorks2012;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO

请参阅

参考

LEN (Transact-SQL)

CAST 和 CONVERT (Transact-SQL)

数据类型 (Transact-SQL)

系统函数 (Transact-SQL)