ML-Modell in BigQuery ML mit der Cloud de Confiance -Konsole erstellen
In diesem Dokument erfahren Sie, wie Sie mit der Cloud de Confiance Console ein BigQuery ML-Modell erstellen.
Erforderliche Rollen
Zum Erstellen eines Modells und Ausführen von Inferenzen benötigen Sie die folgenden Rollen:
- BigQuery-Dateneditor (
roles/bigquery.dataEditor) - BigQuery-Nutzer (
roles/bigquery.user)
- BigQuery-Dateneditor (
Hinweis
-
Wählen Sie in der Cloud de Confiance Console auf der Seite für die Projektauswahl ein Projekt von Cloud de Confiance aus oder erstellen Sie eines.
Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts
- Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
-
Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Project Creator“ (
roles/resourcemanager.projectCreator), die die Berechtigungresourcemanager.projects.createenthält. Informationen zum Zuweisen von Rollen
-
Prüfen Sie, ob die Abrechnung für Ihr Cloud de Confiance -Projekt aktiviert ist.
-
Aktivieren Sie die BigQuery API und die BigQuery Connection API, falls sie noch nicht aktiviert sind.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen
Modellspezifische Voraussetzungen
Bevor Sie ein Modell erstellen, müssen Sie alle Voraussetzungen für den zu erstellenden Modelltyp erfüllen:
Wenn Sie eine Abfrage verwenden möchten, um Trainingsdaten für ein Modell auszuwählen, muss diese Abfrage als gespeicherte Abfrage verfügbar sein.
Für Matrixfaktorisierungsmodelle sind Reservierungen erforderlich. Weitere Informationen finden Sie unter Preise.
Für die folgenden Remote-Modelle ist eine Cloud-Ressourcenverbindung erforderlich:
- Remote-Modelle über die Gemini Enterprise Agent Platform und Partnermodelle
- Remote-Modelle über offenen Modellen
- Remote-Modelle über Cloud AI-Dienste
- Remote-Modelle im Vergleich zu benutzerdefinierten Modellen in der Gemini Enterprise Agent Platform
Dem Dienstkonto der Verbindung müssen je nach Typ des Remote-Modells auch bestimmte Rollen zugewiesen werden.
Wenn Sie ein Modell importieren möchten, müssen Sie es in einen Cloud Storage-Bucket hochladen.
Dataset erstellen
Erstellen Sie ein BigQuery-Dataset, das Ihre Ressourcen enthalten soll:
Console
Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.
Klicken Sie im linken Bereich auf Explorer:

Wenn der linke Bereich nicht angezeigt wird, klicken Sie auf Linken Bereich maximieren, um ihn zu öffnen.
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 einen Namen für das Dataset ein.
Wählen Sie unter Standorttyp die Option Region oder Multiregional aus.
- Wenn Sie Region ausgewählt haben, wählen Sie einen Standort aus der Liste Region aus.
- Wenn Sie Multiregional ausgewählt haben, wählen Sie in der Liste Multiregional die Option USA oder Europa aus.
Klicken Sie auf Dataset erstellen.
bq
Wenn Sie ein neues Dataset erstellen möchten, verwenden Sie den Befehl
bq mkmit dem Flag--location:bq --location=LOCATION mk -d DATASET_ID
Ersetzen Sie Folgendes:
LOCATION: Speicherort des Datasets.DATASET_ID: die ID des zu erstellenden Datasets.
Prüfen Sie, ob das Dataset erstellt wurde:
bq ls
Intern oder extern trainiertes Modell erstellen
Mit diesem Verfahren können Sie die folgenden Modelltypen erstellen:
Zeitreihenmodelle:
Beitragsanalyse: Beitragsanalyse
Klassifizierung:
Regression:
Clustering: K-Means
Empfehlung: Matrixfaktorisierung
Dimensionalitätsreduktion:
Diese Modelle haben je nach Typ unterschiedliche Optionen. Die automatische Abstimmung von BigQuery ML funktioniert in den meisten Fällen gut. Sie können Ihr Modell aber auch manuell abstimmen. Wenn Sie dies tun möchten, finden Sie in der Dokumentation für den jeweiligen Modelltyp weitere Informationen zu den Modelloptionen.
So erstellen Sie ein Modell:
Rufen Sie die Seite BigQuery auf.
Klicken Sie im linken Bereich auf Explorer:

Wenn der linke Bereich nicht angezeigt wird, klicken Sie auf Linken Bereich maximieren, um ihn zu öffnen.
Klicken Sie im Bereich Explorer auf Datasets und dann auf das von Ihnen erstellte Dataset.
Klicken Sie neben dem Dataset auf Aktionen ansehen und dann auf BQML-Modell erstellen.
Der Bereich Neues Modell erstellen wird geöffnet.
Geben Sie unter Modellname einen Namen für das Modell ein.
Wenn Sie eine gespeicherte Abfrage erstellen möchten, die die
CREATE MODEL-Anweisung für das Modell enthält, wählen Sie Abfrage speichern aus.- Geben Sie unter Abfragename einen Namen für die gespeicherte Abfrage ein.
- Wählen Sie unter Region eine Region für die gespeicherte Abfrage aus.
Klicken Sie auf Weiter.
Wählen Sie im Abschnitt Erstellungsmethode die Option Modell in BigQuery trainieren aus.
Wählen Sie im Abschnitt Modellierungsziel ein Modellierungsziel für das Modell aus.
Klicken Sie auf Weiter.
Wählen Sie auf der Seite Modelloptionen einen Modelltyp aus. Welche Modelltypen Sie auswählen können, hängt vom gewählten Modellierungsziel ab.
Führen Sie im Abschnitt Trainingsdaten einen der folgenden Schritte aus:
- Wählen Sie Tabelle/Ansicht aus, um Trainingsdaten aus einer Tabelle oder Ansicht abzurufen, und wählen Sie dann das Projekt, das Dataset und den Ansichts- oder Tabellennamen aus.
- Wählen Sie Abfrage aus, um Trainingsdaten aus einer gespeicherten Abfrage abzurufen, und wählen Sie dann die gespeicherte Abfrage aus.
Wählen Sie unter Ausgewählte Eingabelabelspalten die Spalten aus der Tabelle, Ansicht oder Abfrage aus, die Sie als Eingabe für das Modell verwenden möchten.
Wenn der Abschnitt Erforderliche Optionen vorhanden ist, geben Sie die angeforderten Spalteninformationen an:
- Wählen Sie für Klassifizierungs- und Regressionsmodelle unter INPUT_LABEL_COLS die Spalte mit den Labeldaten aus.
Wählen Sie für Matrixfaktorisierungsmodelle Folgendes aus:
- Wählen Sie für RATING_COL die Spalte aus, die die Bewertungsdaten enthält.
- Wählen Sie für USER_COL die Spalte aus, die die Nutzerdaten enthält.
- Wählen Sie für ITEM_COL die Spalte aus, die die Artikeldaten enthält.
Wählen Sie für Zeitreihen-Prognosemodelle Folgendes aus:
- Wählen Sie für TIME_SERIES_TIMESTAMP_COL die Spalte aus, die die Zeitpunkte enthält, die beim Trainieren des Modells verwendet werden sollen.
- Wählen Sie für TIME_SERIES_DATA_COL die Spalte aus, die die zu prognostizierenden Daten enthält.
Optional: Geben Sie im Abschnitt Optional Werte für zusätzliche Argumente zur Modellabstimmung an. Die verfügbaren Argumente variieren je nach Typ des Modells, das Sie erstellen.
Optional: Wenn ein Abschnitt Hyperparameter-Abstimmung vorhanden ist, können Sie die Option NUM_TRIALS angeben, um die [Hyperparameter-Abstimmung](/bigquery/docs/hyperparameter-tuning-tutorial) für Ihr Modell zu aktivieren. Die für die Hyperparameter-Abstimmung verfügbaren Argumente variieren je nach Typ des Modells, das Sie erstellen.
Klicken Sie auf Modell erstellen.
Wenn die Modellerstellung abgeschlossen ist, klicken Sie auf Zum Modell, um die Modelldetails aufzurufen.
Remote-Modell über ein vortrainiertes Modell erstellen
Mit diesem Verfahren können Sie die folgenden Arten von Remote-Modellen erstellen:
So erstellen Sie ein Modell:
Rufen Sie die Seite BigQuery auf.
Klicken Sie im linken Bereich auf Explorer:

Klicken Sie im Bereich Explorer auf Datasets und dann auf das von Ihnen erstellte Dataset.
Klicken Sie neben dem Dataset auf Aktionen ansehen und dann auf BQML-Modell erstellen.
Der Bereich Neues Modell erstellen wird geöffnet.
Geben Sie unter Modellname einen Namen für das Modell ein.
Wenn Sie eine gespeicherte Abfrage erstellen möchten, die die
CREATE MODEL-Anweisung für das Modell enthält, wählen Sie Abfrage speichern aus.- Geben Sie unter Abfragename einen Namen für die gespeicherte Abfrage ein.
- Wählen Sie unter Region eine Region für die gespeicherte Abfrage aus.
Klicken Sie auf Weiter.
Wählen Sie im Abschnitt Erstellungsmethode die Option Mit Vertex AI-LLM-Dienst und Cloud AI-Diensten verbinden aus.
Wählen Sie auf der Seite Modelloptionen je nach Anwendungsfall Google- und Partnermodelle oder Offene Modelle als Modelltyp aus.
Führen Sie im Abschnitt Remote-Verbindung einen der folgenden Schritte aus:
- Wenn Sie eine Standardverbindung konfiguriert haben oder sowohl die Rolle „BigQuery Admin“ als auch die Rolle „Project IAM Admin“ haben, wählen Sie Standardverbindung aus.
Wenn Sie keine Standardverbindung konfiguriert haben oder Ihnen die entsprechenden Rollen fehlen, wählen Sie Cloud-Ressourcenverbindung aus.
- Wählen Sie unter Projekt das Projekt aus, das die Verbindung enthält, die Sie verwenden möchten.
- Wählen Sie unter Standort den von der Verbindung verwendeten Standort aus.
Wählen Sie unter Verbindung die Verbindung aus, die für das Remote-Modell verwendet werden soll, oder wählen Sie Neue Verbindung erstellen aus, um eine neue Verbindung zu erstellen.
Führen Sie im Abschnitt Erforderliche Optionen einen der folgenden Schritte aus:
- Geben Sie für Remote-Modelle über Google-Modelle und Partnermodelle den zu verwendenden Endpunkt an. Dies ist der Name des Modells, z. B.
gemini-3.5-flash. Weitere Informationen zu unterstützten Modellen finden Sie unterENDPOINT. - Kopieren Sie für Remote-Modelle über offene Modelle den zu verwendenden Endpunkt und fügen Sie ihn ein. Dies ist der freigegebene öffentliche Endpunkt eines Modells, das auf der Agent Platform bereitgestellt wurde, im Format
https://location-aiplatform.googleapis.com/v1/projects/project/locations/location/endpoints/endpoint_id. Weitere Informationen finden Sie unterENDPOINT.
- Geben Sie für Remote-Modelle über Google-Modelle und Partnermodelle den zu verwendenden Endpunkt an. Dies ist der Name des Modells, z. B.
Klicken Sie auf Modell erstellen.
Wenn die Modellerstellung abgeschlossen ist, klicken Sie auf Zum Modell, um die Modelldetails aufzurufen.
Remote-Modell über ein benutzerdefiniertes Modell erstellen
Mit diesem Verfahren können Sie Remote-Modelle über benutzerdefinierte Modelle erstellen, die auf der Gemini Enterprise Agent Platform bereitgestellt wurden.
So erstellen Sie ein Modell:
Rufen Sie die Seite BigQuery auf.
Klicken Sie im linken Bereich auf Explorer:

Klicken Sie im Bereich Explorer auf Datasets und dann auf das von Ihnen erstellte Dataset.
Klicken Sie neben dem Dataset auf Aktionen ansehen und dann auf BQML-Modell erstellen.
Der Bereich Neues Modell erstellen wird geöffnet.
Geben Sie unter Modellname einen Namen für das Modell ein.
Wenn Sie eine gespeicherte Abfrage erstellen möchten, die die
CREATE MODEL-Anweisung für das Modell enthält, wählen Sie Abfrage speichern aus.- Geben Sie unter Abfragename einen Namen für die gespeicherte Abfrage ein.
- Wählen Sie unter Region eine Region für die gespeicherte Abfrage aus.
Klicken Sie auf Weiter.
Wählen Sie im Abschnitt Erstellungsmethode die Option Mit nutzerverwalteten Vertex AI-Endpunkten verbinden aus.
Führen Sie im Abschnitt Remote-Verbindung der Seite Modelloptionen einen der folgenden Schritte aus:
- Wenn Sie eine Standardverbindung konfiguriert haben oder sowohl die Rolle „BigQuery Admin“ als auch die Rolle „Project IAM Admin“ haben, wählen Sie Standardverbindung aus.
Wenn Sie keine Standardverbindung konfiguriert haben oder Ihnen die entsprechenden Rollen fehlen, wählen Sie Cloud-Ressourcenverbindung aus.
- Wählen Sie unter Projekt das Projekt aus, das die Verbindung enthält, die Sie verwenden möchten.
- Wählen Sie unter Standort den von der Verbindung verwendeten Standort aus.
Wählen Sie unter Verbindung die Verbindung aus, die für das Remote-Modell verwendet werden soll, oder wählen Sie Neue Verbindung erstellen aus, um eine neue Verbindung zu erstellen.
Geben Sie im Abschnitt Erforderliche Optionen den zu verwendenden Endpunkt an. Dies ist der freigegebene öffentliche Endpunkt eines Modells, das auf der Agent Platform bereitgestellt wurde, im Format
https://location-aiplatform.googleapis.com/v1/projects/project/locations/location/endpoints/endpoint_id. Weitere Informationen finden Sie unter:ENDPOINT.Klicken Sie auf Modell erstellen.
Wenn die Modellerstellung abgeschlossen ist, klicken Sie auf Zum Modell, um die Modelldetails aufzurufen.
Remote-Modell über einen Cloud AI-Dienst erstellen
Mit diesem Verfahren können Sie Remote-Modelle über Cloud AI-Dienste erstellen.
So erstellen Sie ein Modell:
Rufen Sie die Seite BigQuery auf.
Klicken Sie im linken Bereich auf Explorer:

Klicken Sie im Bereich Explorer auf Datasets und dann auf das von Ihnen erstellte Dataset.
Klicken Sie neben dem Dataset auf Aktionen ansehen und dann auf BQML-Modell erstellen.
Der Bereich Neues Modell erstellen wird geöffnet.
Geben Sie unter Modellname einen Namen für das Modell ein.
Wenn Sie eine gespeicherte Abfrage erstellen möchten, die die
CREATE MODEL-Anweisung für das Modell enthält, wählen Sie Abfrage speichern aus.- Geben Sie unter Abfragename einen Namen für die gespeicherte Abfrage ein.
- Wählen Sie unter Region eine Region für die gespeicherte Abfrage aus.
Klicken Sie auf Weiter.
Wählen Sie im Abschnitt Erstellungsmethode die Option Mit Vertex AI-LLM-Dienst und Cloud AI-Diensten verbinden aus.
Wählen Sie auf der Seite Modelloptionen die Option Cloud AI-Dienste aus.
Führen Sie im Abschnitt Remote-Verbindung einen der folgenden Schritte aus:
- Wenn Sie eine Standardverbindung konfiguriert haben oder sowohl die Rolle „BigQuery Admin“ als auch die Rolle „Project IAM Admin“ haben, wählen Sie Standardverbindung aus.
Wenn Sie keine Standardverbindung konfiguriert haben oder Ihnen die entsprechenden Rollen fehlen, wählen Sie Cloud-Ressourcenverbindung aus.
- Wählen Sie unter Projekt das Projekt aus, das die Verbindung enthält, die Sie verwenden möchten.
- Wählen Sie unter Standort den von der Verbindung verwendeten Standort aus.
Wählen Sie unter Verbindung die Verbindung aus, die für das Remote-Modell verwendet werden soll, oder wählen Sie Neue Verbindung erstellen aus, um eine neue Verbindung zu erstellen.
Wählen Sie im Abschnitt Erforderliche Optionen den zu verwendenden Cloud AI-Diensttyp aus.
Geben Sie im Abschnitt Optional Informationen zum Dokumentprozessor an, wenn Sie den Dienst
CLOUD_AI_DOCUMENT_V1verwenden. Optional können Sie Informationen zur Spracherkennung angeben, wenn Sie den DienstCLOUD_AI_SPEECH_TO_TEXT_V2verwenden.Klicken Sie auf Modell erstellen.
Wenn die Modellerstellung abgeschlossen ist, klicken Sie auf Zum Modell, um die Modelldetails aufzurufen.
Importiertes Modell erstellen
Mit diesem Verfahren können Sie BigQuery ML-Modelle erstellen, indem Sie die folgenden Modelltypen importieren:
So erstellen Sie ein Modell:
Rufen Sie die Seite BigQuery auf.
Klicken Sie im linken Bereich auf Explorer:

Klicken Sie im Bereich Explorer auf Datasets und dann auf das von Ihnen erstellte Dataset.
Klicken Sie neben dem Dataset auf Aktionen ansehen und dann auf BQML-Modell erstellen.
Der Bereich Neues Modell erstellen wird geöffnet.
Geben Sie unter Modellname einen Namen für das Modell ein.
Wenn Sie eine gespeicherte Abfrage erstellen möchten, die die
CREATE MODEL-Anweisung für das Modell enthält, wählen Sie Abfrage speichern aus.- Geben Sie unter Abfragename einen Namen für die gespeicherte Abfrage ein.
- Wählen Sie unter Region eine Region für die gespeicherte Abfrage aus.
Klicken Sie auf Weiter.
Wählen Sie im Abschnitt Erstellungsmethode die Option Modell importieren aus.
Wählen Sie auf der Seite Modelloptionen den Modelltyp aus, den Sie importieren möchten.
Suchen Sie unter GCS-Pfad nach dem URI für den Cloud Storage-Bucket, der das Modell enthält, oder fügen Sie ihn ein.
Klicken Sie auf Modell erstellen.
Wenn die Modellerstellung abgeschlossen ist, klicken Sie auf Zum Modell, um die Modelldetails aufzurufen.