Notebooks verwalten

In diesem Dokument wird beschrieben, wie Sie Colab Enterprise-Notebooks in BigQuery verwalten, einschließlich der Anzeige, des Vergleichs, der Wiederherstellung, der Planung und des Löschens von Notebooks.

Notebooks sind BigQuery Studio-Code-Assets, die auf Dataform basieren.

Sie müssen zuerst BigQuery Studio für die Asset-Verwaltung aktivieren, um Notebooks verwenden zu können.

Erforderliche Berechtigungen

Zum Freigeben von Notebooks benötigen Sie die folgenden IAM-Rollen (Identity and Access Management):

• BigQuery-Jobnutzer(roles/bigquery.jobUser)
• BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser)
• Code-Inhaber (roles/dataform.codeOwner) auf Ressourcenebene.

Zum Speichern und Löschen von Notebooks benötigen Sie die folgenden IAM-Rollen:

• BigQuery-Jobnutzer(roles/bigquery.jobUser)
• BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser)
• Code-Inhaber (roles/dataform.codeOwner) oder Code-Editor (roles/dataform.codeEditor)

Für die Arbeit mit Notebooküberarbeitungen benötigen Sie die folgenden IAM-Rollen:

• BigQuery-Jobnutzer(roles/bigquery.jobUser)
• BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser)

• Eine der folgenden Rollen:

  • Code-Inhaber (roles/dataform.codeOwner)
  • Code Editor (roles/dataform.codeEditor)
  • Code Viewer (roles/dataform.codeViewer)

Zum Erstellen von Notebook-Zeitplänen (Vorabversion) benötigen Sie die folgenden Rollen:

• Dataform Admin (roles/dataform.admin)
• BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser) oder BigQuery Studio-Nutzer (roles/bigquery.studioUser)

Zum Bearbeiten von Notebookzeitplänen (Vorschau) benötigen Sie die Rolle Dataform-Bearbeiter (roles/dataform.editor).

Zum Aufrufen von Notebookzeitplänen (Vorschau) benötigen Sie die Rolle Dataform-Betrachter (roles/dataform.viewer).

Weitere Informationen zu BigQuery IAM finden Sie unter Zugriffssteuerung mit IAM.

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.

Wichtig: Nutzer, die Zugriff auf das Notebook haben, können die gesamte, von Code im Notebook generierte Ausgabe sehen, auch wenn diese Ausgabe Daten aus Tabellen enthält, auf die keinen Zugriff haben. Deaktivieren Sie das Speichern der Notebookausgabe, um zu verhindern, dass die gespeicherte Ausgabe freigegeben wird.

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Suchen Sie das Notebook, auf das Sie Zugriff gewähren möchten.

3. Klicken Sie neben dem Notebook auf Aktionen ansehen und dann auf Freigeben > Berechtigungen verwalten.

4. Klicken Sie im Bereich Berechtigungen verwalten auf Nutzer/Gruppe hinzufügen.

5. Geben Sie im Feld Neue Hauptkonten ein Hauptkonto ein.

6. 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.
   Hinweis: Das Hauptkonto muss zum Ausführen des Notebooks auch über die Rollen Notebook-Laufzeitnutzer (roles/aiplatform.notebookRuntimeUser) und BigQuery-Nutzer (roles/bigquery.user) verfügen.

7. Optional: Klicken Sie auf Erweiterte Freigabe, um eine vollständige Liste der Rollen und erweiterten Freigabeeinstellungen aufzurufen.

8. Klicken Sie auf Speichern.

9. 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.

Wichtig: Nutzer, die Zugriff auf das Notebook haben, können die gesamte, von Code im Notebook generierte Ausgabe sehen, auch wenn diese Ausgabe Daten aus Tabellen enthält, auf die keinen Zugriff haben. Deaktivieren Sie das Speichern der Notebookausgabe, um zu verhindern, dass die gespeicherte Ausgabe freigegeben wird.

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Suchen Sie den Ordner, den Sie umbenennen möchten.

3. Klicken Sie neben dem Notebook auf Aktionen ansehen und dann auf Freigeben > Link kopieren.

4. Geben Sie den Link für andere Nutzer frei.

Alle Notebooks ansehen

So rufen Sie eine Liste aller Notebooks in Ihrem Projekt auf:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Klicken Sie im Bereich Explorer neben Notebooks auf Aktionen anzeigen und führen Sie einen der folgenden Schritte aus:

• Wenn Sie die Liste im aktuellen Tab öffnen möchten, klicken Sie auf Alle anzeigen.
• Wenn Sie die Liste in einem neuen Tab öffnen möchten, klicken Sie auf Alle anzeigen in > Neuer Tab.
• Wenn Sie die Liste in einem geteilten Tab öffnen möchten, klicken Sie auf Alle anzeigen in > Tab aufteilen.

