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)  

適用対象

スカラー列参照またはテーブル列参照のいずれか。

戻り値の型

<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その列には次の入れ子になったテーブルが含まれています。

モデル $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

参照

データ マイニング拡張機能 (DMX) 関数リファレンス
関数 (DMX)
一般的な予測関数 (DMX)