SELECIONE DO <modelo>. CASES (DMX)

Aplica-se a: SQL Server Analysis Services

Oferece suporte a detalhamento e retorna os casos que foram usados para treinar o modelo. Você também pode retornar colunas de estrutura que não estão 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á.

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 retornar.

Lista de expressões
Uma lista de expressões separada por vírgula. Uma expressão pode incluir identificadores de coluna, funções definidas pelo usuário, UDFs e funções VBA e outros.

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

Modelo
Um 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 estiver habilitado no modelo de mineração e na estrutura de mineração, os usuários que são membros de uma função que tem permissão de detalhamento no modelo e na estrutura poderão acessar colunas da estrutura de mineração que não estão incluídas no modelo de 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 for 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 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 e colunas de estrutura

O exemplo a seguir retorna as colunas de todos os casos que foram usados para testar o modelo de mala direta direcionada. Se a estrutura de mineração na qual o modelo é criado não tiver um conjunto de dados de teste de retenção, essa consulta retornará 0 casos. Você pode usar a lista de expressões para retornar apenas as colunas necessárias.

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

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

O exemplo a seguir retorna apenas os casos que foram usados para treinar o Cluster 2. O nó do Cluster 2 tem o valor '002' para a coluna NODE_UNIQUE_NAME. O exemplo também retorna uma coluna de estrutura, [Chave do cliente], que não fazia parte do modelo de mineração e fornece o alias CustomerID para a coluna. Observe que o nome da coluna de estrutura é passado como um valor de cadeia de caracteres e, portanto, deve ser colocado entre aspas, não entre 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 ser habilitadas no modelo de mineração e na estrutura de mineração.

Veja 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)