GROUP BY cláusula

Aplica-se a: Sim marcado Databricks SQL Databricks Runtime

A GROUP BY cláusula é usada para agrupar as linhas com base em um conjunto de expressões de agrupamento especificadas e computar agregações no grupo de linhas com base em uma ou mais funções agregadas especificadas. O Databricks SQL também suporta funcionalidades avançadas de agregação para realizar múltiplas operações de agregação no mesmo conjunto de registros de entrada por meio das cláusulas GROUPING SETS, CUBE, ROLLUP. As expressões de agrupamento e agregações avançadas podem ser misturadas na GROUP BY cláusula e aninhadas numa GROUPING SETS cláusula.

Veja mais detalhes na seção de Análises de Agrupamento Misto/Aninhado.

Quando uma FILTER cláusula é anexada a uma função agregada, apenas as linhas correspondentes são passadas para essa função.

Sintaxe

GROUP BY ALL

GROUP BY group_expression [, ...] [ WITH ROLLUP | WITH CUBE ]

GROUP BY { group_expression | { ROLLUP | CUBE | GROUPING SETS } ( grouping_set [, ...] ) } [, ...]

grouping_set
   { expression |
     ( [ expression [, ...] ] ) }

Enquanto as funções agregadas são definidas como

aggregate_name ( [ DISTINCT ] expression [, ...] ) [ FILTER ( WHERE boolean_expression ) ]

Parâmetros

TODOS

Aplica-se a: Databricks SQL Databricks Runtime 12.2 LTS e acima

Uma notação abreviada para adicionar todas as expressões de lista SELECT que não contêm funções agregadas como group_expression. Se tal expressão não existir GROUP BY ALL , equivale a omitir a GROUP BY cláusula que resulta numa agregação global.

GROUP BY ALL não é garantido que produza um conjunto de expressões de grupo que possam ser resolvidas. O Azure Databricks gera UNRESOLVED_ALL_IN_GROUP_BY ou MISSING_AGGREGATION se a cláusula produzida não estiver bem formada.
group_expression

Especifica os critérios para agrupar linhas. O agrupamento de linhas é realizado com base nos valores de resultado das expressões de agrupamento. Uma expressão de agrupamento pode ser um nome de coluna como GROUP BY a, posição da coluna como GROUP BY 0, ou uma expressão como GROUP BY a + b. Se group_expression contiver uma função agregada, o Azure Databricks gerará um erro GROUP_BY_AGGREGATE .
grouping_set

Um conjunto de agrupamento é especificado por zero ou mais expressões separadas por vírgulas entre parênteses. Quando o conjunto de agrupamento tem apenas um elemento, os parênteses podem ser omitidos. Por exemplo, GROUPING SETS ((a), (b)) é o mesmo que GROUPING SETS (a, b).
CONJUNTOS DE AGRUPAMENTO

Agrupa as linhas para cada conjunto de agrupamentos especificado após GROUPING SETS. Por exemplo:

GROUP BY GROUPING SETS ((warehouse), (product)) é semanticamente equivalente a uma união de resultados de GROUP BY warehouse e GROUP BY product.

Esta cláusula é uma abreviatura de um UNION ALL, onde cada perna do operador UNION ALL executa a agregação de cada conjunto de agrupamento especificado na cláusula GROUPING SETS.

Da mesma forma, GROUP BY GROUPING SETS ((warehouse, product), (product), ()) é semanticamente equivalente à união de resultados de GROUP BY warehouse, product, GROUP BY product e um agregado global.

Nota

Para compatibilidade com o Hive, o Databricks SQL permite GROUP BY ... GROUPING SETS (...): . As GROUP BY expressões geralmente são ignoradas, mas se contiverem expressões extras além das GROUPING SETS expressões, as expressões extras serão incluídas nas expressões de agrupamento e o valor será sempre nulo. Por exemplo, em SELECT a, b, c FROM ... GROUP BY a, b, c GROUPING SETS (a, b), a saída da coluna c é sempre nula.

ROLLUP

Especifica vários níveis de agregações em uma única instrução. Esta cláusula é usada para calcular agregações com base em vários conjuntos de agrupamento. ROLLUP é uma abreviatura de GROUPING SETS. Por exemplo:

GROUP BY warehouse, product WITH ROLLUP

GROUP BY ROLLUP(warehouse, product)

é equivalente a

GROUP BY GROUPING SETS((warehouse, product),
                       (warehouse),
                       ())

Enquanto

GROUP BY ROLLUP(warehouse, product, location))

é equivalente a

GROUP BY GROUPING SETS((warehouse, product, location),
                       (warehouse, product),
                       (warehouse),
                       ())

