Описание
Инструмент PG1C реализован как расширение PostgreSQL.
Для использования под Microsoft Windows необходимо скачать архив pg1c_win64.zip, распаковать его и выполнить исполняемый файл pg1c_install.cmd.
Для использования под Linux необходимо скачать и установить пакет, соответствующий ОС:
pg1c_latest_amd64.deb - для Debian,Ubuntu,Astra Linux;
pg1c-latest.x86_64.rpm - для RHEL-based (Red Hat Enterprise Linux,CentOS,Fedora,Oracle Linux,AlmaLinux,Rocky Linux,RedOS)
Особенности установки, пример настройки и использования описаны ниже для каждого типа операционной системы: Microsoft Windows, Debian/Ubuntu, RHEL-based.
Программа бесплатная, исходный код открыт, разрешается делать свои сборки и включать в сторонние проекты со ссылкой на продукт.
По мере возможности оказываются бесплатные поддержка и консультации, более подробно на странице Контакты
Для продвинутых пользоватетелей есть полный zip-архив с исходным кодом, исполняемыми файлами и примерами.
Дистрибутив представляет собой архив pg1c_win64.zip, который содержит расширение PostgreSQL (SQL-скрипт и DLL-библиотека) и исполняемый файл-инсталятор pg1c_install.cmd. Инсталятор копирует расширение в директории PostgreSQL, для определения директорий установки испольуется программа pg_config.exe, которая ищется в переменной окружения PATH и директории C:\Program Files\PostgreSQL, Если программа не найдена, то возникает ошибка и требуется явное указание полного пути до программы.
Инструкция по установке
1. В WEB-браузере скачиваем файл https://pg1c.org/files/download/pg1c_win64.zip
2. Открываем в проводнике папку Загрузки (в списке скаченных файлов иконка "Показать в папке")
3. Распаковываем архив pg1c_win64.zip (правой кнопкой мыши действие "Извлечь все...")
4. В созданной директории pg1c_win64 (не путать с одноименным архивом) запускаем файл pg1c_install.cmd от имени администратора (правой кнопкой мыши действие "Запуск от имени администратора"). Предупреждение безопасности "Не удается проверить издателя" игнорируем (или отказываемся от установки и самостоятельно собираем расширение из исходных кодов)
Необязательно. Выполняется при возникновении ошибки поиска программы pg_config.exe или необходимости установки в нестандартную директорию.
Для исправления в первой строке файла pg1c_install.cmd указываем полный путь до программы pg_config.exe: Смотрим путь в описании службы PostgreSQL (нажав Ctrl+Shift+Esc запустите Диспетчер задач → вкладка Службы → Открыть службы → Сведения) Открываем файла pg1c_install.cmd на редактирование (в проводнике правой кнопкой мыши выбираем действие "Изменить"), убираем комментарий и указываем путь по аналогии с примером. Повторяем п.2
Пакет pg1c_latest_amd64.deb содержит расширение PostgreSQL (SQL-скрипт и библиотека .so) и bash-скрипт установки. При установке расширение копируется в директории PostgreSQL, для определения директорий установки испольуется программа pg_config, которая ищется в переменной окружения PATH и директории /usr/lib/postgresql. Если программа не найдена, то возникает ошибка и требуется явное указание полного пути до программы.
Инструкция по установке
В командной строке под пользователем root скачиваем файл pg1c_latest_amd64.deb и устанавливаем его:
curl -O https://pg1c.org/files/download/pg1c_latest_amd64.deb
apt install ./pg1c_latest_amd64.deb
Пример
root@debian:~# cd /tmp
root@debian:/tmp# curl -O https://pg1c.org/files/download/pg1c_latest_amd64.deb
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 27920 100 27920 0 0 393k 0 --:--:-- --:--:-- --:--:-- 395k
root@debian:/tmp# apt install ./pg1c_latest_amd64.deb
Reading package lists... Done
Building dependency tree
Reading state information... Done
Note, selecting 'pg1c' instead of '/tmp/pg1c_latest_amd64.deb'
The following NEW packages will be installed:
pg1c
0 upgraded, 1 newly installed, 0 to remove and 2 not upgraded.
Need to get 0 B/27.9 kB of archives.
After this operation, 194 kB of additional disk space will be used.
Get:1 /tmp/pg1c_latest_amd64.deb pg1c amd64 25.4-0 [27.9 kB]
(Reading database ... 56205 files and directories currently installed.)
Preparing to unpack /tmp/pg1c_latest_amd64.deb ...
Unpacking pg1c (25.4-0) ...
Setting up pg1c (25.4-0) ...
Расширение PG1C успешно установлено / PG1C extension installed successfully !
Дальнейшие настройки выполняются в SQL-менеджере или в терминальном клиенте psql, например:
create extension pg1c;
update pg1c.server_1c set web_address='192.168.1.10',publication='УТ',user_1c='odata',password_1c='[пароль]';
select pg1c.build_http_url() "URL для проверки в WEB-браузере";
select pg1c.create_table('Справочник.Контрагенты');
select * from Справочник.Контрагенты;
Необязательно. Выполняется при возникновении ошибки поиска программы pg_config или необходимости установки в нестандартную директорию.
Перед установкой пакета в переменной pg_config указываем полный путь до программы:
pg_config=/usr/lib/postgresql/15/bin/pg_config apt install ./pg1c_latest_amd64.deb
При промышленном использовании установка осуществляется из командной строки:
1. Утилита wget загружает исполняемый файл в папку /usr/bin
wget --directory-prefix=/usr/bin https://pghtml.org/files/download/pghtml
2. Команда chmod устанавливает нужные права для запуска
chmod a+x /usr/bin/pghtml
Пример установки