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

Apache Doris 中文参考:PARSE_DATA_SIZE

· 52CE 我爱测

特殊情况: - 支持的单位(区分大小写,必须按以下拼写输入):B, kB, MB, GB, TB, PB, EB, ZB, YB - 单位采用 1024 进制(如 1kB = 1024B) - 支持小数(如 "2.5MB") - 如果参数格式不合法,返回错误 - 如果参数为 NULL,返回 NULL。Doris 4.1 系列自 4.1.5 起,修复可空列中 NULL 行的处理,NULL 行不会参与字符串解析

描述

PARSE_DATA_SIZE 函数用于解析带存储单位的字符串(如 "1.5GB"),将其转换为以字节为单位的数值。

语法

PARSE_DATA_SIZE(<str>)

参数

参数 说明
<str> 带单位的数据大小字符串(如 "100MB", "2.5GB")。类型:VARCHAR

返回值

返回 LARGEINT 类型,表示转换为字节后的数值。

特殊情况:

  • 支持的单位(区分大小写,必须按以下拼写输入):B, kB, MB, GB, TB, PB, EB, ZB, YB
  • 单位采用 1024 进制(如 1kB = 1024B)
  • 支持小数(如 "2.5MB")
  • 如果参数格式不合法,返回错误
  • 如果参数为 NULL,返回 NULL。Doris 4.1 系列自 4.1.5 起,修复可空列中 NULL 行的处理,NULL 行不会参与字符串解析

支持的单位对照表:

单位 名称 字节数
B Bytes 1
kB Kilobytes 1024
MB Megabytes 1024²
GB Gigabytes 1024³
TB Terabytes 1024⁴
PB Petabytes 1024⁵
EB Exabytes 1024⁶

示例

  1. 基本用法:解析字节
SELECT parse_data_size('1024B');
+--------------------------+
| parse_data_size('1024B') |
+--------------------------+
| 1024                     |
+--------------------------+
  1. 解析千字节
SELECT parse_data_size('1kB');
+------------------------+
| parse_data_size('1kB') |
+------------------------+
| 1024                   |
+------------------------+
  1. 解析带小数的兆字节
SELECT parse_data_size('2.5MB');
+--------------------------+
| parse_data_size('2.5MB') |
+--------------------------+
| 2621440                  |
+--------------------------+
  1. 解析吉字节
SELECT parse_data_size('1GB');
+------------------------+
| parse_data_size('1GB') |
+------------------------+
| 1073741824             |
+------------------------+
  1. 解析太字节
SELECT parse_data_size('1TB');
+------------------------+
| parse_data_size('1TB') |
+------------------------+
| 1099511627776          |
+------------------------+
  1. 不支持的单位,报错
SELECT parse_data_size('1iB');
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INVALID_ARGUMENT]Invalid Input argument "1iB" of function parse_data_size
  1. 输入 NULL
SELECT parse_data_size(NUll);
+-----------------------+
| parse_data_size(NUll) |
+-----------------------+
| NULL                  |
+-----------------------+

Keywords

PARSE_DATA_SIZE

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

资料来源与适用范围

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

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

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