---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.4
alternate:
  - https://ydb.tech/docs/en/integrations/gui/datagrip.md
  - https://ydb.tech/docs/ru/integrations/gui/datagrip.md
sourcePath: ru/core/integrations/gui/datagrip.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

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

[DataGrip](https://www.jetbrains.com/datagrip/) — это эффективный кросс-платформенный инструмент для работы с реляционными базами данных и NoSQL.

DataGrip позволяет работать с YDB по протоколу Java Database Connectivity ([JDBC](https://ru.wikipedia.org/wiki/Java_Database_Connectivity)). Данная статья демонстрирует, как настроить такую интеграцию.

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

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

1. Перейдите в [репозиторий ydb-jdbc-driver](https://github.com/ydb-platform/ydb-jdbc-driver/releases).
1. Выберите последний релиз (отмечен тегом `Latest`) и сохраните файл `ydb-jdbc-driver-shaded-<driver-version>.jar`.

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

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

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

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

1. В поле **Name**, укажите `YDB`.

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

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

   ![драйвер](./_assets/datagrip-ydb-driver.png)

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

## Создание подключения к YDB {#datagrip_ydb_connection}

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

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

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

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

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

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

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

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

    Где:

    - `ydb_endpoint` — [эндпойнт](https://ydb.tech/docs/ru/concepts/connect.md#endpoint) кластера YDB, к которому будут выполняться подключение.
    - `ydb_database` — путь к [базе данных](https://ydb.tech/docs/ru/concepts/glossary.md#database) в кластере YDB, к которой будут выполняться запросы.

1. Нажмите кнопку **Test Connection** для проверки настроек.

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

    ![соединение](./_assets/datagrip-ydb-connection.png)

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

## Работа с YDB {#dbeaver_ydb_connection}

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

![список таблиц](./_assets/datagrip-list-tables.png)

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

![выполнение SQL](./_assets/datagrip-run-sql.png)