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 AdventureWorksDW2022 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).

Confira também

SELECIONAR (DMX)
Instruções de definição de dados DMX (Data Mining Extensions)
Instruções de manipulação de dados DMX (Data Mining Extensions)
Referência de instrução DMX (Data Mining Extensions)