percentile(), percentiles() (função de agregação)

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

A percentile() função calcula uma estimativa para o percentil especificado de classificação mais próxima da população definida por expr. A precisão depende da densidade da população na região do percentil.

percentiles() funciona de forma semelhante a percentile(). No entanto, percentiles() pode calcular vários valores de percentil de uma só vez, o que é mais eficiente do que calcular cada valor de percentil separadamente.

Para calcular percentis ponderados, consulte percentilesw().

Sintaxe

percentile(percentil expr, )

percentiles(percentis expr, )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Devoluções

Retorna uma tabela com as estimativas para expr dos percentis especificados no grupo, cada um em uma coluna separada.

Exemplos

Calcular percentil único

O exemplo a seguir mostra o valor de DamageProperty ser maior que 95% do conjunto de amostras e menor que 5% do conjunto de amostras.

StormEvents | summarize percentile(DamageProperty, 95) by State

Saída

A tabela de resultados mostrada inclui apenas as primeiras 10 linhas.

Calcular vários percentis

O exemplo a seguir mostra o valor de DamageProperty calculado simultaneamente usando 5, 50 (mediana) e 95.

StormEvents | summarize percentiles(DamageProperty, 5, 50, 95) by State

Saída

A tabela de resultados mostrada inclui apenas as primeiras 10 linhas.

Retornar percentis como uma matriz

Em vez de retornar os valores em colunas individuais, use a percentiles_array() função para retornar os percentis em uma única coluna do tipo matriz dinâmica.

Sintaxe

percentiles_array(percentis expr, )

Parâmetros

Devoluções

Retorna uma estimativa para expr dos percentis especificados no grupo como uma única coluna do tipo de matriz dinâmica.

Exemplos

Percentis separados por vírgula

Vários percentis podem ser obtidos como uma matriz em uma única coluna dinâmica, em vez de em várias colunas como com percentiles().

TransformedSensorsData
| summarize percentiles_array(Value, 5, 25, 50, 75, 95), avg(Value) by SensorName

Saída

A tabela de resultados exibe apenas as primeiras 10 linhas.

Matriz dinâmica de percentis

Os percentis para percentiles_array podem ser especificados em uma matriz dinâmica de números inteiros ou de ponto flutuante. A matriz deve ser constante, mas não precisa ser literal.

TransformedSensorsData
| summarize percentiles_array(Value, dynamic([5, 25, 50, 75, 95])), avg(Value) by SensorName

Saída

A tabela de resultados exibe apenas as primeiras 10 linhas.

Percentil de classificação mais próxima

O P-ésimo percentil (0 <P<= 100) de uma lista de valores ordenados, classificados em ordem crescente, é o menor valor da lista. O percentual P dos dados é menor ou igual ao valor do percentil P (do artigo da Wikipedia sobre percentis).

Defina os percentis 0 para ser o menor membro da população.

Erro de estimativa em percentuais

A agregação de percentis fornece um valor aproximado usando T-Digest.

Conteúdo relacionado

• Função AVG