binary 和 varbinary (Transact-SQL)
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric 中的 SQL 终结点 Microsoft Fabric 中的仓库 Microsoft Fabric SQL 数据库
固定长度或可变长度的 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) 数据类型。