大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:VARBINARY

· 52CE 我爱测

变长二进制字节序列,M 表示最大长度(单位:字节)。 与 VARCHAR 不同,保留原始字节序列,不按字符集或排序规则解释,适合存放任意二进制数据(如文件片段、哈希值、加密/压缩数据等),最大长度为2,147,483,647。

description

VARBINARY(M)

变长二进制字节序列,M 表示最大长度(单位:字节)。 与 VARCHAR 不同,保留原始字节序列,不按字符集或排序规则解释,适合存放任意二进制数据(如文件片段、哈希值、加密/压缩数据等),最大长度为2,147,483,647。

当前暂不支持 VARBINARY 列出现在创建的物化视图中,以及在 Group By key、Join Key、和比较谓词。

  • 版本与限制:自 4.0 起支持;当前不支持在 Doris 表中作为列类型进行建表和存储,可通过 Catalog 将外部库的 BINARY/VARBINARY 字段映射为 Doris 中的 VARBINARY 以供查询。

4.1.5 起的外部类型与限制

自 4.1.5 版本起,Catalog 的外部二进制类型固定保留为 VARBINARY,enable.mapping.varbinary=false 不再改回 STRING。Iceberg fixed(N) 保留为 VARBINARY(N),包括查询经过 Block 序列化和数据交换的场景。dev 版本的 Iceberg UUID 直接映射到原生 UUID,区别于 4.1.5 的 VARBINARY(16)。dev 的文件 TVF 也固定启用二进制映射,enable_mapping_varbinary 仅作为兼容参数接收并忽略其值;4.1.5 中该 TVF 选项仍可配置,默认 false。

Hive Text 二进制字段使用 Hive 兼容的 Base64 编解码。涉及十六进制表示的转换要求 0x 前缀以及偶数个合法十六进制数字,否则返回 Invalid VARBINARY hex representation。

上述支持不开放 Doris 内表的原生二进制列存储。当前不支持 VARBINARY 作为 Hash Join / Group By 键,也不支持比较谓词、IN / NOT IN 以及 collect_set 等未实现二进制语义的操作;4.1.5 会明确拒绝这些用法。

keywords

VARBINARY

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。