Creare e gestire query salvate

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei 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 ulteriori informazioni, 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 saperne di più, consulta la panoramica delle query salvate .

La funzionalità delle query salvate è disponibile solo nella console e non tramite le API.

Ruoli obbligatori

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

• Per creare, modificare 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 saperne di più 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 saperne di più sulle autorizzazioni necessarie, consulta Autorizzazioni obbligatorie.

Autorizzazioni obbligatorie

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

Azione	Autorizzazioni IAM obbligatorie
Crea query salvate	databasesconsole.studioQueries.create
Visualizza le query salvate	databasesconsole.studioQueries.search databasesconsole.locations.get databasesconsole.locations.list
Modifica le query salvate	databasesconsole.studioQueries.update
Elimina query salvate	databasesconsole.studioQueries.delete
Amministra le query salvate (solo per l'utilizzo da parte degli amministratori)	databasesConsole.studioQueries.list databasesconsole.locations.list

Nota:l'accesso alle query salvate non implica automaticamente l'autorizzazione a eseguire la query.

Puoi anche ottenere queste autorizzazioni 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 Amministratore query di Studio (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 Google Cloud console.
   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.

Apri ed esegui 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 Visualizza azioni accanto a una query salvata. Quindi, fai clic su Apri query per aprirla in una nuova scheda dell'editor.
3. Fai clic su Esegui.

Aggiorna 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 Visualizza azioni accanto a una query salvata. Quindi, 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 Google Cloud console.
   Istanze
2. Seleziona un'istanza qualsiasi. 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. 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.

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

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

Elimina una query salvata

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

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. Quindi, per eliminare la query salvata, fai clic su Elimina query.
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.