TopPercent (DMX)

La fonction TopPercent retourne, dans l'ordre décroissant, les lignes de premier niveau d'une table dont le total cumulé est au moins égal au pourcentage spécifié.

Syntaxe

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

Application

Expression qui retourne une table, comme une <référence de colonne de table>, ou fonction qui retourne une table.

Type de valeur renvoyé

<table expression>

Notes

La fonction TopPercent retourne les lignes de premier niveau dans l'ordre décroissant en fonction de la valeur évaluée de l'argument <rank expression> pour chaque ligne, de telle sorte que la somme des valeurs <rank expression> soit au moins égale au pourcentage spécifié par l'argument <percent>. TopPercent retourne le plus petit nombre d'éléments possible tout en correspondant à la valeur de pourcentage spécifiée.

Exemples

L'exemple suivant crée une requête de prédiction sur le modèle d'association que vous concevez à l'aide du Didacticiel sur l'exploration de données de base.

Pour comprendre comment TopPercent fonctionne, il peut s'avérer utile d'exécuter en premier lieu une requête de prédiction qui retourne uniquement la table imbriquée.

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

[!REMARQUE]

Dans cet exemple, la valeur fournie en tant qu'entrée contient un guillemet simple et doit donc être placée dans une séquence d'échappement en la préfaçant avec un autre guillemet simple. Si vous n'êtes pas certain de la syntaxe permettant d'insérer un caractère d'échappement, vous pouvez utiliser le Générateur de requêtes de prédiction pour créer la requête. Lorsque vous sélectionnez la valeur dans la liste déroulante, le caractère d'échappement requis est inséré pour vous. Pour plus d'informations, consultez créer une requête singleton dans le Concepteur d'exploration de données.

Résultats de l'exemple :

La fonction TopPercent prend les résultats de cette requête et retourne les lignes à valeur la plus élevée dont la somme est égale au pourcentage spécifié.

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

Le premier argument de la fonction TopPercent est le nom d'une colonne de table. Dans cet exemple, la table imbriquée est retournée en appelant la fonction Predict et en utilisant l'argument INCLUDE_STATISTICS.

Le deuxième argument pour la fonction TopPercent est la colonne dans la table imbriquée que vous utilisez pour classer les résultats. Dans cet exemple, l'option INCLUDE_STATISTICS retourne les colonnes $SUPPORT, $PROBABILTY et $ADJUSTED PROBABILITY. Cet exemple utilise $SUPPORT car les valeurs de support ne sont pas fractionnaires et sont donc plus faciles à vérifier.

Le troisième argument de la fonction TopPercent spécifie le pourcentage, en tant que valeur « double ». Pour obtenir les lignes des produits principaux dont la somme est égale à 50 pour cent du support total, tapez 50.

Résultats de l'exemple :

Remarque   Cet exemple est fourni uniquement pour illustrer l'utilisation de TopPercent. L'exécution de cette requête peut prendre beaucoup de temps, en fonction de la taille de votre jeu de données.

Attention
Les fonctions MDX pour TOPPERCENT et BOTTOMPERCENT peuvent générer des résultats inattendus lorsque les valeurs utilisées pour calculer le pourcentage incluent les nombres négatifs. Ce comportement n'affecte pas les fonctions DMX. Pour plus d'informations, consultez BottomPercent (MDX).

Voir aussi

Référence

Fonctions DMX (Data Mining Extensions)

Fonctions (DMX)

Fonctions de prédiction générales (DMX)