cloud sql jdbc socket factory
1.21.0
O Cloud SQL Connector para Java é uma biblioteca que fornece autorização e criptografia baseadas em IAM ao se conectar a uma instância do Cloud SQL. Ele não pode fornecer um caminho de rede para uma instância do Cloud SQL se ainda não houver uma presente. Consulte a página Visão geral da conexão para mais informações sobre como se conectar a uma instância do Cloud SQL.
Para obter informações de uso específicas para seu mecanismo e driver de banco de dados, consulte as páginas abaixo:
Como se conectar ao Cloud SQL usando JDBC
Como se conectar ao Cloud SQL usando R2DBC
Para obter exemplos desta biblioteca sendo usada no contexto de um aplicativo, confira os exemplos de aplicativos localizados aqui.
Esta biblioteca usa a estratégia Application Default Credentials (ADC) para resolver credenciais. Consulte estas instruções para saber como definir seu ADC (credenciais de aplicativo Google Cloud vs desenvolvimento local, usuário IAM vs conta de serviço).
---
Para construir um JAR gordo contendo o driver JDBC com os pacotes de dependências do Socket Factory, você pode emitir o seguinte comando Maven a partir do local que contém o projeto pom.xml:
mvn -P jar-with-dependencies clean package -DskipTests
Isso criará uma subpasta de destino dentro de cada um dos diretórios do módulo. Dentro desses diretórios de destino você encontrará os arquivos do driver JDBC.
Exemplo:
mysql-socket-factory-connector-j-8–1.8.0-jar-with-dependencies.jar postgres-socket-factory-1.8.0-jar-with-dependencies.jar
O Java Connector suporta registro de depuração opcional para ajudar a diagnosticar problemas com a atualização do certificado em segundo plano. Para habilitá-lo, adicione o seguinte ao arquivo /src/main/resources/application.yml :
logging.level.root=DEBUG
O proxy do Cloud SQL estabelece conexões com instâncias do Cloud SQL usando a porta 3307. Os aplicativos protegidos por um firewall podem precisar ser configurados para permitir conexões de saída na porta TCP 3307. Uma conexão bloqueada por um firewall normalmente resulta em um erro informando falha de conexão ( por exemplo, com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure ).
Para conectar o IntelliJ à sua instância do Cloud SQL, você precisará adicionar esta biblioteca como um jar com dependências na seção "Arquivos adicionais" na página de configurações do driver. Os frascos de gordura pré-construídos não são mais fornecidos (desde a versão 1.14.0).
Aqui estão algumas dicas de solução de problemas para resolver problemas comuns que surgem ao usar o Java Connector:
Certifique-se de usar a versão mais recente do Cloud SQL Connector e do driver de banco de dados para evitar incompatibilidades. Algumas versões mais antigas de drivers não são suportadas.
O conector Java fornece autorização para conexões, mas não fornece novos caminhos para conectividade. Por exemplo, para se conectar a uma instância do Cloud SQL usando um endereço IP privado, seu aplicativo já deve ter acesso VPC.
Este projeto usa versionamento semântico e utiliza o seguinte ciclo de vida em relação ao suporte para uma versão principal:
Ativo - As versões ativas obtêm todos os novos recursos e correções de segurança (que de outra forma não introduziriam uma alteração significativa). As novas versões principais têm garantia de estarem "ativas" por no mínimo 1 ano. Obsoleto - As versões obsoletas continuam a receber correções de bugs críticos e de segurança, mas não recebem novos recursos. As versões obsoletas terão suporte público por 1 ano. Sem suporte - Qualquer versão principal que tenha sido obsoleta por >=1 ano é considerada publicamente sem suporte.
Testamos e oferecemos suporte, no mínimo, a qualquer versão LTS JDK com suporte público. As alterações nas versões suportadas serão consideradas alterações menores e serão listadas nas notas de lançamento.
Este projeto visa uma cadência mínima de lançamento mensal. Se nenhum novo recurso ou correção for adicionado, uma nova versão do PATCH com as dependências mais recentes será lançada.
