Predict (DMX)
Predict 関数は、指定された列に対して、予測された値、または値のセットを返します。
構文
Predict(<scalar column reference>, [option1], [option2], [option n], [INCLUDE_NODE_ID], n)
Predict(<table column reference>, [option1], [option2], [option n], [INCLUDE_NODE_ID], n)
適用対象
スカラー列参照またはテーブル列参照です。
戻り値の型
<scalar column reference>
または
<table column reference>
戻り値の型は、この関数が適用される列の型によって異なります。
注 |
---|
INCLUSIVE、EXCLUSIVE、INPUT_ONLY、および INCLUDE_STATISTICS はテーブル列の参照にのみ適用され、EXCLUDE_NULL および INCLUDE_NULL はスカラー列の参照にのみ適用されます。 |
説明
オプションには、EXCLUDE_NULL (既定)、INCLUDE_NULL、INCLUSIVE、EXCLUSIVE (既定)、INPUT_ONLY、および INCLUDE_STATISTICS が含まています。
注 |
---|
時系列モデルの場合、Predict 関数では、INCLUDE_STATISTICS がサポートされていません。 |
INCLUDE_NODE_ID パラメーターは、結果に $NODEID 列を返します。 NODE_ID は、特定のケースに対して予測が実行されるコンテンツ ノードです。 このパラメーターは、テーブル列で Predict を使用する場合に省略可能です。
n パラメーターは、テーブル列に適用されます。 これにより、予測の種類に基づいて、返される列の数が設定されます。 基礎列がシーケンスの場合は、PredictSequence 関数を呼び出します。 基礎列が時系列の場合は、PredictTimeSeries 関数を呼び出します。 予測の種類が結合型の場合、PredictAssociation 関数を呼び出します。
Predict 関数は多態性をサポートしています。
使用される頻度の高い代替省略形は次のとおりです。
[Gender] は、Predict([Gender], EXCLUDE_NULL) の代替形です。
[Products Purchases] は、Predict([Products Purchases], EXCLUDE_NULL, EXCLUSIVE) の代替形です。
注 この関数の戻り値の型は、列の参照として扱われる元々の型と同じです。 つまり、Predict 関数は、列の参照を引数として扱う他の関数で引数として使用することができます (Predict 関数自身は除く)。
INCLUDE_STATISTICS をテーブル値列での予測に渡すと、列 $Probability および $Support が結果のテーブルに追加されます。 これらのメタ列は、入れ子になった関連テーブルのレコードが存在する確率を説明します。
使用例
次の例は、Predict 関数を使用して、Adventure Works データベースの製品で、一緒に販売される可能性が最も高い 4 つの製品を返します。 この関数は、アソシエーション ルール マイニング モデルに対して予測を行うため、前述のように PredictAssociation 関数を自動的に使用します。
SELECT
Predict([Association].[v Assoc Seq Line Items],INCLUDE_STATISTICS,4)
FROM [Association]
サンプルの結果 :
このクエリでは、1 つの列を含む 1 行のデータ Expression が返されますが、その列には次の入れ子になったテーブルが含まれます。
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 |