Gespeicherte Abfragen erstellen und verwalten

Wenn Sie gängige Datenbankvorgänge sitzungsübergreifend wiederverwenden und freigeben möchten, können Sie gespeicherte SQL-Skripts in Bigtable Studio erstellen, organisieren und verwalten. Weitere Informationen finden Sie unter Gespeicherte Abfragen – Übersicht.

Die Funktion für gespeicherte Abfragen ist nur in der Console und nicht über APIs verfügbar.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen (Identity and Access Management) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung gespeicherter Abfragen benötigen:

  • Zum Ansehen gespeicherter Abfragen: Bigtable-Leser (roles/bigtable.reader)
  • Zum Ansehen, Erstellen, Ändern und Löschen gespeicherter Abfragen: Bigtable-Nutzer (roles/bigtable.user)
  • Zum Verwalten, Ansehen, Erstellen, Ändern und Löschen gespeicherter Abfragen: Bigtable-Administrator (roles/bigtable.admin). Diese Rolle hat umfassende Berechtigungen und bietet vollständigen Zugriff auf Bigtable. Sie ist nur für Administratoren gedacht.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die für die Verwendung gespeicherter Abfragen erforderlich sind. Weitere Informationen zu den erforderlichen Berechtigungen finden Sie unter Erforderliche Berechtigungen.

Erforderliche Berechtigungen

Zum Erstellen, Aufrufen, Ändern und Löschen gespeicherter Abfragen benötigen Sie die folgenden IAM-Berechtigungen auf Projektebene:

Aktion Erforderliche IAM-Berechtigungen
Gespeicherte Abfragen erstellen
  • databasesconsole.studioQueries.create
Gespeicherte Abfragen anzeigen
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Gespeicherte Abfragen ändern
  • databasesconsole.studioQueries.update
Gespeicherte Abfragen löschen
  • databasesconsole.studioQueries.delete
Gespeicherte Abfragen verwalten
(nur für Administratoren)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Die Rolle Studio Query User (roles/databasesconsole.studioQueryUser) bietet Zugriff zum Erstellen, Ansehen und Schreiben gespeicherter Abfragen. Diese Rolle erfüllt die Anforderungen der meisten Nutzer.

Weisen Sie die Rolle Studio Query Admin (roles/databasesconsole.studioQueryAdmin) nur Administratoren zu. Weitere Informationen zu Bigtable IAM finden Sie unter Bigtable-Zugriffssteuerung mit IAM.

Gespeicherte Suchanfrage erstellen

So erstellen Sie eine gespeicherte Abfrage:

  1. Rufen Sie in der Google Cloud Console die Seite Bigtable-Instanzen auf.
    Instanzen
  2. Wählen Sie die Instanz aus, in der Sie eine gespeicherte Abfrage erstellen möchten.

  3. Klicken Sie im Navigationsmenü auf Bigtable Studio.

    Im Bereich Explorer wird eine Liste der Tabellen, Ansichten und Abfragen in der Instanz angezeigt.

  4. Führen Sie die Abfrage im Tab Editor aus.

    Die Ergebnisse werden in der Tabelle Ergebnisse angezeigt.

  5. Wenn Sie mit den Ergebnissen nicht zufrieden sind, ändern Sie die Abfrage und führen Sie sie noch einmal aus. Wenn Sie mit der Abfrage zufrieden sind, klicken Sie auf Speichern.
  6. Geben Sie im Dialogfeld Abfrage speichern einen Namen für die gespeicherte Abfrage ein.
  7. Klicken Sie auf Speichern.

Optional:

  • Wenn Sie die Abfrage unter einem anderen Namen speichern möchten, klicken Sie auf den Erweiterungspfeil Speichern unter, wählen Sie Als Abfrage speichern aus und geben Sie dann im Dialogfeld einen neuen Namen ein.
  • Wenn Sie die Region ändern möchten, die von dieser gespeicherten Abfrage verwendet wird, wählen Sie Erweiterte Optionen einblenden aus. Wählen Sie dann in der Liste Region eine Region aus.

