Подключение к YDB с помощью DataGrip
DataGrip — это эффективный кросс-платформенный инструмент для работы с реляционными базами данных и NoSQL.
DataGrip позволяет работать с YDB по протоколу Java Database Connectivity (JDBC). Данная статья демонстрирует, как настроить такую интеграцию.
Подключение JDBC-драйвера YDB к DataGrip
Для подключения к YDB из DataGrip понадобится JDBC-драйвер. Для загрузки JDBC-драйвера выполните следующие шаги:
- Перейдите в репозиторий ydb-jdbc-driver.
- Выберите последний релиз (отмечен тегом
Latest
) и сохраните файлydb-jdbc-driver-shaded-<driver-version>.jar
.
Для подключения загруженного JDBC-драйвера выполните следующие шаги:
-
Выберите в верхнем меню DataGrip пункт File, а затем подпункт Data Sources….
Откроется диалоговое окно Data Sources and Drivers.
-
Чтобы создать новый драйвер, в открывшемся окне Data Sources and Drivers перейдите на вкладку Drivers и нажмите кнопку +.
-
В поле Name, укажите
YDB
. -
В разделе Driver Files, нажмите кнопку +, в выпадающем списке выберите Custom JARs…, укажите путь к скачанному ранее JDBC-драйверу YDB (файлу
ydb-jdbc-driver-shaded-<driver-version>.jar
) и нажмите кнопку OK. -
В выпадающем списке Class выберите
tech.ydb.jdbc.YdbDriver
. -
Нажмите кнопку OK.
Создание подключения к YDB
Для создания подключения необходимо выполнить следующие шаги:
-
Выберите в верхнем меню DataGrip пункт File, а затем подпункт Data Sources….
Откроется диалоговое окно Data Sources and Drivers.
-
Чтобы создать новое соединение, в открывшемся окне Data Sources and Drivers на вкладке Data Sources нажмите кнопку + и укажите тип соединения
YDB
. -
В выпадающем списке Authentication укажите тип аутентификации.
-
Если вы выбрали
User & Password
в качестве метода аутентификации, в поля User и Password введите логин и пароль для подключения к базе данных YDB. -
В поле URL, укажите следующую строку соединения:
jdbc:ydb:<ydb_endpoint>/<ydb_database>?useQueryService=true
Где:
ydb_endpoint
— эндпойнт кластера YDB, к которому будут выполняться подключение.ydb_database
— путь к базе данных в кластере YDB, к которой будут выполняться запросы.
-
Нажмите кнопку Test Connection для проверки настроек.
Если все настройки указаны верно, то появится сообщение об успешном тестировании соединения.
-
Нажмите кнопку OK для сохранения соединения.
Работа с YDB
С помощью DataGrip можно просматривать список и структуру таблиц:
А также выполнять запросы к данным: