你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
将字符串转换为 guid 标量。
注意
如果可能，请改用 guid 文本。
语法
toguid(
value)
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | Description |
|---|---|---|---|
| value | 标量 (scalar) | ✔️ | 要转换为 guid 的值。 |
返回
转换过程采用输入的前 32 个字符，忽略相应位置的连字符，验证字符是否仅包含 0-9 或 a-f，然后将字符串转换为 guid 标量。 忽略字符串的其余部分。
如果转换成功，则结果是 guid 标量。 否则，结果为 null。
示例
以下示例将符合转换结构要求的数据表中的字符串转换为 guid。
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 的字符串 |