binary 和 varbinary (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric 中的 SQL 分析终结点Microsoft Fabric 中的仓库

固定长度或可变长度的 Binary 数据类型。

参数

binary [ ( n ) ]

长度为 n 个字节的固定长度二进制数据，其中 n 是从 1 到 8,000 的值。 存储大小为 n 字节。

varbinary [ ( n | max ) ]

可变长度二进制数据。 n 的取值范围为 1 至 8,000。 max 指示最大存储大小是 2^31-1 个字节。 存储大小为所输入数据的实际长度 + 2 个字节。 所输入数据的长度可以是 0 字节。 varbinary 的 ANSI SQL 同义词为 binary varying。

备注

如果没有在数据定义或变量声明语句中指定 n，则默认长度为 1。 如果没有使用 CAST 函数指定 n，则默认长度为 30。

数据类型 何时使用...
binary 列数据项的大小一致。
varbinary 列数据项的大小差异相当大。
varbinary(max) 列数据条目超出 8,000 字节。

转换 binary 和 varbinary 数据

将数据从字符串数据类型转换为不同长度的 binary 或 varbinary 数据类型时，SQL Server 将在数据的右侧填充或截断数据。 这些字符串数据类型为：

  • char
  • varchar
  • nchar
  • nvarchar
  • binary
  • varbinary
  • text
  • ntext
  • 图像

从其他数据类型转换为 binary 或 varbinary 时，将在数据的左侧填充或截断数据。 填充将通过使用十六进制的零来完成。

如果 binary 数据是最容易来回移动的数据，则将数据转换为 binary 和 varbinary 数据类型很有用。 某些时候，可能会将值类型转换为足够大的二进制值，然后再将其转换回来。 如果两种转换在同一版本的 SQL Server 上发生，则此转换总是会生成相同的值。 值的二进制表示形式在不同 SQL Server 版本之间可能会有所不同。

可以将 int、smallint 和 tinyint 转换为 binary 或 varbinary。 如果将 binary 值转换回整数值，则在发生了截断的情况下此值将不同于原始整数值。 例如，以下 SELECT 语句显示整数值 123456 被存储为二进制值 0x0001e240：

SELECT CAST( 123456 AS BINARY(4) );

但是，以下 SELECT 语句显示如果 binary 目标太小而不能保存整个值，则前导数字会被自动截断，以使该数值存储为 0xe240：

SELECT CAST( 123456 AS BINARY(2) );

以下批处理显示，这种自动截断会影响算术运算而不产生错误：

DECLARE @BinaryVariable2 BINARY(2);
  
SET @BinaryVariable2 = 123456;
SET @BinaryVariable2 = @BinaryVariable2 + 1;
  
SELECT CAST( @BinaryVariable2 AS INT);
GO

最终结果为 57921，而不是 123457。

注意

不能保证在 SQL Server 各个版本之间对任一数据类型与 binary 数据类型进行转换的结果是一致的。

限制

目前，在 Microsoft Fabric 中，仅支持 varbinary(n)。 不支持 binary 和 varbinary(max) 数据类型。

另请参阅