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éconseillés : any()

Remarque

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

Syntaxe

take_any( expr_1 [, expr_2 ...])

take_any(*)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	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 à partir de chaque groupe de l’opérateur de synthèse.

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 qui empêchent les colonnes group-by, le cas échéant.

Notes

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. L’ancien peut avoir chaque application sélectionner un enregistrement différent, tandis que ce dernier 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

Affichez 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

Affichez 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