SELECT FROM <model>. CAS (DMX)

S’applique à : SQL Server Analysis Services

Prend en charge l'extraction et retourne les cas qui ont été utilisés pour l'apprentissage du modèle. Vous pouvez également retourner des colonnes de structure qui ne sont pas incluses dans le modèle si l'extraction a été activée sur la structure d'exploration de données et sur le modèle d'exploration de données et que vous disposez des autorisations appropriées.

Si l'extraction n'est pas activée sur le modèle d'exploration de données, cette instruction échoue.

Remarque

En DMX (Data Mining Extensions), vous ne pouvez activer l'extraction que lors de la création du modèle. Vous pouvez ajouter l’extraction à un modèle existant à l’aide de SQL Server Data Tools (SSDT), mais le modèle doit être retraité avant de pouvoir afficher ou interroger les cas.

Pour plus d’informations sur l’activation de l’extraction, consultez CREATE MINING MODEL (DMX), SELECT INTO (DMX) et ALTER MINING STRUCTURE (DMX) .

Syntaxe

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

Arguments

n
facultatif. Entier qui spécifie le nombre de lignes à retourner.

liste d’expressions
Liste d'expressions séparées par des virgules. Une expression peut comprendre des identificateurs de colonne, des fonctions définies par l'utilisateur, des fonctions VBA, etc.

Pour inclure une colonne de structure qui n'est pas incluse dans le modèle d'exploration de données, utilisez la fonction StructureColumn('<structure column name>').

modèle
Identificateur du modèle

expression de condition
Condition pour restreindre les valeurs retournées de la liste des colonnes.

expression
facultatif. Expression retournant une valeur scalaire.

Notes

Si l'extraction est activée à la fois sur le modèle d'exploration de données et la structure d'exploration de données, les utilisateurs membres d'un rôle qui a des autorisations d'extraction sur le modèle et la structure peuvent accéder aux colonnes de la structure d'exploration de données qui ne sont pas incluses dans le modèle d'exploration de données. Par conséquent, pour protéger les données sensibles ou les informations personnelles, vous devez construire votre vue de source de données pour masquer les informations personnelles et accorder l’autorisation AllowDrillthrough sur une structure d’exploration de données uniquement lorsque cela est nécessaire.

La fonction Lag (DMX) peut être utilisée avec des modèles de série chronologique pour retourner ou filtrer le décalage temporel entre chaque cas et l’heure initiale.

L’utilisation de la fonction IsInNode (DMX) dans la clause WHERE retourne uniquement les cas associés au nœud spécifié par la colonne NODE_UNIQUE_NAME de l’ensemble de lignes de schéma.

Exemples

Les exemples suivants sont basés sur la structure d’exploration de données Targeted Mailing, qui est basée sur la AdventureWorksDW2022 base de données et ses modèles d’exploration de données associés. Pour plus d’informations, consultez le didacticiel d’exploration de données de base.

Exemple 1 : Extraction dans des cas de modèles et des colonnes de structure

L'exemple suivant retourne les colonnes de tous les cas qui ont été utilisés pour tester le modèle Targeted Mailing. Si la structure d'exploration de données sur laquelle le modèle est construit ne possède pas de jeu de données du test d'exclusion, cette requête retourne 0 cas. Vous pouvez utiliser la liste d'expressions pour retourner uniquement les colonnes dont vous avez besoin.

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

Exemple 2 : Extraction dans des cas d'apprentissage dans un nœud spécifique

L'exemple suivant retourne uniquement les cas utilisés pour l'apprentissage de Cluster 2. Le nœud pour Cluster 2 a la valeur '002' pour la colonne NODE_UNIQUE_NAME. L'exemple retourne également une colonne de structure, [Customer Key], qui ne faisait pas partie du modèle d'exploration de données, et fournit l'alias CustomerID pour la colonne. Notez que le nom de la colonne de structure est passé en tant que valeur de chaîne ; par conséquent, il doit être entre guillemets, et non entre crochets.

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

Pour retourner une colonne de structure, les autorisations d'extraction doivent être activées à la fois sur le modèle d'exploration de données et sur la structure d'exploration de données.

Remarque

La prise en charge de l'extraction varie selon le type de modèle d'exploration de données. Pour plus d’informations sur les modèles qui prennent en charge l’extraction, consultez Requêtes d’extraction (exploration de données).

Voir aussi

SELECT (DMX)
Instructions de définition de données DMX (Data Mining Extensions)
Instructions de manipulation de données DMX (Data Mining Extensions)
Guide de référence des instructions DMX (Data Mining Extensions)