Установка сервера PostgreSQL должна осуществляться системным администратором или пользователем с правами администратора на данном компьютере. Перед началом установки рекомендуется закрыть все другие приложения.

Поддерживается PostgreSQL начиная с версии 14.6, а также совместимые, включая Postgres Pro.

Ссылки на скачивание и руководство по установке PostgreSQL:

для Windows: https://www.postgresql.org/download/windows/
для Linux:
- Debian: https://www.postgresql.org/download/linux/debian/
- Red Hat family: https://www.postgresql.org/download/linux/redhat/
- SUSE: https://www.postgresql.org/download/linux/suse/
- Ubuntu: https://www.postgresql.org/download/linux/ubuntu/

Для установки PostgreSQL нужно запустить установочный файл и следовать инструкциям на экране. В окне Параметры сервера требуется указать пароль администратора, задать порт и установить флажок Настроить переменные среды.

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

Загрузка и сохранение баз данных

При использовании сервера PostgreSQL версии 16 или ниже загрузка и сохранение баз данных осуществляются средствами Business Studio (см. Управление базами данных).

При использовании операционной системы Linux и сервера PostgreSQL начиная с версии 17 загрузка и сохранение баз данных может осуществляться только с помощью командной строки (см. Загрузка базы данных с помощью командной строки и Сохранение базы данных с помощью командной строки).

Загрузка базы данных с помощью командной строки

Загрузка базы данных из бэкапа с помощью командной строки должна осуществляться системным администратором или пользователем с правами администратора на данном компьютере.

Внимание! Для более удобного восприятия синтаксиса аргументы, в которые нужно подставить свои значения, выделены скобками <>. Символы <> в командной строке писать не нужно.

Для загрузки базы данных из бэкапа необходимо:

1. Открыть командную строку.

2. Перейти к папке с расположением утилит "psql", "pg_dump", "pg_restore":

cd <Каталог установки PostgreSQL>\bin

3. Создать базу данных, в которую будет загружен бэкап (если такая база уже есть, то следует перейти к пункту 4):

3.1. Выполнить вход на сервер PostgreSQL командой (потребуется ввести пароль администратора):

psql -h <адрес сервера> -p <порт> -d postgres -U <имя администратора> -W

где <адрес сервера> - адрес сервера PostgreSQL;
<порт> - заданный при установке сервера PostgreSQL порт;
<имя администратора> - имя администратора сервера (по умолчанию "postgres").

3.2. Создать базу данных командой:

CREATE DATABASE "<имя новой базы>" TEMPLATE template0 ENCODING = 'UTF8' CONNECTION LIMIT = -1;

где <имя новой базы> - название новой базы данных.

3.3. Выполнить выход командой:

\q

4. Выполнить команду (потребуется ввести пароль администратора):

pg_restore -h <адрес сервера> -p <порт> -U <имя администратора> -W -O -d "<название базы>" "<путь к файлу>"

где <название базы> - название базы данных, в которую будет загружен бэкап;
<путь к файлу> - путь к файлу бэкапа.

5. Дождаться отклика командной строки.

6. Запустить утилиту DBAdmin из комплекта поставки Business Studio и добавить восстановленную из бэкапа базу в список баз, при этом может появиться информационное сообщение об отсутствии в базе сервисных ролей PostgreSQL.

7. Открыть восстановленную базу в DBAdmin, ответить утвердительно на вопрос: "Создать сервисные роли PostgreSQL?"

Сохранение базы данных с помощью командной строки

Сохранение базы данных с помощью командной строки должно осуществляться системным администратором или пользователем с правами администратора на данном компьютере.

Внимание! Для более удобного восприятия синтаксиса аргументы, в которые нужно подставить свои значения, выделены скобками <>. Символы <> в командной строке писать не нужно.

Для сохранения базы данных в файл бэкапа необходимо:

1. Открыть командную строку.

2. Перейти к папке с расположением утилит "psql", "pg_dump", "pg_restore":

cd <Каталог установки PostgreSQL>\bin

3. Выполнить команду (потребуется ввести пароль администратора):

pg_dump -h <адрес сервера> -p <порт> -U <имя администратора> -W -x -O -Fc -f "<путь к файлу>" "<название базы>"

где <путь к файлу> - директория сохранения файла бэкапа;
<название базы> - название базы данных на сервере.

Настройка доступа к базам данных

Подробную информацию о вариантах настройки доступа к базам данных PostgreSQL см. на сайте https://www.postgresql.org/docs/16/auth-pg-hba-conf.html.

SQL-аутентификация

SQL-аутентификация поддерживается на всех операционных системах. Для настройки доступа необходимо:

