Creare e gestire le query salvate

Questa pagina descrive come creare e gestire le query salvate. Quando scrivi script SQL in Spanner Studio, puoi salvarli e gestirli. Per informazioni, consulta la Panoramica delle query salvate.

La funzionalità delle query salvate è disponibile solo nella console Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare le query salvate, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

  • Per creare ed eliminare le query salvate: Utente query di Studio (roles/databasesConsole.studioQueryUser)
  • Per gestire tutte le query salvate in un progetto, incluso l'accesso alla pagina Query salvate: Amministratore query di Studio (roles/databasesConsole.studioQueryAdmin)

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per utilizzare le query salvate. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per utilizzare le query salvate sono necessarie le seguenti autorizzazioni:

  • Per creare ed eliminare le query salvate:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
  • Per gestire tutte le query salvate in un progetto:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
    • databasesConsole.studioQuery.list
    • databasesConsole.studioQuery.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Il ruolo Utente query di Studio (roles/databasesConsole.studioQueryUser) consente di creare, visualizzare e scrivere query salvate. È sufficiente per la maggior parte degli utenti.

Il ruolo Studio Query Admin (roles/databasesConsole.studioQueryAdmin) deve essere concesso solo agli amministratori. Per ulteriori informazioni su Identity and Access Management (IAM) di Spanner, consulta Panoramica di IAM.

Autorizzazioni

Per creare query salvate, devi disporre delle seguenti autorizzazioni IAM a livello di progetto:

  • databasesConsole.locations.get
  • databasesConsole.locations.list
  • databasesConsole.studioQueries.create

Per visualizzare le query salvate, devi disporre della seguente autorizzazione a livello di progetto:

  • databasesConsole.studioQueries.search

Per modificare ed eliminare le query salvate, devi disporre della seguente autorizzazione a livello di progetto:

  • databasesConsole.studioQueries.update

Le autorizzazioni per eseguire query vengono ereditate dal database. È possibile che tu abbia le autorizzazioni per visualizzare, ma non per eseguire una query.

Crea una query salvata

Per creare una query salvata:

  1. Vai alla pagina Istanze di Spanner nella console Google Cloud.

    Istanze

  2. Seleziona l'istanza in cui vuoi creare una query salvata.

  3. Seleziona il database in cui vuoi creare una query salvata.

  4. Nel menu di navigazione, fai clic su Spanner Studio.

    1. Nella pagina Spanner Studio, fai clic su Nuova scheda o utilizza la scheda editor vuota.
  5. Nell'editor delle query, inserisci una query SQL valida.

  6. Fai clic su Salva.

  7. Nella finestra di dialogo Salva query, digita un nome per la query salvata.

  8. Fai clic su Salva.

Aprire ed eseguire una query salvata

Per aprire una query salvata esistente come nuova query:

  1. Nella pagina Spanner Studio, fai clic su Nuova scheda o utilizza la scheda editor vuota.
  2. Nel riquadro Explorer, vai alla sezione Query. Fai clic su una query salvata per aprirla in una nuova scheda dell'editor. In alternativa, fai clic su Visualizza azioni accanto a una query salvata. Poi, fai clic su Apri query per aprirla in una nuova scheda dell'editor.
  3. Fai clic su Esegui.

Aggiornare una query salvata

Per aggiornare una query salvata esistente:

  1. Nella pagina Spanner Studio, fai clic su Nuova scheda o utilizza la scheda editor vuota.
  2. Nel riquadro Explorer, vai alla sezione Query. Fai clic su una query salvata per aprirla in una nuova scheda dell'editor. In alternativa, fai clic su Visualizza azioni accanto a una query salvata. Poi, fai clic su Apri query per aprirla in una nuova scheda dell'editor.
  3. Modifica la query.
  4. Per salvare la query modificata, fai clic su Salva.

Visualizza e gestisci un elenco di tutte le query salvate

Per visualizzare un elenco di tutte le query salvate nel progetto:

  1. Vai alla pagina Istanze di Spanner nella console Google Cloud.

    Istanze

  2. Seleziona un'istanza. Poiché una query salvata è un elemento secondario di un progetto, se disponi del ruolo richiesto, puoi visualizzare tutte le query salvate nel progetto da qualsiasi istanza o database.

  3. Seleziona un database qualsiasi.

  4. Nella pagina Spanner Studio, fai clic su Nuova scheda o utilizza la scheda editor vuota.

  5. Nel riquadro Explorer, vai alla sezione Query. Fai clic su Visualizza azioni accanto a una query salvata. Quindi, fai clic su Gestisci query.

    Viene visualizzata la pagina Query salvate. Elenca tutte le query salvate in questo project (incluse le query salvate per altri Google Cloud prodotti).

Puoi cercare, filtrare, visualizzare ed eliminare le query nella pagina Query salvate. Non puoi modificare una query esistente nella pagina Query salvate.

Per eliminare una query salvata nella pagina Query salvate:

  1. Fai clic su Visualizza azioni accanto alla query salvata che vuoi eliminare.
  2. Fai clic su Elimina query per eliminare la query salvata.
  3. Nella finestra di dialogo Elimina query, fai clic su Elimina.

Eliminare una query salvata

  1. Nella pagina Spanner Studio, fai clic su Nuova scheda o utilizza la scheda editor vuota.
  2. Nel riquadro Explorer, espandi la cartella Query. Fai clic su Visualizza azioni accanto alla query salvata che vuoi eliminare. Quindi, fai clic su Elimina query per eliminare la query salvata.
  3. Nella finestra di dialogo Elimina query, fai clic su Elimina.

Passaggi successivi