Predict (DMX)

La función Predict devuelve un valor o un conjunto de valores predichos para una columna especificada.

Sintaxis

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

Se aplica a

Una referencia de columna escalar o una referencia de columna de tabla.

Tipo devuelto

<scalar column reference>

o bien

<table column reference>

El tipo devuelvo depende del tipo de columna a la que se aplica la función.

Nota

INCLUSIVE, EXCLUSIVE, INPUT_ONLY e INCLUDE_STATISTICS sólo se aplican a una referencia de columna de tabla, mientras que EXCLUDE_NULL e INCLUDE_NULL se aplican exclusivamente a una referencia de columna escalar.

Comentarios

Entre las opciones de la función, figuran EXCLUDE_NULL (predeterminada), INCLUDE_NULL, INCLUSIVE, EXCLUSIVE (predeterminada), INPUT_ONLY e INCLUDE_STATISTICS.

Nota

Para los modelos de serie temporal, la función Predict no admite INCLUDE_STATISTICS.

El parámetro INCLUDE_NODE_ID devuelve la columna $NODEID en el resultado. NODE_ID es el nodo de contenido en el que se ejecuta la predicción para un caso concreto. Este parámetro es opcional al utilizar Predict en las columnas de la tabla.

El parámetro n se aplica a columnas de tabla. Define el número de filas que se devuelve en función del tipo de predicción. Si la columna subyacente es una secuencia, llama a la función PredictSequence. Si la columna subyacente es una serie temporal, llama a la función PredictTimeSeries. En el caso de tipos de predicción de asociaciones, llama a la función PredictAssociation.

La función Predict admite varias formas distintas.

Las siguientes formas abreviadas alternativas son de uso frecuente:

  • [Gender] es una alternativa de Predict([Gender], EXCLUDE_NULL).

  • [Products Purchases] es una alternativa para Predict([Products Purchases], EXCLUDE_NULL, EXCLUSIVE).

    Nota

    El propio tipo devuelto de esta función se considera como una referencia de columna. Esto indica que la función Predict se puede usar como argumento en otras funciones que aceptan una referencia de columna como argumento (excepto la propia función Predict).

Si se pasa INCLUDE_STATISTICS a una predicción de una columna con valores de tabla, se agregan las columnas $Probability y $Support a la tabla resultante. Estas columnas describen la probabilidad de que exista el registro de tabla anidada asociado.

Ejemplos

En el ejemplo siguiente se utiliza la función Predict para devolver los cuatro productos de la base de datos Adventure Works que es más probable que se vendan juntos. Puesto que la función predice frente a un modelo de minería de datos de reglas de asociación, utiliza automáticamente la función PredictAssociation como se ha descrito anteriormente.

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

Resultados del ejemplo:

Esta consulta devuelve una sola fila de datos con una columna, Expression, pero esa columna contiene la siguiente tabla anidada.

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