---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/operations/connection/create-postgresql
  - ru/operations/connection/create-postgresql
  - href: ru/operations/connection/create-postgresql.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/operations/connection/create-postgresql.html
title: Инструкция по созданию подключения к PostgreSQL в DataLens On-premises
description: Из статьи вы узнаете, как подключиться к PostgreSQL в DataLens On-premises.
vcsPath: ru/operations/connection/create-postgresql.md
---

# Создание подключения к PostgreSQL в DataLens On-premises



Чтобы создать подключение к PostgreSQL:

1. Перейдите на страницу [воркбука](../../workbooks-collections/index.md) или создайте новый.
1. В правом верхнем углу нажмите **Создать** → **Подключение**.
1. Выберите подключение **PostgreSQL**.
1. Укажите параметры подключения для внешней БД PostgreSQL:

   <!-- source: ru/_includes/datalens/datalens-db-connection-parameters-postgresql.md -->
   * **Имя хоста**. Укажите путь до [хоста-мастера](https://www.postgresql.org/docs/16/runtime-config-replication.html#RUNTIME-CONFIG-REPLICATION-PRIMARY) или IP-адрес хоста-мастера PostgreSQL. Вы можете указать несколько хостов через запятую. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка.
   * **Порт**. Укажите порт подключения к PostgreSQL. В DataLens по умолчанию используется порт 6432.
   * **Путь к базе данных**. Укажите имя подключаемой базы данных.
   * **Имя пользователя**. Укажите имя пользователя для подключения к PostgreSQL.
   * **Пароль**. Укажите пароль для пользователя.
   * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).

   <!-- source: ru/_includes/datalens/datalens-db-connection-sql-level-3.md -->
   * **Уровень доступа SQL-запросов**. Позволяет использовать произвольный SQL-запрос для [формирования датасета](../../dataset/settings.md#sql-request-in-datatset). По умолчанию опция отключена. При активации необходимо выбрать уровень доступа SQL-запросов:

      * **Только подзапросы** — описывать источники датасета с помощью [SQL-запросов](../../dataset/settings.md#sql-request-in-datatset).
      * **Подзапросы и параметры** — описывать источники датасета с помощью SQL-запросов и использовать [параметризацию источников](../../dataset/settings.md#parametrization).
      * **SQL на чтение** — описывать источники датасета с помощью SQL-запросов, использовать параметризацию источников, [создавать QL-чарты](../../concepts/chart/ql-charts.md) и выполнять SQL-запросы на чтение.
   <!-- endsource: ru/_includes/datalens/datalens-db-connection-sql-level-3.md -->
   <!-- endsource: ru/_includes/datalens/datalens-db-connection-parameters-postgresql.md -->

   ![image](../../_assets/datalens/operations/connection/connection-postgresql-ent.png)

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


## Дополнительные настройки {#postgresql-additional-settings}

Вы можете указать дополнительные параметры подключения в разделе **Продвинутые настройки подключения**:

* **Указание collate в запросе** — если в запросах к БД требуется явно задать правило сортировки, выберите один из режимов:

  * **Авто** — применяется настройка по умолчанию, решение о включении локали `en_US` остается на усмотрение DataLens.
  * **Вкл** — применяется настройка DataLens, для отдельных выражений в запросе указывается локаль `en_US`. Это приводит к использованию соответствующей логики сортировки сервером, вне зависимости от настроек сервера и конкретных таблиц. Используйте настройку DataLens, если локаль в БД несовместима с работой DataLens. 
  * **Выкл** — применяется настройка по умолчанию, DataLens использует только имеющиеся параметры локали БД.

* **TLS** — опция определяет необходимость использования протокола TLS. Когда опция включена, параметр `sslmode` принимает значение `required`, когда выключена — `prefer`.
* **CA Certificate** — чтобы загрузить сертификат, нажмите кнопку **Прикрепить файл** и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла.
* <!-- source: ru/_includes/datalens/operations/datalens-db-connection-export-settings-item.md -->
  **Запрет на экспорт данных** — когда опция включена, в чартах на базе этого подключения в меню <!-- diplodoc:svg ![icon](../../_assets/console-icons/ellipsis.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg> пункт экспорта данных будет недоступен. При этом останется возможность копировать данные из чартов, а также снимать скриншоты.
  <!-- endsource: ru/_includes/datalens/operations/datalens-db-connection-export-settings-item.md -->