1. Создать пользователей и администраторов с помощью утилиты DBAdmin (см. Назначение пользователей и администраторов баз данных). В наиболее простом варианте создается один SQL-пользователь с правами администратора базы данных и один SQL-пользователь без прав администратора. Эти SQL-пользователи могут использоваться пользователями системы Business Studio для авторизации в базе данных.

2. Настроить файл конфигурации "pg_hba.conf", расположенный в папке "<Каталог установки PostgreSQL>\data". Вносить изменения в файл следует с помощью текстового редактора, корректно работающего с кодировкой UTF-8 (например, NotePad++).

Добавить следующие строки для каждого SQL-пользователя:

host <имя базы> <имя пользователя> ::1/128 <метод>¹⁾
host <имя базы> <имя пользователя> 127.0.0.1/32 <метод>²⁾

где <имя базы> - база, к которой нужно предоставить доступ;
<имя пользователя> - SQL-пользователь;
<метод> - метод аутентификации, поддерживаются следующие методы: scram-sha-256, md5, password.

Настройка файла паролей pgpass

Программой предусмотрена возможность настройки файла паролей pgpass, это позволяет пользователю, для которого настроена SQL-аутентификация:

запускать Business Studio Portal;
запускать средства автоматизации и интеграции со сторонними системами (см. Работа с данными через протокол OData, Работа с Business Studio через OLE);
не вводить каждый раз пароль SQL-пользователя при обычной работе с программой.

Для настройки необходимо:

1. Отредактировать файл Business Studio.exe.config, который находится в каталоге установки программы.
Добавить строку в раздел appSettings:

где <SQL-пользователь> - логин SQL-пользователя, для которого требуется настроить файл паролей.

2. Создать файл паролей по инструкции: https://www.postgresql.org/docs/current/libpq-pgpass.html, добавив в нём строку для SQL-пользователя, заданного в пункте 1.

Внимание! При заполнении файла необходимо соблюдать регистр в имени сервера и названии базы данных. При необходимости можно продублировать запись в разных регистрах.

Доменная аутентификация

В данном разделе будет рассматриваться доменная аутентификация на операционной системе Windows. Доменная аутентификация на операционной системе Linux возможна посредством протокола LDAP или Kerberos (см. Доменная аутентификация PostgreSQL на операционной системе Linux).

Для использования доменной аутентификации на операционной системе Windows необходимо настроить файлы конфигурации, которые расположены в папке: "<Каталог установки PostgreSQL>\data". Вносить изменения в файлы следует с помощью текстового редактора, корректно работающего с кодировкой UTF-8 (например, NotePad++).

1. Файл "pg_ident.conf"
В конец файла вставить строку:

MapForSSPI /^(.*)@<Домен> <Домен>\\1

где <Домен> - домен, к которому требуется предоставить доступ.

При внесении изменений необходимо соблюдать регистр в доменных именах.

2. Файл "pg_hba.conf"

2.1 Добавить строки для системных ролей, необходимых для работы. Они должны располагаться в файле сразу под большим блоком с комментариями (строки, начинающиеся с символа #) и над всеми последующими строками (это требуется, т.к. подключение производится в соответствии с первой подходящей строкой в порядке сверху вниз, и если подключение подходит под какую-то из строк выше, то строки ниже не учитываются):

host all be64_approle ::0/0 <метод>³⁾
host all be64_approle 0.0.0.0/0 <метод>⁴⁾

где <метод> - метод аутентификации, поддерживаются следующие методы: scram-sha-256, md5, password.

2.2 Добавить строки для каждого пользователя домена:

host <имя базы> <Домен\Логин> ::0/0 sspi map=MapForSSPI⁵⁾
host <имя базы> <Домен\Логин> 0.0.0.0/0 sspi map=MapForSSPI⁶⁾

где <имя базы> - база, к которой нужно предоставить доступ,
<Домен\Логин> - домен и логин учетной записи, которой требуется выдать доступ к базе данных.

При внесении изменений необходимо соблюдать регистр в доменных именах.

2.3 При необходимости предоставить доступ к базе данных для всех пользователей PostgreSQL сервера, необходимо добавить следующие строки.
Они должны располагаться в файле обязательно непосредственно под строками из п. 2.2.

host <имя базы> all ::0/0 <метод>⁷⁾
host <имя базы> all 0.0.0.0/0 <метод>⁸⁾

После этого требуется дать права конкретным пользователям на конкретные базы через утилиту DBAdmin. Добавлять доменного пользователя нужно под SQL аутентификацией.

Установка и настройка Postgre SQL