toguid()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Converte uma cadeia de caracteres em um guid escalar.

Sintaxe

toguid( value)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

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

O exemplo a seguir converte cadeias de caracteres em um datatable que se ajustam aos requisitos de estrutura de conversão, para guid.

datatable(str: string)
[
    "0123456789abcdef0123456789abcdef",
    "0123456789ab-cdef-0123-456789abcdef",
    "a string that is not a guid"
]
| extend guid = toguid(str)

Saída

Conteúdo relacionado

• tipos de função escalares rapidamente
• o tipo de dados guid
• new_guid()
• base64_decode_toguid()
• tobool()