[Документация Yandex Cloud](../../../index.md) > [Yandex DataLens](../../index.md) > Подключения > Базы данных > Создание подключения к PostgreSQL # Создание подключения к PostgreSQL в Yandex DataLens {% note warning %} Yandex Cloud не отвечает за настройки удаленного подключения со стороны внешнего сервера БД. Подключая внешнюю БД, которая не является ресурсом Yandex Cloud: * При использовании собственного [SSL-сертификата](../../../glossary/ssl-certificate.md) проверьте, что он совпадает с сертификатом на стороне БД. * Предоставьте доступ к БД для следующих диапазонов IP-адресов сервиса DataLens (через `/` указана длина маски подсети): {% list tabs group=ip_address %} - ipv4 {#ipv4} * `178.154.242.176/28` * `178.154.242.192/28` * `178.154.242.208/28` * `178.154.242.128/28` * `178.154.242.144/28` * `178.154.242.160/28` * `130.193.60.0/28` - ipv6 {#ipv6} * `2a02:6b8:c03:500:0:f83d:a987:0/112` * `2a02:6b8:c02:900:0:f83d:a987:0/112` * `2a02:6b8:c0e:500:0:f83d:a987:0/112` * `2a02:6b8:c41:1300:0:f83d:a987:0/112` {% endlist %} {% endnote %} Чтобы создать подключение к PostgreSQL: 1. Перейдите на [страницу создания нового подключения](https://datalens.ru/connections/new). 1. В разделе **Базы данных** выберите подключение **PostgreSQL**. ![screen01](../../../_assets/datalens/operations/connection/create-postgresql/screen01.png) 1. Выберите тип подключения: {% list tabs group=connection %} - Выбрать в организации {#organization} Выберите управляемую БД в текущей организации Yandex Cloud и укажите для нее параметры, чтобы подключиться по внутренней сети: * **Облако и каталог**. Выберите каталог, в котором находится кластер. * **Кластер**. Укажите кластер из списка доступных кластеров PostgreSQL. В настройках кластера должна быть активирована опция **Доступ из DataLens**. Если у вас нет доступного кластера, нажмите кнопку **Создать новый**. {% note info %} В списке отображаются кластеры: * с правами доступа для пользователя, создающего подключение; * созданные в той же [организации](../../concepts/organizations.md), что и экземпляр DataLens. {% endnote %} * **Тип хоста**. Выберите тип хоста: * **Обычный** (по умолчанию) — позволяет выбрать обычные хосты для подключения. * **Особые FQDN** — позволяет выбрать для подключения [особые FQDN](../../../managed-postgresql/operations/connect/fqdn.md#special-fqdns), которые всегда указывают на текущий хост-мастер или на наименее отстающую от мастера реплику в кластере PostgreSQL. * **Имя хоста**. Выберите имя хоста из списка доступных в кластере PostgreSQL. Вы можете выбрать несколько хостов. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка. * **Порт**. Укажите порт подключения к PostgreSQL. В Yandex Cloud по умолчанию используется порт 6432. * **Путь к базе данных**. Укажите имя подключаемой базы данных. * **Имя пользователя**. Укажите имя пользователя для подключения к PostgreSQL. * **Пароль**. Укажите пароль для пользователя. * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут). * **Уровень доступа 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). Чтобы проверить корректность введенных параметров, нажмите кнопку **Проверить подключение**. - Указать вручную {#manual} Вручную укажите реквизиты внешней БД, чтобы подключиться через публичную сеть: * **Имя хоста**. Укажите путь до [хоста-мастера](https://www.postgresql.org/docs/16/runtime-config-replication.html#RUNTIME-CONFIG-REPLICATION-PRIMARY) или IP-адрес хоста-мастера PostgreSQL. Вы можете указать несколько хостов через запятую. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка. * **Порт**. Укажите порт подключения к PostgreSQL. В Yandex Cloud по умолчанию используется порт 6432. * **Путь к базе данных**. Укажите имя подключаемой базы данных. * **Имя пользователя**. Укажите имя пользователя для подключения к PostgreSQL. * **Пароль**. Укажите пароль для пользователя. * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут). * **Уровень доступа 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-запросы на чтение. Чтобы проверить корректность введенных параметров, нажмите кнопку **Проверить подключение**. - Connection Manager {#conn-man} {% note info %} Для использования подключения Connection Manager в DataLens пользователю должна быть назначена [роль](../../../metadata-hub/security/connection-manager-roles.md) `connection-manager.user` на это подключение. {% endnote %} Выберите [подключение](../../../metadata-hub/concepts/connection-manager.md) к кластеру с управляемой БД PostgreSQL, созданное в сервисе Yandex Connection Manager: * **Облако и каталог**. Выберите каталог, в котором создано подключение к кластеру. * **Идентификатор подключения**. Выберите одно из доступных подключений в Connection Manager или [создайте новое](../../../metadata-hub/operations/create-connection.md). * **Хост**. Выберите хост из списка доступных в кластере PostgreSQL. * **Порт**. Заполняется автоматически в зависимости от выбранного хоста. * **База данных**. Выберите имя подключаемой базы данных. * **Имя пользователя**. Заполняется автоматически из данных выбранного подключения. * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут). * **Уровень доступа 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). {% endlist %} 1. Нажмите кнопку **Создать подключение**. 1. В открывшемся окне: 1. Выберите [воркбук](../../workbooks-collections/index.md), в котором сохранится подключение, или создайте новый. Если вы пользуетесь старой навигацией по папкам, выберите папку для сохранения подключения. 1. Укажите название подключения. 1. Нажмите кнопку **Создать**. ![screen05](../../../_assets/datalens/operations/connection/create-postgresql/screen05.png) ## Дополнительные настройки {#postgresql-additional-settings} Вы можете указать дополнительные параметры подключения в разделе **Продвинутые настройки подключения**: * **Указание collate в запросе** — если в запросах к БД требуется явно задать правило сортировки, выберите один из режимов: * **Авто** — применяется настройка по умолчанию, решение о включении локали `en_US` остается на усмотрение DataLens. * **Вкл** — применяется настройка DataLens, для отдельных выражений в запросе указывается локаль `en_US`. Это приводит к использованию соответствующей логики сортировки сервером, вне зависимости от настроек сервера и конкретных таблиц. Используйте настройку DataLens, если локаль в БД несовместима с работой DataLens. Подробнее о локали и `LC_COLLATE` смотрите в разделе [Создать кластер](../../../managed-postgresql/operations/cluster-create.md#create-cluster). * **Выкл** — применяется настройка по умолчанию, DataLens использует только имеющиеся параметры локали БД. * **TLS** — опция определяет необходимость использования протокола TLS. Когда опция включена, параметр `sslmode` принимает значение `required`, когда выключена — `prefer`. * **CA Certificate** — чтобы загрузить сертификат, нажмите кнопку **Прикрепить файл** и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла. * **Запрет на экспорт данных** — когда опция включена, в чартах на базе этого подключения в меню ![icon](../../../_assets/console-icons/ellipsis.svg) пункт экспорта данных будет недоступен. При этом останется возможность копировать данные из чартов, а также снимать скриншоты.