Simple Log Service:Cláusula GROUP BY

GROUP BY

Agrupa os resultados da análise por uma ou mais colunas especificadas. Para ver exemplos, consulte os Exemplos 1, 2 e 3.

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

Parâmetros:

• key1: A coluna usada para agrupar as linhas. Você pode agrupar as linhas por nomes de campos de log ou por colunas de resultado calculadas por funções de agregação. A cláusula GROUP BY aceita uma ou mais colunas.

• aggregate_function: A função de agregação aplicada a cada grupo, como count, min, max, avg ou sum.

GROUP BY ALL

O GROUP BY ALL usa automaticamente como chaves de agrupamento as expressões da lista SELECT que não contêm funções de agregação nem de janela. Assim, você não precisa repetir essas expressões na cláusula GROUP BY. Essa forma é útil quando há muitos campos de agrupamento ou quando você ajusta as dimensões de análise com frequência. Para ver exemplos, consulte os Exemplos 7, 8 e 9.

SELECT
  key1,
  key2,
  aggregate_function
GROUP BY ALL

Parâmetros:

• key1 e key2: Campos ou expressões de agrupamento, como status, request_method, substr(request_method, 1, 1) ou uma expressão CASE. A expressão é agrupada pelo resultado calculado completo. O GROUP BY ALL não aceita uma lista de campos; portanto, não repita um alias ou uma expressão após ele.

• aggregate_function: A função de agregação aplicada a cada grupo, como count(*), sum(request_time) ou avg(request_time).

Por exemplo, as duas instruções de consulta a seguir são equivalentes:

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

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

Regras e limites:

• O agrupamento automático baseia-se na lista SELECT atual, e não em todos os campos dos logs. Adicione ou exclua uma expressão que não seja de agregação nem de janela; isso altera as dimensões de agrupamento de forma correspondente.

• Não há suporte para seleção com curinga no mesmo nível de consulta: você não pode combinar GROUP BY ALL com SELECT *, SELECT table_alias.* ou SELECT *, count(*). Liste os campos explicitamente. Essa limitação aplica-se à seleção com curinga em si, e não às funções de agregação. Portanto, count(*) funciona normalmente ao lado de campos listados explicitamente.

• Uma expressão completa que contenha uma função de agregação ou de janela não é adicionada automaticamente como chave de agrupamento. Por exemplo, sum(request_time) / count(*) não é usada para agrupamento, e os campos dentro das chamadas de agregação não se tornam chaves de agrupamento. Qualquer campo não agregado que você selecione junto com essa expressão ainda deve obedecer às regras padrão de agrupamento do GROUP BY. Em SELECT request_method, status, count(*) AS PV GROUP BY ALL, tanto request_method quanto status são chaves de agrupamento.

• Se a lista SELECT contiver apenas expressões de agregação, todos os dados que atendem às condições da consulta são agregados globalmente. Por exemplo, * | SELECT count(*) AS PV, sum(request_time) AS total_time GROUP BY ALL equivale a omitir o GROUP BY ALL.

• Você pode usar GROUP BY ALL com WHERE, HAVING, ORDER BY e funções de janela. As funções de janela operam nos resultados agrupados e agregados, e os campos referenciados por elas ainda devem obedecer às regras de agrupamento.

• Para derivar chaves de agrupamento automaticamente, use GROUP BY ALL isoladamente. Em GROUP BY ALL status ou GROUP BY ALL ROLLUP (...), o ALL modifica a especificação de agrupamento que o segue, portanto, nenhuma chave de agrupamento é derivada automaticamente.

• Para agrupar por um campo ou alias chamado all, coloque o nome entre aspas duplas, como em GROUP BY "all". Por padrão, um GROUP BY ALL isolado deriva as chaves de agrupamento automaticamente, mesmo que exista um campo chamado all.

GROUP BY ROLLUP

A cláusula GROUP BY ROLLUP agrupa dados em resumos hierárquicos. Ela retorna um subtotal para cada grupo e um total geral para todos os grupos. Por exemplo, GROUP BY ROLLUP (a, b) produz um conjunto de resultados para os conjuntos de agrupamento (a, b), (a, null) e (null, null). Um valor null em um conjunto de agrupamento significa que a coluna é agregada nesse conjunto, portanto, a linha é um subtotal. Para ver um exemplo, consulte o Exemplo 6.

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

Parâmetros

• key1: A coluna que você defina para agrupar as linhas. Você pode agrupar por nomes de campos de log ou pelas colunas de resultado de uma função de agregação. A cláusula GROUP BY aceita agrupamento por uma ou várias colunas.

• aggregate_function: As Funções de agregação aplicadas a cada grupo, como count, min, max, avg ou sum.

GROUP BY CUBE

A cláusula GROUP BY CUBE agrupa dados por todas as combinações possíveis das colunas especificadas. Por exemplo, GROUP BY CUBE (a, b) produz um conjunto de resultados para os conjuntos de agrupamento (a, b), (null, b), (a, null) e (null, null). Um valor null em um conjunto de agrupamento significa que a coluna é agregada nesse conjunto, portanto, a linha é um subtotal. Para ver um exemplo, consulte o Exemplo 5.

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

Parâmetros

• key1: A coluna usada para agrupar as linhas. Você pode agrupar por nomes de campos de log ou pelas colunas de resultado de uma função de agregação. A cláusula GROUP BY aceita agrupamento por uma ou várias colunas.

• aggregate_function: As Funções de agregação aplicadas a cada grupo, como count, min, max, avg ou sum.

GROUP BY GROUPING SETS

A cláusula GROUP BY GROUPING SETS permite que você especifique vários agrupamentos distintos em uma única consulta. Por exemplo, GROUP BY GROUPING SETS (a, b) equivale a combinar os resultados de GROUP BY a e GROUP BY b, e produz um conjunto de resultados para os conjuntos de agrupamento (a, null) e (null, b). Uma coluna que não faz parte de um conjunto de agrupamento é nula nas linhas desse conjunto. Para ver um exemplo, consulte o Exemplo 4.

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

Parâmetros

• key1: A coluna usada para agrupar as linhas. Você pode agrupar por nomes de campos de log ou pelas colunas de resultado de uma função de agregação. A cláusula GROUP BY aceita agrupamento por uma ou várias colunas.

• aggregate_function: As Funções de agregação aplicadas a cada grupo, como count, min, max, avg ou sum.