toguid()

Converte uma cadeia num guid escalar.

Nota

Sempre que possível, utilize literais guid .

Syntax

toguid(valor)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Necessário	Descrição
value	escalar	✔️	O valor a converter em guid.

Devoluções

O processo de conversão utiliza os primeiros 32 carateres da entrada, ignorando hífenes localizados corretamente, valida que os carateres estão entre 0-9 ou a-f e, em seguida, converte a cadeia num guid escalar. O resto da cadeia é 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 que não é um guid