Predict (DMX)

A função Predict retorna um valor previsto ou conjunto de valores de uma coluna especificada.

Sintaxe

Predict(<scalar column reference>, [option1], [option2], [option n], [INCLUDE_NODE_ID], n)
Predict(<table column reference>, [option1], [option2], [option n], [INCLUDE_NODE_ID], n)

Aplica-se a

Uma referência de coluna escalar ou a uma referência de coluna de tabela.

Tipo de retorno

<referência de coluna escalar>

ou

<referência de coluna de tabela>

O tipo de retorno depende do tipo de coluna ao qual essa função se aplica.

ObservaçãoObservação

INCLUSIVE, EXCLUSIVE, INPUT_ONLY e INCLUDE_STATISTICS aplicam-se somente à referência da coluna da tabela, e EXCLUDE_NULL e INCLUDE_NULL aplicam-se apenas à referência da coluna escalar.

Comentários

As opções incluem EXCLUDE_NULL (padrão), INCLUDE_NULL, INCLUSIVE, EXCLUSIVE (padrão), INPUT_ONLY e INCLUDE_STATISTICS.

ObservaçãoObservação

Para modelos de série temporal, a função Predict não dá suporte a INCLUDE_STATISTICS.

O parâmetro INCLUDE_NODE_ID retorna a coluna $NODEID no resultado. NODE_ID é o nó de conteúdo no qual a previsão é executada para um caso particular. Este parâmetro é opcional durante o uso de Predict em colunas de tabela.

O parâmetro n aplica-se a colunas de tabelas. Define o número de linhas retornadas com base no tipo de previsão. Se a coluna subjacente for seqüência, chamará a função PredictSequence. Se a coluna subjacente for em séries de tempo, chamará a função PredictTimeSeries. Para tipos associativos de previsão, chamará a função PredictAssociation.

A função Predict oferece suporte a polimorfismo.

As formas abreviadas alternativas a seguir são usadas freqüentemente:

  • [Sexo] é uma alternativa para Predict([Sexo], EXCLUDE_NULL).

  • [Compras de produtos] é uma alternativa para Predict([Compras de produtos], EXCLUDE_NULL, EXCLUSIVE).

    ObservaçãoObservação

    O próprio tipo de retorno dessa função é considerado uma referência de coluna. Isso significa que a função Predict poderá ser usada como argumento em outras funções que tomam a referência de uma coluna como argumento (exceto para a própria função Predict).

Passar INCLUDE_STATISTICS para uma previsão em uma coluna com valor de tabela adiciona as colunas $Probability e $Support à tabela resultante. Essas colunas descrevem a probabilidade de existência para o registro de tabela aninhada associada.

Exemplos

O exemplo a seguir usa a função Predict para retornar os quatro produtos do banco de dados Adventure Works que têm maior probabilidade de ser vendidos em conjunto. Como a função é previsão com relação a um modelo de mineração de regras de associação, ela usa automaticamente a função PredictAssociation, como descrito anteriormente.

SELECT
    Predict([Association].[v Assoc Seq Line Items],INCLUDE_STATISTICS,4)
FROM     [Association]

Resultados do exemplo:

Esta consulta retorna uma única linha de dados com uma coluna Expression, mas essa coluna contém a tabela aninhada a seguir.

Modelo

$SUPPORT

$PROBABILITY

$ADJUSTEDPROBABILITY

Sport-100

4334

0.291283016331743

0.252695851192499

Water Bottle

2866

0.192620471805901

0.175205052318795

Patch Kit

2113

0.142012232004839

0.132389356196586

Mountain Tire Tube

1992

0.133879965051415

0.125304947722259