toguid()
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Converte uma cadeia de caracteres em um guid escalar.
Observação
Quando possível, use literais guid.
Sintaxe
toguid(value)
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Description |
|---|---|---|---|
| value | scalar | ✔️ | O valor a ser convertido em guid. |
Devoluções
O processo de conversão pega os primeiros 32 caracteres da entrada, ignorando hífens localizados corretamente, valida se os caracteres estão entre 0-9 ou a-f e, em seguida, converte a cadeia de caracteres em um guid escalar. O restante da cadeia de caracteres é ignorado.
Se a conversão for bem-sucedida, o resultado será um guid escalar. Caso contrário, o resultado será null.
Exemplo
datatable(str: string)
[
"0123456789abcdef0123456789abcdef",
"0123456789ab-cdef-0123-456789abcdef",
"a string that is not a guid"
]
| extend guid = toguid(str)
Saída
| str | guid |
|---|---|
| 0123456789abcdef0123456789abcdef | 01234567-89ab-cdef-0123-456789abcdef |
| 0123456789AB-CDEF-0123-456789ABCDEF | 01234567-89ab-cdef-0123-456789abcdef |
| Uma cadeia de caracteres que não é um GUID |