> ## 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.

> Aplica o teste Z para médias a amostras de duas populações.

# meanZTest

<div id="meanZTest">
  ## meanZTest
</div>

Introduzido em: v22.2.0

Aplica o teste Z para média a amostras de duas populações.

Os valores de ambas as amostras estão na coluna `sample_data`.
Se `sample_index` for igual a 0, o valor nessa linha pertence à amostra da primeira população.
Caso contrário, ele pertence à amostra da segunda população.
A hipótese nula é que as médias das populações são iguais.
Pressupõe-se uma distribuição normal.
As populações podem ter variâncias desiguais, e essas variâncias são conhecidas.

**Sintaxe**

```sql theme={null}
meanZTest(population_variance_x, population_variance_y, confidence_level)(sample_data, sample_index)
```

**Parâmetros**

* `population_variance_x` — Variância da população x. [`Float*`](/pt-BR/reference/data-types/float)
* `population_variance_y` — Variância da população y. [`Float*`](/pt-BR/reference/data-types/float)
* `confidence_level` — Nível de confiança para calcular os intervalos de confiança. [`Float*`](/pt-BR/reference/data-types/float)

**Argumentos**

* `sample_data` — Dados da amostra. [`(U)Int*`](/pt-BR/reference/data-types/int-uint) ou [`Float*`](/pt-BR/reference/data-types/float) ou [`Decimal`](/pt-BR/reference/data-types/decimal)
* `sample_index` — Índice da amostra. [`(U)Int*`](/pt-BR/reference/data-types/int-uint)

**Valor retornado**

Retorna uma tupla com quatro elementos: estatística z calculada, valor p calculado, limite inferior calculado do intervalo de confiança e limite superior calculado do intervalo de confiança. [`Tuple(Float64, Float64, Float64, Float64)`](/pt-BR/reference/data-types/tuple)

**Exemplos**

**Exemplo de teste Z para média**

```sql title=Query theme={null}
CREATE TABLE mean_ztest (sample_data Float64, sample_index UInt8) ENGINE = Memory;
INSERT INTO mean_ztest VALUES (20.3, 0), (21.9, 0), (22.1, 0), (18.9, 1), (19, 1), (20.3, 1);

SELECT meanZTest(0.7, 0.45, 0.95)(sample_data, sample_index) FROM mean_ztest;
```

```response title=Response theme={null}
┌─meanZTest(0.7, 0.45, 0.95)(sample_data, sample_index)───────────────────────────────┐
│ (3.2841296025548123, 0.0010229786769086013, 0.8198428246768334, 3.2468238419898365) │
└─────────────────────────────────────────────────────────────────────────────────────┘
```
