In dieser Anleitung erfahren Sie, wie Sie ein multivariates Zeitreihenmodell verwenden, um den zukünftigen Wert für eine bestimmte Spalte basierend auf dem historischen Wert mehrerer Eingabe-Features vorherzusagen.
In dieser Anleitung wird eine einzelne Zeitachse prognostiziert. Prognostizierte Werte werden einmal für jeden Zeitpunkt in den Eingabedaten berechnet.
In dieser Anleitung werden Daten aus dem öffentlichen Dataset bigquery-public-data.epa_historical_air_quality
verwendet. Dieses Dataset enthält Informationen zu täglichen Feinstaubwerten (PM2.5), Temperatur und Windgeschwindigkeit, die in mehreren US-Städten erfasst wurden.
Dataset erstellen
Erstellen Sie ein BigQuery-Dataset zum Speichern Ihres ML-Modells.
Console
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Klicken Sie im Bereich Explorer auf den Namen Ihres Projekts.
Klicken Sie auf
Aktionen ansehen > Dataset erstellen.Führen Sie auf der Seite Dataset erstellen die folgenden Schritte aus:
Geben Sie unter Dataset-ID
bqml_tutorial
ein.Wählen Sie als Standorttyp die Option Mehrere Regionen und dann USA (mehrere Regionen in den USA) aus.
Übernehmen Sie die verbleibenden Standardeinstellungen unverändert und klicken Sie auf Dataset erstellen.
bq
Wenn Sie ein neues Dataset erstellen möchten, verwenden Sie den Befehl bq mk
mit dem Flag --location
. Eine vollständige Liste der möglichen Parameter finden Sie in der bq mk --dataset
-Befehlsreferenz.
Erstellen Sie ein Dataset mit dem Namen
bqml_tutorial
, wobei der Datenspeicherort aufUS
und die Beschreibung aufBigQuery ML tutorial dataset
festgelegt ist:bq --location=US mk -d \ --description "BigQuery ML tutorial dataset." \ bqml_tutorial
Anstelle des Flags
--dataset
verwendet der Befehl die verkürzte Form-d
. Wenn Sie-d
und--dataset
auslassen, wird standardmäßig ein Dataset erstellt.Prüfen Sie, ob das Dataset erstellt wurde:
bq ls
API
Rufen Sie die Methode datasets.insert
mit einer definierten Dataset-Ressource auf.
{ "datasetReference": { "datasetId": "bqml_tutorial" } }
BigQuery DataFrames
Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von BigQuery DataFrames in der BigQuery-Kurzanleitung: BigQuery DataFrames verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu BigQuery DataFrames.
Richten Sie zur Authentifizierung bei BigQuery die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter ADC für eine lokale Entwicklungsumgebung einrichten.
Tabelle mit Eingabedaten erstellen
Erstellen Sie eine Datentabelle, die Sie zum Trainieren und Bewerten des Modells verwenden können. In dieser Tabelle werden Spalten aus mehreren Tabellen im Dataset bigquery-public-data.epa_historical_air_quality
kombiniert, um tägliche Wetterdaten bereitzustellen. Außerdem erstellen Sie die folgenden Spalten, die als Eingabevariablen für das Modell verwendet werden:
date
: das Datum der Beobachtungpm25
: der durchschnittliche PM2.5-Wert je Tagwind_speed
: durchschnittliche Windgeschwindigkeit je Tagtemperature
: Temperatur: die Höchsttemperatur je Tag
In der folgenden GoogleSQL-Abfrage gibt die FROM bigquery-public-data.epa_historical_air_quality.*_daily_summary
-Klausel an, dass Sie die *_daily_summary
-Tabellen im epa_historical_air_quality
-Dataset abfragen. Diese Tabellen sind partitionierte Tabellen.
So erstellen Sie die Eingabedatentabelle:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
CREATE TABLE `bqml_tutorial.seattle_air_quality_daily` AS WITH pm25_daily AS ( SELECT avg(arithmetic_mean) AS pm25, date_local AS date FROM `bigquery-public-data.epa_historical_air_quality.pm25_nonfrm_daily_summary` WHERE city_name = 'Seattle' AND parameter_name = 'Acceptable PM2.5 AQI & Speciation Mass' GROUP BY date_local ), wind_speed_daily AS ( SELECT avg(arithmetic_mean) AS wind_speed, date_local AS date FROM `bigquery-public-data.epa_historical_air_quality.wind_daily_summary` WHERE city_name = 'Seattle' AND parameter_name = 'Wind Speed - Resultant' GROUP BY date_local ), temperature_daily AS ( SELECT avg(first_max_value) AS temperature, date_local AS date FROM `bigquery-public-data.epa_historical_air_quality.temperature_daily_summary` WHERE city_name = 'Seattle' AND parameter_name = 'Outdoor Temperature' GROUP BY date_local ) SELECT pm25_daily.date AS date, pm25, wind_speed, temperature FROM pm25_daily JOIN wind_speed_daily USING (date) JOIN temperature_daily USING (date);
Eingabedaten visualisieren
Bevor Sie das Modell erstellen, können Sie Ihre Eingabezeitachsendaten optional visualisieren, um einen Eindruck von der Verteilung zu erhalten. Verwenden Sie dazu Looker Studio.
So visualisieren Sie die Zeitreihendaten:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
SELECT * FROM `bqml_tutorial.seattle_air_quality_daily`;
Klicken Sie nach Abschluss der Abfrage auf Daten auswerten > Mit Looker Studio auswerten. Looker Studio wird in einem neuen Tab geöffnet. Führen Sie die folgenden Schritte in dem neuen Tab aus.
Klicken Sie in Looker Studio auf Einfügen > Zeitreihendiagramm.
Wählen Sie im Bereich Diagramm den Tab Einrichtung aus.
Fügen Sie im Bereich Messwert die Felder pm25, temperature und wind_speed hinzu und entfernen Sie den Standardmesswert Anzahl der Datensätze. Das resultierende Diagramm sieht etwa so aus:
Dem Diagramm können Sie entnehmen, dass die Eingabezeitachse ein wöchentliches saisonales Muster aufweist.
Zeitachsenmodell erstellen
Erstellen Sie ein Zeitreihenmodell, um die Werte für Feinstaub (pm25
) anhand der Werte der Spalten pm25
, wind_speed
und temperature
als Eingabevariablen vorherzusagen. Trainieren Sie das Modell mit den Luftqualitätsdaten aus der Tabelle bqml_tutorial.seattle_air_quality_daily
. Wählen Sie dazu die Daten aus, die zwischen dem 1. Januar 2012 und dem 31. Dezember 2020 erfasst wurden.
In der folgenden Abfrage gibt die OPTIONS(model_type='ARIMA_PLUS_XREG',
time_series_timestamp_col='date', ...)
-Anweisung an, dass Sie ein ARIMA-Modell mit externen Regressoren erstellen. Die auto_arima
-Option der CREATE MODEL
-Anweisung hat standardmäßig den Wert TRUE
. Der auto.ARIMA
-Algorithmus stimmt die Hyperparameter im Modell also automatisch ab. Der Algorithmus passt Dutzende von Kandidatenmodellen an und wählt das beste Modell aus, also das Modell mit dem niedrigsten Akaike-Informationskriterium (AIC).
Die data_frequency
-Option der CREATE MODEL
-Anweisungen hat standardmäßig den Wert AUTO_FREQUENCY
. Der Trainingsprozess leitet also automatisch die Datenhäufigkeit der Eingabezeitachse ab.
So erstellen Sie das Modell:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
CREATE OR REPLACE MODEL `bqml_tutorial.seattle_pm25_xreg_model` OPTIONS ( MODEL_TYPE = 'ARIMA_PLUS_XREG', time_series_timestamp_col = 'date', # Identifies the column that contains time points time_series_data_col = 'pm25') # Identifies the column to forecast AS SELECT date, # The column that contains time points pm25, # The column to forecast temperature, # Temperature input to use in forecasting wind_speed # Wind speed input to use in forecasting FROM `bqml_tutorial.seattle_air_quality_daily` WHERE date BETWEEN DATE('2012-01-01') AND DATE('2020-12-31');
Die Abfrage dauert etwa 20 Sekunden. Anschließend können Sie auf das Modell
seattle_pm25_xreg_model
zugreifen. Da die Abfrage eineCREATE MODEL
-Anweisung zum Erstellen eines Modells verwendet, werden keine Abfrageergebnisse ausgegeben.
Kandidatenmodelle bewerten
Bewerten Sie die Zeitreihenmodelle mit der Funktion ML.ARIMA_EVALUATE
. Die ML.ARIMA_EVALUATE
-Funktion zeigt die Bewertungsmesswerte aller Kandidatenmodelle an, die während der automatischen Hyperparameter-Abstimmung bewertet wurden.
So bewerten Sie das Modell:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
SELECT * FROM ML.ARIMA_EVALUATE(MODEL `bqml_tutorial.seattle_pm25_xreg_model`);
Die Antwort sollte in etwa so aussehen:
Die Ausgabespalten
non_seasonal_p
,non_seasonal_d
,non_seasonal_q
undhas_drift
definieren ein ARIMA-Modell in der Trainingspipeline. Die Ausgabespaltenlog_likelihood
,AIC
undvariance
sind für den ARIMA-Modellanpassungsprozess relevant.Der
auto.ARIMA
-Algorithmus verwendet den KPSS-Test, um den besten Wert fürnon_seasonal_d
zu ermitteln. In diesem Fall ist das1
. Wennnon_seasonal_d
1
ist, trainiert derauto.ARIMA
-Algorithmus 42 verschiedene ARIMA-Kandidatenmodelle parallel. In diesem Beispiel sind alle 42 Kandidatenmodelle gültig. Die Ausgabe enthält also 42 Zeilen, eine für jedes ARIMA-Kandidatenmodell. Wenn einige der Modelle ungültig sind, werden sie aus der Ausgabe ausgeschlossen. Diese Kandidatenmodelle werden in aufsteigender Reihenfolge nach AIC zurückgegeben. Das Modell in der ersten Zeile hat den niedrigsten AIC und gilt als bestes Modell. Das beste Modell wird als endgültiges Modell gespeichert und verwendet, wenn Sie Funktionen wieML.FORECAST
für das Modell aufrufen.Die Spalte
seasonal_periods
enthält Informationen zum saisonalen Muster, das in den Zeitachsendaten ermittelt wurde. Es hat nichts mit der ARIMA-Modellierung zu tun und hat daher in allen Ausgabezeilen denselben Wert. Es wird ein Wochenmuster gemeldet, das mit den Ergebnissen übereinstimmt, die Sie gesehen haben, wenn Sie die Eingabedaten visualisiert haben.Die Spalten
has_holiday_effect
,has_spikes_and_dips
undhas_step_changes
enthalten Informationen zu den Eingabezeitreihendaten und stehen nicht im Zusammenhang mit der ARIMA-Modellierung. Diese Spalten werden zurückgegeben, weil der Wert der Optiondecompose_time_series
in der AnweisungCREATE MODEL
TRUE
ist. Diese Spalten haben auch in allen Ausgabezeilen dieselben Werte.In der Spalte
error_message
werden alle Fehler angezeigt, die während derauto.ARIMA
-Anpassung aufgetreten sind. Ein möglicher Grund für Fehler ist, dass die ausgewählten Spaltennon_seasonal_p
,non_seasonal_d
,non_seasonal_q
undhas_drift
die Zeitachse nicht stabilisieren können. Legen Sie beim Erstellen des Modells die Optionshow_all_candidate_models
aufTRUE
fest, um die Fehlermeldung aller Kandidatenmodelle abzurufen.Weitere Informationen zu den Ausgabespalten finden Sie unter
ML.ARIMA_EVALUATE
-Funktion.
Koeffizienten des Modells prüfen
Prüfen Sie die Koeffizienten des Zeitachsenmodells mit der Funktion ML.ARIMA_COEFFICIENTS
.
So rufen Sie die Koeffizienten des Modells ab:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
SELECT * FROM ML.ARIMA_COEFFICIENTS(MODEL `bqml_tutorial.seattle_pm25_xreg_model`);
Die Antwort sollte in etwa so aussehen:
In der Ausgabespalte
ar_coefficients
werden die Modellkoeffizienten des autoregressiven (AR) Teils des ARIMA-Modells angezeigt. Entsprechend zeigt die Ausgabespaltema_coefficients
die Modellkoeffizienten des gleitenden Durchschnitts (Moving Average, MA) des ARIMA-Modells an. Beide Spalten enthalten Array-Werte, deren Längenon_seasonal_p
bzw.non_seasonal_q
entspricht. In der Ausgabe der FunktionML.ARIMA_EVALUATE
haben Sie gesehen, dass das beste Modell einennon_seasonal_p
-Wert von0
und einennon_seasonal_q
-Wert von5
hat. Daher ist imML.ARIMA_COEFFICIENTS
-Ergebnis derar_coefficients
-Wert ein leeres Array und derma_coefficients
-Wert ein Array mit fünf Elementen. Der Wert fürintercept_or_drift
ist der konstante Begriff im ARIMA-Modell.In den Ausgabespalten
processed_input
,weight
undcategory_weights
werden die Gewichte für jedes Feature und der Achsenabschnitt im linearen Regressionsmodell angezeigt. Wenn es sich um ein numerisches Feature handelt, wird die Gewichtung in der Spalteweight
angezeigt. Wenn es sich bei dem Feature um ein kategorisches Feature handelt, ist der Wertcategory_weights
ein Array von Strukturwerten, wobei jeder Strukturwert den Namen und die Gewichtung einer bestimmten Kategorie enthält.Weitere Informationen zu den Ausgabespalten finden Sie unter
ML.ARIMA_COEFFICIENTS
-Funktion.
Modell zum Vorhersagen von Daten verwenden
Mit der Funktion ML.FORECAST
können Sie zukünftige Zeitachsenwerte prognostizieren.
In der folgenden GoogleSQL-Abfrage gibt die STRUCT(30 AS horizon, 0.8 AS confidence_level)
-Klausel an, dass die Abfrage 30 zukünftige Zeitpunkte prognostiziert und ein Vorhersageintervall mit einem Konfidenzniveau von 80 % generiert.
So prognostizieren Sie Daten mit dem Modell:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
SELECT * FROM ML.FORECAST( MODEL `bqml_tutorial.seattle_pm25_xreg_model`, STRUCT(30 AS horizon, 0.8 AS confidence_level), ( SELECT date, temperature, wind_speed FROM `bqml_tutorial.seattle_air_quality_daily` WHERE date > DATE('2020-12-31') ));
Die Antwort sollte in etwa so aussehen:
Die Ausgabezeilen sind in chronologischer Reihenfolge nach dem Wert der Spalte
forecast_timestamp
sortiert. In der Zeitachsenprognose ist das Vorhersageintervall, das durch die Spaltenwerteprediction_interval_lower_bound
undprediction_interval_upper_bound
dargestellt wird, genauso wichtig wie der Spaltenwertforecast_value
. Derforecast_value
-Wert ist der Mittelpunkt des Vorhersageintervalls. Das Vorhersageintervall hängt von den Spaltenwertenstandard_error
undconfidence_level
ab.Weitere Informationen zu den Ausgabespalten finden Sie unter
ML.FORECAST
-Funktion.
Prognosegenauigkeit bewerten
Bewerten Sie die Prognosegenauigkeit des Modells mit der Funktion ML.EVALUATE
.
In der folgenden GoogleSQL-Abfrage enthält die zweite SELECT
-Anweisung die Daten mit den zukünftigen Features, die für die Prognose der zukünftigen Werte verwendet werden, um sie mit den tatsächlichen Daten zu vergleichen.
So bewerten Sie die Genauigkeit des Modells:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
SELECT * FROM ML.EVALUATE( MODEL `bqml_tutorial.seattle_pm25_xreg_model`, ( SELECT date, pm25, temperature, wind_speed FROM `bqml_tutorial.seattle_air_quality_daily` WHERE date > DATE('2020-12-31') ), STRUCT( TRUE AS perform_aggregation, 30 AS horizon));
Die Ergebnisse sollten in etwa so aussehen:
Weitere Informationen zu den Ausgabespalten finden Sie unter
ML.EVALUATE
-Funktion.
Prognoseergebnisse erklären
Mit der Funktion ML.EXPLAIN_FORECAST
können Sie neben Prognosedaten auch Messwerte zur Erklärbarkeit abrufen. Die Funktion ML.EXPLAIN_FORECAST
prognostiziert zukünftige Zeitreihenwerte und gibt auch alle separaten Komponenten der Zeitreihe zurück.
Ähnlich wie bei der Funktion ML.FORECAST
gibt die in der Funktion ML.EXPLAIN_FORECAST
verwendete Klausel STRUCT(30 AS horizon, 0.8 AS confidence_level)
an, dass die Abfrage 30 zukünftige Zeitpunkte prognostiziert und ein Vorhersageintervall mit einer Konfidenz von 80% generiert.
So erklären Sie die Ergebnisse des Modells:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Fügen Sie die folgende Abfrage in den Abfrageeditor ein und klicken Sie auf Ausführen:
SELECT * FROM ML.EXPLAIN_FORECAST( MODEL `bqml_tutorial.seattle_pm25_xreg_model`, STRUCT(30 AS horizon, 0.8 AS confidence_level), ( SELECT date, temperature, wind_speed FROM `bqml_tutorial.seattle_air_quality_daily` WHERE date > DATE('2020-12-31') ));
Die Antwort sollte in etwa so aussehen:
Die Ausgabezeilen werden chronologisch nach dem Spaltenwert
time_series_timestamp
sortiert.Weitere Informationen zu den Ausgabespalten finden Sie unter
ML.EXPLAIN_FORECAST
-Funktion.