Notebook-Metadaten ansehen

So rufen Sie die Notebook-Metadaten auf:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des Notebooks, für das Sie Metadaten aufrufen möchten.

3. Im Bereich Zusammenfassung finden Sie Informationen zum Notebook, z. B. die Region, die es für Daten verwendet, und das Datum, an dem es zuletzt geändert wurde.

Mit Notebook-Versionen arbeiten

In den folgenden Abschnitten erfahren Sie, wie Sie Versionen eines Notebooks aufrufen, vergleichen und wiederherstellen.

Notebook-Versionen ansehen

So rufen Sie Notebook-Versionen auf:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des Notebooks, für das Sie Aktivitäten aufrufen möchten.

3. Klicken Sie auf den Tab Aktivität, um eine Liste der Notebookversionen in absteigender Reihenfolge nach Datum aufzurufen.

Notebook-Versionen vergleichen

Um Notebook-Versionen zu vergleichen, führen Sie folgende Schritte aus.:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des Notebooks, für das Sie die Versionsinformationen vergleichen möchten.

3. Klicken Sie auf dem Tab Aktivität neben einer Notebook-Version auf Aktionen ansehen und dann auf Vergleichen. Der Vergleichsbereich wird geöffnet und die ausgewählte Notebookversion wird mit der aktuellen Notebookversion verglichen.

4. Optional: Wenn Sie die Versionen inline und nicht in separaten Bereichen vergleichen möchten, klicken Sie auf Vergleichen und dann auf Inline.

5. Optional: Wenn Sie den Quellcode der Versionen vergleichen möchten, klicken Sie auf Vergleichen und dann auf Rohquelle anzeigen.

6. Optional: Wenn Sie die Befehlsausgabe im Notebook ausblenden möchten, klicken Sie auf Vergleichen und entfernen Sie dann das Häkchen bei Ausgabe anzeigen.

Notebook-Version wiederherstellen

Verwenden Sie eine der folgenden Optionen, um eine Notebook-Version wiederherzustellen. Wenn Sie über den Vergleichsbereich wiederherstellen, können Sie die aktuelle und die vorherige Version des Notebooks vergleichen, bevor Sie die vorherige Version wiederherstellen. Beim Wiederherstellen eines Notebooks wird eine neue Version des Notebooks erstellt, anstatt die aktuelle Version zu überschreiben. Der Versionsverlauf geht nicht verloren.

Aktivitätsbereich

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des Notebooks, von dem Sie eine vorherige Version wiederherstellen möchten.

3. Wählen Sie den Bereich Aktivität aus.

4. Klicken Sie neben der Version des Notebooks, die Sie wiederherstellen möchten, auf Aktionen ansehen und dann auf Wiederherstellen.

5. Klicken Sie auf Bestätigen.

Vergleichsbereich

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des Notebooks, von dem Sie eine vorherige Version wiederherstellen möchten.

3. Wählen Sie den Bereich Aktivität aus.

4. Klicken Sie neben einer Notebook-Version auf Aktionen ansehen und dann auf Vergleichen. Der Vergleichsbereich wird geöffnet und die ausgewählte Notebookversion wird mit der neuesten Notebookversion verglichen.

5. Wenn Sie nach dem Vergleich die vorherige Notebookversion wiederherstellen möchten, klicken Sie auf Wiederherstellen.

6. Klicken Sie auf Bestätigen.

Notebook herunterladen

So laden Sie ein Notebook herunter:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des Notebooks, das Sie herunterladen möchten.

3. Klicken Sie auf Herunterladen.

Notebooks planen

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Wenn Sie Feedback zur Notebookplanung geben möchten, senden Sie eine E-Mail an [e-mail].

Sie können ein Notebook für die automatische Ausführung zu einer bestimmten Zeit und Häufigkeit planen, um beispielsweise ein ML-Modell zu trainieren, externe APIs aufzurufen oder BigQuery DataFrames-Code auszuführen.

Änderungen, die Sie an einem Notebook vornehmen, werden automatisch gespeichert, sind jedoch nur für Sie und Nutzer verfügbar, die Zugriff auf das Notebook haben. Wenn Sie den Zeitplan mit einer neuen Version des Notebooks aktualisieren möchten, müssen Sie das Notebook bereitstellen. Durch die Bereitstellung eines Notebooks aktualisieren Sie den Zeitplan mit der aktuellen Version des Notebooks. Zeitpläne führen die zuletzt bereitgestellte Version des Notebooks aus.

