Cloud SQL Фабрика сокетов JDBC
1.21.0
Cloud SQL Connector для Java – это библиотека, которая обеспечивает авторизацию и шифрование на основе IAM при подключении к экземпляру Cloud SQL. Он не может предоставить сетевой путь к экземпляру Cloud SQL, если он еще не существует. Дополнительную информацию о подключении к экземпляру Cloud SQL см. на странице «Обзор подключения».
Информацию об использовании, специфичную для вашего ядра базы данных и драйвера, см. на страницах ниже:
Подключение к Cloud SQL с помощью JDBC
Подключение к Cloud SQL с помощью R2DBC
Примеры использования этой библиотеки в контексте приложения можно найти в примерах приложений, расположенных здесь.
Эта библиотека использует стратегию учетных данных приложения по умолчанию (ADC) для разрешения учетных данных. Ознакомьтесь с этими инструкциями, чтобы узнать, как настроить ADC (облачное приложение Google или локальная разработка, учетные данные пользователя IAM или учетной записи службы).
---
Чтобы создать толстый JAR-файл, содержащий драйвер JDBC с зависимостями Socket Factory пакетов, вы можете выполнить следующую команду Maven из местоположения, содержащего проект pom.xml:
mvn -P jar-with-dependencies clean package -DskipTests
Это создаст целевую подпапку в каждом каталоге модуля. В этих целевых каталогах вы найдете файлы драйверов JDBC.
Пример:
mysql-socket-factory-connector-j-8–1.8.0-jar-with-dependencies.jar postgres-socket-factory-1.8.0-jar-with-dependencies.jar
Java Connector поддерживает дополнительное ведение журнала отладки, что помогает диагностировать проблемы с фоновым обновлением сертификата. Чтобы включить его, добавьте в файл /src/main/resources/application.yml следующее:
logging.level.root=DEBUG
Прокси-сервер Cloud SQL устанавливает соединения с экземплярами Cloud SQL, используя порт 3307. Приложениям, защищенным брандмауэром, возможно, потребуется настроить разрешение исходящих подключений через TCP-порт 3307. Соединение, заблокированное брандмауэром, обычно приводит к ошибке, указывающей на сбой соединения ( например com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure ).
Чтобы подключить IntelliJ к вашему экземпляру Cloud SQL, вам нужно будет добавить эту библиотеку в виде jar с зависимостями в разделе «Дополнительные файлы» на странице настроек драйвера. Готовые жировые банки больше не предоставляются (начиная с версии 1.14.0).
Вот несколько советов по устранению распространенных проблем, возникающих при использовании Java Connector:
Убедитесь, что вы используете последнюю версию Cloud SQL Connector и драйвера базы данных, чтобы избежать несовместимости. Некоторые старые версии драйверов не поддерживаются.
Соединитель Java обеспечивает авторизацию подключений, но не предоставляет новых путей подключения. Например, чтобы подключиться к экземпляру Cloud SQL с использованием частного IP-адреса, ваше приложение уже должно иметь доступ к VPC.
В этом проекте используется семантическое управление версиями и следующий жизненный цикл поддержки основной версии:
Активный — активные версии получают все новые функции и исправления безопасности (которые в противном случае не привели бы к критическим изменениям). Новые основные версии гарантированно будут «активны» в течение как минимум 1 года. Устарело . Устаревшие версии продолжают получать исправления безопасности и критические ошибки, но не получают новых функций. Устаревшие версии будут публично поддерживаться в течение 1 года. Неподдерживаемая — любая основная версия, которая устарела в течение >=1 года, считается публично неподдерживаемой.
Мы тестируем и поддерживаем как минимум любую общедоступную версию LTS JDK. Изменения в поддерживаемых версиях будут считаться незначительными изменениями и будут указаны в примечаниях к выпуску.
Этот проект нацелен на минимальную ежемесячную частоту выпусков. Если новые функции или исправления не были добавлены, выпускается новая версия PATCH с последними зависимостями.
