Подключиться
Yandex DataLens

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

Статья создана

Важно

Подключая внешнюю БД, которая не является ресурсом Yandex Cloud, предоставьте доступ к БД для следующих диапазонов IP-адресов сервиса DataLens (через / указана длина маски подсети):

  • 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
  • 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

Подключение к PostgreSQL

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

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

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

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

  4. Задайте Имя подключения. Имя может быть произвольным.

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

    Укажите параметры подключения для БД PostgreSQL, доступной в Yandex Cloud:

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

      Примечание

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

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

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

    • Порт. Укажите порт подключения к PostgreSQL. Порт по умолчанию — 6432.

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

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

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

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

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

    Укажите параметры подключения для внешней БД PostgreSQL:

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

  6. Нажмите Сохранить. Подключение появится в списке.

Примечание

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

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

Если в запросах к БД требуется явно задать правило сортировки, перейдите к разделу Продвинутые настройки подключения.

Выберите один из режимов для настройки Указание collate в запросе:

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