DBeaver для аналитика: подключение к PostgreSQL, ClickHouse и выгрузка

Коротко

• DBeaver Community — бесплатный клиент для десятков СУБД: PostgreSQL, ClickHouse, MySQL, SQLite и других.
• Для подключения нужны хост, порт, база, пользователь и пароль. До закрытого сервера ходят через SSH-туннель, настройка — на отдельной вкладке.
• Подключение к рабочей базе отметьте типом Production и включите режим только для чтения: DBeaver спросит подтверждение перед изменяющим запросом или запретит его.
• Ctrl+Enter выполняет запрос под курсором, Alt+X — весь скрипт, Ctrl+\ — запрос в новой вкладке результата. На macOS вместо Ctrl — Cmd.
• По умолчанию DBeaver загружает первые 200 строк. Для выгрузки всего результата используйте экспорт, а не копирование из таблицы.

Что такое DBeaver и какую версию ставить

DBeaver — программа-клиент: сама она данные не хранит, а подключается к серверам баз данных и показывает их таблицы, выполняет запросы и выгружает результаты. Подключение к каждой СУБД идёт через драйвер JDBC, и DBeaver скачивает нужный драйвер сам при первом подключении.

Аналитику хватает бесплатной версии Community. Платные редакции добавляют NoSQL-базы, облачные хранилища и командные функции. Скачать Community можно на dbeaver.io, на macOS удобно поставить через Homebrew: brew install --cask dbeaver-community.

Подключение к PostgreSQL

Нажмите кнопку с вилкой «Новое соединение» на панели слева или выберите в меню «База данных → Новое соединение». В списке выберите PostgreSQL и заполните вкладку «Главное».

После заполнения нажмите «Тест соединения». Если драйвер ещё не скачан, DBeaver предложит его загрузить — согласитесь. Зелёное «Connected» значит, что всё верно. Если тест упал, текст ошибки почти всегда точно называет причину — разбор частых ошибок ниже.

SSH-туннель: подключение к закрытому серверу

Рабочие базы редко открыты в интернет. Часто к ним пускают только с промежуточного сервера (его называют bastion или jump host), а вам выдают доступ по SSH к нему. Тогда на вкладке SSH включите «Use SSH Tunnel», укажите адрес промежуточного сервера, порт 22, пользователя и ключ или пароль.

Поля на вкладке «Главное» при этом заполняются так, как их видит промежуточный сервер: часто host — это внутренний адрес базы или localhost, если база стоит на том же сервере. Если сомневаетесь, спросите администратора, какой адрес у базы «изнутри».

Как не сломать рабочую базу

У каждого подключения в DBeaver есть тип: Development, Test или Production. Тип Production красит подключение в заметный цвет, выключает автоматическую фиксацию изменений и просит подтверждения перед INSERT, UPDATE и DELETE. Выставьте его для любой базы, где лежат настоящие данные, даже если у вашего пользователя прав на запись нет.

Второй уровень защиты — режим только для чтения. Он включается в настройках подключения, в разделе Security: там можно запретить редактирование данных, изменение структуры и выполнение скриптов. Аналитику на реплике этого достаточно: все запросы — SELECT.

Подключение к ClickHouse

В списке СУБД выберите ClickHouse. Официальный драйвер подключается по HTTP: порт 8123 для обычного соединения и 8443 для HTTPS — не путайте с портом 9000, на котором работает консольный клиент. Для облачного ClickHouse включите SSL на вкладке драйвера или выберите порт 8443.

В редакторе SQL действует диалект ClickHouse: свои функции дат (toStartOfMonth, toDate) и свои типы. Запросы, написанные для PostgreSQL, часто приходится немного переписать — об отличиях подробно в статье про ClickHouse для аналитика.

Редактор SQL и горячие клавиши

Редактор открывается кнопкой SQL на панели или сочетанием Ctrl+] — новый скрипт для выбранного подключения. В одном скрипте можно держать несколько запросов: DBeaver разделяет их по точке с запятой и пустым строкам и выполняет тот, на котором стоит курсор.

Параметры в запросе

Один и тот же отчёт часто запускают за разные периоды. Вместо того чтобы править даты в тексте, напишите в запросе параметры с двоеточием: :date_from, :date_to. При выполнении DBeaver откроет окно и спросит значения. Строки и даты вводите в кавычках, как в обычном SQL.

Это возможность самого DBeaver: он подставляет значения до отправки запроса на сервер. В psql или в другой программе такой запрос без замены параметров не выполнится.

select
  plan,
  count(*)    as payments,
  sum(amount) as revenue
from payments
where paid_at >= :date_from
  and paid_at <  :date_to
group by plan
order by revenue desc;

Результат: фильтр, 200 строк и итоги

Результат открывается таблицей под редактором. Строка фильтра над ней дописывает условие к запросу: введите plan = 'pro', и DBeaver перезапросит данные. Щелчок по заголовку столбца сортирует.

По умолчанию DBeaver загружает первые 200 строк, остальные — кнопками «Следующая страница» и «Загрузить все строки» внизу. Это частая ловушка: выделили всё, скопировали в Excel, а там 200 строк вместо двадцати тысяч. Число строк для загрузки меняется в настройках редактора результатов.

Если выделить ячейки с числами, панель справа покажет их количество, сумму, среднее, минимум и максимум. Это быстрый способ сверить итог с дашбордом без отдельного запроса.

Выгрузка в CSV и Excel

Для выгрузки щёлкните правой кнопкой по результату и выберите «Экспорт данных». Мастер предложит формат — CSV, Excel, JSON, SQL INSERT и другие, — кодировку и папку. Экспорт заново выполняет запрос и выгружает все строки, а не только загруженные 200.

Для CSV, который откроют в Excel на русской Windows, поставьте разделитель «;» и кодировку UTF-8 с BOM: иначе кириллица превратится в кракозябры, а все столбцы окажутся в одном. Чтобы скопировать несколько строк в письмо или таблицу вместе с заголовками, используйте расширенное копирование Ctrl+Shift+C.

Схема базы и ER-диаграмма

В дереве слева раскройте подключение → базу → схему → таблицы. Двойной щелчок по таблице открывает её свойства: вкладка «Свойства» показывает столбцы и типы, «Данные» — содержимое, «ER-диаграмма» — связи с другими таблицами по внешним ключам.

Диаграмма полезна в первую неделю на новом месте: она сразу показывает, через какие таблицы связаны заказы и пользователи. Учтите, что связи рисуются только по объявленным внешним ключам. В аналитических базах их часто нет, и тогда схему приходится восстанавливать по названиям столбцов.

Часовой пояс в результатах

DBeaver показывает время в часовом поясе программы, а не сервера. Если запрос в psql и та же таблица в DBeaver показывают разное время, причина обычно здесь. В новых версиях пояс задаётся в настройках («Окно → Параметры → Пользовательский интерфейс → Часовой пояс»), в старых — строкой -Duser.timezone=UTC после -vmargs в файле dbeaver.ini.

Надёжнее не зависеть от клиента вовсе: в запросе переводите время в пояс отчёта явно через AT TIME ZONE. Как это работает — в статье про TIMESTAMP в PostgreSQL.

Частые ошибки подключения

Частые вопросы

Если базы пока нет, писать запросы можно в песочнице на учебной базе, а курс «SQL с нуля» проведёт от первого SELECT до оконных функций с проверкой каждого решения.