跳到主要内容

UUID_TO_BIN

声明​

UUID_TO_BIN(string_uuid), UUID_TO_BIN(string_uuid, swap_flag)

说明​

UUID_TO_BIN() 将字符串 UUID 转换为二进制 UUID 并返回结果。有关字符串 UUID 格式的详细信息，请参见 **IS_UUID()**。 UUID_TO_BIN() 返回的二进制 UUID 是一个 VARBINARY(16) 值。如果 UUID 参数为 NULL，则返回值为 NULL。如果某一参数无效，则会发生报错。 UUID_TO_BIN() 的语法包括单参数和双参数两种形式，说明如下：

  • 单参数形式指定字符串 UUID 值。二进制结果与字符串参数的顺序相同。
  • 双参数形式指定字符串 UUID 值和 swap_flag 值：
    • 如果 swap_flag 为 0，则双参数形式等同于单参数形式，返回的二进制结果与字符串参数的顺序相同。
    • 如果 swap_flag 为 1，则返回值的格式是不同的，会将时间低和时间高部分（分别是十六进制数字的第一组和第三组）进行交换，即将变化较快的部分向右移动。如果结果存储在索引列中，可以提高索引的效率。

时间部分的交换被假定为使用 UUID 版本 1 的值，例如由 UUID() 函数生成的值。对于不遵循版本 1 格式的其他方式生成的 UUID 值，时间部分的交换是不适用的。

示例​

以如下字符串 UUID 值为例：

SET @uuid = '6ccd780c-abcd-1026-9564-5b8c656024db';

使用两种形式的 UUID_TO_BIN() 进行转换：

SELECT HEX(UUID_TO_BIN(@uuid));
+----------------------------------+
| HEX(UUID_TO_BIN(@uuid))          |
+----------------------------------+
| 6CCD780CABCD102695645B8C656024DB |
+----------------------------------+
1 row in set (0.001 sec)

SELECT HEX(UUID_TO_BIN(@uuid, 0));
+----------------------------------+
| HEX(UUID_TO_BIN(@uuid, 0))       |
+----------------------------------+
| 6CCD780CABCD102695645B8C656024DB |
+----------------------------------+
1 row in set (0.001 sec)

SELECT HEX(UUID_TO_BIN(@uuid, 1));
+----------------------------------+
| HEX(UUID_TO_BIN(@uuid, 1))       |
+----------------------------------+
| 1026ABCD6CCD780C95645B8C656024DB |
+----------------------------------+
1 row in set (0.001 sec)

使用 BIN_TO_UUID() 将 UUID_TO_BIN() 返回的二进制 UUID 转换为字符串 UUID。如果您使用第二个参数 1 调用 UUID_TO_BIN() 通过交换时间部分来生成二进制 UUID，您还应该将第二个参数 1 传递给 BIN_TO_UUID()，这样才能在将二进制 UUID 转换回字符串 UUID 时取消交换时间部分。

SELECT BIN_TO_UUID(UUID_TO_BIN(@uuid));
+--------------------------------------+
| BIN_TO_UUID(UUID_TO_BIN(@uuid))      |
+--------------------------------------+
| 6ccd780c-abcd-1026-9564-5b8c656024db |
+--------------------------------------+
1 row in set (0.001 sec)

SELECT BIN_TO_UUID(UUID_TO_BIN(@uuid,0),0);
+--------------------------------------+
| BIN_TO_UUID(UUID_TO_BIN(@uuid,0),0)  |
+--------------------------------------+
| 6ccd780c-abcd-1026-9564-5b8c656024db |
+--------------------------------------+
1 row in set (0.001 sec)

SELECT BIN_TO_UUID(UUID_TO_BIN(@uuid,1),1);
+--------------------------------------+
| BIN_TO_UUID(UUID_TO_BIN(@uuid,1),1)  |
+--------------------------------------+
| 6ccd780c-abcd-1026-9564-5b8c656024db |
+--------------------------------------+
1 row in set (0.001 sec)

如果两个方向的时间部分交换的转换方式不相同，则原始 UUID 无法正确恢复：

SELECT BIN_TO_UUID(UUID_TO_BIN(@uuid,0),1);
+--------------------------------------+
| BIN_TO_UUID(UUID_TO_BIN(@uuid,0),1)  |
+--------------------------------------+
| abcd1026-780c-6ccd-9564-5b8c656024db |
+--------------------------------------+
1 row in set (0.001 sec)

SELECT BIN_TO_UUID(UUID_TO_BIN(@uuid,1),0);
+--------------------------------------+
| BIN_TO_UUID(UUID_TO_BIN(@uuid,1),0)  |
+--------------------------------------+
| 1026abcd-6ccd-780c-9564-5b8c656024db |
+--------------------------------------+
1 row in set (0.001 sec)

Contents

编辑此页