Gestire i dati utilizzando Cloud SQL Studio

MySQL | PostgreSQL | SQL Server

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

Cloud SQL Studio consente agli utenti autorizzati di interagire direttamente con il database SQL ed eseguire query SQL dalla Google Cloud console per accedere ai dati e manipolarli. Puoi eseguire una serie di azioni che eseguirai su un client della riga di comando SQL, ad esempio 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 di 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, ad esempio:

Tabelle
Colonne
Indici e chiavi
Funzioni

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

Cloud SQL Studio convalida automaticamente la sintassi quando digiti una query o selezioni una parte di una query.

Se non hai familiarità con Cloud SQL, consulta la panoramica di Cloud SQL.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per completare le attività descritte in questo documento, chiedi all'amministratore di concederti il ruolo IAM Utente di Cloud SQL Studio (roles/cloudsql.studioUser) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci 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 (richiesta solo se utilizzi l'autenticazione IAM dei database)
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 stai utilizzando.

Autenticarsi 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 IAM dei database. L'utilizzo di questo tipo di autenticazione ti consente di accedere al database e a Cloud SQL Studio senza dover gestire una password aggiuntiva. Puoi anche usufruire dell'autenticazione dei gruppi IAM e gestire l'accesso e i privilegi del database per più utenti della tua organizzazione contemporaneamente.
Autenticazione del database integrata. Ti connetti al database in Cloud SQL Studio utilizzando il tuo account utente MySQL e le relative credenziali.

Esplora i tuoi dati

Per accedere al riquadro Explorer:

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

Vai a Istanze Cloud SQL
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
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

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

Per strutturare, modificare o eseguire query sui dati:

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

Vai a Istanze Cloud SQL
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password.
Componi una query utilizzando uno dei seguenti metodi:
- Per comporre la tua query:
  1. Apri una nuova scheda facendo clic su .
  2. Quando viene visualizzato l'editor di query, scrivi la query.
- Per comporre una query a partire da un modello:
  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 tutti i segnaposto nel modello.
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, seleziona una o più istruzioni e fai clic su Esegui selezione.
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.

Convalidare la sintassi delle query

Quando inserisci la query nell'editor di query, Cloud SQL Studio convalida automaticamente le istruzioni per verificare la presenza di errori di sintassi.

Cloud SQL Studio convalida le query in tempo reale dall'istanza MySQL. Se hai abilitato gli audit log o i log generali di MySQL, le sessioni di convalida vengono registrate come qualsiasi altra sessione. Per evitare la registrazione di queste sessioni di convalida, puoi impostare il cloudsql_avoid_parse_session_logging flag su on. Il valore predefinito è off.

Per saperne di più su come configurare un flag di database, consulta Configurare i flag di database.

Limitazioni

Cloud SQL Studio supporta le query leggere. Se la risposta SQL supera i 10 MB, verrà troncata. 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. L'impostazione di un timeout di query più elevato utilizzando SET SESSION MAX_EXECUTION_TIME non è supportata. Per Cloud SQL per MySQL 5.6 e 5.7, il timeout delle istruzioni DDL a lunga esecuzione può causare file o tabelle orfani di cui non è possibile eseguire il rollback in modo sicuro. Fai attenzione alle query come ALTER TABLE su tabelle di grandi dimensioni.
Cloud SQL Studio non mantiene aperta una connessione al database dopo il completamento dell'esecuzione di uno script SQL. Allo stesso modo, 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, 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'esecuzione di query SELECT sui dati BLOB. Se lo script SQL produce una colonna BLOB nell'output, lo script SQL non riesce a causa di un errore.
I comandi client di 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 lo richiede per la connessione.
Gli utenti con password vuote non sono supportati in Cloud SQL Studio.
USE database è stateful solo per l'esecuzione della query attiva e non funziona come nella gcloud CLI.
L'utente del database deve avere l'autorizzazione per connettersi da localhost.
Quando esegui più query e una di queste non riesce, viene restituito il primo errore rilevato. Alcune delle istruzioni nel batch prima dell'errore potrebbero essere state eseguite correttamente. Puoi racchiudere più query in un'istruzione transaction per evitare questo problema:
```
START TRANSACTION;
    YOUR_SQL_STATEMENTS
COMMIT;
```
Sostituisci quanto segue:
- YOUR_SQL_STATEMENTS: le istruzioni che vuoi eseguire come parte di questa query
Cloud SQL non convalida la parte dell'istruzione SQL di un'istruzione preparata ( preparable_stmt ).

Lo script SQL e la relativa risposta di esecuzione potrebbero transitare attraverso posizioni intermedie tra il client e la posizione dell'istanza di destinazione.

Passaggi successivi

Scrivi SQL con l'assistenza di Gemini