Os elementos N de uma ROLLUP especificação resultam em N+1 GROUPING SETS.

CUBO

A CUBE cláusula é usada para executar agregações com base em uma combinação de colunas de agrupamento especificadas na GROUP BY cláusula. CUBE é uma abreviatura de GROUPING SETS. Por exemplo:

GROUP BY warehouse, product WITH CUBE

GROUP BY CUBE(warehouse, product)

é equivalente a:

GROUP BY GROUPING SETS((warehouse, product),
                       (warehouse),
                       (product),
                       ())

Enquanto

GROUP BY CUBE(warehouse, product, location)

é equivalente ao seguinte:

GROUP BY GROUPING SETS((warehouse, product, location),
                       (warehouse, product),
                       (warehouse, location),
                       (product, location),
                       (warehouse),
                       (product),
                       (location),
                       ())

Os elementos N de uma CUBE especificação resultam em 2^N GROUPING SETS.

aggregate_name

Um nome de função agregado (MIN, MAX, COUNT, SUM, AVG, etc.).
DISTINTO

Remove duplicatas em linhas de entrada antes que elas sejam passadas para funções agregadas.
FILTRAR

Filtra as linhas de entrada para as quais a boolean_expression na cláusula WHERE se avalia como verdadeira, sendo passadas para a função agregada; outras linhas são descartadas.

Análise de agrupamento misto/aninhado

Uma cláusula GROUP BY pode incluir vários group_expressions e vários CUBE, ROLLUPe GROUPING SETS.

GROUPING SETS também pode ter cláusulas aninhadas CUBE, ROLLUP ou GROUPING SETS. Por exemplo:

GROUPING SETS(ROLLUP(warehouse, location),
              CUBE(warehouse, location)),
GROUPING SETS(warehouse,
              GROUPING SETS(location,
                            GROUPING SETS(ROLLUP(warehouse, location),
                                          CUBE(warehouse, location))))

CUBE e ROLLUP é apenas açúcar de sintaxe para GROUPING SETS.

Consulte as seções acima para saber como traduzir CUBE e ROLLUP para GROUPING SETS.

group_expression podem ser tratados como um grupo GROUPING SETS único neste contexto.

Para múltiplos GROUPING SETS na cláusula GROUP BY, o Databricks SQL gera um único GROUPING SETS ao realizar um produto cruzado dos GROUPING SETS originais.

Para GROUPING SETS aninhado na cláusula GROUPING SETS, o Databricks SQL pega seus conjuntos de agrupamento e os remove. Por exemplo, as seguintes consultas:

GROUP BY warehouse,
         GROUPING SETS((product), ()),
         GROUPING SETS((location, size),
         (location),
         (size),
         ());

GROUP BY warehouse,
         ROLLUP(product),
         CUBE(location, size);

são equivalentes ao seguinte:

GROUP BY GROUPING SETS( (warehouse, product, location, size),
                        (warehouse, product, location),
                        (warehouse, product, size),
                        (warehouse, product),
                        (warehouse, location, size),
                        (warehouse, location),
                        (warehouse, size),
                        (warehouse))

Enquanto

GROUP BY GROUPING SETS(GROUPING SETS(warehouse),
                       GROUPING SETS((warehouse, product)))`

é equivalente a

GROUP BY GROUPING SETS((warehouse),
                       (warehouse, product))`.

Exemplos

CREATE TEMP VIEW dealer (id, city, car_model, quantity) AS
VALUES (100, 'Fremont', 'Honda Civic', 10),
       (100, 'Fremont', 'Honda Accord', 15),
       (100, 'Fremont', 'Honda CRV', 7),
       (200, 'Dublin', 'Honda Civic', 20),
       (200, 'Dublin', 'Honda Accord', 10),
       (200, 'Dublin', 'Honda CRV', 3),
       (300, 'San Jose', 'Honda Civic', 5),
       (300, 'San Jose', 'Honda Accord', 8);

-- Sum of quantity per dealership. Group by `id`.
> SELECT id, sum(quantity) FROM dealer GROUP BY id ORDER BY id;
  id sum(quantity)
 --- -------------
 100            32
 200            33
 300            13

-- Use column position in GROUP by clause.
> SELECT id, sum(quantity) FROM dealer GROUP BY 1 ORDER BY 1;
  id sum(quantity)
 --- -------------
 100            32
 200            33
 300            13

-- Multiple aggregations.
-- 1. Sum of quantity per dealership.
-- 2. Max quantity per dealership.
> SELECT id, sum(quantity) AS sum, max(quantity) AS max
    FROM dealer GROUP BY id ORDER BY id;
  id sum max
 --- --- ---
 100  32  15
 200  33  20
 300  13   8

