Simple Log Service:Clause GROUP BY

GROUP BY

Regroupe les résultats d'analyse selon une ou plusieurs colonnes spécifiées. Pour des exemples, reportez-vous à l'exemple 1, à l'exemple 2 et à l'exemple 3.

SELECT
  key1,
  ...,
  aggregate_function
GROUP BY
  key1, ...

Paramètres :

• key1 : la colonne selon laquelle regrouper les lignes. Vous pouvez regrouper les lignes par noms de champs de journal ou par colonnes de résultat calculées par des fonctions d'agrégation. La clause GROUP BY prend en charge une ou plusieurs colonnes.

• aggregate_function : la fonction d'agrégation appliquée à chaque groupe, telle que count, min, max, avg ou sum.

GROUP BY ALL

La clause GROUP BY ALL utilise automatiquement comme clés de regroupement les expressions de la liste SELECT qui ne contiennent ni fonction d'agrégation ni fonction de fenêtrage. Vous n'avez donc pas besoin de répéter ces expressions dans la clause GROUP BY. Cette forme est utile lorsque vous disposez de nombreux champs de regroupement ou lorsque vous ajustez fréquemment les dimensions d'analyse. Pour des exemples, reportez-vous à l'exemple 7, à l'exemple 8 et à l'exemple 9.

SELECT
  key1,
  key2,
  aggregate_function
GROUP BY ALL

Paramètres :

• key1 et key2 : champs ou expressions de regroupement, tels que status, request_method, substr(request_method, 1, 1) ou une expression CASE. Une expression est regroupée selon son résultat calculé complet. La clause GROUP BY ALL ne prend aucune liste de champs ; vous ne devez donc pas répéter un alias ou une expression après celle-ci.

• aggregate_function : la fonction d'agrégation appliquée à chaque groupe, telle que count(*), sum(request_time) ou avg(request_time).

Par exemple, les deux instructions de requête suivantes sont équivalentes :

* | SELECT request_method, status, count(*) AS PV GROUP BY ALL

* | SELECT request_method, status, count(*) AS PV GROUP BY request_method, status

Règles et limites :

• Le regroupement automatique repose sur la liste SELECT actuelle, et non sur tous les champs présents dans les journaux. L'ajout ou la suppression d'une expression non agrégée et sans fenêtrage modifie les dimensions de regroupement en conséquence.

• La sélection par caractère générique n'est pas prise en charge au même niveau de requête : vous ne pouvez pas combiner GROUP BY ALL avec SELECT *, SELECT table_alias.* ou SELECT *, count(*). Listez les champs explicitement. Cette limite s'applique à la sélection par caractère générique elle-même, et non aux fonctions d'agrégation ; ainsi, count(*) fonctionne comme d'habitude aux côtés des champs listés explicitement.

• Une expression entière contenant une fonction d'agrégation ou une fonction de fenêtrage n'est pas automatiquement ajoutée en tant que clé de regroupement. Par exemple, sum(request_time) / count(*) n'est pas utilisée pour le regroupement, et les champs contenus dans les appels de fonction d'agrégation ne deviennent pas des clés de regroupement. Tout champ non agrégé que vous sélectionnez aux côtés d'une telle expression doit toujours respecter les règles standard de regroupement de la clause GROUP BY. Dans l'instruction SELECT request_method, status, count(*) AS PV GROUP BY ALL, request_method et status sont tous deux des clés de regroupement.

• Si la liste SELECT ne contient que des expressions d'agrégation, toutes les données répondant aux conditions de la requête sont agrégées globalement. Par exemple, * | SELECT count(*) AS PV, sum(request_time) AS total_time GROUP BY ALL équivaut à omettre la clause GROUP BY ALL.

• Vous pouvez utiliser GROUP BY ALL avec les clauses WHERE, HAVING, ORDER BY et avec des fonctions de fenêtrage. Les fonctions de fenêtrage s'appliquent aux résultats groupés et agrégés, et les champs auxquels elles font référence doivent toujours respecter les règles de regroupement.

