toguid()

Converte uma cadeia de caracteres em um guid escalar.

Observação

Quando possível, use literais guid .

Syntax

toguid(value)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
value	escalar	✔️	O valor a ser convertido em guid.

Retornos

O processo de conversão usa os primeiros 32 caracteres da entrada, ignorando hifens localizados corretamente, valida se os caracteres estão entre 0-9 ou a-f e 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á escalar guid . Caso contrário, o resultado será null.

Exemplo

Executar a consulta

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