Jeder Notebookzeitplan wird von einem benutzerdefinierten Dataform-Dienstkonto ausgeführt, das Sie während der Zeitplanerstellung auswählen. Weitere Informationen zu den Arten von Dienstkonten in Dataform finden Sie unter Dienstkonten in Dataform.

Dataform schreibt die Ausgabe geplanter Notebookausführungen in den Cloud Storage-Bucket, der bei der Zeitplanerstellung ausgewählt wurde.

Notebook-Zeitpläne verwenden eine Standard-E2-Laufzeit. Es gelten die Laufzeitgebühren von Colab Enterprise. Die Kosten für die Laufzeitverarbeitung richten sich nach dem E2-Maschinentyp. Informationen zu den Preisen der Standard-E2-Laufzeiten finden Sie unter Colab Enterprise-Preise.

Notebookzeitplan aktivieren

Wenn Sie Notebooks planen möchten, müssen Sie dem benutzerdefinierten Dataform-Dienstkonto, das Sie für Notebook-Zeitpläne verwenden möchten, die folgenden Rollen zuweisen:

Notebook Executor User (roles/aiplatform.notebookExecutorUser)

Folgen Sie der Anleitung Eine Rolle für ein Projekt zuweisen, um Ihrem benutzerdefinierten Dataform-Dienstkonto im ausgewählten Projekt die Rolle "Notebook-Executor-Nutzer" zuzuweisen.

Storage-Administrator (roles/storage.admin)

Folgen Sie der Anleitung unter Hauptkonto zu einer Richtlinie auf Bucket-Ebene hinzufügen, um Ihrem benutzerdefinierten Dataform-Dienstkonto die Rolle „Storage Admin“ zuzuweisen und es als Hauptkonto dem Cloud Storage-Bucket hinzuzufügen, in dem Sie die Ausgabe geplanter Notebookausführungen speichern möchten.

Service Account User (roles/iam.serviceAccountUser)

Folgen Sie der Anleitung unter Einer einzelnen Rolle ein Dienstkonto zuweisen, um Ihrem benutzerdefinierten Dataform-Dienstkonto selbst die Rolle „Hauptkonto“ zuzuweisen. Mit anderen Worten, fügen Sie das benutzerdefinierte Dataform-Dienstkonto als Hauptkonto demselben benutzerdefinierten Dataform-Dienstkonto hinzu. Weisen Sie diesem Hauptkonto dann die Rolle „Dienstkontonutzer“ zu.

Außerdem müssen Sie dem Dataform-Standarddienstkonto die folgende Rolle zuweisen:

Service Account Token Creator(roles/iam.serviceAccountTokenCreator)

Folgen Sie Zugriff auf die Tokenerstellung für ein benutzerdefiniertes Dataform-Dienstkonto, um dem standardmäßigen Dataform-Dienstkonto ein Hauptkonto für Ihr benutzerdefiniertes Dataform-Dienstkonto hinzuzufügen und diesem Hauptkonto die Rolle „Service Account Token Creator“ zuzuweisen.

Weitere Informationen zu Dienstkonten in Dataform finden Sie unter Dienstkonten in Dataform.

Zeitplan erstellen

Zum Löschen eines Notebooks führen Sie diese Schritte aus:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des Notebooks, das Sie herunterladen möchten.

3. Klicken Sie auf Planen.

4. Geben Sie im Bereich Notebook planen im Feld Name des Zeitplans einen Namen für den Zeitplan ein.

5. Wählen Sie im Feld Laufzeitvorlage eine Laufzeit aus.

6. Wählen Sie im Feld Dienstkonto ein benutzerdefiniertes Dataform-Dienstkonto aus.

7. Klicken Sie im Feld Cloud Storage-Bucket auf Durchsuchen und wählen Sie einen Cloud Storage-Bucket aus oder erstellen Sie einen.

   Dem ausgewählten benutzerdefinierten Dataform-Dienstkonto muss die IAM-Rolle „Storage Admin“ für den ausgewählten Bucket zugewiesen sein. Weitere Informationen finden Sie unter Notebook-Planung aktivieren.

8. Führen Sie im Abschnitt Planungshäufigkeit folgende Schritte aus:

   1. Wählen Sie im Drop-down-Menü Wiederholungen die Häufigkeit der geplanten Notebookausführungen aus.
   2. Geben Sie im Feld Um die Zeit für geplante Notebookausführungen ein.
   3. Wählen Sie im Drop-down-Menü Zeitzone die Zeitzone für den Zeitplan aus.

9. Klicken Sie auf Zeitplan erstellen.

