binary 和 varbinary (Transact-SQL)

适用于:Microsoft Fabric Microsoft Fabric Warehouse 中的 SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW) SQL Analytics 终结点

固定长度或可变长度的 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 版本之间可能会有所不同。

可以将 intsmallinttinyint 转换为 binaryvarbinary。 如果将 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) 数据类型。

另请参阅