Partilhar via

Toguid()

  • Artigo

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

Conteúdo relacionado