ClickHouse/docs/zh/sql-reference/functions/uuid-functions.md
Ivan Blinkov d91c97d15d
[docs] replace underscores with hyphens (#10606)
* Replace underscores with hyphens

* remove temporary code

* fix style check

* fix collapse
2020-04-30 21:19:18 +03:00

3.1 KiB
Raw Blame History

UUID函数

下面列出了所有UUID的相关函数

generateuidv4

生成一个UUID版本4)。

generateUUIDv4()

返回值

UUID类型的值。

使用示例

此示例演示如何在表中创建UUID类型的列并对其写入数据。

:) CREATE TABLE t_uuid (x UUID) ENGINE=TinyLog

:) INSERT INTO t_uuid SELECT generateUUIDv4()

:) SELECT * FROM t_uuid

┌────────────────────────────────────x─┐
 f4bf890f-f9dc-4332-ad5c-0c18e73f28e9 
└──────────────────────────────────────┘

toUUID(x)

将String类型的值转换为UUID类型的值。

toUUID(String)

返回值

UUID类型的值

使用示例

:) SELECT toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0') AS uuid

┌─────────────────────────────────uuid─┐
 61f0c404-5cb3-11e7-907b-a6006ad3dba0 
└──────────────────────────────────────┘

UUIDStringToNum

接受一个String类型的值其中包含36个字符且格式为xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx将其转换为UUID的数值并以固定字符串(16)将其返回。

UUIDStringToNum(String)

返回值

固定字符串(16)

使用示例

:) SELECT
    '612f3c40-5d3b-217e-707b-6a546a3d7b29' AS uuid,
    UUIDStringToNum(uuid) AS bytes

┌─uuid─────────────────────────────────┬─bytes────────────┐
 612f3c40-5d3b-217e-707b-6a546a3d7b29  a/<@];!~p{jTj={) 
└──────────────────────────────────────┴──────────────────┘

UUIDNumToString

接受一个固定字符串(16)类型的值返回其对应的String表现形式。

UUIDNumToString(FixedString(16))

返回值

字符串。

使用示例

SELECT
    'a/<@];!~p{jTj={)' AS bytes,
    UUIDNumToString(toFixedString(bytes, 16)) AS uuid

┌─bytes────────────┬─uuid─────────────────────────────────┐
 a/<@];!~p{jTj={)  612f3c40-5d3b-217e-707b-6a546a3d7b29 
└──────────────────┴──────────────────────────────────────┘

另请参阅

来源文章