You need to enable JavaScript to run this app.
导航
UUID 函数
最近更新时间:2024.11.25 12:55:25首次发布时间:2022.02.28 12:33:07

generateUUIDv4

生成version 4的 UUID 。
语法

generateUUIDv4()

返回值

  • UUID 类型值。

示例
此示例演示如何创建一个具有 UUID 类型列的表并将值插入该表中。

CREATE TABLE test.functionGenerateUUIDv4 (x UUID) ENGINE=CnchMergeTree ORDER BY x;
INSERT INTO test.functionGenerateUUIDv4 SELECT generateUUIDv4();
SELECT * FROM test.functionGenerateUUIDv4;
┌─x────────────────────────────────────┐
│ a630fbcb-1a32-4902-b5cc-dd51eba8cf4b │
└──────────────────────────────────────┘

toUUID

将字符串类型值转换为 UUID 类型。如果输入字符串是无效的 uuid 格式,则会引发异常。
语法

toUUID(String)

参数

  • String— uuid 格式的字符串。

返回值

  • UUID 类型值。

示例

SELECT toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0') AS uuid, toTypeName(uuid) AS uuid_type;
┌─uuid─────────────────────────────────┬─uuid_type─┐
│ 61f0c404-5cb3-11e7-907b-a6006ad3dba0 │ UUID      │
└──────────────────────────────────────┴───────────┘

toUUIDOrNull

它接受一个 String 类型的参数并尝试将其解析为 UUID。如果失败,则返回 NULL。
语法

toUUIDOrNull(String)

参数

  • String— uuid 格式的字符串。

返回值

  • Nullable(UUID) 类型的值。

示例

SELECT toUUIDOrNull('61f0c404-5cb3-11e7-907b-a6006ad3dba0T') AS uuid
┌─uuid─┐
│ ᴺᵁᴸᴸ │
└──────┘

toUUIDOrZero

它接受一个 String 类型的参数并尝试将其解析为 UUID。如果失败,则返回零个 UUID。
语法

toUUIDOrZero(String)

参数

  • String— uuid 格式的字符串。

返回值

  • UUID 类型值。

示例

SELECT toUUIDOrZero('61f0c404-5cb3-11e7-907b-a6006ad3dba0T') AS uuid
┌─uuid─────────────────────────────────┐
│ 00000000-0000-0000-0000-000000000000 │
└──────────────────────────────────────┘