<nom_du_modèle>!FORECAST¶
Génère une prévision à partir du modèle précédemment entraîné model_name
.
Si vous devez sélectionner des colonnes spécifiques des données renvoyées par cette méthode, vous pouvez appeler la méthode dans la clause FROM d’une instruction SELECT. Voir Sélection de colonnes à partir de méthodes d’instance de classe SQL renvoyant des données tabulaires.
Syntaxe¶
Les arguments requis varient en fonction du cas d’utilisation pour lequel le modèle a été entraîné.
Pour les modèles à série unique sans variables exogènes :
<name>!FORECAST(
FORECASTING_PERIODS => <forecasting_periods>,
[ CONFIG_OBJECT => <config_object> ]
);
Pour les modèles à série unique avec des variables exogènes :
<name>!FORECAST(
INPUT_DATA => <input_data>,
TIMESTAMP_COLNAME => '<timestamp_colname>',
[ CONFIG_OBJECT => <config_object> ]
);
Pour les modèles à séries multiples sans variables exogènes :
<name>!FORECAST(
SERIES_VALUE => <series>,
FORECASTING_PERIODS => <forecasting_periods>,
[ CONFIG_OBJECT => <config_object> ]
);
Pour les modèles à séries multiples avec variables exogènes :
<name>!FORECAST(
SERIES_VALUE => <series>,
SERIES_COLNAME => <series_colname>,
INPUT_DATA => <input_data>,
TIMESTAMP_COLNAME => '<timestamp_colname>',
[ CONFIG_OBJECT => <config_object> ]
);
Arguments¶
Obligatoire :
Tous les arguments suivants ne sont pas nécessaires pour tous les cas d’utilisation.
FORECASTING_PERIODS => forecasting_periods
Nécessaire pour les prévisions sans variables exogènes.
Nombre de pas en avant pour la prévision. L’intervalle entre les étapes est déduit par le modèle au cours de l’entraînement.
INPUT_DATA => input_data
Nécessaire pour les prévisions avec des variables exogènes.
Référence à une table, une vue ou une requête qui contient les horodatages futurs et les valeurs des variables exogènes (fonctions supplémentaires fournies par l’utilisateur) qui ont été transmises en tant que
input_data
lors de la formation du modèle. L’utilisation d’une référence permet au processus de prévision, qui s’exécute avec des privilèges limités, d’utiliser vos privilèges pour accéder aux données. Les colonnes sont mises en correspondance entre cet argument et les données d’entraînement exogènes d’origine par nom.Pour créer cette référence, vous pouvez utiliser le mot-clé TABLE avec le nom de la table, de la vue ou de la requête, ou vous pouvez appeler la fonction SYSTEM$REFERENCE ou SYSTEM$QUERY_REFERENCE.
TIMESTAMP_COLNAME => 'timestamp_colname'
Nécessaire pour les prévisions avec des variables exogènes.
Nom de la colonne dans
input_data
contenant les horodatages.SERIES_COLNAME => 'series_colname'
Nécessaire pour les prévisions multi-séries avec des variables exogènes.
Nom de la colonne dans
input_data
spécifiant la série.SERIES_VALUE => series
Nécessaire pour les prévisions multi-séries.
Série temporelle à prévoir. Peut être une valeur unique (par exemple,
'Series A'::variant
) ou un VARIANT, mais doit spécifier une série sur laquelle le modèle a été entraîné. Si elle n’est pas spécifiée, toutes les séries entraînées sont prévues.
Facultatif :
CONFIG_OBJECT => config_object
OBJECT contenant des paires de clés de valeurs utilisées pour configurer la tâche de prévision.
Clé
Type
Par défaut
Description
prediction_interval
0,95
Une valeur supérieure ou égale à 0,0 et inférieure à 1,0. La valeur par défaut est 0,95, ce qui signifie que 95 % des points futurs devraient se situer dans l’intervalle [lower_bound, upper_bound] du résultat de la prévision.
on_error
'ABORT'
Chaîne (constante) spécifiant la méthode de gestion des erreurs. Cette fonction est particulièrement utile pour la prévision de plusieurs séries. Valeurs prises en charge :
'abort'
: abandonner l’opération de prévision de modèle si une erreur est rencontrée dans une série temporelle.l
'skip'
: ignorer toute série temporelle pour laquelle la prévision a rencontré une erreur. Cela permet d’effectuer des prévisions pour d’autres séries temporelles. Les séries qui ont échoué sont absentes de la sortie du modèle.
Sortie¶
Colonne |
Type |
Description |
---|---|---|
SERIES |
Valeur de la série (NULL si l’entraînement du modèle a été effectué avec une seule série temporelle). |
|
TS |
Horodatage. |
|
FORECAST |
Valeur cible de la prévision. |
|
LOWER_BOUND |
Limite inférieure de l’intervalle de prédiction. |
|
UPPER_BOUND |
Limite supérieure de l’intervalle de prédiction. |
Exemples¶
Voir Exemples.