Notebooks erstellen
In diesem Dokument wird beschrieben, wie Sie Colab Enterprise-Notebooks in BigQuery erstellen. Notebooks sind BigQuery Studio-Code-Assets, die auf Dataform basieren.
Hinweise
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Enable the BigQuery API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Enable the BigQuery API.
BigQuery Studio aktivieren
Folgen Sie der Anleitung unter BigQuery Studio für die Asset-Verwaltung aktivieren, um Versionen von Code-Assets wie z. B. Notebooks zu speichern, freizugeben und zu verwalten.
Erforderliche Berechtigungen
Legen Sie die entsprechenden Berechtigungen zum Erstellen, Bearbeiten oder Anzeigen von Notebooks fest.
Alle Nutzer mit der Rolle „Dataform-Administrator“ (roles/dataform.admin
) haben Inhaberzugriff auf alle im Projekt erstellten Notebooks.
Weitere Informationen zu BigQuery Identity and Access Management (IAM) finden Sie unter Zugriffssteuerung mit IAM.
Berechtigungen zum Erstellen von Notebooks
Zum Erstellen und Ausführen von Notebooks benötigen Sie folgende IAM-Berechtigungen:
resourcemanager.projects.get
resourcemanager.projects.list
bigquery.config.get
bigquery.jobs.create
bigquery.readsessions.create
bigquery.readsessions.getData
bigquery.readsessions.update
resourcemanager.projects.get
resourcemanager.projects.list
dataform.locations.get
dataform.locations.list
dataform.repositories.create
dataform.repositories.list
dataform.collections.create
dataform.collections.list
aiplatform.notebookRuntimeTemplates.apply
aiplatform.notebookRuntimeTemplates.get
aiplatform.notebookRuntimeTemplates.list
aiplatform.notebookRuntimeTemplates.getIamPolicy
aiplatform.notebookRuntimes.assign
aiplatform.notebookRuntimes.get
aiplatform.notebookRuntimes.list
aiplatform.operations.list
Sie können diese Berechtigungen über die folgenden IAM-Rollen abrufen:
- BigQuery Read Session-Nutzer (
roles/bigquery.readSessionUser
) BigQuery Studio Nutzer (
roles/bigquery.studioUser
)Die Rolle „BigQuery Studio-Nutzer“ kombiniert die folgenden IAM-Rollen:
Berechtigungen zum Bearbeiten von Notebooks
Zum Bearbeiten und Ausführen von Notebooks benötigen Sie die folgenden IAM-Rollen:
- BigQuery-Jobnutzer(
roles/bigquery.jobUser
) - BigQuery Read Session-Nutzer (
roles/bigquery.readSessionUser
) - Notebook Runtime-Nutzer (
roles/aiplatform.notebookRuntimeUser
) - Code Editor (
roles/dataform.codeEditor
)
Berechtigungen zum Anzeigen von Notebooks
Zum Aufrufen und Ausführen von Notebooks benötigen Sie die folgenden IAM-Rollen:
- BigQuery-Jobnutzer(
roles/bigquery.jobUser
) - BigQuery Read Session-Nutzer (
roles/bigquery.readSessionUser
) - Notebook Runtime-Nutzer (
roles/aiplatform.notebookRuntimeUser
) - Code Viewer (
roles/dataform.codeViewer
)
Notebooks erstellen
In den folgenden Abschnitten erfahren Sie, wie Sie ein Notebook erstellen.
Standardregion für Code-Assets festlegen
Wenn Sie zum ersten Mal ein Code-Asset erstellen, legen Sie die Standardregion für Code-Assets fest. Sie können die Region für ein Code-Asset nicht mehr ändern, nachdem es erstellt wurde.
Notebook aus dem BigQuery-Editor erstellen
So erstellen Sie ein Notebook, das eine Standardabfrage für eine bestimmte Tabelle enthält:
Rufen Sie die Seite BigQuery auf.
Klicken Sie in der Tableiste des Editorbereichs auf den
Drop-down-Pfeil neben dem +-Zeichen und dann auf Python-Notebook erstellen:Das neue Notebook wird geöffnet und enthält Zellen, die Beispielabfragen für das öffentliche Dataset
bigquery-public-data.ml_datasets.penguins
zeigen.
Notebook aus einer Tabelle erstellen
So erstellen Sie ein Notebook, das eine Standardabfrage für eine bestimmte Tabelle enthält:
Rufen Sie die Seite BigQuery auf.
Maximieren Sie im Bereich Explorer Ihr Projekt und suchen Sie die Tabelle, die Sie abfragen möchten.
Klicken Sie neben der Tabelle auf > Python-Notebook.
Aktionen ansehen und dann auf Abfrage inDas neue Notebook wird geöffnet, das Zellen enthält, die Beispielabfragen für die ausgewählte Tabelle enthalten.
Ein Notebook erstellen, um die Ergebnismenge einer Abfrage zu untersuchen
So erstellen Sie ein Notebook, um die Ergebnismenge einer Abfrage zu untersuchen:
Rufen Sie die Seite BigQuery auf.
Führen Sie im Editorbereich eine Abfrage aus, die ein Abfrageergebnis generiert.
Klicken Sie im Bereich Abfrageergebnisse auf Daten auswerten und dann auf Mit Python-Notebook auswerten.
Das neue Notebook wird geöffnet. Es enthält Zellen mit Code, um das Abfrage-SQL und die Abfrageergebnisse zurückzugeben.
Notebook aus einem vorhandenen Notebook erstellen
So öffnen Sie eine beliebige Version eines vorhandenen Notebooks als neues Notebook:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und gegebenenfalls den Ordner Explorer. Wählen Sie ein Notebook aus.
Wählen Sie den Bereich Aktivität aus.
Klicken Sie neben einer Notebookversion auf
Aktionen ansehen und dann auf Als neues Python-Notebook öffnen.Eine Kopie des Notebooks wird als neues Notebook geöffnet.
Notebooks hochladen
Sie können ein lokales Notebook hochladen, um es in BigQuery Studio zu verwenden. Das hochgeladene Notebook ist dann auch auf der BigQuery-Seite der Google Cloud Console sichtbar.
So aktualisieren Sie ein Notebook:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und führen Sie dann einen der folgenden Schritte aus:
- Klicken Sie neben Notebooks auf > In Notebooks hochladen. Aktionen ansehen
- Klicken Sie neben dem Namen des Google Cloud-Projekts auf > In Projekt hochladen > Python-Notebook. Aktionen ansehen
Klicken Sie im Dialogfeld Notebook hochladen im Feld Notebook auf Durchsuchen und wählen Sie das Notebook aus, das Sie hochladen möchten.
Optional: Bearbeiten Sie im Feld Notebookname den Namen des Notebooks.
Wählen Sie im Feld Region die Region aus, in die Sie Ihr Notebook hochladen möchten.
Klicken Sie auf Hochladen.
Ihr Notebook wird im Explorer-Bereich angezeigt.
Mit einer Laufzeit verbinden
In den folgenden Abschnitten erfahren Sie, wie Sie ein Notebook mit einer Vertex AI-Laufzeit verbinden. Eine Laufzeit ist eine Computing-Ressource, die den Code in Ihrem Notebook ausführt.
Weitere Informationen zu Laufzeiten finden Sie unter Laufzeiten und Laufzeitvorlagen.
Verbindung zur Standardlaufzeit herstellen
Die Standardlaufzeit ist eine voreingestellte Laufzeit, die nur minimale Einrichtung erfordert.
So stellen Sie eine Verbindung zur Standardlaufzeit her:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und gegebenenfalls den Ordner Explorer. Klicken Sie auf den Namen eines Notebooks, um es zu öffnen.
Klicken Sie im Notebook auf Verbinden oder führen Sie eine beliebige Zelle im Notebook aus.
Es kann einige Minuten dauern, bis eine Verbindung zur Standardlaufzeit hergestellt wird, wenn Sie noch keine aktive Laufzeit haben.
Verbindung zu einer nicht standardmäßigen Laufzeit herstellen
Wenn Sie eine andere Laufzeit als die Standardlaufzeit verwenden möchten, müssen Sie zuerst diese zusätzliche Laufzeit in Vertex AI erstellen.
So stellen Sie eine Verbindung zur Nicht-Standardlaufzeit her:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und gegebenenfalls den Ordner Explorer. Klicken Sie auf den Namen eines Notebooks, um es zu öffnen.
Klicken Sie im Notebook auf das
Drop-down-Menü neben Verbinden und dann auf Mit einer Laufzeit verbinden.Klicken Sie auf Mit einer vorhandenen Laufzeit verbinden.
Wählen Sie unter Laufzeiten die zu verwendende Laufzeit aus.
Klicken Sie auf Verbinden.
Mit neuer Laufzeit verbinden
So stellen Sie eine Verbindung zu einer neuen Laufzeit her:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und gegebenenfalls den Ordner Explorer. Klicken Sie auf den Namen eines Notebooks, um es zu öffnen.
Klicken Sie im Notebook auf das
Drop-down-Menü neben Verbinden und dann auf Mit einer Laufzeit verbinden.Klicken Sie auf Neue Laufzeit erstellen.
Wählen Sie unter Laufzeitvorlage die zu verwendende Vertex AI-Laufzeitvorlage aus.
Geben Sie unter Laufzeitname einen Namen für die Laufzeit ein.
Klicken Sie auf Verbinden.
Zugriff auf Notebooks gewähren
Wenn Sie anderen Nutzern Zugriff auf ein Notebook gewähren möchten, fügen Sie diese Nutzer einer entsprechenden IAM-Rolle hinzu.
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und gegebenenfalls den Ordner Explorer. Suchen Sie das Notebook, auf das Sie Zugriff gewähren möchten.
Klicken Sie neben dem Notebook auf > Berechtigungen verwalten.
Aktionen ansehen und dann auf FreigebenKlicken Sie im Bereich Berechtigungen verwalten auf Nutzer/Gruppe hinzufügen.
Geben Sie im Feld Neue Hauptkonten ein Hauptkonto ein.
Wählen Sie in der Liste Rolle eine der folgenden Rollen aus:
- Code-Inhaber: Kann alle Aktionen für das Notebook ausführen, einschließlich Löschen oder Freigeben.
- Code-Editor: Kann das Notebook bearbeiten.
- Code-Betrachter: Kann das Notebook aufrufen.
Optional: Klicken Sie auf Erweiterte Freigabe, um eine vollständige Liste der Rollen und erweiterten Freigabeeinstellungen aufzurufen.
Klicken Sie auf Speichern.
Klicken Sie auf Schließen, um zur Seite mit den Notebook-Informationen zurückzukehren.
Notebooks teilen
Wenn Sie ein Notebook für andere Nutzer freigeben möchten, können Sie einen Link zum Notebook generieren und freigeben. Damit andere Nutzer das von Ihnen freigegebene Notebook sehen können, müssen Sie zuerst den Zugriff auf das Notebook gewähren.
Zum Ausführen eines Notebooks benötigen Nutzer Zugriff auf die Daten, auf die das Notebook zugreift. Weitere Informationen finden Sie unter Zugriff auf ein Dataset gewähren.
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und gegebenenfalls den Ordner Explorer. Suchen Sie den Ordner, den Sie umbenennen möchten.
Klicken Sie neben dem Notebook auf > Link kopieren.
Aktionen ansehen und dann auf FreigebenGeben Sie den Link für andere Nutzer frei.
Speichern der Notebook-Ausgabe deaktivieren
Um die Freigabe der gespeicherten Notebookausgabe für andere Nutzer mit Zugriff auf die Notebookdatei zu verhindern, deaktivieren Sie das Speichern der Notebookausgabe.
Wenn Sie das Speichern der Ausgabe für ein ausgewähltes Notebook deaktivieren, löscht BigQuery alle in der Notebookdatei gespeicherten Ausgaben und speichert die Ausgabe der nachfolgenden Ausführungen nicht.
Nutzer mit Zugriff auf das Notebook können die Ausgabe jedoch so aufrufen:
- Führen Sie das Notebook aus, um die aktuelle Ausgabe aufzurufen. Diese Ausgabe wird nicht gespeichert.
- Sie können eine Archivversion des Notebooks und seine Ausgabe im Überarbeitungsverlauf ansehen.
So deaktivieren Sie das Speichern der Ausgabe für ein ausgewähltes Notebook:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und wählen Sie dann das Notebook aus, für das Sie das Speichern der Ausgabe deaktivieren möchten.
Klicken Sie auf > Bearbeiten > Notebook-Einstellungen.
Header-Sichtbarkeit umschaltenWählen Sie im Fenster Notebookeinstellungen die Option Codezellenausgabe beim Speichern dieses Notebooks weglassen aus.
Klicken Sie auf Speichern.
Klicken Sie auf Neu laden.
Konflikte lösen
Wenn Sie und ein anderer Nutzer in einem Notebook widersprüchliche Änderungen vornehmen, löst der Dienst den Fehler Automatic saving failed. This file was updated remotely or
in another tab.
aus und stellt den Link Show diff
bereit. So beheben Sie den Konflikt:
- Klicken Sie auf den
Show diff
-Link. Das Dialogfeld Remote-Änderungen prüfen wird geöffnet. - Optional: Klicken Sie das Kästchen Rohquelle an, um den Notebook-Quellcode zu vergleichen.
- Optional: Klicken Sie das Kästchen Inline-Unterschiede an, um die Versionen inline und nicht in separaten Bereichen zu vergleichen.
- Prüfen Sie die Änderungen und entscheiden Sie, welche beibehalten werden sollen, und überarbeiten Sie Ihre Eingabe bei Bedarf.
- Klicken Sie auf Änderungen speichern.
Notebooks umbenennen
So benennen Sie ein Notebook um:
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Explorer und gegebenenfalls den Ordner Explorer. Suchen Sie den Ordner, den Sie umbenennen möchten.
Klicken Sie neben dem Notebook auf
Aktionen ansehen und dann auf Umbenennen.Geben Sie einen Namen für das Notebook ein und klicken Sie auf Umbenennen.
Fehlerbehebung
Weitere Informationen finden Sie unter Fehlerbehebung bei Colab Enterprise.