take_any() (fonction d’agrégation)

Choisit arbitrairement un enregistrement pour chaque groupe dans un opérateur de synthèse et retourne la valeur d’une ou plusieurs expressions sur chaque enregistrement de ce type.

Alias dépréciés : any()

Notes

La version dépréciée ajoute any_ un préfixe aux colonnes retournées par l’agrégation any() .

Syntax

take_any(expr_1 [,expr_2 ...])

take_any(*)

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
expr_N	string	✔️	Expression utilisée pour sélectionner un enregistrement. Si la valeur générique (*) est donnée à la place d’une expression, tous les enregistrements sont sélectionnés.

Retours

La take_any fonction d’agrégation retourne les valeurs des expressions calculées pour chacun des enregistrements sélectionnés de façon indéterminée dans chaque groupe de l’opérateur summarize.

Si l’argument * est fourni, la fonction se comporte comme si les expressions sont toutes les colonnes de l’entrée de l’opérateur de synthèse, à l’exception des colonnes group-by, le cas échéant.

Remarques

Cette fonction est utile lorsque vous souhaitez obtenir un exemple de valeur d’une ou plusieurs colonnes par valeur de la clé de groupe composé.

Lorsque la fonction est fournie avec une référence de colonne unique, elle tente de retourner une valeur non null/non vide, si cette valeur est présente.

En raison de la nature indéterministe de cette fonction, l’utilisation de cette fonction plusieurs fois dans une seule application de l’opérateur summarize n’équivaut pas à utiliser cette fonction une seule fois avec plusieurs expressions. La première peut faire sélectionner chaque application un enregistrement différent, tandis que la seconde garantit que toutes les valeurs sont calculées sur un seul enregistrement (par groupe distinct).

Exemples

Afficher l’état indéterministe :

Exécuter la requête

StormEvents
| summarize take_any(State)

Sortie

State
ATLANTIQUE SUD

Afficher tous les détails d’un enregistrement aléatoire :

Exécuter la requête

StormEvents
| project StartTime, EpisodeId, State, EventType
| summarize take_any(*)

Sortie

StartTime	EpisodeId	État	Type d’événement
2007-09-29 08:11:00.0000000	11091	ATLANTIQUE SUD	Trombe marine

Afficher tous les détails d’un enregistrement aléatoire pour chaque état commençant par « A » :

Exécuter la requête

StormEvents
| where State startswith "A"
| project StartTime, EpisodeId, State, EventType
| summarize take_any(*) by State

Sortie

State	StartTime	EpisodeId	Type d’événement
ALASKA	2007-02-01 00:00:00.0000000	1733	Crue
ATLANTIQUE SUD	2007-09-29 08:11:00.0000000	11091	Trombe marine
ATLANTIQUE NORD	2007-11-27 00:00:00.0000000	11523	Vent d’orage marin
ARIZONA	2007-12-01 10:40:00.0000000	11955	Crue soudaine
SAMOA AMÉRICAINES	2007-12-07 14:00:00.0000000	13183	Crue soudaine
ARKANSAS	2007-12-09 16:00:00.0000000	11319	Lightning
ALABAMA	2007-12-15 18:00:00.0000000	12580	Fortes précipitations