-- Count the number of distinct dealers in cities per car_model.
> SELECT car_model, count(DISTINCT city) AS count FROM dealer GROUP BY car_model;
    car_model count
 ------------ -----
  Honda Civic     3
    Honda CRV     2
 Honda Accord     3

-- Count the number of distinct dealers in cities per car_model, using GROUP BY ALL
> SELECT car_model, count(DISTINCT city) AS count FROM dealer GROUP BY ALL;
    car_model count
 ------------ -----
  Honda Civic     3
    Honda CRV     2
 Honda Accord     3

-- Sum of only 'Honda Civic' and 'Honda CRV' quantities per dealership.
> SELECT id,
         sum(quantity) FILTER (WHERE car_model IN ('Honda Civic', 'Honda CRV')) AS `sum(quantity)`
    FROM dealer
    GROUP BY id ORDER BY id;
  id sum(quantity)
 --- -------------
 100            17
 200            23
 300             5

-- Aggregations using multiple sets of grouping columns in a single statement.
-- Following performs aggregations based on four sets of grouping columns.
-- 1. city, car_model
-- 2. city
-- 3. car_model
-- 4. Empty grouping set. Returns quantities for all city and car models.
> SELECT city, car_model, sum(quantity) AS sum
    FROM dealer
    GROUP BY GROUPING SETS ((city, car_model), (city), (car_model), ())
    ORDER BY city;
      city    car_model sum
 --------- ------------ ---
      null         null  78
      null  HondaAccord  33
      null     HondaCRV  10
      null   HondaCivic  35
    Dublin         null  33
    Dublin  HondaAccord  10
    Dublin     HondaCRV   3
    Dublin   HondaCivic  20
   Fremont         null  32
   Fremont  HondaAccord  15
   Fremont     HondaCRV   7
   Fremont   HondaCivic  10
  San Jose         null  13
  San Jose  HondaAccord   8
  San Jose   HondaCivic   5

-- Group by processing with `ROLLUP` clause.
-- Equivalent GROUP BY GROUPING SETS ((city, car_model), (city), ())
> SELECT city, car_model, sum(quantity) AS sum
    FROM dealer
    GROUP BY city, car_model WITH ROLLUP
    ORDER BY city, car_model;
      city    car_model sum
 --------- ------------ ---
      null         null  78
    Dublin         null  33
    Dublin  HondaAccord  10
    Dublin     HondaCRV   3
    Dublin   HondaCivic  20
   Fremont         null  32
   Fremont  HondaAccord  15
   Fremont     HondaCRV   7
   Fremont   HondaCivic  10
  San Jose         null  13
  San Jose  HondaAccord   8
  San Jose   HondaCivic   5

-- Group by processing with `CUBE` clause.
-- Equivalent GROUP BY GROUPING SETS ((city, car_model), (city), (car_model), ())
> SELECT city, car_model, sum(quantity) AS sum
    FROM dealer
    GROUP BY city, car_model WITH CUBE
    ORDER BY city, car_model;
      city    car_model sum
 --------- ------------ ---
      null         null  78
      null  HondaAccord  33
      null     HondaCRV  10
      null   HondaCivic  35
    Dublin         null  33
    Dublin  HondaAccord  10
    Dublin     HondaCRV   3
    Dublin   HondaCivic  20
   Fremont         null  32
   Fremont  HondaAccord  15
   Fremont     HondaCRV   7
   Fremont   HondaCivic  10
  San Jose         null  13
  San Jose  HondaAccord   8
  San Jose   HondaCivic   5

--Prepare data for ignore nulls example
> CREATE TEMP VIEW person (id, name, age) AS
   VALUES (100, 'Mary', NULL),
          (200, 'John', 30),
          (300, 'Mike', 80),
          (400, 'Dan' , 50);

--Select the first row in column age
> SELECT FIRST(age) FROM person;
  first(age, false)
 --------------------
  NULL

--Get the first row in column `age` ignore nulls,last row in column `id` and sum of column `id`.
> SELECT FIRST(age IGNORE NULLS), LAST(id), SUM(id) FROM person;
  first(age, true)    last(id, false)    sum(id)
 ------------------- ------------------ ----------
  30                  400                1000

Comentários

Esta página foi útil?

Last updated on 2025-07-21

Partilhar via

GROUP BY cláusula

Sintaxe

Parâmetros

Análise de agrupamento misto/aninhado

Exemplos

Artigos relacionados

Comentários

Recursos adicionais