Table of contents
- Overview
- Windows and MacOS installer
- ZIP archive
- Debian Package
- RPM Package
- Automatic updates
Overview
The installation process depends on the distribution type and your operating system.
DBeaver supports the following operating systems:
- Microsoft Windows: Windows 8.1, Windows Server 2012 or later versions.
- Windows Server: Windows Server 2016 or later versions.
- macOS: macOS 11 or later versions.
- Linux: Most modern distributions.
For downloading the product, please visit the appropriate links below:
- DBeaver PRO Products.
- DBeaver Community Edition.
Windows and MacOS installer
The installer distribution is the recommended method for installing DBeaver on Windows and MacOS. It includes all
necessary dependencies. Additionally, the installer automatically upgrades DBeaver to the new version if a previous
version is already installed. To install DBeaver, run the installer executable and follow the on-screen instructions.
Note:
- The installer does not modify any system settings or the Java installation.
- The included JDK is accessible only to DBeaver.
- DBeaver includes OpenJDK, which is an open-source version of Java. This means you do not need to purchase a separate
Java license to use DBeaver.
ZIP archive
To install DBeaver manually without using an installer:
-
Extract the contents of the archive.
Note:
- Do not unzip the archive over a previous version of DBeaver. If you already have any version of DBeaver extracted
in the same location, remove it before unzipping the new version. - All configurations, scripts, and other necessary data are stored in a separate location (usually in the user’s
home directory), so uninstalling the program does not affect them.
- Do not unzip the archive over a previous version of DBeaver. If you already have any version of DBeaver extracted
-
Run the dbeaver executable.
Debian Package
To install DBeaver using a Debian package:
- Run
sudo dpkg -i dbeaver-<version>.deb
. - Execute
dbeaver &
.
RPM Package
To install DBeaver using an RPM package:
- Run
sudo rpm -ivh dbeaver-<version>.rpm
. - Execute
dbeaver &
.
Note: To upgrade DBeaver to a newer version, use the
-Uvh
parameter. For
instance:sudo rpm -Uvh dbeaver-<version>.rpm
.
Automatic updates
This feature is available only on Windows and macOS.
Periodically, DBeaver automatically checks for new versions. If the check is not disabled and a new version is
available, it will prompt you to decide whether to upgrade. If you choose to upgrade, the installer will be downloaded
and launched automatically upon completion.
Note: DBeaver itself will be gracefully closed to avoid data loss.
DBeaver — это бесплатное программное обеспечение для работы с базами данных. При помощи DBeaver можно создавать новые базы данных, объекты и управлять данными в базе данных, а также выполнять SQL-запросы.
Открываем страницу на официальном сайте DBeaver и выбираем необходимый дистрибутив для загрузки.
Запускаем загруженный файл. Выбираем язык для дальнейшей установки, нажимаем — ОК.
Пропускаем экран приветствия, нажимаем — Далее.
Принимаем условия лицензионного соглашения, нажимаем — Принимаю.
Выбираем для кого будет установлено программное обеспечение, то есть, для всех пользователей компьютера или только для одного пользователя. Выбираем пункт — For anyone who uses this computer (all users) и нажимаем — Далее.
Отмечаем компоненты, которые необходимо установить: DBeaver Community и Include Java, нажимаем — Далее.
Указываем директорию для установки DBeaver, и нажимаем — Далее.
Выбираем директорию в меню пуск, в которую будут помещены ярлыки DBeaver. Нажимаем — Установить.
Пошёл процесс установки.
Установка программного обеспечения DBeaver закончена, ставим галочку на пункте — Create desktop Shortcut, и нажимаем — Готово.
На рабочем столе появился ярлык для запуска DBeaver, и теперь можно запустить программное обеспечение.
Метки: DBeaver.
Установка СУБД PostgreSQL
Для Windows
Если дистрибутив предоставлен в виде архива, его необходимо распаковать.
Для установки СУБД PostgreSQL выполняются следующие действия:
- Запустить командную строку от имени администратора и запустить службу Secondary Logon:
net start seclogon
- Запустить установочный файл «postgresql-15.8-5.1C(x64).msi» (без -int в конце имени). Будет запущен мастер установки:
- Выбрать язык установки Russian / Russian и нажать кнопку Start.
- В следующем окне мастера установки (с предложением завершить все выполняющиеся программы) нажать кнопку «Далее».
- В следующем окне мастера установки (Опции установки) нажать кнопку «Далее», не меняя опции (если не требуется).
- В следующем окне мастера установки (Инициализировать кластер базы данных) нужно задать параметры инициализации, после чего нажать кнопку «Далее» (Порт по умолчанию – 5432, Локаль – Russian, Russian):
- В следующем окне мастера установки (Готово к установке) нужно нажать кнопку «Далее».
- Дождаться окончания процесса установки.
- В следующем окне (Инсталляция завершена) убрать флаг «По выходу запустить Stack Builder» и нажать кнопку «Завершить»:
- После завершения установки нужно запустить «psql» и вводим необходимые запросы:
- Создать отдельного суперпользователя modus для подключения к базам из модулей системы:
CREATE ROLE modus WITH LOGIN SUPERUSER PASSWORD 'пароль';
- Создаем новую базу данных с именем dwh для использования в качестве хранилища данных:
CREATE DATABASE dwh;
- Создаем новую базу данных с именем modusbi для хранения метаданных Модуля АП (или можно пропустить и создать во время установки АП):
CREATE DATABASE modusbi;
Установка завершена.
Для Linux
Перед установкой желательно настроить разрешение имен, позволяющее получать IP-адрес сервера. Если сетевая служба разрешения имен не используется, то в файле “/etc/hosts” должно быть указано соответствие IP-адреса и имени сервера.
Чтобы узнать свой адрес сети, можно ввести команду ip addr
. Например, для сервера с полным именем 1c.example.ru и IP-адресом 192.168.122.159 должна быть указана строка вида:
# sudo nano /etc/hosts
127.0.0.1 localhost
192.168.122.159 1c.example.ru 1c-example
Чтобы открыть файл на редактирование можно воспользоваться командой:
sudo nano <путь к файлу>
Установить пакеты СУБД PostgreSQL (указать каталог с дистрибутивом):
sudo apt install -y ./postgresql_15.6/*.deb
Далее зайти и задать пароль пользователю postgres и создать отдельного суперпользователя для подключения к базам из модулей системы.
Переключаемся на пользователя postgres для управления базой данных:
sudo su – postgres
Запускаем интерактивную оболочку PostgreSQL для выполнения SQL-запросов:
psql
Изменяем пароль для роли postgres на указанный пароль для повышения безопасности:
ALTER ROLE postgres WITH PASSWORD 'пароль';
Cоздать отдельного суперпользователя modus для подключения к базам из модулей системы:
CREATE ROLE modus WITH LOGIN SUPERUSER PASSWORD 'пароль';
И при желании сразу создать базы данных для компонентов системы (базы данных можно создать и во время установки самих компонентов системы).
Создаем новую базу данных с именем modusbi для хранения метаданных Модуля АП:
CREATE DATABASE modusbi;
Создаем новую базу данных с именем dwh для использования в качестве хранилища данных:
CREATE DATABASE dwh;
После этого, отключить возможность обновления связанных пакетов:
apt-mark hold libpq5
apt-mark hold postgresql-15
apt-mark hold postgresql-client-15
Установка СУБД завершена.
Установка и настройка инструмента DBeaver
DBeaver — это клиентское приложение SQL и инструмент администрирования базы данных. Он может потребоваться для администрирования базы данных, построения и отладки сложных запросов и оперативного просмотра объектов базы.
Для Linux — установка происходит командой в терминале (файл *.deb) или запуском установочного файла в графическом режиме.
Так же, после установки, DBeaver должен быть доступен в меню приложений.
Установка для Linux и Windows в графическом режиме.
- Запустить установочный файл.
- В появившемся окне выбрать язык и нажать кнопку «OK».
- Откроется мастер установки. Следуйте указаниям мастера установки.
- На этапе выбора компонентов — выбрать все компоненты программы.
- Выбрать папку для установки программы или оставить по умолчанию.
- После начала процесса установки – дождаться ее окончания.
- По завершению нажать «Готово».
Программа установлена.
Создание нового соединения с БД
Для Подключения к БД необходимо установить драйвер, в данном случае для PostgreSQL.
Если компьютер подключен к сети интернет, то файлы можно скачать автоматически при подключении базы. Если скачивание не доступно, тогда необходимо добавить драйвер вручную. Для этого нужно:
- Подготовить файл драйвера.
- Зайти в программу DBeaver.
- Перейти в меню «База данных» → «Управление драйверами».
- В открывшемся «Менеджере драйверов» выбрать PostgreSQL и нажать «Изменить».
- В редакторе драйвера перейти на вкладку «Библиотеки».
- Удалить все компоненты, если они присутствуют.
- Нажать «Добавить файл» и выбрать файл драйвера.
- После этого нажать «OK» и закрыть окно «Менеджера драйверов».
Далее можно приступать к соединению с базой данных. Для этого нужно:
- В программе DBeaver выбрать «Новое соединение» в меню «База данных» или нажать на соответствующий значок:
- Выбрать тип базы данных, с которой нужно создать соединение – PostgreSQL.
- Указать параметры соединения — хост, порт, имя пользователя и пароль.
- Для проверки ввода данных и работы соединения нажмите на кнопку «Тест соединения».
- Если подключение установлено успешно, нажать кнопку «Сохранить» для создания соединения.
- Созданное соединение можно открыть, дважды щёлкнув по нему в списке соединений.
Соединение с базой данных установлено.
Для управления базами данных витрины рекомендуется использовать DBeaver — это бесплатное программное обеспечение с открытым исходным кодом для управления базами данных (БД). Для взаимодействия с реляционными БД в витрине используется программный интерфейс JDBC (через JDBC-драйвер).
Для подключения к базе данных витрины необходимо выполнить следующие действия:
- установить приложение DBeaver (менеджер баз данных);
- получить у системного программиста учетные записи для доступа к базе данных (название БД, логин и пароль пользователя БД);
- настроить приложение DBeaver;
- установить и настроить JDBC-драйвер для работы с базой данных витрины;
- выполнить проверку подключения к базе данных витрины.
Установка приложения DBeaver
Для установки DBeaver скачайте дистрибутив приложения с официального сайта https://dbeaver.io/download/.
Установите программу стандартным способом в соответствии с операционной системой, установленной на вашем компьютере.
Установка и настройка JDBC-драйвера
Дистрибутив с актуальной версией JDBC-драйвера находится в установочном пакете витрины данных.
Процесс установки JDBC-драйвера и настройки подключения к базам данных в приложении Dbeaver, работающем под операционными системами Windows или Linux (на примере Ubuntu, версия 20.04), идентичный. Для этого выполните следующие действия:
- Откройте приложение Dbeaver;
- В главном меню приложения выберите Базы данных/Database и нажмите пункт Управление драйверами/Driver Manager;
- В открывшемся окне Менеджер драйверов/Driver Manager нажмите кнопку Новый/New;
- В открывшемся окне Создать драйвер/Create new driver заполните следующую информацию:
- Имя драйвера/Driver Name: DtmDriver;
- Имя класса/Class Name: ru.datamart.prostore.jdbc.Driver;
- Шаблон URL/URL Template: jdbc:prostore://{host}:{port}.
- Установите галочку в поле Без авторизации/No authentication и Пустой пароль/Allow Empty Password;
- Во вкладке Библиотеки/Libraries нажмите кнопку Добавить файл и укажите путь к jar-файлу JDBC-драйвера укажите путь к jar-файлу с JDBC-драйвер;
- Нажмите кнопку Ок;
- Проверьте, что драйвер был добавлен в приложение. Для этого откройте окно Менеджер драйверов»/«Driver Manager (Базы данных/Database > Управление драйверами/Driver Manager) и в поисковой строке введите название драйвера – DtmDriver.
Подключение к базе данных витрины для ОС Windows/Linux
Для подключения к базам данных через JDBC-драйвер, выполните следующие действия:
- Откройте Dbeaver;
- В главном меню приложения выберите пункт База данных/Database > Новое соединение/Connect to a Database;
- В окне Создать соединение/Connect to a Database в поисковой строке введите dtmdriver;
- Выберите DtmDriver и нажмите кнопку Далее/Next;
- Нажмите кнопку Тест соединения/Connection test для проверки подключения.
- Закройте окно проверки соединения, для этого нажмите кнопку OK;
- В окне Настройка базового соединения/Connection Settings нажмите кнопку Готово/Finish.
В окне Настройка соединения/Connection Settings заполните следующие поля:
— Хост — DNS-name или IP адрес сервера базы данных. Например, 172.16.0.17.
— Порт — порт для сервера базы данных, например, 9090.
В результате выполненных действий, в поле JDBC URL будет отображено следующее значение jdbc:prostore://172.16.0.17:9090;
В случае успешного подключение отобразится сообщение о корректном подключении:
Проверка загрузки данных в БД витрины
Для проверки загрузки данных следует выполнить на тестовом стенде следующие действия:
1. Откройте приложение Dbeaver, установите подключение к БД витрины и проверьте, что логическая БД test_upload_data отсутствует, для этого выполните следующий sql-запрос:
FROM INFORMATION_SCHEMA.schemata
WHERE schema_name = UPPER(‘test_upload_data’);
Результат выполнения должен быть Пустым.
2. Для создания тестовой БД с таблицей Trip выполните следующий sql-запрос:
CREATE TABLE test_upload_data.trip (
id varchar NULL,
«number» int NOT NULL,
duration varchar NULL,
length float NULL,
PRIMARY KEY (number))
DISTRIBUTED BY (number);
3. Для проверки, что логическая БД test_upload_data создана, выполните sql-запрос:
FROM INFORMATION_SCHEMA.schemata
WHERE schema_name = UPPER(‘test_upload_data’);
SQL-запрос должен вернуть одну строку, в которой поле SCHEMA_NAME имеет значение TEST_UPLOAD_DATA
4. Для проверки, что в созданной БД существует таблица Trip, выполните sql-запрос:
FROM INFORMATION_SCHEMA.tables
WHERE table_schema = UPPER(‘test_upload_data’);
SQL-запрос должен вернуть запись о созданной логической таблице.
5. Для вставки произвольных данных в таблицу Trip выполните последовательно следующие sql-запросы:
(id, «number», duration, «length»)
VALUES(‘a001’, 1, ‘Moscow’, 800),(‘a002’, 2, ‘Saratov’, 680) ,(‘a003’, 3, ‘Omsk’, 890);
6. Для проверки загрузки данных выполните следующий sql-запрос:
SELECT COUNT(*) FROM test_upload_data.trip;
SQL-запрос должен вернуть значение 3 – три созданных строки в таблице.
Процесс установки зависит от типа дистрибутива и используемой Вами ОС.
Windows и MacOS
Рекомендованный способ установки DBeaver – использование установщика для Windows и MacOS X который уже содержит в себе все зависимости. Кроме того, при необходимости установщик автоматически обновляет текущую версию DBeaver до новой версии. Для установки DBeaver запустите исполняемый файл программы установки и следуйте инструкциям, появившимся на экране.
NB:
- Установщик не меняет никаких системных настроек или настройки установленной версии Java
- Включенный в состав установщика JDK будет доступен только для DBeaver
ZIP архив
DBeaver можно установить и вручную, без использования установщика:
- Извлеките содержимое из архива
NB: Не распаковывайте архив в том случае, если запущена предыдущая версия DBeaver. Заранее проверьте, не стоит ли на Вашем компьютере предыдущая версия DBeaver. Если она установлена и находится в этой же папке, обязательно удалите ее до распаковки архива.
NB: Все настройки, скрипты и другие необходимые данные хранятся в отдельной папке — обычно это домашняя директория пользователя. Поэтому удаление программы никак не затронет их.
- Запустите исполняемый файл DBeaver
Пакет Debian
Для установки DBeaver с помощью пакета Debian:
- выполните sudo dpkg -i dbeaver-<version>.deb.
- выполните dbeaver &.
Пакет RPM
Для установки DBeaver с помощью пакета RPM:
- выполните sudo rpm -ivh dbeaver-<version>.rpm.
- выполните dbeaver &.
NB: для обновления DBeaver до новой версии используйте sudo rpm -Uvh dbeaver-<version>.rpm parameter.
Автоматическое обновление
Доступно только для Windows и MacOS.
Периодически DBeaver проверяет наличие новых версий. Если эта опция не отключена, и система обнаружила новую доступную версию, Вас спросят, хотите ли Вы оставить текущую версию или обновить ее. Если Вы решите обновиться, DBeaver автоматически запустит установщик. При этом сама программа закроется – так Ваши данные не будут потеряны.