Crea e gestisci le query salvate

Per riutilizzare e condividere operazioni di database comuni tra le sessioni, puoi creare, organizzare e gestire gli script SQL salvati in Bigtable Studio. Per saperne di più, consulta la panoramica delle query salvate.

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

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 visualizzare le query salvate: Bigtable Reader (roles/bigtable.reader)
  • Per visualizzare, creare, modificare ed eliminare le query salvate: Bigtable User (roles/bigtable.user)
  • Per amministrare, visualizzare, creare, modificare ed eliminare le query salvate: Amministratore Bigtable (roles/bigtable.admin). Questo ruolo dispone di autorizzazioni ampie e fornisce l'accesso completo a Bigtable, solo per l'utilizzo da parte degli amministratori.

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 scoprire di più sulle autorizzazioni richieste, consulta 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 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 gli amministratori)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

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

Il ruolo Studio Query User (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 Bigtable IAM, consulta Controllo controllo dell'accesso Bigtable con IAM.

Crea una query salvata

Per creare una query salvata, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Istanze di Bigtable.
    Istanze
  2. Seleziona l'istanza in cui vuoi creare una query salvata.

  3. Nel menu di navigazione, fai clic su Bigtable Studio.

    Il riquadro Explorer mostra un elenco di tabelle, visualizzazioni e query nell'istanza.

  4. Esegui la query dalla scheda Editor.

    I risultati vengono visualizzati nella tabella Risultati.

  5. Se i risultati non ti soddisfano, modifica la query ed eseguila di nuovo. Quando la query ti soddisfa, fai clic su Salva.
  6. Nella finestra di dialogo Salva query, inserisci un nome per la query salvata.
  7. Fai clic su Salva.

Facoltativamente,

  • Per salvare la query con un nome diverso, fai clic sulla freccia di espansione Salva con nome, scegli Salva come query e inserisci un nuovo nome nella finestra di dialogo.
  • Per modificare la regione utilizzata da questa query salvata, seleziona Mostra opzioni avanzate. Quindi, seleziona una regione dall'elenco Regione.

Puoi anche salvare la query come vista logica o materializzata continua.

Apri ed esegui una query salvata

Per aprire una query salvata come nuova query, segui questi passaggi:

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

Aggiorna una query salvata

Per aggiornare una query salvata esistente, segui questi passaggi:

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

Visualizza e gestisci un elenco di tutte le query salvate

Per visualizzare un elenco di tutte le query salvate nel progetto, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Istanze di Bigtable.
    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.
  1. Nel riquadro Explorer della pagina Bigtable Studio, vai alla sezione Query.
  2. Fai clic su Visualizza azioni accanto a una query salvata. Poi fai clic su Gestisci query.

    Viene visualizzata la pagina Query salvate. Questa pagina elenca tutte le query salvate in questo progetto, incluse quelle 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 Bigtable Studio o dalla pagina Query salvate nella console Google Cloud .

  1. Nel riquadro Explorer della pagina Bigtable Studio, vai alla sezione Query.
  2. Fai clic su Visualizza azioni accanto alla query salvata che vuoi eliminare. Poi, 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, segui questi passaggi:

  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