Gespeicherte Abfragen erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie gespeicherte Abfragen erstellen und verwalten. Wenn Sie SQL-Scripts in Spanner Studio schreiben, können Sie diese speichern und verwalten. Weitere Informationen finden Sie unter Gespeicherte Abfragen – Übersicht.

Gespeicherte Abfragen sind nur in der Google Cloud Console verfügbar.

Erforderliche Rollen

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

  • So erstellen und löschen Sie gespeicherte Abfragen: Studio Query User (roles/databasesconsole.studioQueryUser)
  • So verwalten Sie alle gespeicherten Abfragen in einem Projekt, einschließlich des Zugriffs auf die Seite „Gespeicherte Abfragen“: Studio Query Admin (roles/databasesconsole.studioQueryAdmin)

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

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Verwenden gespeicherter Abfragen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind für die Verwendung gespeicherter Abfragen erforderlich:

  • So erstellen und löschen Sie gespeicherte Abfragen:
    • databasesconsole.studioQuery.create
    • databasesconsole.studioQuery.update
    • databasesconsole.studioQuery.delete
    • databasesconsole.studioQuery.search
  • So verwalten Sie alle gespeicherten Abfragen in einem Projekt:
    • databasesconsole.studioQuery.create
    • databasesconsole.studioQuery.update
    • databasesconsole.studioQuery.delete
    • databasesconsole.studioQuery.search
    • databasesconsole.studioQuery.list
    • databasesconsole.studioQuery.get

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

Mit der Rolle „Studio Query User“ (roles/databasesconsole.studioQueryUser) können Nutzer gespeicherte Abfragen erstellen, ansehen und schreiben. Für die meisten Nutzer ist das ausreichend.

Die Rolle „Studio Query Admin“ (roles/databasesconsole.studioQueryAdmin) sollte nur Administratoren zugewiesen werden. Weitere Informationen zu Spanner Identity and Access Management (IAM) finden Sie in der IAM-Übersicht.

Berechtigungen

Zum Erstellen gespeicherter Abfragen benötigen Sie auf Projektebene die folgenden IAM-Berechtigungen:

  • databasesconsole.locations.get
  • databasesconsole.locations.list
  • databasesconsole.studioQueries.create

Zum Aufrufen gespeicherter Abfragen benötigen Sie auf Projektebene die folgende Berechtigung:

  • databasesconsole.studioQueries.search

Zum Ändern und Löschen gespeicherter Abfragen benötigen Sie die folgende Berechtigung auf Projektebene:

  • databasesconsole.studioQueries.update

Berechtigungen zum Ausführen von Abfragen werden von der Datenbank übernommen. Möglicherweise sind Sie berechtigt, eine Abfrage anzusehen, aber nicht auszuführen.

Gespeicherte Suchanfrage erstellen

So erstellen Sie eine gespeicherte Abfrage:

  1. Rufen Sie in derGoogle Cloud Console die Seite Spanner-Instanzen auf.

    Instanzen

  2. Wählen Sie die Instanz aus, in der Sie eine gespeicherte Abfrage erstellen möchten.

  3. Wählen Sie die Datenbank aus, in der Sie eine gespeicherte Abfrage erstellen möchten.

  4. Klicken Sie im Navigationsmenü auf Spanner Studio.

  5. Klicken Sie auf der Seite Spanner Studio auf  Neuer Tab oder verwenden Sie den leeren Editor-Tab.

  6. Geben Sie im Abfrageeditor eine gültige SQL-Abfrage ein.

  7. Klicken Sie auf Speichern.

  8. Geben Sie im Dialogfeld Abfrage speichern einen Namen für die gespeicherte Abfrage ein.

  9. Klicken Sie auf Speichern.

Gespeicherte Abfrage öffnen und ausführen

So öffnen Sie eine vorhandene gespeicherte Abfrage als neue Abfrage:

  1. Klicken Sie auf der Seite Spanner Studio auf  Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  2. Gehen Sie im Bereich Explorer zum Abschnitt Abfragen. Klicken Sie auf eine gespeicherte Abfrage, um sie in einem neuen Editor-Tab zu öffnen. Alternativ können Sie neben einer gespeicherten Abfrage auf Aktionen ansehen klicken. Klicken Sie dann auf Abfrage öffnen, um sie auf einem neuen Editor-Tab zu öffnen.
  3. Klicken Sie auf Ausführen.

Gespeicherte Abfrage aktualisieren

So aktualisieren Sie eine vorhandene gespeicherte Abfrage:

  1. Klicken Sie auf der Seite Spanner Studio auf  Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  2. Gehen Sie im Bereich Explorer zum Abschnitt Abfragen. Klicken Sie auf eine gespeicherte Abfrage, um sie in einem neuen Editor-Tab zu öffnen. Alternativ können Sie neben einer gespeicherten Abfrage auf Aktionen ansehen klicken. Klicken Sie dann auf Abfrage öffnen, um sie auf 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 derGoogle Cloud Console die Seite Spanner-Instanzen auf.

    Instanzen

  2. Wählen Sie eine beliebige Instanz aus. Da eine gespeicherte Abfrage ein untergeordnetes Element eines Projekts ist, können Sie alle gespeicherten Abfragen im Projekt von einer beliebigen Instanz oder Datenbank aus ansehen, sofern Sie die erforderliche Rolle haben.

  3. Wählen Sie eine beliebige Datenbank aus.

  4. Klicken Sie auf der Seite Spanner Studio auf  Neuer Tab oder verwenden Sie den leeren Editor-Tab.

  5. Gehen Sie im Bereich Explorer zum Abschnitt Abfragen. Klicken Sie neben einer gespeicherten Abfrage auf  Aktionen ansehen. Klicken Sie dann auf Abfragen verwalten.

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

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

So löschen Sie eine gespeicherte Abfrage auf der Seite Gespeicherte Abfragen:

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

Gespeicherte Abfragen löschen

  1. Klicken Sie auf der Seite Spanner Studio auf  Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  2. Maximieren Sie im Bereich Explorer den Ordner Abfragen. 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.

Nächste Schritte