Beim Erstellen des Zeitplans wird die aktuelle Version des Notebooks automatisch bereitgestellt. Wenn Sie den Zeitplan mit einer neuen Version des Notebooks aktualisieren möchten, implementieren Sie das Notebook.

Die zuletzt bereitgestellte Version des Notebooks wird zum ausgewählten Zeitpunkt und mit der ausgewählten Häufigkeit ausgeführt.

Notebook bereitstellen

Beim Bereitstellen eines Notebooks wird der Zeitplan mit der aktuellen Version des Notebooks aktualisiert. Zeitpläne führen die zuletzt bereitgestellte Version des Notebooks aus.

So stellen Sie ein Notebook bereit:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des ausgewählten Notizbuchs.

3. Klicken Sie auf Bereitstellen.

Der entsprechende Zeitplan wird mit der aktuellen Version des Notebooks aktualisiert. Die neueste bereitgestellte Version des Notebooks wird zum geplanten Zeitpunkt ausgeführt.

Zeitplandetails ansehen

So rufen Sie Zeitplandetails für ein ausgewähltes Notebook auf:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des ausgewählten Notizbuchs.

3. Klicken Sie auf Zeitplan ansehen.

Bisherige Ausführungen ansehen

So rufen Sie die bisherigen Ausführungen eines ausgewählten Notebook-Zeitplans auf:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des ausgewählten Notizbuchs.

3. Klicken Sie auf Zeitplan ansehen und dann auf Frühere Ausführungen ansehen.

Zeitplan deaktivieren

Wenn Sie geplante Ausführungen eines ausgewählten Notebooks pausieren möchten, ohne den Zeitplan zu löschen, können Sie den Zeitplan deaktivieren.

So deaktivieren Sie einen Zeitplan für ein ausgewähltes Notebook:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des ausgewählten Notizbuchs.

3. Klicken Sie auf Zeitplan ansehen.

4. Klicken Sie in der Tabelle mit den Zeitplandetails in der Zeile Zeitplanstatus auf die Ein/Aus-Schaltfläche Zeitplan ist aktiviert.

Zeitplan aktivieren

So nehmen Sie geplante Ausführungen eines deaktivierten Zeitplans wieder auf:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des ausgewählten Notizbuchs.

3. Klicken Sie auf Zeitplan ansehen.

4. Klicken Sie in der Tabelle mit den Zeitplandetails in der Zeile Zeitplanstatus auf die Ein/Aus-Schaltfläche Zeitplan deaktiviert.

Zeitplan bearbeiten

So bearbeiten Sie einen Zeitplan:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Klicken Sie auf den Namen des ausgewählten Notizbuchs.

3. Klicken Sie auf Zeitplan ansehen und dann auf Bearbeiten.

4. Bearbeiten Sie im Dialogfeld Notebook planen den Zeitplan und klicken Sie dann auf Zeitplan aktualisieren.

Alle Zeitpläne ansehen

So rufen Sie alle Notebook-Zeitpläne in Ihrem Projekt auf:

1. Rufen Sie in der Google Cloud Console die Seite Orchestrierung auf.

   Zur Seite Orchestrierung

2. Optional: Klicken Sie auf den Namen des Zeitplans, um Details zu einem ausgewählten Zeitplan und seinen bisherigen Ausführungen aufzurufen.

Zeitplan löschen

So löschen Sie einen Zeitplan für ein ausgewähltes Notebook endgültig:

1. Rufen Sie in der Google Cloud Console die Seite Orchestrierung auf.

   Zur Seite Orchestrierung

2. Wählen Sie in der Liste aller Zeitpläne die Zeile mit dem Zeitplan aus, den Sie löschen möchten.

3. Optional: Wenn Sie mehrere Zeitpläne gleichzeitig löschen möchten, wählen Sie mehrere Zeilen aus.

4. Klicken Sie auf Löschen.

5. Klicken Sie im angezeigten Dialogfeld auf Löschen.

Notebooks löschen

Zum Löschen eines Notebooks führen Sie diese Schritte aus:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks und gegebenenfalls den Ordner Freigegebene Notebooks. Suchen Sie den Ordner, den Sie löschen möchten.

3. Klicken Sie neben dem Notebook auf Aktionen ansehen und dann auf Löschen.

4. Geben Sie delete in das Dialogfeld ein, um den Löschvorgang zu bestätigen.

5. Klicken Sie auf Löschen.

Fehlerbehebung

Weitere Informationen finden Sie unter Fehlerbehebung bei Colab Enterprise.

Nächste Schritte

• Weitere Informationen zu Colab Enterprise-Notebooks in BigQuery
• Notebooks erstellen