Creare e gestire le query salvate

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

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

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare le query salvate, chiedi all'amministratore di concederti i seguenti ruoli IAM (Identity and Access Management) nel progetto:

• Per creare, modificare ed eliminare 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: Studio Query Admin (roles/databasesconsole.studioQueryAdmin)

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

Questi ruoli predefiniti contengono le autorizzazioni necessarie per utilizzare le query salvate. Per scoprire di più sulle autorizzazioni richieste, vedi Autorizzazioni richieste.

Autorizzazioni obbligatorie

Per creare, visualizzare, modificare ed eliminare le query salvate, devi disporre delle seguenti autorizzazioni IAM a livello di progetto:

Azione	Autorizzazioni IAM richieste
Creare query salvate	databasesconsole.studioQueries.create
Visualizza le query salvate	databasesconsole.studioQueries.search databasesconsole.locations.get databasesconsole.locations.list
Modificare le query salvate	databasesconsole.studioQueries.update
Elimina query salvate	databasesconsole.studioQueries.delete
Amministra query salvate (solo per uso da parte degli amministratori)	databasesConsole.studioQueries.list databasesconsole.locations.list

Nota:l'accesso alle query salvate non significa automaticamente che tu disponga delle autorizzazioni per eseguire la query.

Puoi ottenere queste autorizzazioni anche utilizzando ruoli personalizzati o altri ruoli predefiniti.

Il ruolo Utente query di Studio (roles/databasesconsole.studioQueryUser) fornisce l'accesso per creare, visualizzare e scrivere query salvate. Questo ruolo soddisfa le esigenze della maggior parte degli utenti.

Concedi il ruolo Studio Query Admin (roles/databasesconsole.studioQueryAdmin) solo agli amministratori. Per saperne di più su Spanner IAM, consulta la panoramica di IAM.

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.
5. Nella pagina Spanner Studio, fai clic su Nuova scheda o utilizza la scheda dell'editor vuota.
6. Nell'editor di query, inserisci una query SQL.
7. Fai clic su Salva.
8. Nella finestra di dialogo Salva query, inserisci un nome per la query salvata.
9. Fai clic su Salva.

Aprire ed eseguire una query salvata

Per aprire una query salvata come nuova query:

1. Nel riquadro Explorer della pagina Spanner Studio, vai alla sezione Query.
2. Fai clic su una query salvata per aprirla in una nuova scheda dell'editor. (Facoltativo) Puoi fare 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. Nel riquadro Explorer della pagina Spanner Studio, vai alla sezione Query.
2. Fai clic su una query salvata per aprirla in una nuova scheda dell'editor. (Facoltativo) Puoi fare 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.

Visualizzare e gestire un elenco di tutte le query salvate

Per visualizzare un elenco di tutte le query salvate nel tuo 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.
4. Nel riquadro Explorer della pagina Spanner Studio, vai alla sezione Query.
5. Fai clic su Visualizza azioni accanto a una query salvata. Quindi, fai clic su Gestisci query.

   Viene visualizzata la pagina Query salvate. Questa pagina elenca tutte le query salvate in questo progetto, incluse le query salvate per altri prodotti Google Cloud .

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

Eliminare una query salvata

Puoi eliminare una query salvata dalla pagina Spanner Studio o dalla pagina Query salvate nella console Google Cloud .

1. Nel riquadro Explorer della pagina Spanner Studio, vai alla sezione Query.
2. Fai clic su Visualizza azioni accanto alla query salvata che vuoi eliminare. Poi fai clic su Elimina query per eliminare la query salvata.
3. Nella finestra di dialogo Elimina query, fai clic su Elimina.

Puoi anche eliminare una query salvata nella pagina Query salvate. Per eliminare una query salvata nella pagina Query salvate:

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

Passaggi successivi

• Scopri di più sulle query salvate.