<Name_des_Modells>!FORECAST¶
Generiert eine Prognose aus dem zuvor trainierten Modell model_name
.
Wenn Sie bestimmte Spalten aus den von dieser Methode zurückgegebenen Daten auswählen müssen, können Sie die Methode in der FROM-Klausel einer SELECT-Anweisung aufrufen. Siehe Auswählen von Spalten aus SQL-Klasseninstanzmethoden, die Tabellendaten zurückgeben.
Syntax¶
Die erforderlichen Argumente variieren je nachdem, für welchen Anwendungsfall das Modell trainiert wurde.
Einzelzeitreihen-Modelle ohne exogene Variablen:
<name>!FORECAST(
FORECASTING_PERIODS => <forecasting_periods>,
[ CONFIG_OBJECT => <config_object> ]
);
Einzelreihen-Modelle mit exogenen Variablen:
<name>!FORECAST(
INPUT_DATA => <input_data>,
TIMESTAMP_COLNAME => '<timestamp_colname>',
[ CONFIG_OBJECT => <config_object> ]
);
Multizeitreihen-Modelle ohne exogene Variablen:
<name>!FORECAST(
SERIES_VALUE => <series>,
FORECASTING_PERIODS => <forecasting_periods>,
[ CONFIG_OBJECT => <config_object> ]
);
Multizeitreihen-Modelle mit exogenen Variablen:
<name>!FORECAST(
SERIES_VALUE => <series>,
SERIES_COLNAME => <series_colname>,
INPUT_DATA => <input_data>,
TIMESTAMP_COLNAME => '<timestamp_colname>',
[ CONFIG_OBJECT => <config_object> ]
);
Argumente¶
Benötigt:
Nicht alle der folgenden Argumente sind für jeden der zuvor aufgeführten Anwendungsfälle erforderlich.
FORECASTING_PERIODS => forecasting_periods
Erforderlich für Prognosen ohne exogene Variablen.
Die Anzahl der Schritte bis zur Prognose. Das Intervall zwischen den Schritten wird während des Trainings vom Modell abgeleitet.
INPUT_DATA => input_data
Erforderlich für Prognosen mit exogenen Variablen.
Eine Referenz zu einer Tabelle, Ansicht oder Abfrage, die die zukünftigen Zeitstempel und Werte der exogenen Variablen (zusätzliche, vom Benutzer bereitgestellte Features) enthält, die beim Training des Modells als Eingabedaten mit
input_data
übergeben wurden. Die Verwendung einer Referenz ermöglicht bei einem Prognoseprozess, der mit eingeschränkten Berechtigungen ausgeführt wird, Ihre Berechtigungen für den Zugriff auf die Daten zu nutzen. Die Spalten werden anhand des Namens zwischen diesem Argument und den ursprünglichen exogenen Trainingsdaten abgeglichen.Um diesen Verweis zu erstellen, können Sie das Schlüsselwort TABLE mit dem Tabellennamen, dem Ansichtsnamen oder der Abfrage verwenden, oder Sie können die Funktion SYSTEM$REFERENCE oder SYSTEM$QUERY_REFERENCE aufrufen.
TIMESTAMP_COLNAME => 'timestamp_colname'
Erforderlich für Prognosen mit exogenen Variablen.
Der Name der Spalte in
input_data
, die die Zeitstempel enthält.SERIES_COLNAME => 'series_colname'
Erforderlich bei Multizeitreihen-Prognosen mit exogenen Variablen.
Der Name der Spalte in
input_data
, die die Zeitreihen angibt.SERIES_VALUE => series
Erforderlich bei Multizeitreihen-Prognosen.
Die Zeitreihe für die Prognose. Kann ein einzelner Wert (z. B.
'Series A'::variant
) oder ein VARIANT sein, muss aber eine Zeitreihe angeben, mit der das Modell trainiert wurde. Wenn nicht angegeben, werden alle trainierten Zeitreihen vorhergesagt.
Optional:
CONFIG_OBJECT => config_object
Ein OBJECT mit Schlüssel-Wert-Paaren, die zur Konfiguration des Prognose-Jobs verwendet werden.
Schlüssel
Typ
Standard
Beschreibung
prediction_interval
0,95
Ein Wert, der größer als oder gleich 0,0 und kleiner als 1,0 ist. Der Standardwert ist 0,95, was bedeutet, dass 95 % der zukünftigen Punkte innerhalb des Intervalls [untere_Grenze, obere_Grenze] des Prognoseergebnisses liegen werden.
on_error
'ABORT'
Zeichenfolge (Konstante), die die Fehlerbehandlungsmethode angibt. Dies ist besonders nützlich, wenn Prognosen für mehrere Zeitreihen erstellt werden. Folgende Werte werden unterstützt:
'abort'
: Modellprognoseoperation abbrechen, wenn in einer Zeitreihe ein Fehler auftritt.'skip'
: Alle Zeitreihen überspringen, bei denen während bei der Prognoseerstellung ein Fehler auftritt. Dies ermöglicht eine erfolgreiche Prognose für andere Zeitreihen. Die fehlgeschlagenen Zeitreihen sind in der Modellausgabe nicht enthalten.
Ausgabe¶
Spalte |
Typ |
Beschreibung |
---|---|---|
SERIES |
Zeitreihenwert (NULL, wenn Modell mit mehreren Zeitreihen trainiert wurde). |
|
TS |
Zeitstempel |
|
FORECAST |
Prognostizierter Zielwert |
|
LOWER_BOUND |
Untere Grenze des Vorhersageintervalls. |
|
UPPER_BOUND |
Obere Grenze des Vorhersageintervalls. |
Beispiele¶
Siehe Beispiele.