MySQL UUID_TO_BIN 的 swap_flag 怎样调整时间字段顺序

UUID_TO_BIN(uuid, 1)把UUID时间字段的排列由“time-low、time-mid、time-high”调整为“time-high、time-mid、time-low”，后面的字段保持不变。省略swap_flag或传0则保持原顺序。写入时传1，读回时也要用 BIN_TO_UUID(binary_uuid, 1)恢复。

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

先把存储约定写成一对函数

我更愿意把这个选项看成数据格式约定，而不是一个随手打开的性能开关。原因很直接：同一个UUID文本，用不同标志得到的二进制排列不同，查询端与展示端也必须遵守同一约定。

假设项目准备把外部可见的UUID文本存成二进制列，最小配方应同时写出编码与解码。下面示例未在本地数据库执行，只用于说明函数关系：

-- 编码和解码显式使用同一个重排标志
SET @id_text = '12345678-9abc-1def-8123-0123456789ab';
SET @id_bin = UUID_TO_BIN(@id_text, 1);
SELECT BIN_TO_UUID(@id_bin, 1) AS restored_uuid;

我会把这一对函数放在数据库访问层同一个位置维护，避免写入代码记得传1，报表导出却按默认格式解码。这里是设计建议，不是某次迁移事故的复盘。

用固定UUID看清字段重排

固定样例可以直接看出字段的位置，比每次生成一个不同UUID更容易比较。样例前三段分别是12345678、9abc、1def；开启重排后，十六进制字节前缀对应1def、9abc、12345678。

-- 同一个UUID分别按原顺序和时间字段重排编码
SET @id_text = '12345678-9abc-1def-8123-0123456789ab';
SELECT
  HEX(UUID_TO_BIN(@id_text, 0)) AS plain_layout,
  HEX(UUID_TO_BIN(@id_text, 1)) AS swapped_layout;

按字段排列可推导：原顺序为 123456789ABC1DEF81230123456789AB，重排顺序为 1DEF9ABC1234567881230123456789AB。这是示例推导，不是本机输出记录。重排规则见UUID_TO_BIN官方定义。

读写和查找使用相同标志

示例表可以把格式约定写进列注释。以下表名专供练习，应在自己的测试库使用：

-- 为示例表记录二进制UUID的编码约定
CREATE TABLE uuid_layout_demo (
    id BINARY(16) NOT NULL
        COMMENT 'UUID_TO_BIN(text, 1); decode with BIN_TO_UUID(id, 1)',
    label VARCHAR(40) NOT NULL,
    PRIMARY KEY (id)
);

-- 固定样例只插入一次，重复执行会命中主键约束
SET @id_text = '12345678-9abc-1def-8123-0123456789ab';
INSERT INTO uuid_layout_demo (id, label)
VALUES (UUID_TO_BIN(@id_text, 1), 'layout-sample');

-- 查询条件与写入保持同样编码，展示时使用配对解码
SELECT BIN_TO_UUID(id, 1) AS id_text, label
FROM uuid_layout_demo
WHERE id = UUID_TO_BIN(@id_text, 1);

这个写法把“外部文本→列值”和“列值→外部文本”明确配对。不要因为界面仍显示UUID样式，就认定读回的是原值；要用已知样本比较往返结果。

决定哪些数据适合开启重排

官方把时间字段重排的索引收益建立在UUID version 1布局上，例如MySQL UUID()产生的形式。它不是所有UUID来源都通用的优化。我的选择标准是先确认生成器与版本，再决定是否采用这套排列，不凭“UUID都差不多”作判断。

这里不提供未经实测的索引提升比例。转换函数说明了布局，并不能替代对写入量、索引结构和实际负载的测量。

给已有数据保留明确的格式说明

对已有表，我会先收集一组可追溯的UUID文本与对应列值，再对照当前编码规则。二进制列本身没有额外存储“当初传了哪个flag”的标签，所以新旧写法混用后，不能指望展示函数替项目自动猜出历史约定。

如果需要迁移，先在独立列或测试副本验证明确的转换方案，并保留原值映射；不要直接给生产列批量套一遍函数。本文只给新表最小示例，不推断任何现有数据库都适合原地转换。

swap_flag会生成新的UUID吗？

它用于既有UUID的二进制转换与字段排列，不是UUID生成器。

写入传1，读取省略标志会怎样？

省略标志按未重排布局解释，不能正确恢复原字段位置。保持配对解码是最小约定。

转换后的值有多少字节？

有效UUID转换成16字节二进制值；HEX显示的是这些字节的十六进制文本，不应把显示字符数当成二进制字节数。