Как подключиться к базе данных в DBeaver: 6 шагов и разбор ошибок

DBeaver подключается к любой популярной базе данных за пару минут, если знать, что вводить в десяток полей первого окна. Разобрали по шагам подключение к PostgreSQL, MySQL и SQLite, настройку SSH-туннеля и пять типовых ошибок соединения с решениями. Инструкция написана для новичков: каждый термин объяснён, а по чек-листу в конце вы почините даже то подключение, которое не работает непонятно почему.
Статью написал:
Ваня Буявец, продюсер, основатель Checkroi
Ваня Буявец
Основатель Checkroi, продюсер, эксперт в выборе онлайн-курсов
Все 2348 статей автора Подписаться на Телеграм-канал
Одобрено экспертом:
Наташа Буявец, основатель Checkroi, эксперт по онлайн-курсам
Наташа Буявец
Основательница Checkroi, продюсер Youtube-каналов, эксперт по онлайн-курсам
Все 3009 экспертных мнений Подписаться на Телеграм-канал
Обложка: Как подключиться к базе данных в DBeaver: 6 шагов и разбор ошибок

DBeaver открывает почти каждый, кто начинает работать с базами данных: аналитики, тестировщики, будущие разработчики. И почти каждого останавливает первое же окно программы. Хост, порт, драйвер, какая-то строка JDBC: полей десяток, а понятно из них в лучшем случае два.

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

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

Инструкция пригодится не только айтишникам. Подключаться к базам сегодня приходится аналитикам данных, маркетологам, продактам, тестировщикам: всем, кому нужно достать цифры из рабочей системы, не дёргая разработчиков.

А если хотите разобраться с базами данных системно, загляните в подборку курсов по SQL: там сотни программ от коротких интенсивов до полноценных профессий, и DBeaver встречается почти в каждой.

Теперь по порядку.

CheckroiCheckroiПодборка курсов по DBeaver8 курсов • 3 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить

Что такое DBeaver и почему именно он

Рой знакомит с программой DBeaver

DBeaver — это бесплатная программа для работы с базами данных. Через неё можно смотреть таблицы, писать SQL-запросы (команды на специальном языке, которыми у базы просят данные), выгружать результаты в Excel и CSV, редактировать записи. Работает на Windows, macOS и Linux.

Главное удобство в том, что DBeaver понимает почти любую СУБД. СУБД (система управления базами данных) отвечает за хранение информации и доступ к ней: PostgreSQL, MySQL, SQLite, SQL Server, Oracle, ClickHouse и ещё десятки. Вместо отдельного инструмента под каждую базу (pgAdmin для PostgreSQL, Workbench для MySQL) вы ставите одну программу и подключаетесь к чему угодно.

У программы две редакции. Community — бесплатная, её хватает для всего, что описано в этой статье. PRO — платная, с поддержкой NoSQL-баз вроде MongoDB и корпоративными функциями. Новичку нужна Community, скачивается она с официального сайта dbeaver.io, а среда Java, на которой работает программа, уже включена в установщик, ставить её отдельно не нужно.

Важный момент для тех, кто боится что-то сломать: само подключение и просмотр данных ничего не меняют в базе. Пока вы не выполняете команды на изменение и не сохраняете правки в таблицах, база остаётся нетронутой. К тому же на рабочих проектах новичку обычно выдают доступ только на чтение.

Что подготовить перед подключением

Чтобы подключиться к базе, DBeaver нужно знать, где она находится и под каким пользователем в неё входить. Всего пять параметров:

  • Хост — адрес компьютера, где работает база. Это либо IP-адрес вида 192.168.1.10, либо доменное имя вида db.mycompany.ru. Если база стоит на вашем же компьютере, хост будет localhost;
  • Порт — номер «двери», через которую СУБД принимает подключения. У каждой СУБД свой порт по умолчанию: у PostgreSQL это 5432, у MySQL — 3306. Полная таблица ниже;
  • Имя базы данных — на одном сервере может жить несколько баз, и нужно указать, к какой именно вы подключаетесь;
  • Логин и пароль — учётная запись пользователя внутри СУБД. Это отдельные логин и пароль, они не совпадают с входом в Windows или почту.

Откуда всё это взять? Если база рабочая, параметры выдаёт администратор базы данных, тимлид или DevOps-инженер: попросите «доступы к базе для DBeaver», вас поймут. Если база на хостинге или в облаке, параметры лежат в панели управления, в разделе про базы данных. Если вы поставили СУБД себе на компьютер для учёбы, хост будет localhost, а логин с паролем вы задали при установке.

Совет. Если у вас пока нет ни рабочей базы, ни установленной СУБД, начните с SQLite: для неё не нужен сервер, логин и пароль. Как это сделать, разбираем ниже в отдельном разделе.

Канал основателя Checkroi Вани Буявца3 700 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединиться

