Cloud Code supporta l'esecuzione di proxy di autenticazione Cloud SQL per connettersi a un database Cloud SQL, visualizzare le istanze Cloud SQL e creare nuove origini dati.
Prima di iniziare
Installa Cloud Code se non l'hai ancora fatto.
Per creare una nuova origine dati, puoi utilizzare uno dei seguenti IDE JetBrains premium:
IntelliJ Ultimate o un altro IDE JetBrains premium contenente il plug-in Database Tools and SQL (abilitato per impostazione predefinita).
DataGrip, l'ambiente di gestione del database autonomo.
Puoi anche utilizzare altri strumenti di database preferiti (come DBeaver, MySQL Workbench e SQL Server Management Studio) per connetterti alle istanze Cloud SQL utilizzando la porta locale fornita da Cloud Code.
Connettiti al database Cloud SQL utilizzando il proxy di autenticazione Cloud SQL
Puoi connetterti a un database Cloud SQL e visualizzare un elenco di istanze Cloud SQL in IntelliJ o in altri IDE JetBrains supportati con Cloud Code.
Per connetterti a un database Cloud SQL con Cloud Code, svolgi quanto segue:
Nell'IDE, fai clic su Database Google Cloud nella barra laterale o su Visualizza > Finestre degli strumenti > Database Google Cloud.
Se non è già selezionato un progetto Google Cloud, fai clic su Seleziona un progetto Google Cloud e segui le istruzioni per caricarlo.
Le istanze Cloud SQL nel tuo progetto Google Cloud vengono visualizzate in Cloud SQL.
Per connetterti a un'istanza Cloud SQL, fai clic con il tasto destro del mouse su un'istanza e seleziona Connetti utilizzando il proxy Cloud SQL. Puoi anche scegliere di utilizzare un IP privato selezionando Connetti utilizzando il proxy Cloud SQL (IP privato).
Per scoprire di più sulla connessione alle istanze SQL, consulta Informazioni sulle opzioni di connessione.
Creare una nuova origine dati
Dopo aver stabilito una connessione al proxy di autenticazione Cloud SQL, viene visualizzata la finestra di dialogo Istanzia Cloud SQL collegata, che ti consente di creare una nuova origine dati per il database disponibile localmente o di visualizzare le origini dati esistenti.
Per creare una nuova origine dati, seleziona Crea nuova origine dati.
In alternativa, puoi fare clic con il tasto destro del mouse su un'istanza e selezionare Crea nuova origine dati.
Nel campo Autenticazione, seleziona un metodo (per impostazione predefinita, si tratta di un nome utente e una password).
Salva la configurazione.
Cloud Code crea una nuova connessione all'origine dati con un nome nel seguente formato:
gcp-project:location:db-instance-name.Puoi iniziare a utilizzare l'istanza di database tramite le funzionalità di Database Tools e del plug-in SQL di JetBrains o DataGrip.
(Facoltativo) Per visualizzare l'elenco delle origini dati nell'IDE, fai clic su Database nella barra laterale o su Visualizza > Finestre degli strumenti > Database. Se fai clic con il tasto destro del mouse su un'origine dati, viene visualizzato un elenco di opzioni, ad esempio la visualizzazione di schemi, tabelle e altre operazioni di database.
Per scoprire di più sull'utilizzo dei database in DataGrip, consulta la sezione Guida rapida all'utilizzo di DataGrip.
Scollega il proxy di autenticazione Cloud SQL
Per interrompere il processo del proxy e liberare la porta del database locale, premi Ctrl+C nel terminale.
Problemi noti
Questa sezione elenca eventuali problemi noti e le relative risoluzioni attuali.
Impostare una porta diversa per connettersi a più database
Il proxy di autenticazione Cloud SQL non seleziona automaticamente le porte se sono occupate e dipende sempre da una, il che ti limita a una singola istanza connessa di un determinato tipo di database.
Cloud Code esegue il proxy di autenticazione Cloud SQL nel terminale e, se si verifica un conflitto di porte, puoi impostare una porta diversa per connetterti a un database eseguendo lo stesso comando nel terminale con un flag --port personalizzato. Ad
esempio:
--port=PORT_NUMBER
Puoi quindi utilizzare questa porta nella connessione al database. Il comando verrà generato automaticamente. Ad esempio:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING