> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# sumArray

> Exemplo de uso do combinador sumArray

<div id="description">
  ## Descrição
</div>

O combinador [`Array`](/pt-BR/reference/functions/aggregate-functions/combinators#-array)
pode ser aplicado à função [`sum`](/pt-BR/reference/functions/aggregate-functions/sum)
para calcular a soma de todos os elementos de um array, usando a função de
agregação com combinador `sumArray`.

A função `sumArray` é útil quando você precisa calcular a soma total de
todos os elementos em vários arrays de um conjunto de dados.

<div id="example-usage">
  ## Exemplo de uso
</div>

Neste exemplo, usaremos um conjunto de dados de exemplo com vendas diárias em
diferentes categorias de produtos para demonstrar como `sumArray` funciona. Vamos calcular o total
de vendas de todas as categorias em cada dia.

```sql title="Query" theme={null}
CREATE TABLE daily_category_sales
(
    date Date,
    category_sales Array(UInt32)
) ENGINE = Memory;

INSERT INTO daily_category_sales VALUES
    ('2024-01-01', [100, 200, 150]),
    ('2024-01-02', [120, 180, 160]),
    ('2024-01-03', [90, 220, 140]);

SELECT 
    date,
    category_sales,
    sumArray(category_sales) AS total_sales_sumArray,
    sum(arraySum(category_sales)) AS total_sales_arraySum
FROM daily_category_sales
GROUP BY date, category_sales;
```

A função `sumArray` somará todos os elementos em cada Array `category_sales`.
Por exemplo, em `2024-01-01`, ela soma `100 + 200 + 150 = 450`. Isso gera o
mesmo resultado que `arraySum`.

<div id="see-also">
  ## Veja também
</div>

* [`sum`](/pt-BR/reference/functions/aggregate-functions/sum)
* [`arraySum`](/pt-BR/reference/functions/regular-functions/array-functions#arraySum)
* [`Array combinador`](/pt-BR/reference/functions/aggregate-functions/combinators#-array)
* [`sumMap`](/pt-BR/guides/clickhouse/examples/aggregate-function-combinators/sumMap)