Как подключиться к базе данных: универсальная инструкция

Рой настраивает новое соединение с базой

Порядок одинаковый для любой СУБД, различаются только значения в полях. Весь процесс занимает пару минут.

Шаг 1: создайте новое соединение

Запустите DBeaver. В верхнем меню выберите «База данных → Новое соединение» или нажмите иконку с вилкой и плюсом в левом верхнем углу. В английском интерфейсе пункт называется Database → New Database Connection.

Шаг 2: выберите тип базы данных

Откроется окно со списком СУБД: PostgreSQL, MySQL, SQLite, Oracle и далее по алфавиту. Выберите свою и нажмите «Далее». Если не знаете, какая СУБД у вашего проекта, спросите того, кто выдал вам доступы: угадать по параметрам подключения можно разве что по номеру порта.

Шаг 3: заполните параметры подключения

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

Шаг 4: разрешите скачать драйвер

При первом подключении к новому типу СУБД программа предложит скачать драйвер. Драйвер — это небольшая библиотека-переводчик, через которую DBeaver разговаривает с конкретной СУБД. Нажмите «Скачать» и подождите несколько секунд. Драйвер скачивается один раз, дальше он уже будет на месте.

Шаг 5: проверьте соединение

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

Шаг 6: сохраните и откройте базу

Нажмите «Готово». Соединение появится слева в «Навигаторе баз данных». Раскройте его: внутри будут схемы и таблицы. Двойной клик по таблице открывает данные, а SQL-редактор для запросов вызывается сочетанием Ctrl+] или через меню «SQL-редактор».

Важный нюанс. Зелёная галочка на иконке соединения означает, что подключение активно. Если после перезапуска программы база «пропала», просто раскройте соединение заново: DBeaver подключается к базе в момент обращения.

Настройки подключения для популярных СУБД

Различия между СУБД при подключении сводятся к порту и паре нюансов. Сохраните таблицу, чтобы не искать эти значения каждый раз:

СУБД Порт по умолчанию База по умолчанию Нюанс
PostgreSQL 5432 postgres Пользователь по умолчанию тоже postgres
MySQL 3306 mysql На новых версиях бывает ошибка Public Key Retrieval, решение ниже
MariaDB 3306 mysql Подключается и через драйвер MySQL
SQL Server 1433 master Выберите способ входа: SQL-логин или учётка Windows
Oracle 1521 Вместо имени базы указывается SID или сервис
ClickHouse 8123 default Порт 8123 для HTTP-подключения, его и использует DBeaver
SQLite Сервера нет, вместо хоста указывается путь к файлу базы

Если вы выбираете, с какой СУБД тренироваться, берите PostgreSQL: это самая востребованная база в вакансиях аналитиков и разработчиков, и курсов по PostgreSQL на рынке больше всего.

CheckroiCheckroiПодборка курсов по PostgreSQL160 курсов • 23 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить

Как подключиться к SQLite и потренироваться без сервера

SQLite — это СУБД, у которой вся база лежит в одном обычном файле на диске. Никакого сервера, логинов и портов. Для первых экспериментов с SQL удобнее варианта нет: сломать нечего, настраивать нечего.

Порядок такой. Создайте новое соединение, в списке СУБД выберите SQLite. В поле Path укажите путь к файлу базы: если у вас уже есть файл с расширением .db или .sqlite, выберите его через «Открыть», а если нет, нажмите «Создать» и DBeaver сделает новый пустой файл. Дальше «Тест соединения» и «Готово», как в универсальной инструкции.

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

Как подключиться к удалённой базе через SSH-туннель

Схема SSH-туннеля от ноутбука к серверу

Частая ситуация на реальных проектах: база живёт на сервере компании и снаружи напрямую недоступна, это базовая мера безопасности. Зато на сервер можно зайти по SSH (протокол защищённого удалённого доступа, тот самый, через который админы управляют серверами из командной строки).

На этот случай в DBeaver встроен SSH-туннель. Работает он так: программа сначала подключается к серверу по SSH, а уже изнутри сервера стучится в базу. Для базы такое подключение выглядит локальным, поэтому она его принимает.

Настройка занимает одну вкладку:

  1. В окне соединения перейдите на вкладку SSH и поставьте галочку «Использовать туннель SSH»;
  2. Заполните хост сервера, порт 22, имя пользователя SSH. Способ аутентификации: пароль или файл приватного ключа, смотря что вам выдали;
  3. Вернитесь на вкладку «Главное». Теперь в поле «Хост» укажите адрес базы с точки зрения сервера: чаще всего это localhost, потому что СУБД работает на той же машине;
  4. Нажмите «Тест соединения»: DBeaver проверит сразу и туннель, и подключение к базе.

