Cloud Code admite la ejecución del proxy de autenticación de Cloud SQL para conectarse a una base de datos de Cloud SQL, visualizar instancias de Cloud SQL y crear nuevas fuentes de datos.
Antes de comenzar
Instala Cloud Code si aún no lo has hecho.
Para crear una nueva fuente de datos, puedes usar uno de los siguientes IDE premium de JetBrains:
IntelliJ Ultimate o algún otro IDE premium de JetBrains que contenga el complemento Database Tools y SQL (habilitado de forma predeterminada)
DataGrip, el entorno de administración de bases de datos independiente.
También puedes usar otras herramientas de base de datos preferidas (como DBeaver, MySQL Workbench y SQL Server Management Studio) para conectarte a las instancias de Cloud SQL mediante el puerto local que proporciona Cloud Code.
Conéctate a la base de datos de Cloud SQL con el proxy de autenticación de Cloud SQL
Puedes conectarte a una base de datos de Cloud SQL y ver una lista de instancias de Cloud SQL en IntelliJ o en otros IDE de JetBrains compatibles con Cloud Code.
Para conectarte a una base de datos de Cloud SQL con Cloud Code, sigue estos pasos:
En tu IDE, haz clic en Bases de datos de Google Cloud en la barra lateral o en Ver > Ventanas de herramientas > Bases de datos de Google Cloud.
Si un proyecto de Google Cloud aún no está seleccionado, haz clic en Seleccionar un proyecto de Google Cloud y sigue las instrucciones para cargar el proyecto.
Las instancias de Cloud SQL en tu proyecto de Google Cloud aparecen en Cloud SQL.
Para conectarte a una instancia de Cloud SQL, haz clic con el botón derecho en una instancia y selecciona Conectarse mediante el proxy de Cloud SQL. También puedes optar por usar una IP privada. Para ello, selecciona Conectarse mediante el proxy de Cloud SQL (IP privada).
Para obtener más información sobre cómo conectarte a instancias de SQL, consulta Acerca de las opciones de conexión.
Crea una nueva fuente de datos
Después de establecer una conexión de proxy de autenticación de Cloud SQL, aparece el diálogo Instancia de Cloud SQL conectada, lo que te brinda la opción de crear una nueva fuente de datos para la base de datos disponible localmente o ver las fuentes de datos existentes.
Para crear una nueva fuente de datos, selecciona Crear nueva fuente de datos.
También puedes hacer clic con el botón derecho en una instancia y seleccionar Crear fuente de datos nueva.
En el campo Autenticación, selecciona un método (de forma predeterminada, es un nombre de usuario y una contraseña).
Guarde la configuración.
Cloud Code crea una nueva conexión de fuente de datos con un nombre en el siguiente formato:
gcp-project:location:db-instance-name.Puedes comenzar a trabajar con la instancia de la base de datos a través de las herramientas del complemento de SQL y las herramientas de base de datos de JetBrains, o DataGrip.
(Opcional) Para ver la lista de fuentes de datos en tu IDE, haz clic en Database en la barra lateral o View > Tool Windows > Database. Si haces clic con el botón derecho en una fuente de datos, se te proporciona una lista de opciones, como la visualización de esquemas, tablas y otras operaciones de bases de datos.
Si deseas obtener más información para trabajar con bases de datos en DataGrip, consulta Inicio rápido con DataGrip.
Desconectar el proxy de autenticación de Cloud SQL
Para detener el proceso del proxy y liberar el puerto de la base de datos local, presiona Ctrl+C en la terminal.
Problemas conocidos
En esta sección, se enumeran los problemas conocidos y sus soluciones actuales.
Configura un puerto diferente para conectarte a varias bases de datos
El proxy de autenticación de Cloud SQL no selecciona automáticamente los puertos que están ocupados y siempre depende de uno, lo que te limita a una sola instancia conectada de un determinado tipo de base de datos.
Cloud Code ejecuta el proxy de autenticación de Cloud SQL en la terminal y, si se encuentra con un conflicto de puertos, puedes configurar un puerto diferente para conectarte a una base de datos mediante la ejecución del mismo comando en la terminal con una marca --port personalizada. Por ejemplo:
--port=PORT_NUMBER
Luego, puedes usar este puerto en la conexión de tu base de datos. El comando se generará automáticamente. Por ejemplo:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING