Подключение к YDB с помощью DataGrip

DataGrip — это эффективный кросс-платформенный инструмент для работы с реляционными базами данных и NoSQL.

DataGrip позволяет работать с YDB по протоколу Java Database Connectivity (JDBC). Данная статья демонстрирует, как настроить такую интеграцию.

Подключение JDBC-драйвера YDB к DataGrip

Для подключения к YDB из DataGrip понадобится JDBC-драйвер. Для загрузки JDBC-драйвера выполните следующие шаги:

  1. Перейдите в репозиторий ydb-jdbc-driver.
  2. Выберите последний релиз (отмечен тегом Latest) и сохраните файл ydb-jdbc-driver-shaded-<driver-version>.jar.

Для подключения загруженного JDBC-драйвера выполните следующие шаги:

  1. Выберите в верхнем меню DataGrip пункт File, а затем подпункт Data Sources….

    Откроется диалоговое окно Data Sources and Drivers.

  2. Чтобы создать новый драйвер, в открывшемся окне Data Sources and Drivers перейдите на вкладку Drivers и нажмите кнопку +.

  3. В поле Name, укажите YDB.

  4. В разделе Driver Files, нажмите кнопку +, в выпадающем списке выберите Custom JARs…, укажите путь к скачанному ранее JDBC-драйверу YDB (файлу ydb-jdbc-driver-shaded-<driver-version>.jar) и нажмите кнопку OK.

  5. В выпадающем списке Class выберите tech.ydb.jdbc.YdbDriver.

    драйвер

  6. Нажмите кнопку OK.

Создание подключения к YDB

Для создания подключения необходимо выполнить следующие шаги:

  1. Выберите в верхнем меню DataGrip пункт File, а затем подпункт Data Sources….

    Откроется диалоговое окно Data Sources and Drivers.

  2. Чтобы создать новое соединение, в открывшемся окне Data Sources and Drivers на вкладке Data Sources нажмите кнопку + и укажите тип соединения YDB.

  3. В выпадающем списке Authentication укажите тип аутентификации.

  4. Если вы выбрали User & Password в качестве метода аутентификации, в поля User и Password введите логин и пароль для подключения к базе данных YDB.

  5. В поле URL, укажите следующую строку соединения:

    jdbc:ydb:<ydb_endpoint>/<ydb_database>?useQueryService=true
    

    Где:

    • ydb_endpointэндпойнт кластера YDB, к которому будут выполняться подключение.
    • ydb_database — путь к базе данных в кластере YDB, к которой будут выполняться запросы.
  6. Нажмите кнопку Test Connection для проверки настроек.

    Если все настройки указаны верно, то появится сообщение об успешном тестировании соединения.

    соединение

  7. Нажмите кнопку OK для сохранения соединения.

Работа с YDB

С помощью DataGrip можно просматривать список и структуру таблиц:

список таблиц

А также выполнять запросы к данным:

выполнение SQL