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 |