---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/integrations/gui/dbeaver.md?version=v26.1
  - https://ydb.tech/docs/ru/integrations/gui/dbeaver.md?version=v26.1
  - href: ru/integrations/gui/dbeaver.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/integrations/gui/dbeaver.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

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

[DBeaver](https://dbeaver.com) — бесплатный кроссплатформенный инструмент управления базами данных с открытым исходным кодом, обеспечивающий визуальный интерфейс для подключения к различным базам данных и выполнения SQL-запросов. Он поддерживает множество систем управления базами данных, включая MySQL, PostgreSQL, Oracle и SQLite.

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

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

Для подключения к YDB из DBeaver понадобится 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. Выберите в верхнем меню DBeaver пункт **База данных**, а затем подпункт **Управление драйверами**:

    ![управление драйверами](./_assets/dbeaver-driver-management_ru.png)

1. Чтобы создать новый драйвер, в открывшемся окне **Менеджер Драйверов** нажмите кнопку **Новый**:

    ![создание нового драйвера](./_assets/dbeaver-driver-create-new-driver_ru.png)

1. В открывшемся окне **Создать драйвер**, в поле **Имя драйвера**, укажите `YDB`:

    ![выбор имени](./_assets/dbeaver-driver-create-new-driver-set-name_ru.png)

1. Перейдите в раздел **Библиотеки**, нажмите кнопку **Добавить файл**, укажите путь к скачанному ранее JDBC-драйверу YDB (файлу `ydb-jdbc-driver-shaded-<driver-version>.jar`) и нажмите кнопку **OK**:

    ![управление драйверами](./_assets/dbeaver-driver-management-driver_ru.png)

1. В списке драйверов появится пункт **YDB**. Дважды кликните по новому драйверу и перейдите на вкладку **Библиотеки**, нажмите кнопку **Найти Класс** и в выпадающем списке выберите `tech.ydb.jdbc.YdbDriver`.

    {% note warning %}

    Обязательно явно выберите пункт выпадающего списка `tech.ydb.jdbc.YdbDriver`, нажав на него. В противном случае DBeaver будет считать, что драйвер не был выбран.

    {% endnote %}

    ![выбор драйвера](./_assets/dbeaver-driver-management-driver_set.png)

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

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

1. В DBeaver создайте новое соединение, указав тип соединения `YDB`.
1. В открывшемся окне перейдите в раздел **Главное**.
1. В подразделе **Общие**, в поле ввода **JDBC URL**, укажите следующую строку соединения:

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

    Где:

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

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

1. В поля **Пользователь** и **Пароль** введите логин и пароль для подключения к базе данных. Полный список способов аутентификации и строк подключения к YDB приведён в описании [JDBC-драйвера](https://github.com/ydb-platform/ydb-jdbc-driver).

{% note info %}

В Managed-инсталляциях YDB недоступна аутентификация по логину и паролю.

{% endnote %}

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

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

    ![проверка соединения](./_assets/dbeaver-connection-test.png =400x)

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

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

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

![структура таблиц](./_assets/dbeaver-table-structure.png)

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

![выполнение запроса](./_assets/dbeaver-query.png)