你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

toguid()

适用于：✅Microsoft Fabric✅Azure 数据资源管理器Azure Monitor✅Microsoft✅ Sentinel

将字符串转换为 guid 标量。

注意

如果可能，请改用 guid 文本。

语法

toguid(value)

详细了解语法约定。

参数

客户	类型​​	必需	Description
value	标量 (scalar)	✔️	要转换为 guid 的值。

返回

转换过程采用输入的前 32 个字符，忽略相应位置的连字符，验证字符是否仅包含 0-9 或 a-f，然后将字符串转换为 guid 标量。 忽略字符串的其余部分。

如果转换成功，结果将为 guid 标量。 否则，结果将为 null。

示例

运行查询

datatable(str: string)
[
    "0123456789abcdef0123456789abcdef",
    "0123456789ab-cdef-0123-456789abcdef",
    "a string that is not a guid"
]
| extend guid = toguid(str)

输出

str	guid
0123456789abcdef0123456789abcdef	01234567-89ab-cdef-0123-456789abcdef
0123456789ab-cdef-0123-456789abcdef	01234567-89ab-cdef-0123-456789abcdef
一个不是 guid 的字符串