MySQL FORMAT_BYTES 怎样显示容量并保留数值排序

MySQL FORMAT_BYTES() 返回带单位的容量字符串。要让报表既易读又能正确排序，应同时保留原始字节列和显示列：ORDER BY、WHERE 和 SUM 使用数值，FORMAT_BYTES 只放在展示表达式里。不要把带 KiB、MiB 的文本当作统一计量单位的数字。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/performance-schema-functions.html

以下按 MySQL 8.4 官方接口说明编写，示例数据是人为构造的容量记录；SQL 没有在本机数据库执行，也不代表生产采集结果。本文解决显示与计算的字段设计，不测量数据库文件的真实占用。

保留数值列，让容量文本只负责显示

为接口约定一个非负整数 bytes_value，单位固定为字节。查询增加一个独立的 size_text 列，供人阅读。数值排序和阈值筛选继续引用 bytes_value；FORMAT_BYTES 根据输入量级生成容量文本，再交给展示列。

函数使用 KiB、MiB、GiB 等以 1024 为基础的单位；低于 1024 的字节值以整数显示。格式化包含舍入，NULL 输入仍得到 NULL。它返回字符串，不能充当精确原始值的替代品。

用只读示例固定排序规则

下面用一个公共表表达式模拟三条报告条目。它不建表、不修改数据，便于先在开发环境理解字段关系。

-- 人为构造容量数据，数值单位统一为字节。
WITH capacity_sample AS (
  SELECT 'report_alpha' AS item_name, 983040 AS bytes_value
  UNION ALL
  SELECT 'report_beta', 2097152
  UNION ALL
  SELECT 'report_gamma', 12288
)
SELECT
  item_name,
  bytes_value,
  FORMAT_BYTES(bytes_value) AS size_text
FROM capacity_sample
-- 排序引用原始数值；名称作为相同容量时的稳定次序。
ORDER BY bytes_value DESC, item_name ASC;

按数值大小推导，beta 应排在 alpha 前，gamma 最后。这是对示例数据的大小关系说明，不是执行日志。如果改成 ORDER BY size_text，数据库比较的是字符串，而不是先把每个单位换算成字节。即便某一组样本恰好看起来正确，也不应把这种偶然顺序写进报表契约。

稳定次序中的第二字段在真实系统里可以使用唯一 ID。名称可能重复时，不能仅凭名称保证翻页顺序稳定；格式化函数也不会替你解决分页中的并发数据变化。

阈值和合计都在原始数值上完成

例如“至少 1 MiB”应写为 bytes_value >= 1048576。不要筛选“显示文本含 MiB”，也不要把显示列转成数字后再比较；剥离单位的数字已经失去一致的量纲。

-- 阈值固定为字节数，示例只读取常量，不访问生产表。
WITH capacity_sample AS (
  SELECT 983040 AS bytes_value
  UNION ALL SELECT 2097152
  UNION ALL SELECT 12288
)
SELECT
  COUNT(*) AS selected_items,
  SUM(bytes_value) AS total_bytes,
  FORMAT_BYTES(SUM(bytes_value)) AS total_text
FROM capacity_sample
-- 先按统一单位选取记录，合计仍保留精确数值列。
WHERE bytes_value >= 1048576;

合计的顺序也要明确：先对原始字节值 SUM，再把合计值格式化。不要逐行解析 size_text 相加，单位选择和舍入都会让这种实现变得不可靠。没有符合条件的记录时，SUM 的 NULL 与业务上确定的零不是天然同义，是否转成零应由报表定义决定。

给接口和报表保留可计算的字段

导出至少保留原始字节字段与文本字段。前者支持聚合数值与客户端筛选，后者服务报表阅读。NULL 要有明确的缺失含义，不能一律当成“零占用”。如果数值来源是估算，显示单位变化不会把估算变成精确测量。

在应用接口中，若客户端数值类型不能精确容纳全部整数范围，可以把原始字节数作为十进制字符串传输，并由支持大整数或精确十进制的代码处理。它与 size_text 这种带单位字符串用途不同，应在字段文档里写清楚。

生产报表的权限由实际数据来源决定。FORMAT_BYTES 是格式化函数，不会赋予读取业务表或系统统计表的权限，也不需要为了显示单位增加写权限。日志记录可保留报表参数、数值阈值和数据来源口径，避免把一整份业务明细当作调试日志输出。

上线前明确这些约定

相关问题

FORMAT_BYTES 可以固定显示成 MiB 吗？

它按输入量级选择单位。若产品要求整列固定 MiB，可以自行使用原始字节数除以 1048576，并单独约定精度和列标题。排序仍然保留数值表达式。

显示相同的容量是不是原始值也相同？

不能这样判断。舍入可能让不同字节数得到相同的显示文本，精确比较需要原始字段。

函数报不存在时要创建 sys 函数吗？

先确认实际连接的数据库产品和版本支持哪个接口。本文使用 MySQL 8.4 的内置 FORMAT_BYTES；不要把其他兼容产品或旧环境自动视为具有同一能力，也不要仅为显示格式给报表账号授予建函数权限。