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

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

1. Перейдите на страницу создания нового подключения.

2. В разделе Базы данных выберите подключение PostgreSQL.

   

3. Выберите тип подключения:

   Выбрать в организации

   Указать вручную

   Connection Manager

   Выберите управляемую БД в текущей организации Yandex Cloud и укажите для нее параметры, чтобы подключиться по внутренней сети:

   • Облако и каталог. Выберите каталог, в котором находится кластер.

   • Кластер. Укажите кластер из списка доступных кластеров PostgreSQL. В настройках кластера должна быть активирована опция Доступ из DataLens. Если у вас нет доступного кластера, нажмите кнопку Создать новый.

     Примечание

     В списке отображаются кластеры:

     • с правами доступа для пользователя, создающего подключение;
     • созданные в той же организации, что и экземпляр DataLens.

   • Тип хоста. Выберите тип хоста:

     • Обычный (по умолчанию) — позволяет выбрать обычные хосты для подключения.
     • Особые FQDN — позволяет выбрать для подключения особые FQDN, которые всегда указывают на текущий хост-мастер или на наименее отстающую от мастера реплику в кластере PostgreSQL.

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

   • Порт. Укажите порт подключения к PostgreSQL. В Yandex Cloud по умолчанию используется порт 6432.

   • Путь к базе данных. Укажите имя подключаемой базы данных.

   • Имя пользователя. Укажите имя пользователя для подключения к PostgreSQL.

   • Пароль. Укажите пароль для пользователя.

   • Время жизни кеша в секундах. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).

   • Уровень доступа SQL запросов. Позволяет использовать произвольный SQL-запрос для формирования датасета.

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

   

   Вручную укажите реквизиты внешней БД, чтобы подключиться через публичную сеть:

   • Имя хоста. Укажите путь до хоста-мастера или IP-адрес хоста-мастера PostgreSQL. Вы можете указать несколько хостов через запятую. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка.
   • Порт. Укажите порт подключения к PostgreSQL. В Yandex Cloud по умолчанию используется порт 6432.
   • Путь к базе данных. Укажите имя подключаемой базы данных.
   • Имя пользователя. Укажите имя пользователя для подключения к PostgreSQL.
   • Пароль. Укажите пароль для пользователя.
   • Время жизни кеша в секундах. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).
   • Уровень доступа SQL запросов. Позволяет использовать произвольный SQL-запрос для формирования датасета.

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

   

   Примечание

   Для использования подключения Connection Manager в DataLens пользователю должна быть назначена роль connection-manager.user на это подключение.

   Выберите подключение к кластеру с управляемой БД PostgreSQL, созданное в сервисе Yandex Connection Manager:

   • Облако и каталог. Выберите каталог, в котором создано подключение к кластеру.
   • Идентификатор подключения. Выберите одно из доступных подключений в Connection Manager или создайте новое.
   • Хост. Выберите хост из списка доступных в кластере PostgreSQL.
   • Порт. Заполняется автоматически в зависимости от выбранного хоста.
   • База данных. Выберите имя подключаемой базы данных.
   • Имя пользователя. Заполняется автоматически из данных выбранного подключения.
   • Время жизни кеша в секундах. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).
   • Уровень доступа SQL запросов. Позволяет использовать произвольный SQL-запрос для формирования датасета.

   

4. Нажмите кнопку Создать подключение.

5. В открывшемся окне:

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

   2. Укажите название подключения.

   3. Нажмите кнопку Создать.

   

Дополнительные настройкиДополнительные настройки

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

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

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

• TLS — опция определяет необходимость использования протокола TLS. Когда опция включена, параметр sslmode принимает значение required, когда выключена — prefer.

• CA Certificate — чтобы загрузить сертификат, нажмите кнопку Прикрепить файл и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла.

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