reduce operator

Applies to: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Regroupe un ensemble de chaînes en fonction de la similarité des valeurs.

Pour chaque groupe de ce type, l’opérateur retourne un pattern, countet representative. Le pattern meilleur décrit le groupe dans lequel le * caractère représente un caractère générique. Il count s’agit du nombre de valeurs dans le groupe, et il representative s’agit de l’une des valeurs d’origine du groupe.

Syntax

T|reduce [kind=ReduceKind] byExpr [with [threshold=Threshold] [,characters=Characters]]

Learn more about syntax conventions.

Parameters

Returns

Table avec autant de lignes qu’il existe des groupes et des colonnes intitulés pattern, countet representative. Le pattern meilleur décrit le groupe dans lequel le * caractère représente un caractère générique ou un espace réservé pour une chaîne d’insertion arbitraire. Il count s’agit du nombre de valeurs dans le groupe, et il representative s’agit de l’une des valeurs d’origine du groupe.

Par exemple, le résultat de reduce by city peut inclure :

Examples

L’exemple de cette section montre comment utiliser la syntaxe pour vous aider à commencer.

L’exemple suivant génère une plage de nombres, crée une colonne avec des chaînes concaténées et des entiers aléatoires, puis regroupe les lignes par la nouvelle colonne avec des paramètres de réduction spécifiques. Le seuil est défini sur 0,001, ce qui signifie que les valeurs d’opérateur sont très similaires les unes aux autres.

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

L’exemple suivant génère une plage de nombres, crée une colonne avec des chaînes concaténées et des entiers aléatoires, puis regroupe les lignes par la nouvelle colonne avec des paramètres de réduction spécifiques. Le seuil est défini sur 0,9, ce qui signifie que l’opérateur regroupe les valeurs moins strictement et autorise davantage de variance.

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

Le résultat inclut uniquement les groupes où la valeur MyText apparaît dans au moins 90% des lignes.

If the Characters parameter is unspecified, by default the operator treats all non-alphanumeric characters (including spaces and punctuation) as term separators. The following example shows how the reduce operator behaves when the Characters parameter isn't specified.

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

Output

Toutefois, si vous spécifiez que « Z » est un séparateur, il est comme si chaque valeur dans str est deux termes : foo et tostring(x):

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

Output

L’exemple suivant montre comment appliquer l’opérateur reduce à une entrée « nettoyée », dans laquelle les GUID de la colonne en cours de réduction sont remplacés avant de réduire :

Commencez par quelques enregistrements de la table Trace. Réduisez ensuite la colonne Texte qui inclut des GUID aléatoires. Comme les GUID aléatoires interfèrent avec l’opération de réduction, remplacez-les tous par la chaîne « GUID ». Effectuez maintenant l’opération de réduction. Dans le cas où il existe d’autres identificateurs « quasi aléatoires » avec des caractères incorporés « - » ou « _ », traitez les caractères comme des analyseurs non-termes.

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="-_"

Related content

• autocluster