toguid()

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Konvertiert eine Zeichenfolge in einen guid Skalar.

Hinweis

Verwenden Sie nach Möglichkeit stattdessen GUID-Literale .

Syntax

toguid(value)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
value	Skalarwert	✔️	Der Wert, der in guid konvertiert werden soll.

Gibt zurück

Der Konvertierungsprozess verwendet die ersten 32 Zeichen der Eingabe, wobei die korrekten Bindestriche ignoriert werden, überprüft, ob die Zeichen zwischen 0-9 oder a-f liegen, und konvertiert dann die Zeichenfolge in einen guid Skalar. Der Rest der Zeichenfolge wird ignoriert.

Wenn die Konvertierung erfolgreich ist, ist das Ergebnis ein guid Skalar. Andernfalls lautet nulldas Ergebnis .

Beispiel

Abfrage ausführen

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
eine Zeichenfolge, die keine GUID ist