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

Apache Doris 中文参考:FROM_BASE64

· 52CE 我爱测

FROM_BASE64 函数用于将 Base64 编码的字符串解码回原始字符串。这是 TO_BASE64 函数的逆操作,遵循 RFC 4648 标准。Base64 编码常用于在文本协议中传输二进制数据,该函数可以将编码的数据还原。支持标准 Base64 字符集(A-Z, a-z, 0-9, +, /)和填充字符(=)。

描述

FROM_BASE64 函数用于将 Base64 编码的字符串解码回原始字符串。这是 TO_BASE64 函数的逆操作,遵循 RFC 4648 标准。Base64 编码常用于在文本协议中传输二进制数据,该函数可以将编码的数据还原。支持标准 Base64 字符集(A-Z, a-z, 0-9, +, /)和填充字符(=)。

语法

FROM_BASE64(<str>)

参数

参数 说明
<str> 需要解码的 Base64 编码字符串。类型:VARCHAR

返回值

返回 VARCHAR 类型,表示 Base64 解码后的原始字符串。

解码规则:

  • 接受标准 Base64 字符集:A-Z, a-z, 0-9, +, /
  • 支持填充字符 =
  • 遵循 RFC 4648 标准
  • 输入长度必须是 4 的整数倍(空字符串除外)
  • 解码结果可能包含不可打印字符

特殊情况:

  • 如果输入为 NULL,返回 NULL
  • 如果输入包含非法的 Base64 字符(包括空格、换行等空白字符),返回 NULL
  • 如果输入为空字符串,返回空字符串
  • 如果输入长度不是 4 的整数倍,返回 NULL
  • 填充错误或格式不正确,返回 NULL

4.0.8 修正了 FROM_BASE64 的解码缓冲区大小计算,并明确了非法输入的处理:输入长度不是 4 的整数倍时直接返回 NULL。此前的缓冲区按输入长度的一半计算,长度偏小,非法输入可能触发越界写入。TO_BASE64 的编码缓冲区大小计算也在同一版本中修正。

示例

  1. 基本解码
SELECT FROM_BASE64('MQ=='), FROM_BASE64('QQ==');
+---------------------+---------------------+
| FROM_BASE64('MQ==') | FROM_BASE64('QQ==') |
+---------------------+---------------------+
| 1                   | A                   |
+---------------------+---------------------+
  1. 多字符解码
SELECT FROM_BASE64('MjM0'), FROM_BASE64('SGVsbG8=');
+---------------------+-------------------------+
| FROM_BASE64('MjM0') | FROM_BASE64('SGVsbG8=') |
+---------------------+-------------------------+
| 234                 | Hello                   |
+---------------------+-------------------------+
  1. NULL 值处理
SELECT FROM_BASE64(NULL);
+-------------------+
| FROM_BASE64(NULL) |
+-------------------+
| NULL              |
+-------------------+
  1. 空字符串处理
SELECT FROM_BASE64('');
+-----------------+
| FROM_BASE64('') |
+-----------------+
|                 |
+-----------------+
  1. 非法字符处理
SELECT FROM_BASE64('!!!'), FROM_BASE64('ABC@DEF');
+--------------------+------------------------+
| FROM_BASE64('!!!') | FROM_BASE64('ABC@DEF') |
+--------------------+------------------------+
| NULL               | NULL                   |
+--------------------+------------------------+
  1. 长字符串解码
SELECT FROM_BASE64('SGVsbG8gV29ybGQ='), FROM_BASE64('VGhlIHF1aWNrIGJyb3duIGZveA==');
+---------------------------------+-----------------------------------------+
| FROM_BASE64('SGVsbG8gV29ybGQ=') | FROM_BASE64('VGhlIHF1aWNrIGJyb3duIGZveA==') |
+---------------------------------+-----------------------------------------+
| Hello World                     | The quick brown fox                     |
+---------------------------------+-----------------------------------------+
  1. UTF-8 多字节字符解码
SELECT FROM_BASE64('4bmt4bmbw6w='), FROM_BASE64('4bmN4bmNdW1haSBoZWxsbw==');
+---------------------------+---------------------------------------+
| FROM_BASE64('4bmt4bmbw6w=') | FROM_BASE64('4bmN4bmNdW1haSBoZWxsbw==') |
+---------------------------+---------------------------------------+
| ṭṛì                       | ḍḍumai hello                          |
+---------------------------+---------------------------------------+
  1. 电子邮件地址解码
SELECT FROM_BASE64('dXNlckBleGFtcGxlLmNvbQ=='), FROM_BASE64('YWRtaW4udGVzdEBjb21wYW55Lm9yZw==');
+----------------------------------------+----------------------------------------------+
| FROM_BASE64('dXNlckBleGFtcGxlLmNvbQ==') | FROM_BASE64('YWRtaW4udGVzdEBjb21wYW55Lm9yZw==') |
+----------------------------------------+----------------------------------------------+
| user@example.com                       | admin.test@company.org                       |
+----------------------------------------+----------------------------------------------+
  1. JSON 数据解码
SELECT FROM_BASE64('eyJuYW1lIjoiSm9obiIsImFnZSI6MzB9'), FROM_BASE64('WzEsMiwzLDQsNV0=');
+-----------------------------------------------+---------------------------+
| FROM_BASE64('eyJuYW1lIjoiSm9obiIsImFnZSI6MzB9') | FROM_BASE64('WzEsMiwzLDQsNV0=') |
+-----------------------------------------------+---------------------------+
| {"name":"John","age":30}                      | [1,2,3,4,5]              |
+-----------------------------------------------+---------------------------+
  1. 编码解码循环验证
SELECT FROM_BASE64(TO_BASE64('Hello')), FROM_BASE64(TO_BASE64('测试'));
+----------------------------------+--------------------------------+
| FROM_BASE64(TO_BASE64('Hello')) | FROM_BASE64(TO_BASE64('测试'))  |
+----------------------------------+--------------------------------+
| Hello                            | 测试                            |
+----------------------------------+--------------------------------+

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

资料来源与适用范围

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

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

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