SELECIONAR A PARTIR DE CASOS DE <modelo> (DMX)

Artigo
05/07/2013

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. É possível adicionar o detalhamento a um modelo existente usando o SSDT (SQL Server Data Tools), mas o modelo deve ser reprocessado antes de você poder exibir ou consultar os casos.

Para obter mais informações sobre como habilitar o detalhamento, consulte CRIAR UM MODELO DE MINERAÇÃO (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.
expression list
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>').
model
Identificador de modelo.
condition expression
Uma condição para restringir os valores retornados da lista de colunas.
expression
Opcional. 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 de fonte de dados para mascarar informações pessoais e atribuir a permissão AllowDrillthrough a uma estrutura de mineração ou modelo de mineração somente quando for necessário.

A função Latência (DMX) pode ser usada com modelos de série temporal para retornar ou filtrar um intervalo de tempo entre cada caso e o tempo inicial.

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

Exemplos

Os exemplos a seguir baseiam-se na estrutura de mineração Targeted Mailing, que, por sua vez, baseia-se no banco de dados AdventureWorksDW2012 e nos modelos de mineração associados. Para obter mais informações, consulte Tutorial de mineração de dados básico.

Exemplo 1: detalhamento para casos de modelo colunas de estrutura

O exemplo a seguir retorna as colunas para todos os casos usados para testar o modelo Targeted Mailing. 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 suportam o detalhamento, consulte Consultas de detalhamento (mineração de dados).