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

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