Predict (DMX)
適用対象:SQL Server Analysis Services 
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)
適用対象
スカラー列参照またはテーブル列参照。
返り値の種類
<スカラー列参照>
または
<テーブル列のリファレンス>
戻り値の型は、この関数が適用される列の型によって異なります。
Note
INCLUSIVE、EXCLUSIVE、INPUT_ONLY、INCLUDE_STATISTICSはテーブル列参照にのみ適用され、EXCLUDE_NULLとINCLUDE_NULLはスカラー列参照にのみ適用されます。
解説
オプションには、EXCLUDE_NULL (既定)、INCLUDE_NULL、INCLUSIVE、EXCLUSIVE (既定)、INPUT_ONLY、および INCLUDE_STATISTICS が含まれています。
Note
時系列モデルの場合、Predict 関数はINCLUDE_STATISTICSをサポートしていません。
INCLUDE_NODE_ID パラメーターは、結果の$NODEID列を返します。 NODE_IDは、特定のケースに対して予測が実行されるコンテンツ ノードです。 このパラメーターは、テーブル列で Predict を使用する場合は省略可能です。
n パラメーターはテーブル列に適用されます。 予測の種類に基づいて返される行数を設定します。 基になる列がシーケンスの場合は、 PredictSequence 関数を呼び出します。 基になる列が時系列の場合は、 PredictTimeSeries 関数を呼び出します。 連想型の予測では、 PredictAssociation 関数を呼び出します。
Predict 関数はポリモーフィズムをサポートします。
使用される頻度の高い代替省略形は次のとおりです。
[Gender] は、 Predict([Gender], EXCLUDE_NULL) の代替手段です。
[製品の購入] は、 Predict([Products Purchases], EXCLUDE_NULL, EXCLUSIVE) の代替手段です。
Note
この関数の戻り値の型自体は、列参照と見なされます。 つまり、 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 つの列 ( Expression) を持つ 1 行のデータを返しますが、その列には次の入れ子になったテーブルが含まれています。
| モデル | $SUPPORT | $PROBABILITY | $ADJUSTEDPROBABILITY |
|---|---|---|---|
| Sport-100 | 4334 | 0.291283016331743 | 0.252695851192499 |
| Water Bottle | 2866 | 0.192620471805901 | 0.175205052318795 |
| パッチ キット | 2113 | 0.142012232004839 | 0.132389356196586 |
| Mountain Tire Tube | 1992 | 0.133879965051415 | 0.125304947722259 |