如何使用ESQL生成UUID V4？UUIDASCHAR版本存疑

API 探路者

2026-8-18

ESQL生成UUID V4的实现方案

关于UUIDASCHAR的版本说明

UUIDASCHAR函数生成的是UUID V1，它基于系统MAC地址、时间戳和随机数生成，属于时间相关的UUID版本，不符合V4的全随机特征。

如何在ESQL中生成UUID V4

ESQL本身没有内置的UUID V4生成函数，但可以通过以下两种方式实现：

方法1：调用Java的UUID生成器（推荐）

利用ESQL对Java的调用能力，直接调用java.util.UUID.randomUUID()生成标准的UUID V4，代码示例如下：

-- 创建生成UUID V4的存储过程
CREATE PROCEDURE GenerateUUIDv4() RETURNS CHARACTER
BEGIN
    DECLARE javaUuidObj REFERENCE TO JAVA OBJECT 'java.util.UUID';
    DECLARE uuidStr CHARACTER;
    -- 调用Java方法生成UUID并转为字符串
    SET uuidStr = CALL javaUuidObj.randomUUID().toString();
    RETURN uuidStr;
END;

-- 使用示例
DECLARE myV4Uuid CHARACTER;
SET myV4Uuid = GenerateUUIDv4();

方法2：手动实现UUID V4逻辑（不推荐）

根据UUID V4的规范（第13位固定为4，第17位为8/9/A/B，其余位为随机十六进制字符），可以通过ESQL的随机函数构造，但需要注意随机数范围和格式拼接的准确性，示例代码：

CREATE PROCEDURE ManualGenerateUUIDv4() RETURNS CHARACTER
BEGIN
    DECLARE part1, part2, part3, part4, part5 CHARACTER;
    DECLARE variant CHAR(1);

    -- 生成各段随机十六进制字符串
    SET part1 = SUBSTRING(HEX(RANDOM() * 4294967295), 1, 8);
    SET part2 = SUBSTRING(HEX(RANDOM() * 65535), 1, 4);
    -- 第三段第4位固定为4（UUID V4标识）
    SET part3 = SUBSTRING(HEX(RANDOM() * 4095), 1, 3) || '4';
    -- 第四段第1位为8/9/A/B（UUID变体标识）
    SET variant = CHOOSE(FLOOR(RANDOM() * 4), '8', '9', 'A', 'B');
    SET part4 = variant || SUBSTRING(HEX(RANDOM() * 4095), 1, 3);
    SET part5 = SUBSTRING(HEX(RANDOM() * 1099511627775), 1, 12);

    -- 拼接成标准UUID格式
    RETURN part1 || '-' || part2 || '-' || part3 || '-' || part4 || '-' || part5;
END;