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

# avgIf

> Exemplo de uso do combinador avgIf

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

O combinador [`If`](/pt-BR/reference/functions/aggregate-functions/combinators#-if) pode ser aplicado à função [`avg`](/pt-BR/reference/functions/aggregate-functions/avg)
para calcular a média aritmética dos valores das linhas em que a condição é verdadeira,
usando a função de agregação com combinador `avgIf`.

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

Neste exemplo, vamos criar uma tabela que armazena dados de vendas com indicadores de sucesso
e usar `avgIf` para calcular o valor médio das vendas em transações bem-sucedidas.

```sql title="Query" theme={null}
CREATE TABLE sales(
    transaction_id UInt32,
    amount Decimal(10,2),
    is_successful UInt8
) ENGINE = MergeTree
ORDER BY ();

INSERT INTO sales VALUES
    (1, 100.50, 1),
    (2, 200.75, 1),
    (3, 150.25, 0),
    (4, 300.00, 1),
    (5, 250.50, 0),
    (6, 175.25, 1);

SELECT
    avgIf(amount, is_successful = 1) AS avg_successful_sale
FROM sales;
```

A função `avgIf` calculará a média apenas das linhas em que `is_successful = 1`.
Nesse caso, ela calculará a média dos valores: 100.50, 200.75, 300.00 e 175.25.

```response title="Response" theme={null}
   ┌─avg_successful_sale─┐
1. │              193.88 │
   └─────────────────────┘
```

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

* [`avg`](/pt-BR/reference/functions/aggregate-functions/avg)
* [`If combinador`](/pt-BR/reference/functions/aggregate-functions/combinators#-if)