Cloud Code supporta l'esecuzione di un 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 lo hai già fatto.
Per creare una nuova origine dati, puoi utilizzare uno dei seguenti IDE premium JetBrains:
IntelliJ Ultimate o un altro IDE premium JetBrains contenente il plug-in Database Tools and SQL (attivato 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 altri IDE JetBrains supportati con Cloud Code.
Per connetterti a un database Cloud SQL con Cloud Code, esegui queste operazioni:
Nell'IDE, fai clic su Database Google Cloud nella barra laterale oppure su Visualizza > Finestre degli strumenti > Database Google Cloud.
Se non è ancora selezionato alcun 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 Connetti utilizzando il proxy Cloud SQL. Puoi anche scegliere di utilizzare un IP privato selezionando Connettiti tramite 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 proxy di autenticazione Cloud SQL, viene visualizzata la finestra di dialogo Connessa istanza Cloud SQL, che offre la possibilità di creare una nuova origine dati per il database disponibile in locale 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 di 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 lavorare con l'istanza di database tramite DataGrip o DataGrip di Database Tools e delle funzionalità dei plug-in SQL di JetBrains.
(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 come la visualizzazione di schemi, tabelle e altre operazioni di database.
Per scoprire di più sull'utilizzo dei database in DataGrip, consulta la guida rapida con DataGrip.
Disconnetti 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 vengono elencati gli eventuali problemi noti e le relative soluzioni attuali.
Imposta una porta diversa per connetterti a più database
Il proxy di autenticazione Cloud SQL non seleziona automaticamente le porte se occupato e dipende sempre da una porta, 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 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 al database. Il comando verrà generato automaticamente. Ad esempio:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING