PostgreSQL. Способ подключения: Native API

Экстрактор 1С позволяет подключится к базам данных PostgreSQL через Native API

Начиная с версии 3.6.5.49 доступен способ подключения по Native API для PostgreSQL.

Важно!

Подходит для серверов 1С, развернутых как в Windows, так и в Linux.

Обратите внимание, что в ОС Linux должны быть установлены библиотеки, минимальные рекомендуемые версии библиотек:

  • Glibc (GNU C Library): 2.18;

  • GCC (GNU Compiler Collection): 7.5.0;

  • OpenSSL: 3.

Native API обладает рядом важных преимуществ перед другими вариантами:

  • высокая производительность за счет оптимизации для работы с БД.

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

  • поддержка расширений, что что позволяет использовать специализированные функции и типы данных.

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

Внешние компоненты в релизе 3.15

Начиная с 3.15.1.50 библиотеки для MySQL, PostgreSQL через Native API, AMQP 1.0 и Kafka через Native API выбираются и обновляются через справочник «Внешние компоненты». Краткие шаги приведены в соответствующих инструкциях по подключениям. Для очереди Redis (Native DLL) компонента выбирается в настройках Экстрактора.

  1. В настройках подключения типа PostgreSQL выберите способ «Native API».

  2. В поле «Внешняя компонента» выберите компоненту PostgreSQL и откройте её карточку.

  3. Нажмите «Обновить из облака» или «Загрузить из файла» и выполните «Проверить подключение» в карточке.

  4. Вернитесь в настройки PostgreSQL, заполните параметры сервера и проверьте само подключение перед сохранением.

Требования к системным библиотекам зависят от выбранного варианта компоненты. Сверяйте их с описанием в карточке перед установкой.

Создание подключения

Чтобы создать подключение к PostgreSQL через Native API, зайдите в меню «Экстрактор 1С» — выберите «Подключения» и в открывшейся форме списка нажмите «Создать».

Настройки подключения для способа выгрузки «Блоками»

В открывшемся окне заполните все поля последовательно:

  • Наименование.

  • Тип подключения: PostgreSQL.

  • Партиции в нижнем регистре. Оставьте эту галку установленной (значение по умолчанию). Она добавлена для других типов СУБД.

  • Способ подключения: «Native API».

  • SSL mode: При подключении к базе данных Postgres использует параметр sslmode.

Примечание

Для определения безопасности соединения. Приведем аналогию с веб-безопасностью: disable является HTTP, а verify-full — это HTTPS

Все остальные опции находятся где-то посередине и по своей конструкции дают меньше гарантий безопасности, чем HTTPS в вашем браузере. Сюда входит значение по умолчанию prefer. В документах Postgres есть отличная таблица, объясняющая это.

  • Сервер: Имя (или IP-адрес) сервера PostgreSQL.

  • порт (обычно, по умолчанию: 5432).

  • логин и пароль к PostgreSQL.

  • Базу можно написать, или выбрать из выпадающего списка.

  • проставьте таймаут (обычно это 30-60 секунд).

  • при необходимости использования TLS установите соответствующий флаг в поле «Дополнительные параметры» и укажите сертификат (отметим, если сертификат установлен на сервере 1С, то его не надо добавлять в подключении);

  • Установите значение «Способ доставки файла в каталог загрузки» — «Не используется» для выгрузки только «Блоками».

  • Начиная с релиза 3.11.1.48, добавлена настройка «Тип подключения компоненты» (для версий платформы старше 8.3.21). Она позволяет указать способ подключения библиотеки и имеет следующие значения:

    • «Изолированно»: библиотека подключается изолированно от основного процесса в котором выполняется код.

    • «Не изолированно»: библиотека подключается не изолированно от основного процесса в котором выполняется код.

    • «По умолчанию»: до версии платформы 8.3.21 — значение «Не изолированно», с 8.3.21 — «Изолированно».

    Отметим, что специально менять значение «По умолчанию» не требуется (это используется только для устранения проблем, например, не подключается библиотека).

  • Далее, нажимаете кнопку «Проверить подключение». Если будут на каком то из шагов ошибки, то:

    • убедиться, что у расширения «Экстрактор 1С» снят флаг «Безопасный режим»

    • Далее, идти к вашим системным администраторам и просить их починить доступы.

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

Настройки подключения для способа выгрузки «Через файл»

Этот блок используется для выгрузки способом «Через файл». Настройки этого подключения требуют навыков настройки доступа к папкам. Потребуется помощь системного администратора.

Если вы не хотите использовать свое подключение к базе данных для выгрузки данных способом «Через файлы», то установите переключатель «Способ доставки файлов в каталог загрузки» в положение «Не используется». В противном случае — заполните каталоги загрузки/выгрузки и настройки сжатия.
Тут надо понимать, что по сути (в физическом смысле) это один каталог (одна и та же папка). А каталоги выгрузки и загрузки — это пути к этой папке со стороны 1С сервера и PostgreSQL сервера соответственно.

Обратите внимание!

При размере сегмента от 100 000 строк рекомендуется использовать способ выгрузки «Через файл», а если нет возможности, то рекомендуем уменьшить размер сегмента и сделать его не более 10 000 строк.