Sie können die Abfrage auch als logische oder kontinuierliche materialisierte Ansicht speichern.

Gespeicherte Abfrage öffnen und ausführen

So öffnen Sie eine gespeicherte Abfrage als neue Abfrage:

  1. Wechseln Sie im Bereich Explorer auf der Seite Bigtable Studio zum Abschnitt Abfragen.
  2. Klicken Sie auf eine gespeicherte Abfrage, um sie in einem neuen Editor-Tab zu öffnen. Optional können Sie neben einer gespeicherten Abfrage auf Aktionen ansehen klicken. Klicken Sie dann auf Abfrage öffnen, um sie in einem neuen Editor-Tab zu öffnen.
  3. Klicken Sie auf Ausführen.

Gespeicherte Abfrage aktualisieren

So aktualisieren Sie eine vorhandene gespeicherte Abfrage:

  1. Gehen Sie im Bereich Explorer auf der Seite Bigtable Studio zum Abschnitt Abfragen.
  2. Klicken Sie auf eine gespeicherte Abfrage, um sie in einem neuen Editor-Tab zu öffnen. Optional können Sie neben einer gespeicherten Abfrage auf Aktionen ansehen klicken. Klicken Sie dann auf Abfrage öffnen, um sie in einem neuen Editor-Tab zu öffnen.
  3. Ändern Sie die Abfrage.
  4. Klicken Sie zum Speichern der geänderten Abfrage auf Speichern.

Liste aller gespeicherten Abfragen ansehen und verwalten

So rufen Sie eine Liste aller gespeicherten Abfragen in Ihrem Projekt auf:

  1. Rufen Sie in der Google Cloud Console die Seite Bigtable-Instanzen auf.
    Instanzen
  2. Wählen Sie eine Instanz aus. Da eine gespeicherte Abfrage einem Projekt untergeordnet ist, können Sie alle gespeicherten Abfragen im Projekt von jeder Instanz oder Datenbank aus aufrufen, sofern Sie die erforderliche Rolle haben.
  1. Wechseln Sie im Bereich Explorer auf der Seite Bigtable Studio zum Abschnitt Abfragen.
  2. Klicken Sie neben einer gespeicherten Abfrage auf Aktionen ansehen. Klicken Sie dann auf Abfragen verwalten.

    Die Seite Gespeicherte Abfragen wird geöffnet. Auf dieser Seite werden alle gespeicherten Abfragen in diesem Projekt aufgeführt, einschließlich gespeicherter Abfragen für andere Google Cloud -Produkte.

Auf der Seite Gespeicherte Abfragen können Sie Abfragen suchen, filtern, ansehen und löschen. Sie können eine vorhandene Abfrage auf der Seite Gespeicherte Abfragen nicht bearbeiten.

Gespeicherte Abfragen löschen

Sie können eine gespeicherte Abfrage auf der Seite Bigtable Studio oder auf der Seite Gespeicherte Abfragen in der Google Cloud Console löschen.

  1. Gehen Sie im Bereich Explorer auf der Seite Bigtable Studio zum Abschnitt Abfragen.
  2. Klicken Sie neben der gespeicherten Abfrage, die Sie löschen möchten, auf Aktionen ansehen. Klicken Sie dann auf Abfrage löschen, um die gespeicherte Abfrage zu löschen.
  3. Klicken Sie im Dialogfeld Abfrage löschen auf Löschen.

Sie können eine gespeicherte Abfrage auch auf der Seite Gespeicherte Abfragen löschen. So löschen Sie eine gespeicherte Abfrage auf der Seite Gespeicherte Abfragen:

  1. Rufen Sie die Seite Gespeicherte Abfragen auf.
  2. Klicken Sie neben der gespeicherten Abfrage, die Sie löschen möchten, auf Aktionen ansehen.
  3. Klicken Sie auf Abfrage löschen, um die gespeicherte Abfrage zu löschen.
  4. Klicken Sie im Dialogfeld Abfrage löschen auf Löschen.

Nächste Schritte