Notebooks verwalten

Hinweis: BigQuery Studio-Notebooks sind ab dem 11. April 2024 allgemein verfügbar. Auf Ihrer Rechnung werden nun nutzungsbasierte Gebühren für BigQuery Studio-Notebooks angezeigt.

In diesem Dokument wird beschrieben, wie Sie Colab Enterprise-Notebooks in BigQuery verwalten. 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.

Wichtig: Im März 2024 werden APIs, die BigQuery Studio-Funktionen unterstützen, automatisch für alle BigQuery-Projekte aktiviert. Weitere Informationen finden Sie unter BigQuery Studio APIs automatisch aktivieren.

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-Betrachter (roles/dataform.codeViewer)

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 ansehen, 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 Notebook-Versionen 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.

4. Wählen Sie im Bereich Überarbeitungsverlauf mithilfe der Drop-down-Menüs Version Versionen aus, die verglichen werden sollen.

5. Optional: Klicken Sie das Kästchen Rohquelle an, um den Notebook-Quellcode zu vergleichen.

6. Optional: Klicken Sie das Kästchen Inline-Unterschiede an, um die Versionen inline und nicht in separaten Bereichen zu vergleichen.

7. Optional: Entfernen Sie das Häkchen bei Ausgabe anzeigen, um die Befehlsausgabe im Notebook auszublenden.

Notebook-Version wiederherstellen

Verwenden Sie eine der folgenden Optionen, um eine Notebook-Version wiederherzustellen. Durch die Wiederherstellung im Bereich Überarbeitungsverlauf können Sie die aktuelle und vorherige Version des Notebooks vergleichen, bevor Sie die vorherige Version wiederherstellen. Durch die Wiederherstellung eines Notebooks wird eine neue Version eines Notebooks erstellt, anstatt die aktuelle Version zu überschreiben. Es wird kein Versionsverlauf gelöscht.

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 frühere 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.

Überarbeitungsverlauf

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 frühere 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.

5. Klicken Sie im Bereich Überarbeitungsverlauf neben dem Drop-down-Menü Version auf Aktionen ansehen und dann auf Überarbeitung 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 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 im Dialogfeld delete 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