Dela via


toguid()

Gäller för: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Konverterar en sträng till en guid skalär.

Not

Använd om möjligt guid-literaler i stället.

Syntax

toguid( värde)

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Krävs Beskrivning
värde skalär ✔️ Värdet som ska konverteras till guid.

Returnerar

Konverteringsprocessen tar de första 32 tecknen i indata, ignorerar korrekt placerade bindestreck, verifierar att tecknen är mellan 0-9 eller a-f och konverterar sedan strängen till en guid skalär. Resten av strängen ignoreras.

Om konverteringen lyckas blir resultatet en guid skalär. Annars blir resultatet null.

Exempel

I följande exempel konverteras strängar i en datatabell som passar kraven för konverteringsstrukturen till guid.

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

utdata

Str GUID
0123456789abcdef0123456789abcdef 01234567-89ab-cdef-0123-456789abcdef
0123456789ab-cdef-0123-456789abcdef 01234567-89ab-cdef-0123-456789abcdef
en sträng som inte är ett guid