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

108 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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-->