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 su un client a riga di comando SQL, ad esempio creando tabelle e indici, modificando tabelle o impostando viste.

Cloud SQL Studio include un riquadro Explorer che si integra con una query dell'editor di codice e una tabella dei risultati delle query SQL. Puoi eseguire istruzioni DDL, DML e DQL da questa unica 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. Puoi creare, modificare ed eliminare gli oggetti del database come segue:

  • Tabelle
  • Colonne
  • Indici e chiavi
  • Funzioni

Puoi anche utilizzare il riquadro Explorer per eseguire il seed delle query SELECT per le tabelle.

Se non hai mai utilizzato Cloud SQL, consulta 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.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 di database con privilegi che utilizzi.

Esplora i tuoi dati

Per accedere al riquadro Explorer, segui questi passaggi:

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

Creare, modificare ed eseguire query sui dati

Utilizzando l'editor SQL, puoi eseguire una combinazione di istruzioni DDL, DML e DQL. Puoi comporre una query personalmente oppure completare l'editor di query con una utilizzando Explorer.

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. Crea 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 di query, scrivi la query.
    • Per comporre una query partendo da un modello, segui questi passaggi:
      1. Nel riquadro Explorer, accanto a un oggetto o 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 query, fai clic su Esegui.
    • Per eseguire istruzioni specifiche, selezionane una o più e fai clic su Esegui selezionate.
  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 superiori a 10 MB potrebbero troncato. Cloud SQL Studio indica quando vengono restituiti risultati parziali.
  • Puoi eseguire query solo per istanze Cloud SQL in esecuzione.
  • Cloud SQL Studio non supporta i server esterni.
  • Le richieste che richiedono più di cinque minuti vengono annullate.
  • Cloud SQL Studio non mantiene aperta una connessione al database dopo l'esecuzione di uno script SQL. Analogamente, le schede editor non condividono e ogni esecuzione avvia una nuova sessione.
  • Quando esegui un mix di istruzioni DML, DQL e DDL, vengono 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'autenticazione Active Directory.
  • Cloud SQL Studio non supporta il comando GO. Questo comando viene utilizzato nelle utilità di Microsoft SQL Server per indicare che un batch di istruzioni è terminato e può essere inviato a SQL Server.

  • Se una query include una colonna binaria, Cloud SQL Studio non può mostrarla. Converti invece i valori binari in una stringa.

    Ad esempio, sostituisci:

    SELECT my_binary_column from my_table2;

    with:

    SELECT CONVERT(NVARCHAR(4000), my_binary_column, 1) from my_table2;

  • Quando si eseguono più query e una di queste ha esito negativo, la prima . Alcune istruzioni del batch prima dell'errore potrebbe essere stato eseguito correttamente. Puoi aggregare più query in un Dichiarazione di transaction per evitare questo problema:

    BEGIN TRANSACTION
    YOUR_SQL_STATEMENTS
COMMIT;

    Sostituisci quanto segue:

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