Função KTHLARGEST

Extrai o valor classificado dos valores em uma coluna. k=1 retorna o valor máximo quando uma condição especificada é atendida. O valor de k precisa estar entre 1 e 1.000, inclusive.

Para realizar esse cálculo, duas instâncias do mesmo valor são tratadas como valores separados. Então, se o conjunto de dados contiver três linhas com valores de coluna 10, 9 e 9, KTHLARGEST retornará 9 para k=2 e k=3.

Quando usada em uma transformação pivot, a função é calculada para cada instância do valor especificado no parâmetro group. Consulte Transformação Pivot.

A coluna de entrada pode ser de tipo Inteiro ou Decimal. Os dados não numéricos na coluna são ignorados. Se uma linha contiver um valor ausente ou nulo, ele não será considerado no cálculo.

Uso básico

pivot value:KTHLARGEST(myRating, 2) group:postal_code limit:1

Saída: gera uma tabela de duas colunas que contém os valores únicos na coluna postal_code e o segundo valor mais alto da coluna myRating para o valor postal_code. O parâmetro limit define o número máximo de colunas do resultado.

Sintaxe

pivot value:KTHLARGEST(function_col_ref, k_integer) [ group:group_col_ref] [limit:limit_count]

Argumento	Obrigatório?	Tipo de dados	Descrição
function_col_ref	S	string	Nome da coluna à qual aplicar a função
k_integer	S	inteiro (positivo)	A classificação do valor a extrair da coluna de origem

Para mais informações sobre os parâmetros group e limit, consulte Transformação Pivot.

Para mais informações sobre os padrões de sintaxe, consulte Notas de sintaxe da documentação da linguagem.

function_col_ref

Nome da coluna que contém os valores com base nos quais você quer calcular a média. A coluna precisa conter valores inteiros ou decimais.

• Valores literais não são aceitos como entradas.
• Não há compatibilidade com várias colunas e caracteres curinga.

Observações sobre o uso:

Obrigatório?	Tipo de dados	Valor de exemplo
Sim	String (referência de coluna)	myValues

k_integer

Inteiro que representa a classificação do valor a extrair da coluna de origem.

OBSERVAÇÃO: o valor de k precisa ser um inteiro entre 1 e 1.000, inclusive.

• k=1 representa o valor máximo na coluna.
• Se k é maior ou igual ao número de valores na coluna, o valor mínimo é retornado.
• Os valores ausentes e nulos não são considerados na classificação de k.

Notas de uso:

Obrigatório?	Tipo de dados	Valor de exemplo
Sim	Inteiro (positivo)	4

Exemplos

Este exemplo explora como você pode usar funções de agregação para calcular a classificação de valores em uma coluna usando as funções KTHLARGEST e KTHLARGESTUNIQUE.

• Consulte Função KTHLARGEST.
• Consulte Função KTHLARGESTUNIQUE.

Fonte:

Você tem um conjunto de pontuações de testes de estudantes:

Estudante	Score
Anna	84
Ben	71
Caleb	76
Danielle	87
Evan	85
Faith	92
Gabe	87
Hannah	99
Ian	73
Jane	68

Transformação:

Você pode usar as seguintes transformações para extrair as pontuações da 1ª à 4ª colocação no teste:

derive type:single value:KTHLARGEST(Score, 1) as: '1st'

derive type:single value:KTHLARGEST(Score, 2) as: '2nd'

derive type:single value:KTHLARGEST(Score, 3) as: '3rd'

derive type:single value:KTHLARGEST(Score, 4) as: '4th'

derive type:single value:KTHLARGESTUNIQUE(Score, 3) as: '3rdUnique'

derive type:single value:KTHLARGESTUNIQUE(Score, 4) as: '4thUnique'

Resultados:

Quando você reorganiza as colunas, o conjunto de dados pode ser o seguinte:

Estudante	Pontuação	1º	2º	3º	4º	3º Exclusivo	4º Exclusivo
Anna	84	99	92	87	87	87	85
Ben	71	99	92	87	87	87	85
Caleb	76	99	92	87	87	87	85
Danielle	87	99	92	87	87	87	85
Evan	85	99	92	87	87	87	85
Faith	92	99	92	87	87	87	85
Gabe	87	99	92	87	87	87	85
Hannah	99	99	92	87	87	87	85
Ian	73	99	92	87	87	87	85
Jane	68	99	92	87	87	87	85

Observações:

• O valor 87 é equivalente à terceira e à quarta pontuações.
  • Para a função KTHLARGEST, é o resultado da terceira e da quarta classificações.
  • Para a função KTHLARGESTUNIQUE, é o resultado apenas da terceira classificação.