SystemGetAccuracyResults (Analysis Services - データ マイニング)
マイニング構造と関連するすべてのモデル (クラスタ モデルを除く) に対するクロス検証の精度基準を返します。
このストアド プロシージャは、データセット全体の基準を 1 つのパーティションとして返します。データセットをセクションにパーティション分割して、各パーティションの基準を返すには、SystemGetCrossValidationResults (Analysis Services - データ マイニング) を使用してください。
.gif "注意") 注意 |
|---|
このストアド プロシージャは、Microsoft タイム シリーズ アルゴリズムや Microsoft シーケンス クラスタ アルゴリズムを使用して作成されたモデルではサポートされていません。また、クラスタ モデルには、別のストアド プロシージャ SystemGetClusterAccuracyResults (Analysis Services - データ マイニング) を使用してください。 |
構文
SystemGetAccuracyResults(<mining structure>,
[,<mining model list>]
,<data set>
,<target attribute>
[,<target state>]
[,<target threshold>]
[,<test list>])
引数
mining structure
現在のデータベースのマイニング構造の名前。(必須)
model list
検証するモデルのコンマ区切りの一覧。既定値は null です。つまり、適用可能なモデルがすべて使用されます。既定値を使用すると、クラスタ モデルは処理の対象一覧から自動的に除外されます。
(省略可)
data set
テストに使用される、マイニング構造のパーティションを示す整数値。この値は、次の値の合計を表すビットマスクから派生しています。この場合、いずれの値も省略可能です。トレーニング ケース
0x0001
テスト ケース
0x0002
モデル フィルタ
0x0004
指定可能な値の一覧については、このトピックの「解説」を参照してください。
(必須)
target attribute
予測可能なオブジェクトの名前を表す文字列。予測可能なオブジェクトには、マイニング モデルの列、入れ子になったテーブル列、または入れ子になったテーブル キー列を指定できます。(必須)
target state
予測する特定の値を表す文字列。値を指定した場合、その特定の状態の基準が収集されます。
値を指定しなかった場合、または Null を指定した場合は、予測ごとに最も可能性の高い状態の基準が計算されます。
既定値は null です。
(省略可能)
target threshold
予測値が正確であると見なされる最小確率を示す 0.0 ～ 1 の範囲の数値。既定値は null です。これは、すべての予測が正しいと見なされることを意味します。
(省略可能)
test list
テスト オプションを指定する文字列。このパラメータは将来使用するために予約されています。(省略可能)
戻り値の型
返される行セットには、各パーティションのスコアと、すべてのモデルの集計が含まれます。
次の表は、GetValidationResults によって返される列の一覧です。
列名 |
説明 |
|---|---|
Model |
テストされたモデルの名前。All は、結果がすべてのモデルの集計であることを示します。 |
AttributeName |
予測可能列の名前。 |
AttributeState |
予測可能列の対象の値。 この列に値が含まれる場合、指定した状態の基準だけが収集されます。 この値が指定されていない場合や Null の場合は、予測ごとに最も可能性の高い状態の基準が計算されます。 |
PartitionIndex |
結果が適用されるパーティションを表します。 このプロシージャでは、常に 0 になります。 |
PartitionCases |
<data set> パラメータに基づいた、ケース セットの行数を示す整数。 |
Test |
実行されたテストの種類。 |
Measure |
テストから返されたメジャーの名前。各モデルのメジャーは、モデルの種類と、予測可能な値の型によって異なります。 予測可能な型ごとに返されるメジャーの一覧については、「クロス検証レポート (Analysis Services - データ マイニング)」を参照してください。 各メジャーの定義については、「相互検証 (Analysis Services - データ マイニング)」を参照してください。 |
Value |
指定したメジャーの値。 |
説明
次の表は、クロス検証に使用されるマイニング構造のデータを指定するために使用できる値の例を示しています。クロス検証にテスト ケースを使用する場合、マイニング構造には、既にテスト データセットが含まれている必要があります。マイニング構造の作成時にテスト データセットを定義する方法の詳細については、「トレーニング セットとテスト セットへのデータのパーティション分割 (Analysis Services - データ マイニング)」を参照してください。
整数値 |
説明 |
|---|---|
1 |
トレーニング ケースのみが使用されます。 |
2 |
テスト ケースのみが使用されます。 |
3 |
トレーニング ケースとテスト ケースの両方が使用されます。 |
4 |
無効な組み合わせです。 |
5 |
トレーニング ケースのみが使用され、モデル フィルタが適用されます。 |
6 |
テスト ケースのみが使用され、モデル フィルタが適用されます。 |
7 |
トレーニング ケースとテスト ケースの両方が使用され、モデル フィルタが適用されます。 |
クロス検証を使用するシナリオの詳細については、「データ マイニング モデルの検証 (Analysis Services - データ マイニング)」を参照してください。
使用例
この例では、vTargetMail マイニング構造に関連付けられている 1 つのデシジョン ツリー モデル v Target Mail DT の精度のメジャーを返します。4 行目のコードは、結果が、テスト ケースに基づいていて、モデルごとにそのモデル固有のフィルタでフィルタ処理されていることを示します。[Bike Buyer] は、予測される列を指定し、その次の行の 1 は、モデルが特定の値 1 ("はい、購入します") に対してのみ評価されることを示します。
コードの最後の行では、状態のしきい値が 0.5 であることを指定します。つまり、確率が 50% を超える予測は、精度を計算する際に "良い" 予測であると見なされます。
CALL SystemGetAccuracyResults (
[vTargetMail],
[vTargetMail DT],
6,
'Bike Buyer',
1,
0.5
)
サンプルの結果 :
ModelName |
AttributeName |
AttributeState |
PartitionIndex |
PartitionSize |
Test |
Measure |
Value |
|---|---|---|---|---|---|---|---|
v Target Mail DT |
Bike Buyer |
1 |
0 |
1638 |
Classification |
True Positive |
605 |
v Target Mail DT |
Bike Buyer |
1 |
0 |
1638 |
Classification |
False Positive |
177 |
v Target Mail DT |
Bike Buyer |
1 |
0 |
1638 |
Classification |
True Negative |
501 |
v Target Mail DT |
Bike Buyer |
1 |
0 |
1638 |
Classification |
False Negative |
355 |
v Target Mail DT |
Bike Buyer |
1 |
0 |
1638 |
Likelihood |
Log Score |
-0.598454638753028 |
v Target Mail DT |
Bike Buyer |
1 |
0 |
1638 |
Likelihood |
Lift |
0.0936717116894395 |
v Target Mail DT |
Bike Buyer |
1 |
0 |
1638 |
Likelihood |
Root Mean Square Error |
0.361630800104946 |
要件
クロス検証は SQL Server 2008 Enterprise でのみ使用できます。