Cloud Code supporta l'esecuzione del proxy di autenticazione Cloud SQL per la connessione a un database Cloud SQL, la visualizzazione delle istanze Cloud SQL e la creazione di nuove origini dati.
Prima di iniziare
Installa Cloud Code se non l'hai già fatto.
Per creare una nuova origine dati, puoi utilizzare uno dei seguenti IDE JetBrains premium:
IntelliJ Ultimate o un altro IDE JetBrains premium che contiene il plug-in Strumenti di database e SQL (abilitato per impostazione predefinita).
DataGrip, l'ambiente di gestione dei 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, esegui questi passaggi:
Nel tuo IDE, fai clic su Database Google Cloud nella barra laterale oppure su Visualizza > Finestre degli strumenti > Database Google Cloud.
Se non è ancora selezionato un progetto Google Cloud, fai clic su Seleziona un progetto Google Cloud e segui le istruzioni per caricare il progetto Google Cloud.
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 Connettiti utilizzando il proxy Cloud SQL. Puoi anche scegliere di utilizzare un IP privato selezionando Connettiti utilizzando il proxy Cloud SQL (IP privato).
Per saperne 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 Istanza Cloud SQL collegata, che ti offre la possibilità 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 (che per impostazione predefinita sono un nome utente e una password).
Salva la configurazione.
Cloud Code crea una nuova connessione dell'origine dati con un nome nel formato seguente:
gcp-project:location:db-instance-name.Puoi iniziare a lavorare con l'istanza del database tramite le funzionalità del plug-in SQL e gli strumenti del database di JetBrains o DataGrip.
(Facoltativo) Per visualizzare l'elenco delle origini dati nel tuo IDE, fai clic su Database nella barra laterale o su Visualizza > Finestre degli strumenti > Database. Se fai clic con il pulsante destro del mouse su un'origine dati, viene visualizzato un elenco di opzioni, tra cui la visualizzazione di schemi, tabelle e altre operazioni di database.
Per scoprire di più sull'utilizzo dei database in DataGrip, consulta la Guida rapida a DataGrip.
Disconnetti il proxy di autenticazione Cloud SQL
Per arrestare il processo proxy e liberare la porta del database locale, premi Ctrl+C nel terminale.
Problemi noti
In questa sezione sono elencati gli eventuali problemi noti e le relative risoluzioni attuali.
Imposta una porta diversa per connettersi a più database
Il proxy di autenticazione Cloud SQL non seleziona automaticamente le porte se 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 porta, puoi impostare una porta diversa per la connessione a un database eseguendo lo stesso comando nel terminale con un flag --port personalizzato. Ad
esempio:
--port=PORT_NUMBER
Potrai quindi utilizzare questa porta nella connessione del database. Il comando verrà generato automaticamente. Ad esempio:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING