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 版本之间可能会有所不同。
可以将 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) 数据类型。