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 SQL-Scripts speichern und verwalten. Weitere Informationen finden Sie unter Gespeicherte Abfragen – Übersicht.

Die Funktion „Gespeicherte Abfragen“ ist 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 zum Verwenden gespeicherter Abfragen benötigen:

  • So erstellen und löschen Sie gespeicherte Abfragen: Studio-Abfragenutzer (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.

Die Rolle „Studio Query User“ (roles/databasesConsole.studioQueryUser) bietet Zugriff zum Erstellen, Ansehen und Schreiben gespeicherter Abfragen. Sie ist für die meisten Nutzer 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 Ansehen 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 haben Sie die Berechtigung, Abfragen anzusehen, sie aber nicht auszuführen.

Gespeicherte Suchanfrage erstellen

So erstellen Sie eine gespeicherte Abfrage:

  1. Rufen Sie in der Google 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.

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

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

  6. Klicken Sie auf Speichern.

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

  8. 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 Editortab.
  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 in einem neuen Editortab 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 Editortab.
  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 in einem neuen Editortab zu öffnen.
  3. Ändern Sie die Abfrage.
  4. Klicken Sie auf Speichern, um die geänderte Abfrage zu speichern.

Liste aller gespeicherten Abfragen aufrufen und verwalten

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

  1. Rufen Sie in der Google 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 über eine beliebige Instanz oder Datenbank aufrufen, 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 Editortab.

  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. Hier werden alle gespeicherten Abfragen in diesem Projekt aufgelistet, einschließlich gespeicherter Abfragen für andere Google Cloud Produkte.

Auf der Seite Gespeicherte Abfragen können Sie nach Abfragen suchen, sie filtern, ansehen und löschen. Auf der Seite Gespeicherte Abfragen können Sie keine vorhandenen 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 Editortab.
  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