SystemGetClusterCrossValidationResults (Analysis Services – mineração de dados)

Aplica-se a: SQL Server 2019 e versões anteriores do Analysis Services Azure Analysis Services Fabric/Power BI Premium

Importante

A mineração de dados foi preterida no SQL Server 2017 Analysis Services e agora descontinuada no SQL Server 2022 Analysis Services. A documentação não é atualizada para recursos preteridos e descontinuados. Para saber mais, consulte a compatibilidade com versões anteriores do Analysis Services.

Esse procedimento armazenado particiona a estrutura de mineração no número especificado de seções cruzadas, treina um modelo para cada partição e retorna métricas de precisão para cada partição.

Observação Use este procedimento armazenado apenas com uma estrutura de mineração que tenha pelo menos um modelo de clustering. Para validar modelos não clusterizadores, use SystemGetCrossValidationResults (Analysis Services – Data Mining).

Sintaxe

  
SystemGetClusterCrossValidationResults(  
<structure name>,   
[,<mining model list>]  
,<fold count>}  
,<max cases>  
<test list>])  

Arguments

estrutura de mineração
Nome de uma estrutura de mineração no banco de dados atual.

(obrigatório)

lista de modelos de mineração
Lista separada por vírgulas de modelos de mineração a serem validados.

Se você não especificar uma lista de modelos de mineração, a validação cruzada será executada em todos os modelos de clustering para a estrutura especificada.

Observação

Para validar modelos que não são modelos de clustering, use um procedimento armazenado separado, SystemGetCrossValidationResults (Analysis Services – Data Mining).

(opcional)

contagem de dobras
Inteiro que especifica o número de partições para separar o conjunto de dados. O valor mínimo é 2. O número máximo de dobras é o número máximo inteiro ou o número de casos, o que for menor.

Cada partição contém aproximadamente esse número de casos: contagem máxima de dobras/ de casos.

Não existe um valor padrão.

Observação

O número de dobras afeta muito o tempo necessário para executar a validação cruzada. Se você selecionar um número muito alto, a consulta poderá ser executada por muito tempo. Em alguns casos, o servidor pode ficar sem resposta ou tempo limite.

(obrigatório)

max cases
Inteiro que especifica o número máximo de casos que podem ser testados.

Um valor de 0 indica que o procedimento usa todos os casos na fonte de dados.

Se você especificar um número maior que o número real de casos no conjunto de dados, o procedimento testará todos os casos na fonte de dados.

(obrigatório)

lista de testes
Uma cadeia de caracteres que especifica as opções de teste.

Nota Esse parâmetro é reservado para uso futuro.

(opcional)

Tipo de retorno

A tabela Tipo de Retorno contém pontuações para cada partição individual e agregações para todos os modelos.

A tabela a seguir descreve as colunas retornadas.

Nome da Coluna Description
ModelName O nome do modelo que foi testado.
Nome do atributo O nome da coluna previsível. Para modelos de cluster, sempre nulo.
AttributeState Um valor de destino especificado na coluna previsível. Para modelos de cluster, sempre nulo.
PartitionIndex Um índice baseado em 1 que identifica a qual partição os resultados se aplicam.
PartitionSize Um inteiro que indica quantos casos foram incluídos em cada partição.
Test O tipo de teste que foi executado.
Medida O nome da medida retornada pelo teste. As medidas para cada modelo dependem do tipo do valor previsível. Para obter uma definição de cada medida, consulte Validação Cruzada (Analysis Services – Mineração de Dados).

Para obter uma lista de medidas retornadas para cada tipo previsível, consulte Medidas no Relatório de Validação Cruzada.
Value O valor da medida de teste especificada.

Observações

Para retornar métricas de precisão para todo o conjunto de dados, use SystemGetClusterAccuracyResults (Analysis Services – Mineração de Dados).

Se o modelo de mineração já contiver dobras, use SystemGetClusterAccuracyResults (Analysis Services – Data Mining) para ignorar o processamento e retornar apenas os resultados de validação cruzada.

Exemplos

Este exemplo particiona uma estrutura de mineração em três dobras e testa dois modelos de clustering associados.

A linha três lista os modelos de mineração a serem testados. Se você não listar modelos, o código testará todos os modelos de clustering associados à estrutura.

A linha quatro especifica o número de dobras e a linha cinco especifica o número máximo de casos a serem usados.

Os modelos de clustering não exigem que você especifique um atributo ou valor previsível.

CALL SystemGetClusterCrossValidationResults(  
[v Target Mail],  
[Cluster 1], [Cluster 2],  
3,  
10000  
)  

Resultados de exemplo:

ModelName Nome do atributo AttributeState PartitionIndex PartitionSize Test Medida Value
Cluster 1 1 3025 Clustering Probabilidade de maiúsculas e 0.930524511864121
Cluster 1 2 3025 Clustering Probabilidade de maiúsculas e 0.919184178430778
Cluster 1 3 3024 Clustering Probabilidade de maiúsculas e 0.929651120490248
Cluster 2 1 1289 Clustering Probabilidade de maiúsculas e 0.922789726933607
Cluster 2 2 1288 Clustering Probabilidade de maiúsculas e 0.934865535691068
Cluster 2 3 1288 Clustering Probabilidade de maiúsculas e 0.924724595688798

Requirements

A partir do SQL Server 2008, somente o SQL Server Enterprise dá suporte à validação cruzada.

Consulte Também

SystemGetCrossValidationResults (Analysis Services – Mineração de Dados)
SystemGetAccuracyResults (Analysis Services – Mineração de Dados)
SystemGetClusterCrossValidationResults
SystemGetClusterAccuracyResults (Analysis Services – Mineração de Dados)