UUIDTOSTR 函数 [String]

将唯一标识符值（UUID，又称 GUID）转换为字符串值。

较新的数据库中不需要

在使用 9.0.2 以前的版本创建的数据库中，需要使用 STRTOUUID 和 UUIDTOSTR 函数在 UUID 值的二进制与字符串表示之间进行转换。

在使用 9.0.2 或更高版本创建的数据库中，UNIQUEIDENTIFIER 数据类型已更改为本地数据类型，。在这些版本中不需要使用 STRTOUUID 和 UUIDTOSTR 函数。

语法

UUIDTOSTR( uuid-expression )

参数

uuid-expression 唯一标识符值。

返回值

VARCHAR

注释

将唯一标识符转换为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（其中 x 是十六进制数字）格式的字符串值。如果此二进制值不是有效的唯一标识符，则返回 NULL。

如果您想查看 UUID 值，则可使用此函数。

另请参见

标准和兼容性

SQL/2003 服务商扩充。

示例

以下语句创建一个包含两列的 mytab 表。列 pk 的数据类型是唯一标识符，列 c1 的数据类型是整数。随后该语句在列 c1 中插入两行（值分别为 1 和 2）。

CREATE TABLE mytab(
    pk UNIQUEIDENTIFIER PRIMARY KEY DEFAULT NEWID(),
    c1 INT );
INSERT INTO mytab( c1 ) values ( 1 );
INSERT INTO mytab( c1 ) values ( 2 );

执行以下 SELECT 语句后，将返回新创建的表中的所有数据。

SELECT * FROM mytab;

您将看到一个包含两列、两行的表。为列 pk 显示的值将是二进制值。

若要将唯一标识符值转换为可读的格式，请执行以下的命令：

SELECT UUIDTOSTR(pk), c1 FROM mytab;

对于使用 9.0.2 或更高版本创建的数据库，不需要 UUIDTOSTR 函数。