SELECIONE DO <modelo>. CASOS (DMX)

Aplica-se a: SQL Server Analysis Services

Suporta o detalhamento e retorna os casos usados para treinar o modelo. Também é possível retornar colunas de estrutura que não foram incluídas no modelo, se o detalhamento tiver sido habilitado na estrutura de mineração e no modelo de mineração e se você tiver as permissões apropriadas.

Se o detalhamento não estiver habilitado no modelo de mineração, essa instrução falhará.

Observação

No DMX (Data Mining Extensions) é possível apenas habilitar o detalhamento ao criar o modelo. Você pode adicionar o detalhamento a um modelo existente usando o SSDT (SQL Server Data Tools), mas o modelo deve ser reprocessado antes que você possa exibir ou consultar os casos.

Para obter mais informações sobre como habilitar o detalhamento, consulte CREATE MINING MODEL (DMX), SELECT INTO (DMX) e ALTER MINING STRUCTURE (DMX).

Sintaxe

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

Argumentos

n
Opcional. Um inteiro que especifica quantas linhas serão retornadas.

Lista de expressões
Uma lista de expressões separadas por vírgulas. Uma expressão pode incluir identificadores de coluna, funções definidas pelo usuário, UDFs e funções VBA, além de outras.

Para incluir uma coluna de estrutura que não foi incluída no modelo de mineração, use a função StructureColumn('<structure column name>').

Modelo
Identificador de modelo.

expressão de condição
Uma condição para restringir os valores retornados da lista de colunas.

expressão
Opcional. Uma expressão que retorna um valor escalar.

Comentários

Se o detalhamento for habilitado no modelo e na estrutura de mineração, os usuários que foram membros de uma função com permissão de detalhamento no modelo e na estrutura poderão acessar as colunas da estrutura de mineração que não foram incluídas no modelo e mineração. Portanto, para proteger dados confidenciais ou informações pessoais, você deve construir sua exibição da fonte de dados para mascarar informações pessoais e conceder permissão AllowDrillthrough em uma estrutura de mineração somente quando necessário.

A função Lag (DMX) pode ser usada com modelos de séries temporais para retornar ou filtrar o intervalo de tempo entre cada caso e o tempo inicial.

O uso da função IsInNode (DMX) na cláusula WHERE retorna apenas os casos associados ao nó especificado pela coluna NODE_UNIQUE_NAME do conjunto de linhas do esquema.

Exemplos

Os exemplos a seguir são baseados na estrutura de mineração Targeted Mailing, que se baseia no AdventureWorksDW2025 banco de dados e em seus modelos de mineração associados. Para obter mais informações, consulte Tutorial básico de mineração de dados.

Exemplo 1: detalhamento para casos de modelo colunas de estrutura

O seguinte exemplo retorna as colunas para todos os casos usados para testar o modelo Correspondência destinada. Se a estrutura de mineração na qual o modelo foi construído não tiver um conjunto de dados de testes de validação, essa consulta retornará 0 casos. É possível usar a lista de expressões para retornar apenas as colunas necessárias.

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

Exemplo 2: Detalhamento para casos de treinamento em um nó específico

O exemplo seguinte retorna apenas os casos usados para treinar o Cluster 2. O nó para o Cluster 2 tem o valor '002' para a coluna de NODE_UNIQUE_NAME. O exemplo também retorna uma coluna de estrutura, [Customer Key], que não faz parte do modelo de mineração e fornece o alias CustomerID para a coluna. Observe que o nome da coluna da estrutura é passado como um valor de cadeia de caracteres e, portanto, deve estar entre aspas, não colchetes.

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

Para retornar uma coluna de estrutura, as permissões de detalhamento devem estar habilitadas no modelo de mineração e na estrutura de mineração.

Observação

Nem todos os modelos de mineração suportam o detalhamento. Para obter informações sobre os modelos que dão suporte ao detalhamento, consulte Consultas de detalhamento (mineração de dados).