Данные для SSH и данные для базы разные: у туннеля свой пользователь и свой способ входа, у СУБД свои логин и пароль. Новички часто вводят одни и те же данные в обе вкладки, и подключение падает.

CheckroiCheckroiПодборка курсов по SQL395 курсов • 32 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить Ваня БуявецКанал основателя Checkroi Вани БуявцаЗабирайте промпты и обучение по нейросетям в моём Телеграм-каналеБольше 3 700 человек уже применяют Claude Code, ChatGPT и другие нейросети в работе, учёбе, бизнесе и жизниПерейти в канал

Ошибки подключения и что с ними делать

Тест соединения проходит не у всех с первого раза, и это нормально. Разберём пять ошибок, на которые приходится почти весь поток вопросов новичков на форумах: каждая решается за несколько минут, если понимать, что она означает.

Connection refused: сервер отказал в подключении

Означает, что по указанному адресу и порту никто не слушает. Три типовые причины. Первая: СУБД просто не запущена, проверьте её статус на сервере или в службах Windows. Вторая: вы ошиблись портом, сверьтесь с таблицей выше и с выданными доступами. Третья, самая коварная: СУБД принимает подключения только со своего компьютера. У PostgreSQL это настройка listen_addresses в конфигурации, у MySQL — bind-address. Если база удалённая и это ваш случай, подключайтесь через SSH-туннель из предыдущего раздела.

Connection timed out: время ожидания истекло

DBeaver стучится, но ответа нет вообще. Обычно это значит, что путь до сервера закрыт: файрвол (сетевой фильтр, который блокирует чужие подключения) не пускает вас на порт базы, либо сервер доступен только из внутренней сети компании. Проверьте, включён ли корпоративный КВН, и уточните у админа, открыт ли порт для вашего IP. И снова: SSH-туннель решает большинство таких ситуаций.

Can’t load driver: не загружается драйвер

Ошибка первого запуска. DBeaver скачивает драйверы из интернета, и если сеть закрыта корпоративным прокси, загрузка падает без внятного сообщения об ошибке. Что делать: в настройках соединения нажмите «Настройки драйвера → Скачать/обновить» и повторите загрузку. Если прокси обязателен, пропишите его в настройках программы в разделе «Соединения». Крайний случай: скачать файл драйвера вручную с сайта СУБД и добавить его в библиотеки драйвера кнопкой «Добавить файл».

Access denied или password authentication failed: неверные логин и пароль

База вас видит, но не пускает. Сначала банальное: проверьте раскладку, пробелы при копировании пароля, регистр логина. Если всё верно, причина в правах: пользователю может быть запрещено подключаться с вашего адреса или к этой конкретной базе. Такое лечится только на стороне сервера, попросите администратора выдать права.

Public Key Retrieval is not allowed: особенность новых MySQL

Фирменная ошибка при подключении к MySQL 8. Лечится за минуту: откройте настройки соединения, вкладка «Свойства драйвера», найдите свойство allowPublicKeyRetrieval и поставьте значение true. Сохраните и повторите тест соединения.

Запомнить. Ошибки читаются по первым словам: refused значит «стучитесь не туда», timed out означает «вас не пускает сеть», а access denied указывает на логин или права. Одно это правило экономит часы на форумах.

Не подключается: чек-лист проверки по порядку

Рой проходит чек-лист проверки подключения

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

  1. Запущена ли СУБД вообще? Локально: посмотрите в службах. Удалённо: спросите админа;
  2. Верный ли хост и порт? Сверьте с выданными доступами посимвольно;
  3. Пароль вводится или копируется? При копировании часто прилетает лишний пробел;
  4. Есть ли доступ к серверу из вашей сети? Включите КВН, если он есть в компании;
  5. Скачан ли драйвер? Загляните в настройки драйвера и обновите его;
  6. Не нужен ли SSH-туннель? Если база на удалённом сервере и напрямую не отвечает, почти наверняка нужен.

Девять из десяти проблем с подключением закрываются этим списком. Оставшаяся десятая обычно означает нестандартную конфигурацию сервера, и тут быстрее спросить того, кто эту конфигурацию делал.

Что делать после подключения

Подключение — это входная дверь, самое интересное за ней. Дальше стоит освоить три вещи: просмотр и фильтрацию таблиц, SQL-запросы в редакторе и экспорт результатов в Excel или CSV. На этой тройке держится вся ежедневная работа с данными, будь вы SQL-аналитик или тестировщик.

Если чувствуете, что упираетесь в незнание самого языка запросов, это нормальный этап: DBeaver лишь инструмент, а думает запросами человек. Быстрее всего этот пробел закрывается на курсе с наставником и практикой на реальных базах: прогресс там заметнее, чем на разрозненных роликах с Ютуба. Мы собрали подборку курсов, где обучение работе в DBeaver и SQL начинается с нуля:

