Gestire i dati utilizzando 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, come creare tabelle e indici, modificare tabelle o configurare visualizzazioni.

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 singola interfaccia. Ad esempio, anziché configurare uno strumento di query del database di terze parti, puoi creare una tabella ed eseguire query sui dati utilizzando l'editor di query in Cloud SQL Studio.

Puoi utilizzare il riquadro Explorer per visualizzare e interagire con gli oggetti del database. Creazione, modifica ed eliminazione degli oggetti del database, ad esempio:

  • Tabelle
  • Colonne
  • Indici e chiavi
  • Funzioni

Puoi anche utilizzare il riquadro Esplorazione per creare query SELECT per le tabelle.

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

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per completare le attività in questo documento, chiedi all'amministratore di concederti il ruolo IAM Utente Cloud SQL Studio (roles/cloudsql.studioUser) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

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

  • cloudsql.databases.list
  • cloudsql.instances.executeSql
  • cloudsql.instances.get
  • cloudsql.instances.login (obbligatorio solo se utilizzi l'autenticazione database IAM)
  • cloudsql.users.list

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 utilizzi.

Esegui l'autenticazione in Cloud SQL Studio

Prima di poter accedere a un database in Cloud SQL Studio, devi prima selezionare un metodo di autenticazione del database. Per accedere al database utilizzando Cloud SQL Studio, puoi utilizzare uno dei seguenti tipi di autenticazione:

  • Autenticazione database IAM. L'utilizzo di questo tipo di autenticazione ti consente di accedere al database e a Cloud SQL Studio senza dover gestire un'altra password. Puoi anche usufruire dell'autenticazione di gruppo IAM e gestire contemporaneamente l'accesso e i privilegi del database per più utenti della tua organizzazione.

  • Autenticazione del database integrata. Per connetterti al database in Cloud SQL Studio, utilizza le credenziali e l'account utente MySQL.

Esplora i tuoi dati

Per accedere al riquadro Explorer:

  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. Il riquadro Explorer mostra un elenco degli oggetti nel database.

Creare, modificare ed eseguire query sui dati

Con l'editor SQL puoi eseguire una combinazione di istruzioni DDL, DML e DQL. Puoi comporre una query autonomamente o compilare l'editor di query con un modello utilizzando lo spazio 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. Componi una query utilizzando uno dei seguenti metodi:
    • Per comporre la tua query, segui questi passaggi:
      1. Apri una nuova scheda facendo clic su .
      2. Quando viene visualizzato l'editor delle query, scrivi la query.
    • Per comporre una query a partire da un modello, segui questi passaggi:
      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 di query viene compilato con un modello.
      3. Sostituisci eventuali segnaposto nel modello.
  6. Esegui le query utilizzando uno dei seguenti approcci:
    • Per eseguire tutte le istruzioni nell'editor di query, fai clic su Esegui.
    • Per eseguire istruzioni specifiche, selezionane una o più e fai clic su Esegui selezione.
  7. I risultati delle query vengono visualizzati nella scheda Risultati. Se sono disponibili più set di risultati, selezionane uno dall'elenco a discesa Tutti i risultati.

Limitazioni

  • Cloud SQL Studio supporta query leggere. Le risposte di dimensioni superiori a 10 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 cinque minuti vengono annullate. Per Cloud SQL per MySQL 5.6 e 5.7, il timeout delle istruzioni DDL a lunga esecuzione può causare file o tabelle orfani che non possono essere sottoposti a rollback in modo sicuro. Fai attenzione con query come ALTER TABLE su tabelle di grandi dimensioni.
  • Cloud SQL Studio non mantiene aperta una connessione al database al termine 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 un mix di istruzioni DML, DQL e DDL, verranno visualizzati solo i risultati delle query DQL.
  • La chiusura del browser o della scheda 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 non supporta l'esecuzione di query SELECT sui dati BLOB. Se lo script SQL genera una colonna BLOB nell'output, lo script SQL non va a buon fine e viene visualizzato un errore.
  • I comandi del client Cloud SQL per MySQL non sono supportati e non possono essere eseguiti in Cloud SQL Studio.
  • L'utente root non è supportato in Cloud SQL Studio.
  • Cloud SQL Studio richiede sempre un database, anche se Cloud SQL per MySQL non richiede un database per la connessione.
  • Gli utenti con password vuote non sono supportati in Cloud SQL Studio.
  • USE database è stateful solo per l'esecuzione delle query attive e non funziona come nell'interfaccia a riga di comando gcloud.
  • L'utente del database deve disporre dell'autorizzazione per connettersi da localhost.

  • Quando esegui più query e una non va a buon fine, viene restituito il primo errore rilevato. Alcune istruzioni nel batch precedenti all'errore potrebbero essere state eseguite correttamente. Per evitare questo problema, puoi racchiudere più query in un'istruzione transaction:

    START TRANSACTION;
    YOUR_SQL_STATEMENTS
COMMIT;

    Sostituisci quanto segue:

    • YOUR_SQL_STATEMENTS: le istruzioni da eseguire nell'ambito di questa query