Delen via


toguid()

Van toepassing op: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel-

Converteert een tekenreeks naar een guid scalaire waarde.

Notitie

Gebruik indien mogelijk letterlijke guid-.

Syntaxis

toguid( waarde)

Meer informatie over syntaxisconventies.

Parameters

Naam Type Vereist Beschrijving
waarde scalar ✔️ De waarde die moet worden geconverteerd naar guid-.

Retourneert

Tijdens het conversieproces worden de eerste 32 tekens van de invoer gebruikt, waarbij de juiste afbreekstreepjes worden genegeerd, wordt gecontroleerd of de tekens tussen 0-9 of a-f liggen en wordt de tekenreeks vervolgens geconverteerd naar een guid scalaire waarde. De rest van de tekenreeks wordt genegeerd.

Als de conversie is geslaagd, is het resultaat een guid scalaire waarde. Anders wordt het resultaat null.

Voorbeeld

In het volgende voorbeeld worden tekenreeksen geconverteerd in een gegevenstabel die voldoen aan de vereisten voor de conversiestructuur, naar guid.

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

uitvoer

Str Guid
0123456789abcdef0123456789abcdef 01234567-89ab-cdef-0123-456789abcdef
0123456789ab-cdef-0123-456789abcdef 01234567-89ab-cdef-0123-456789abcdef
een tekenreeks die geen GUID is