SELECT FROM <モデル>。ケース (DMX)

適用: SQL Server Analysis Services

ドリルスルーをサポートし、モデルのトレーニングに使用されたケースを返します。 マイニング構造とマイニング モデルについてドリルスルーを有効にした場合、ユーザーが適切な権限を持っているときは、モデルに含まれていない構造列も返すことができます。

マイニング モデルでドリルスルーが有効になっていない場合、このステートメントは失敗します。

注意

データ マイニング拡張機能 (DMX) では、ドリルスルーはモデルの作成時にのみ可能です。 SQL Server Data Tools (SSDT) を使用して既存のモデルにドリルスルーを追加できますが、ケースを表示またはクエリする前にモデルを再処理する必要があります。

ドリルスルーを有効にする方法の詳細については、「マイニング モデルの作成 (DMX)、SELECT INTO (DMX)、ALTER MINING STRUCTURE (DMX)」を参照してください。

構文

  
SELECT [FLATTENED] [TOP <n>] <expression list> FROM <model>.CASES  
[WHERE <condition expression>][ORDER BY <expression> [DESC|ASC]]  

引数

n
省略可能。 返す行数を指定する整数値です。

式リスト
式のコンマ区切りのリストです。 式には、列識別子、ユーザー定義関数、UDF、VBA 関数などを含めることができます。

マイニング モデルに含まれていない構造列を含めるには、関数 StructureColumn('<structure column name>') を使用します。

model
モデル識別子。

condition 式
列リストから返される値を制限する条件。

expression
省略可能。 スカラー値を返す式。

解説

マイニング モデルとマイニング構造の両方でドリルスルーが有効になっている場合、モデルと構造に対するドリルスルーアクセス許可を持つロールのメンバーであるユーザーは、マイニング モデルに含まれていないマイニング構造の列にアクセスできます。 したがって、機密データまたは個人情報を保護するには、データ ソース ビューを作成して個人情報をマスクし、必要な場合にのみマイニング構造に対する AllowDrillthrough アクセス許可を付与する必要があります。

Lag (DMX) 関数は、時系列モデルと共に使用して、各ケースと初期時間の間のタイム ラグを返したりフィルター処理したりできます。

WHERE 句で IsInNode (DMX) 関数を使用すると、スキーマ行セットのNODE_UNIQUE_NAME列で指定されたノードに関連付けられているケースのみが返されます。

例

次の例は、データベースとそれに関連付けられているマイニング モデルに基づくマイニング構造の Targeted Mailing に AdventureWorksDW2022 基づいています。 詳細については、「基本的なデータ マイニング チュートリアル」を参照してください。

例 1: モデル ケースと構造列へのドリルスルー

次の例では、対象メーリング モデルのテストに使用されたすべてのケースの列を返します。 モデルが構築されているマイニング構造にホールドアウト テスト データ セットがない場合、このクエリは 0 ケースを返します。 必要な列のみを返す式のリストを使用できます。

SELECT * FROM [TM Decision Tree].Cases  
WHERE IsTestCase();  

例 2 : 特定のノードのトレーニング ケースにドリルスルーする

次の例では、クラスター 2 のトレーニングに使用されたケースのみを返します。 Cluster 2 のノードの NODE_UNIQUE_NAME 列の値は '002' です。 この例では、マイニング モデルの一部ではない 1 つの構造列 [Customer Key] も返され、列のエイリアス CustomerID が提供されます。 構造体列の名前は文字列値として渡されるため、角かっこではなく引用符で囲む必要があることに注意してください。

SELECT StructureColumn('Customer Key') AS CustomerID, *   
FROM [TM_Clustering].Cases  
WHERE IsTrainingCase()  
AND IsInNode('002')  

構造列を返すには、マイニング モデルとマイニング構造の両方についてドリルスルー権限を有効にする必要があります。

注意

すべてのマイニング モデルの種類でドリルスルーがサポートされているわけではありません。 ドリルスルーをサポートするモデルの詳細については、「ドリルスルー クエリ (データ マイニング)」を参照してください。

参照

SELECT (DMX)
データ マイニング拡張機能 (DMX) データ定義ステートメント
データ マイニング拡張機能 (DMX) データ操作ステートメント
データ マイニング拡張機能 (DMX) ステートメント リファレンス