reducera-operator

Växla tjänster genom att använda listrutan Version. Läs mer om navigering.
Gäller för: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Grupperar en uppsättning strängar tillsammans baserat på värdelikhet.

För varje sådan grupp returnerar operatorn en pattern, countoch representative. pattern beskriver bäst gruppen, där *-tecknet representerar ett jokertecken. count är antalet värden i gruppen och representative är ett av de ursprungliga värdena i gruppen.

Syntax

T|reduce [kind=ReduceKind] byUttr [with [threshold=Tröskelvärde] [,characters=Tecken]]

Läs mer om syntaxkonventioner.

Parameters

Returns

En tabell med så många rader som det finns grupper och kolumner med titeln pattern, countoch representative. pattern beskriver bäst gruppen, där *-tecknet representerar ett jokertecken eller platshållare för en godtycklig insättningssträng. count är antalet värden i gruppen och representative är ett av de ursprungliga värdena i gruppen.

Resultatet av reduce by city kan till exempel innehålla:

Examples

Exemplet i det här avsnittet visar hur du använder syntaxen för att komma igång.

Följande exempel genererar ett intervall med tal, skapar en ny kolumn med sammanfogade strängar och slumpmässiga heltal och grupperar sedan raderna efter den nya kolumnen med specifika minskningsparametrar. Tröskelvärdet är inställt på 0,001, vilket innebär att operatorn grupperar värden som är mycket lika varandra.

range x from 1 to 1000 step 1
| project MyText = strcat("MachineLearningX", tostring(toint(rand(10))))
| reduce by MyText  with threshold=0.001 , characters = "X" 

Output

Följande exempel genererar ett intervall med tal, skapar en ny kolumn med sammanfogade strängar och slumpmässiga heltal och grupperar sedan raderna efter den nya kolumnen med specifika minskningsparametrar. Tröskelvärdet är inställt på 0,9, vilket innebär att operatorn grupperar värden mindre strikt och tillåter mer varians.

range x from 1 to 1000 step 1
| project MyText = strcat("MachineLearningX", tostring(toint(rand(10))))
| reduce by MyText  with threshold=0.9 , characters = "X" 

Output

Resultatet innehåller endast de grupper där värdet MyText visas i minst 90% av raderna.

Om parametern Tecken är ospecificerad behandlar operatorn som standard alla icke-alfanumeriska tecken (inklusive blanksteg och skiljetecken) som termavgränsare. I följande exempel visas hur operatorn reduce beter sig när parametern Tecken inte har angetts.

range x from 1 to 10 step 1 | project str = strcat("foo", "Z", tostring(x)) | reduce by str

Output

Men om du anger att "Z" är en avgränsare är det som om varje värde i str är två termer: foo och tostring(x):

range x from 1 to 10 step 1 | project str = strcat("foo", "Z", tostring(x)) | reduce by str with characters="Z"

Output

I följande exempel visas hur man kan tillämpa reduce-operatorn på en "sanerad" indata, där GUID:er i kolumnen som minskas ersätts innan de minskar:

Börja med några poster från tabellen Trace. Minska sedan kolumnen Text som innehåller slumpmässiga GUID:er. Eftersom slumpmässiga GUID:er stör reduce-åtgärden ersätter du dem alla med strängen "GUID". Utför nu reduce-åtgärden. Om det finns andra "kvasi-slumpmässiga" identifierare med inbäddade '-' eller '_' tecken i dem, behandlar du tecken som icke-termbrytare.

Trace
| take 10000
| extend Text = replace(@"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}", "GUID", Text)
| reduce by Text with characters="-_"

Relaterat innehåll

• autocluster