toguid()
Gilt für: ✅Microsoft Fabric✅✅
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 wird das Ergebnis null.
Beispiel
Im folgenden Beispiel werden Zeichenfolgen in eine Datentabelle konvertiert, die den Anforderungen der Konvertierungsstruktur entspricht, in 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 |
| eine Zeichenfolge, die keine GUID ist |