Predict (DMX)

La fonction Predict retourne une valeur ou un ensemble de valeurs prédites pour une colonne spécifiée.

Syntaxe

Predict(<scalar column reference>, [option1], [option2], [option n], [INCLUDE_NODE_ID], n)
Predict(<table column reference>, [option1], [option2], [option n], [INCLUDE_NODE_ID], n)

Application

Référence de colonne scalaire ou référence de colonne de table

Type de valeur renvoyé

<référence de colonne scalaire>

- ou -

<référence de colonne de table>

Le type de retour dépend du type de colonne auquel cette fonction est appliquée.

Notes

INCLUSIVE, EXCLUSIVE, INPUT_ONLY et INCLUDE_STATISTICS s'appliquent uniquement à une référence de colonne de table, et EXCLUDE_NULL et INCLUDE_NULL s'appliquent uniquement à une référence de colonne scalaire.

Notes

Les options sont EXCLUDE_NULL (par défaut), INCLUDE_NULL, INCLUSIVE, EXCLUSIVE (par défaut), INPUT_ONLY et INCLUDE_STATISTICS.

Notes

Dans le cadre des modèles de séries chronologiques, la fonction Predict ne prend pas en charge INCLUDE_STATISTICS.

Le paramètre INCLUDE_NODE_ID retourne la colonne $NODEID dans le résultat. NODE_ID est le nœud de contenu sur lequel la prédiction est exécutée pour un cas particulier. Ce paramètre est facultatif lors de l'utilisation de Predict sur les colonnes de table.

Le paramètre n s'applique aux colonnes de table. Il définit le nombre de lignes retournées en fonction du type de prédiction. Si la colonne sous-jacente est une séquence, il appelle la fonction PredictSequence. Si la colonne sous-jacente est une série chronologique, il appelle la fonction PredictTimeSeries. Pour les types de prédictions associatives, il appelle la fonction PredictAssociation.

La fonction Predict prend en charge le polymorphisme.

Les formes abrégées des autres solutions suivantes sont fréquemment utilisées :

  • [Gender] est une autre solution pour Predict([Gender], EXCLUDE_NULL).

  • [Products Purchases] est une autre solution pour Predict([Products Purchases], EXCLUDE_NULL, EXCLUSIVE).

    Notes

    Le type de retour de cette fonction est lui-même considéré comme une référence de colonne. Ceci signifie que la fonction Predict peut être utilisée comme argument dans d'autres fonctions prenant une référence de colonne en tant qu'argument (excepté pour la fonction Predict elle-même).

La transmission de l'instruction INCLUDE_STATISTICS à une prédiction sur une colonne à valeur de table ajoute les colonnes $Probability et $Support à la table obtenue. Ces colonnes décrivent la probabilité de l'existence de l'enregistrement de table imbriquée associée.

Exemple

L'exemple suivant utilise la fonction Predict pour retourner les quatre produits de la base de données Adventure Works les plus susceptibles d'être vendus ensemble. Dans la mesure où la fonction tente une prédiction par rapport à un modèle d'exploration de données exploitant des règles d'association, elle utilise automatiquement la fonction PredictAssociation comme décrit plus haut.

SELECT
    Predict([Association].[v Assoc Seq Line Items],INCLUDE_STATISTICS,4)
FROM     [Association]

Exemples de résultats :

Cette requête retourne une ligne de données unique à une colonne (Expression) qui contient la table imbriquée suivante.

Model

$SUPPORT

$PROBABILITY

$ADJUSTEDPROBABILITY

Sport-100

4334

0.291283016331743

0.252695851192499

Water Bottle

2866

0.192620471805901

0.175205052318795

Patch Kit

2113

0.142012232004839

0.132389356196586

Mountain Tire Tube

1992

0.133879965051415

0.125304947722259