En esta página, se resumen los conectores de lenguaje de Cloud SQL y cómo usarlos con tus instancias.
Los conectores de lenguaje de Cloud SQL son bibliotecas que proporcionan encriptación y autorización de IAM cuando se conectan a una instancia de Cloud SQL. Los conectores de lenguaje de Cloud SQL crean conexiones autorizadas al proxy del servidor en nombre de la aplicación de un usuario y pasan esa conexión al controlador de base de datos de la aplicación. No pueden proporcionar una ruta de red a una instancia de Cloud SQL, si aún no hay una.
Los conectores de lenguaje de Cloud SQL usan un componente del cliente para conectarse a un servidor proxy en la instancia de Cloud SQL. El conector crea un certificado temporal que autoriza al titular a conectarse al proxy del servidor. El proxy del servidor limita el acceso a la base de datos de Cloud SQL mediante la solicitud de un certificado TLS válido para conectarse.
Cloud SQL admite los siguientes conectores de lenguaje de Cloud SQL:
- Conector de Java de Cloud SQL
- Conector de Python de Cloud SQL
- Conector de Go de Cloud SQL
- Conector de Node.js de Cloud SQL
Cloud SQL recomienda usar los conectores de lenguaje de Cloud SQL para conectarte a tu instancia de Cloud SQL. También puedes conectarte a una instancia de Cloud SQL con un cliente de base de datos o el proxy de autenticación de Cloud SQL. Para obtener más información sobre cómo conectarte a una instancia de Cloud SQL, consulta Acerca de las opciones de conexión.
Requisitos
Si tu instancia de Cloud SQL usa una
autoridad certificadora (AC) compartida
como su serverCaMode, asegúrate de que, en el lado del cliente,
los conectores de lenguaje de Cloud SQL que usas cumplan con
los siguientes requisitos de versión:
- Conector de Java de Cloud SQL: v1.21.0 o posterior
- Conector de Go de Cloud SQL: v1.12.0 o posterior
- Conector de Node.js de Cloud SQL: v1.4.0 o posterior
Si tu instancia de Cloud SQL usa una
AC administrada por el cliente
como su serverCaMode, asegúrate de que, del lado del cliente,
los conectores de lenguaje de Cloud SQL que usas cumplan con
los siguientes requisitos de versión:
- Conector de Java de Cloud SQL: v1.22.0 o posterior
- Conector de Go de Cloud SQL: v1.14.0 o posterior
- Conector de Node.js de Cloud SQL: v1.6.0 o posterior
Cuando una instancia usa una AC administrada por el cliente como su modo de AC de servidor, puedes configurarla con un nombre de DNS personalizado. Debes proporcionar el nombre de DNS personalizado en el campo de nombre alternativo del sujeto (SAN) personalizado del certificado del servidor.
Después de configurar un nombre de DNS personalizado para la instancia, puedes conectarte a ella desde los conectores de lenguaje de Cloud SQL con el nombre de DNS.
Beneficios de los conectores de lenguaje de Cloud SQL
Los conectores de lenguaje de Cloud SQL proporcionan los siguientes beneficios con la conexión a una instancia de Cloud SQL:
- Autorización de IAM: usa permisos de Identity and Access Management (IAM) para controlar quién o qué puede conectarse a tus instancias de Cloud SQL.
- Conveniencia: quita el requisito de administrar certificados SSL, configurar reglas de firewall o habilitar redes autorizadas.
Limitaciones
No puedes usar los conectores de lenguaje de Cloud SQL si usas el acceso adaptado al contexto y la autenticación de la base de datos de IAM. Cuando intentas acceder a la instancia, la autenticación de IAM falla.
Aplica el uso de los conectores de lenguaje de Cloud SQL
Con la aplicación de conectores, puedes aplicar el uso solo del proxy de autenticación de Cloud SQL o de los conectores de lenguaje de Cloud SQL para conectarte a las instancias de Cloud SQL. Con la aplicación de medidas por incumplimiento del conector, Cloud SQL rechaza las conexiones directas a la base de datos.
Si usas una instancia habilitada para Private Service Connect, existe una limitación. Si la instancia tiene habilitada la aplicación de conectores, no puedes crear réplicas de lectura para ella. Del mismo modo, si la instancia tiene réplicas de lectura, no puedes habilitar la aplicación de medidas por incumplimiento del conector para la instancia.
Para obtener más información sobre cómo aplicar el uso de solo el proxy de autenticación de Cloud SQL o los conectores de lenguaje de Cloud SQL para conectarse a una instancia, consulta Conéctate con los conectores de lenguaje de Cloud SQL.