toguid()

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Konwertuje ciąg na skalarny guid .

Uwaga

Jeśli to możliwe, użyj literałów guid.

Składnia

toguid(wartość)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko	Type	Wymagania	Popis
wartość	skalar	✔️	Wartość, która ma być konwertowana na identyfikator GUID.

Zwraca

Proces konwersji przyjmuje pierwsze 32 znaki danych wejściowych, ignorując prawidłowo zlokalizowane łączniki, sprawdza, czy znaki znajdują się w zakresie od 0 do 9 lub a-f, a następnie konwertuje ciąg na skalarny guid . Pozostała część ciągu jest ignorowana.

Jeśli konwersja zakończy się pomyślnie, wynik będzie skalarny guid . W przeciwnym razie wynik będzie mieć wartość null.

Przykład

Uruchamianie zapytania

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

Wyjście

Str	Identyfikator GUID
0123456789abcdef0123456789abcdef	01234567-89ab-cdef-0123-456789abcdef
0123456789ab-cdef-0123-456789abcdef	01234567-89ab-cdef-0123-456789abcdef
ciąg, który nie jest identyfikatorem GUID