TopPercent (DMX)

Aplica-se a: SQL Server Analysis Services

A função TopPercent retorna, em ordem de classificação decrescente, as linhas mais altas de uma tabela cujo total cumulativo é pelo menos uma porcentagem especificada.

Syntax

  
TopPercent(<table expression>, <rank expression>, <percent>)  

Aplica-se A

Uma expressão que retorna uma tabela, como uma <referência> de coluna de tabela ou uma função que retorna uma tabela.

Tipo de retorno

<expressão de tabela>

Comentários

A função TopPercent retorna as linhas mais altas em ordem decrescente de classificação com base no valor avaliado do argumento de expressão de <classificação> para cada linha, de modo que a soma dos valores de <expressão de classificação> seja pelo menos a porcentagem especificada pelo <argumento percent> . TopPercent retorna o menor número de elementos possível enquanto ainda atende ao valor percentual especificado.

Exemplos

O exemplo a seguir cria uma consulta de previsão em relação ao modelo de Associação que você cria usando o Tutorial básico de mineração de dados.

Para entender como o TopPercent funciona, pode ser útil primeiro executar uma consulta de previsão que retorna apenas a tabela aninhada.

SELECT Predict ([Association].[v Assoc Seq Line Items], INCLUDE_STATISTICS, 10)  
FROM   
     [Association]  
NATURAL PREDICTION JOIN  
SELECT (SELECT 'Women''s Mountain Shorts' as [Model]) AS [v Assoc Seq Line Items]) AS t  

Observação

Neste exemplo, o valor fornecido como entrada contém uma única aspa e, portanto, deve ser precedido por outra aspa. Se você não tiver certeza da sintaxe para inserção de um caractere de escape, use o Construtor de Consultas de Previsão para criar a consulta. Quando você seleciona o valor da lista suspensa, o caractere de escape exigido é inserido. Para obter mais informações, consulte Criar uma consulta singleton no Designer de mineração de dados.

Resultados do exemplo:

Modelar	$SUPPORT	$PROBABILITY	$ADJUSTEDPROBABILITY
Sport-100	4334	0.291283016	0.252695851
Water Bottle	2866	0.192620472	0.175205052
Patch kit	2113	0.142012232	0.132389356
Mountain Tire Tube	1992	0.133879965	0.125304948
Mountain-200	1755	0.117951475	0.111260823
Tubo de pneu de estrada	1588	0.106727603	0.101229538
Capacete para Ciclismo	1473	0.098998589	0.094256014
Fender Set - Mountain	1415	0.095100477	0.090718432
Mountain Bottle Cage	1367	0.091874454	0.087780332
Road Bottle Cage	1195	0.080314537	0.077173962

A função TopPercent usa os resultados dessa consulta e retorna as linhas com os maiores valores que somam à porcentagem especificada.

SELECT   
TopPercent  
    (  
    Predict ([Association].[v Assoc Seq Line Items],INCLUDE_STATISTICS,10),  
    $SUPPORT,  
    50)  
FROM   
     [Association]  
NATURAL PREDICTION JOIN  
(SELECT (SELECT 'Women''s Mountain Shorts' as [Model]) AS [v Assoc Seq Line Items]) AS t  

O primeiro argumento para a função TopPercent é o nome de uma coluna de tabela. Neste exemplo, a tabela aninhada é retornada chamando a função Predict e usando o argumento INCLUDE_STATISTICS.

O segundo argumento para a função TopPercent é a coluna na tabela aninhada que você usa para ordenar os resultados. Neste exemplo, a opção INCLUDE_STATISTICS retorna as colunas $SUPPORT, $PROBABILTY e $ADJUSTED PROBABILITY. Este exemplo usa $SUPPORT porque os valores de suporte não são fracionários e, portanto, são mais fáceis de verificar.

O terceiro argumento para a função TopPercent especifica a porcentagem, como um duplo. Para obter as linhas dos principais produtos que totalizam até 50 por cento do suporte total, digite 50.

Resultados do exemplo:

Modelar	$SUPPORT	$PROBABILITY	$ADJUSTEDPROBABILITY
Sport-100	4334	0.29...	0.25...
Water Bottle	2866	0.19...	0.17...
Patch kit	2113	0.14...	0.13...
Mountain Tire Tube	1992	0.133...	0.12...

Nota Este exemplo é fornecido apenas para ilustrar o uso de TopPercent. Dependendo do tamanho do conjunto de dados, esta consulta pode demorar muito para ser executada.

Aviso

As funções MDX para TOPPERCENT e BOTTOMPERCENT podem gerar resultados inesperados quando os valores usados para calcular o percentual incluem números negativos. Esse comportamento não afeta as funções DMX. Para obter mais informações, consulte BottomPercent (MDX).

Consulte Também

Referência de função de DMX (Data Mining Extensions)
Funções (DMX)
Funções de previsão gerais (DMX)