• Pour déduire automatiquement les clés de regroupement, utilisez GROUP BY ALL seul. Dans les expressions GROUP BY ALL status ou GROUP BY ALL ROLLUP (...), le mot-clé ALL modifie la spécification de regroupement qui le suit ; aucune clé de regroupement n'est donc déduite automatiquement.

• Pour effectuer un regroupement selon un champ ou un alias nommé all, placez le nom entre guillemets doubles, comme dans GROUP BY "all". Par défaut, une clause GROUP BY ALL isolée déduit automatiquement les clés de regroupement, même si un champ nommé all existe.

GROUP BY ROLLUP

La clause GROUP BY ROLLUP regroupe les données en récapitulatifs hiérarchiques. Elle renvoie un sous-total pour chaque groupe et un total général pour l'ensemble des groupes. Par exemple, GROUP BY ROLLUP (a, b) produit un ensemble de résultats pour les ensembles de regroupement (a, b), (a, null) et (null, null). Une valeur null dans un ensemble de regroupement signifie que la colonne est agrégée dans cet ensemble, de sorte que la ligne constitue un sous-total. Pour un exemple, reportez-vous à l'exemple 6.

SELECT
  key1,
  ...,
  aggregate_function
GROUP BY ROLLUP (key1, ...)

Paramètres

• key1 : la colonne selon laquelle regrouper les lignes. Vous pouvez regrouper les lignes par noms de champs de journal ou par colonnes de résultat d'une fonction d'agrégation. La clause GROUP BY prend en charge le regroupement selon une ou plusieurs colonnes.

• aggregate_function : les fonctions d'agrégation appliquées à chaque groupe, telles que count, min, max, avg ou sum.

GROUP BY CUBE

La clause GROUP BY CUBE regroupe les données selon toutes les combinaisons possibles des colonnes spécifiées. Par exemple, GROUP BY CUBE (a, b) produit un ensemble de résultats pour les ensembles de regroupement (a, b), (null, b), (a, null) et (null, null). Une valeur null dans un ensemble de regroupement signifie que la colonne est agrégée dans cet ensemble, de sorte que la ligne constitue un sous-total. Pour un exemple, reportez-vous à l'exemple 5.

SELECT
  key1,
  ...,
  aggregate_function
GROUP BY CUBE (key1, ...)

Paramètres

• key1 : la colonne selon laquelle regrouper les lignes. Vous pouvez regrouper les lignes par noms de champs de journal ou par colonnes de résultat d'une fonction d'agrégation. La clause GROUP BY prend en charge le regroupement selon une ou plusieurs colonnes.

• aggregate_function : les fonctions d'agrégation appliquées à chaque groupe, telles que count, min, max, avg ou sum.

GROUP BY GROUPING SETS

La clause GROUP BY GROUPING SETS vous permet de spécifier plusieurs regroupements distincts dans une seule requête. Par exemple, GROUP BY GROUPING SETS (a, b) équivaut à combiner les résultats de GROUP BY a et de GROUP BY b, et produit un ensemble de résultats pour les ensembles de regroupement (a, null) et (null, b). Une colonne qui ne fait pas partie d'un ensemble de regroupement prend la valeur null dans les lignes correspondant à cet ensemble. Pour un exemple, reportez-vous à l'exemple 4.

SELECT
  key1,
  ...,
  aggregate_function
GROUP BY GROUPING SETS (key1, ...)

Paramètres

• key1 : la colonne selon laquelle regrouper les lignes. Vous pouvez regrouper les lignes par noms de champs de journal ou par colonnes de résultat d'une fonction d'agrégation. La clause GROUP BY prend en charge le regroupement selon une ou plusieurs colonnes.

• aggregate_function : les fonctions d'agrégation appliquées à chaque groupe, telles que count, min, max, avg ou sum.