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

StarRocks 中文参考:to_binary

· 52CE 我爱测

根据指定的二进制格式 ( ),将 VARCHAR 字符串转换为二进制类型。支持的二进制格式包括 Hex, Base64,和 UTF-8。如果未指定,默认为 Hex。

to_binary

根据指定的二进制格式 (binary_type),将 VARCHAR 字符串转换为二进制类型。支持的二进制格式包括 Hex, Base64,和 UTF-8。如果未指定,默认为 Hex。

该函数从 3.0 版本开始支持。

语法

to_binary(str[, binary_type])

参数说明

  • str: 必选,待转换的字符串,VARCHAR 类型。

  • binary_type:可选,指定的二进制格式,VARCHAR 类型。有效值:hex,encode64,utf8。

    • hex (默认值): 该函数会将输入字符串作为十六进制字符串处理('0123456789abcdef'),比如 "abab" 会转换为 x'abab'。如果输入值非法,返回空 binary 而非抛异常。hex 格式下该函数对大小写不敏感。
    • encode64: 该函数会将输入字符串作为 Base64 字符串处理,比如 "YWJhYg==" 会解码为 x'abab'。如果输入值非法,返回空 binary 而非抛异常。
    • utf8: 该函数直接将输入字符串转换为二进制类型,不做任何转换处理。

返回值说明

返回 VARBINARY 类型的二进制数值。

示例

以下示例在启动 MySQL 客户端时添加了 --binary-as-hex 选项,会默认以 hex 格式展示 BINARY 数据。

mysql> select to_binary('abab', 'hex');
+----------------------------------------------------+
| to_binary('ABAB', 'hex')                           |
+----------------------------------------------------+
| 0xABAB                                             |
+----------------------------------------------------+
1 row in set (0.01 sec)

mysql> select to_binary('U1RBUlJPQ0tT', 'encode64');
+------------------------------------------------------------------------------+
| to_binary('U1RBUlJPQ0tT', 'encode64')                                        |
+------------------------------------------------------------------------------+
| 0x53544152524F434B53                                                         |
+------------------------------------------------------------------------------+
1 row in set (0.00 sec)

mysql> select to_binary('STARROCKS', 'utf8');
+----------------------------------------------------------------+
| to_binary('STARROCKS', 'utf8')                                 |
+----------------------------------------------------------------+
| 0x53544152524F434B53                                           |
+----------------------------------------------------------------+
1 row in set (0.00 sec)

-- 输入值不合法,返回空 binary。
mysql> select to_binary('U1RBUlJPQ0tT', 'hex');
+--------------------------------------------------------------------+
| to_binary('U1RBUlJPQ0tT', 'hex')                                   |
+--------------------------------------------------------------------+
| 0x                                                                 |
+--------------------------------------------------------------------+
1 row in set (0.00 sec)

相关文档

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

资料来源与适用范围

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

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

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