Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 em vez disso.
Sintaxe
toguid(
valor)
Saiba mais sobre convenções de sintaxe.
Parâmetros
| Designação | Tipo | Necessário | Descrição |
|---|---|---|---|
| valor | escalar | ✔️ | O valor a converter para guid. |
Devoluções
O processo de conversão pega os primeiros 32 caracteres da entrada, ignorando hífenes corretamente localizados, valida que 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 é null.
Exemplo
O exemplo a seguir converte cadeias de caracteres em uma tabela de dados que se ajustam aos requisitos da estrutura de conversão em guid.
datatable(str: string)
[
"0123456789abcdef0123456789abcdef",
"0123456789ab-cdef-0123-456789abcdef",
"a string that is not a guid"
]
| extend guid = toguid(str)
Output
| 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 |