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