Predict (DMX)

La funzione Predict restituisce un valore, o un set di valori, stimato per una colonna specificata.

Sintassi

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

Si applica a

Riferimento a colonna scalare o a colonna di tabella.

Tipo restituito

<riferimento di colonna scalare>

Oppure

<riferimento a colonna di tabella>

Il tipo restituito dipende dal tipo di colonna a cui è applicata la funzione.

Nota

INCLUSIVE, EXCLUSIVE, INPUT_ONLY e INCLUDE_STATISTICS sono applicabili solo a riferimenti a colonne di tabella, mentre EXCLUDE_NULL e INCLUDE_NULL sono applicabili solo a riferimenti a colonne scalari.

Osservazioni

Le opzioni disponibili includono EXCLUDE_NULL (predefinita), INCLUDE_NULL, INCLUSIVE, EXCLUSIVE (predefinita), INPUT_ONLY e INCLUDE_STATISTICS.

Nota

Per i modelli Time Series la funzione Predict non supporta INCLUDE_STATISTICS.

Se è specificato il parametro INCLUDE_NODE_ID, nel risultato verrà restituita la colonna $NODEID. NODE_ID è il nodo di contenuto su cui viene eseguita la stima per un case specifico. Questo parametro è facoltativo quando si utilizza Predict nelle colonne della tabella.

Il parametro n è applicabile alle colonne di tabella. Imposta il numero delle righe restituite in base al tipo di stima. Se la colonna sottostante contiene una sequenza, verrà chiamata la funzione PredictSequence. Se la colonna sottostante contiene una serie temporale, verrà chiamata la funzione PredictTimeSeries. Per i tipi di stima associativi viene chiamata la funzione PredictAssociation.

La funzione Predict supporta il polimorfismo.

Vengono spesso utilizzate le seguenti forme abbreviate alternative:

  • [Gender] è una forma alternativa per Predict([Gender], EXCLUDE_NULL).

  • [Products Purchases] è una forma alternativa per Predict([Products Purchases], EXCLUDE_NULL, EXCLUSIVE).

    Nota

    Il tipo restituito da questa funzione viene a sua volta gestito come riferimento a colonna. La funzione Predict può essere pertanto utilizzata come argomento in altre funzioni che accettano un riferimento a colonna come argomento, a eccezione della funzione Predict stessa.

Se si passa INCLUDE_STATISTICS a una stima su una colonna valutata a livello di tabella, alla tabella risultante verranno aggiunte le colonne $Probability e $Support, che descrivono la probabilità dell'esistenza del record della tabella nidificata associato.

Esempi

Nell'esempio seguente viene utilizzata la funzione Predict per restituire i quattro prodotti nel database Adventure Works che più probabilmente verranno venduti assieme. Poiché le stime della funzione vengono eseguite su un modello di data mining delle regole di associazione, viene utilizzata automaticamente la funzione PredictAssociation come descritto in precedenza.

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

Risultati dell'esempio:

Questa query restituisce una singola riga di dati con una sola colonna, Expression, che però contiene la seguente tabella nidificata.

Model

$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