КурсШколаСтоимость со скидкойВ рассрочкуДлитель­ностьОбзор курса от Checkroi
Бизнес-аналитик: тариф Базовый
Перейти на сайт курса
Академия ЭдюсонЭдюсон109 900 ₽4579 ₽/мес.6 месяцевОбзор курса
Бизнес-аналитик: тариф PRO
Перейти на сайт курса
Академия ЭдюсонЭдюсон136 395 ₽5683 ₽/мес.6 месяцевОбзор курса
ETL-разработчик: пайплайны, хранилища данных и BI-решения
Перейти на сайт курса
НетологияНетология41 300 ₽2294 ₽/мес.5 месяцевОбзор курса
SQL и получение данных
Перейти на сайт курса
НетологияНетология33 900 ₽2313 ₽/мес.9 недельОбзор курса
Бизнес-аналитик: тариф Мастер
Перейти на сайт курса
Академия ЭдюсонЭдюсон176 295 ₽7345 ₽/мес.6 месяцевОбзор курса
SQL-разработчик: тариф PRO
Перейти на сайт курса
Академия ЭдюсонЭдюсон89 900 ₽7491 ₽/мес.2 месяцаОбзор курса
SQL для работы с данными и аналитики
Перейти на сайт курса
Яндекс ПрактикумЯндекс Практикум49 000 ₽14 700 ₽/мес.2 месяцаОбзор курса
DataLens: анализ и визуализация данных
Перейти на сайт курса
Яндекс ПрактикумЯндекс ПрактикумБесплатно - 15 часовОбзор курса

Больше программ — в полном каталоге курсов по DBeaver

А если хотите превратить работу с базами в профессию, посмотрите наши разборы: как стать администратором баз данных с планом на 12 месяцев и кто такой SQL-разработчик с задачами и зарплатами.

Часто задаваемые вопросы

Можно ли пользоваться DBeaver бесплатно?

Да. Редакция DBeaver Community бесплатна и для личных, и для рабочих задач: в ней есть подключение ко всем популярным реляционным СУБД, SQL-редактор, экспорт данных. Платная версия PRO нужна для NoSQL-баз вроде MongoDB и корпоративных функций, новичку она не требуется.

Какие данные нужны, чтобы подключиться к базе данных?

Пять параметров: хост (адрес сервера с базой), порт, имя базы данных, логин и пароль пользователя СУБД. На рабочем проекте их выдаёт администратор или DevOps-инженер, на хостинге они лежат в панели управления, а для локальной базы хостом будет localhost.

Почему DBeaver не подключается к базе данных?

Четыре самые частые причины: СУБД не запущена, ошибка в хосте или порте, не скачался драйвер, доступ закрыт файрволом или настройками сервера. Начните с ошибки в окне теста соединения: refused указывает на неверный адрес или выключенный сервер, timed out на сетевой запрет, access denied на логин и права.

Как подключиться к PostgreSQL в DBeaver?

Создайте новое соединение, выберите PostgreSQL, укажите хост, порт 5432, имя базы, логин и пароль, затем нажмите «Тест соединения» и «Готово». При первом подключении программа предложит скачать драйвер, соглашайтесь. База и пользователь по умолчанию называются postgres.

Нужно ли ставить Java, чтобы работал DBeaver?

Нет. Свежие установщики DBeaver уже включают среду Java, поэтому отдельно ставить и настраивать её не нужно. Достаточно скачать дистрибутив с официального сайта dbeaver.io и установить как обычную программу.

Чем DBeaver отличается от pgAdmin?

pgAdmin работает только с PostgreSQL, а DBeaver понимает десятки СУБД: PostgreSQL, MySQL, SQLite, SQL Server, Oracle, ClickHouse и другие. Если вы работаете с несколькими базами или ещё выбираете направление, DBeaver практичнее: один инструмент закрывает все подключения.

Можно ли сломать базу, просто подключившись к ней?

Нет. Подключение и просмотр таблиц ничего не меняют в данных. Риск появляется только при выполнении команд на изменение и удаление, поэтому новичкам на рабочих проектах обычно выдают доступ только на чтение. Для безопасных экспериментов подойдёт локальная база SQLite.

Как подключиться к базе на удалённом сервере, если напрямую она недоступна?

Через SSH-туннель: в настройках соединения откройте вкладку SSH, включите туннель и укажите данные для входа на сервер, а на главной вкладке пропишите адрес базы с точки зрения сервера, обычно localhost. DBeaver сначала зайдёт на сервер по SSH и уже оттуда подключится к базе.

Читайте Checkroi первым в Google
Добавьте Checkroi в избранные источники — и наши разборы курсов и обзоры школ будут показываться выше в вашей выдаче Google.
Оставить комментарий
0 комментариев
Форма комментария

Оставьте комментарий

Напишите, что думаете. Нам важно ваше мнение!