Gestire i dati con Cloud SQL Studio

Questa pagina descrive come esplorare e gestire i dati Cloud SQL utilizzando Cloud SQL Studio nella console Google Cloud.

Cloud SQL Studio consente agli utenti autorizzati di interagire direttamente con il database SQL ed eseguire query SQL dalla console Google Cloud per accedere ai dati e manipolarli. Puoi eseguire una serie di azioni che eseguiresti su un client a riga di comando SQL, ad esempio creare tabelle e indici, modificare tabelle o impostare viste.

Cloud SQL Studio include un riquadro Explorer che si integra con un editor di query e una tabella dei risultati delle query SQL. Puoi eseguire istruzioni DDL, DML e DQL da questa interfaccia. Ad esempio, anziché configurare un Query Tool di database di terze parti, puoi creare una tabella ed eseguire query sui tuoi dati utilizzando l'editor query in Cloud SQL Studio.

Puoi utilizzare il riquadro Explorer per visualizzare e interagire con gli oggetti del database. Puoi creare, modificare ed eliminare gli oggetti del database, ad esempio:

  • Tables
  • Colonne
  • Indici e chiavi
  • Funzioni

Puoi anche utilizzare il riquadro Explorer per visualizzare le query SELECT per le tabelle.

Se non hai mai utilizzato Cloud SQL, consulta la panoramica di Cloud SQL.

Autorizzazioni e ruoli richiesti

Per ottenere le autorizzazioni necessarie per completare le attività indicate in questo documento, chiedi all'amministratore di concederti il ruolo IAM Amministratore Cloud SQL (roles/cloudsql.admin) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per utilizzare Cloud SQL Studio, devi disporre delle seguenti autorizzazioni:

  • cloudsql.instances.get
  • cloudsql.users.list
  • cloudsql.databases.list
  • cloudsql.instances.executeSql

Inoltre, assicurati di disporre delle autorizzazioni a livello di database per il database che utilizzi per l'autenticazione e della password per l'utente del database con privilegi che utilizzerai.

Esplora i tuoi dati

Per accedere al riquadro Explorer, procedi nel seguente modo:

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Seleziona un'istanza dall'elenco.
  3. Nel menu di navigazione, fai clic su Cloud SQL Studio.
  4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Nel riquadro Spazio di esplorazione viene visualizzato un elenco degli oggetti presenti nel database.

Creare, modificare ed eseguire query sui dati

Con l'editor SQL, puoi eseguire una combinazione di istruzioni DDL, DML e DQL. Puoi scrivere una query autonomamente oppure completare un modello nell'editor query utilizzando lo strumento di esplorazione.

Per strutturare, modificare o eseguire query sui dati:

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Seleziona un'istanza dall'elenco.
  3. Nel menu di navigazione, fai clic su Cloud SQL Studio.
  4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password.
  5. Scrivi una query utilizzando uno dei seguenti metodi:
    • Per scrivere la tua query, segui questi passaggi:
      1. Apri una nuova scheda facendo clic su .
      2. Quando viene visualizzato l'editor query, scrivi la query.
    • Per scrivere una query iniziando con un modello:
      1. Nel riquadro Explorer, accanto a un oggetto o a una raccolta di database, fai clic su more_vert Visualizza azioni. Vengono visualizzate una o più azioni disponibili.
      2. Fai clic su un'azione. L'editor query completa un modello.
      3. Sostituisci gli eventuali segnaposto nel modello.
  6. Esegui le query utilizzando uno dei seguenti approcci:
    • Per eseguire tutte le istruzioni nell'Editor query, fai clic su Esegui.
    • Per eseguire istruzioni specifiche, seleziona una o più istruzioni e fai clic su Esegui istruzioni selezionate.
  7. I risultati delle query vengono visualizzati nella scheda Risultati. Se sono disponibili più set di risultati, seleziona un risultato dall'elenco a discesa Tutti i risultati.

Limitazioni

  • Cloud SQL Studio supporta query leggere. Le risposte superiori a 8 MB potrebbero essere troncate. Cloud SQL Studio indica quando vengono restituiti risultati parziali.
  • Puoi eseguire query solo per le istanze Cloud SQL in esecuzione.
  • Cloud SQL Studio non supporta i server esterni.
  • Le richieste che richiedono più di un minuto vengono annullate.
  • Cloud SQL Studio non tiene aperta una connessione al database dopo il completamento dell'esecuzione di uno script SQL. Analogamente, le schede dell'editor non condividono una sessione comune e ogni esecuzione avvia una nuova sessione.
  • Quando esegui una combinazione di istruzioni DML, DQL e DDL, verranno visualizzati solo i risultati delle query DQL.
  • La chiusura della scheda del browser o del browser non interrompe l'esecuzione della query in Cloud SQL Studio. La query verrà eseguita fino al completamento o al timeout.
  • Cloud SQL Studio supporta solo l'autenticazione nativa di PostgreSQL (nome utente e password). Non puoi eseguire l'autenticazione utilizzando Identity and Access Management o utilizzare le credenziali salvate in Secret Manager.
  • Se esegui contemporaneamente più istruzioni nell'editor query e una o più istruzioni generano un errore, l'esecuzione di tutte le istruzioni viene interrotta e viene visualizzato il primo errore riscontrato.