mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-19 14:11:58 +00:00
d91c97d15d
* Replace underscores with hyphens * remove temporary code * fix style check * fix collapse
108 lines
3.1 KiB
Markdown
108 lines
3.1 KiB
Markdown
# UUID函数 {#uuidhan-shu}
|
||
|
||
下面列出了所有UUID的相关函数
|
||
|
||
## generateuidv4 {#uuid-function-generate}
|
||
|
||
生成一个UUID（[版本4](https://tools.ietf.org/html/rfc4122#section-4.4)）。
|
||
|
||
``` sql
|
||
generateUUIDv4()
|
||
```
|
||
|
||
**返回值**
|
||
|
||
UUID类型的值。
|
||
|
||
**使用示例**
|
||
|
||
此示例演示如何在表中创建UUID类型的列，并对其写入数据。
|
||
|
||
``` sql
|
||
:) 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) {#touuid-x}
|
||
|
||
将String类型的值转换为UUID类型的值。
|
||
|
||
``` sql
|
||
toUUID(String)
|
||
```
|
||
|
||
**返回值**
|
||
|
||
UUID类型的值
|
||
|
||
**使用示例**
|
||
|
||
``` sql
|
||
:) SELECT toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0') AS uuid
|
||
|
||
┌─────────────────────────────────uuid─┐
|
||
│ 61f0c404-5cb3-11e7-907b-a6006ad3dba0 │
|
||
└──────────────────────────────────────┘
|
||
```
|
||
|
||
## UUIDStringToNum {#uuidstringtonum}
|
||
|
||
接受一个String类型的值，其中包含36个字符且格式为`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`，将其转换为UUID的数值并以[固定字符串(16)](../../sql-reference/functions/uuid-functions.md)将其返回。
|
||
|
||
``` sql
|
||
UUIDStringToNum(String)
|
||
```
|
||
|
||
**返回值**
|
||
|
||
固定字符串(16)
|
||
|
||
**使用示例**
|
||
|
||
``` sql
|
||
:) SELECT
|
||
'612f3c40-5d3b-217e-707b-6a546a3d7b29' AS uuid,
|
||
UUIDStringToNum(uuid) AS bytes
|
||
|
||
┌─uuid─────────────────────────────────┬─bytes────────────┐
|
||
│ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │ a/<@];!~p{jTj={) │
|
||
└──────────────────────────────────────┴──────────────────┘
|
||
```
|
||
|
||
## UUIDNumToString {#uuidnumtostring}
|
||
|
||
接受一个[固定字符串(16)](../../sql-reference/functions/uuid-functions.md)类型的值，返回其对应的String表现形式。
|
||
|
||
``` sql
|
||
UUIDNumToString(FixedString(16))
|
||
```
|
||
|
||
**返回值**
|
||
|
||
字符串。
|
||
|
||
**使用示例**
|
||
|
||
``` sql
|
||
SELECT
|
||
'a/<@];!~p{jTj={)' AS bytes,
|
||
UUIDNumToString(toFixedString(bytes, 16)) AS uuid
|
||
|
||
┌─bytes────────────┬─uuid─────────────────────────────────┐
|
||
│ a/<@];!~p{jTj={) │ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │
|
||
└──────────────────┴──────────────────────────────────────┘
|
||
```
|
||
|
||
## 另请参阅 {#ling-qing-can-yue}
|
||
|
||
- [dictgetuid](ext-dict-functions.md)
|
||
|
||
[来源文章](https://clickhouse.tech/docs/en/query_language/functions/uuid_function/) <!--hide-->
|