Облачная платформаEvolution

Подключиться к базе данных

Эта статья полезна?

Подключиться к базе данных в кластере Managed PostgreSQL® можно только по внутреннему IP-адресу с виртуальной машины, размещенной в облаке Evolution. Виртуальная машина и кластер Managed PostgreSQL® должны быть размещены в одном проекте и в одной подсети.

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

Для подключения вам понадобятся следующие данные:

  • Внутренний IP и порт кластера — на вкладке Информация в блоке Подключение к дефолтной базе данных.

  • Название базы данных — на вкладке Базы данных.

  • Имя пользователя — на вкладке Базы данных напротив нужной базы либо выбрать любого другого пользователя из списка.

  • Пароль пользователя — задается при создании пользователя и не отображается в интерфейсе. Исключение — пользователь dbadmin, который создается при развертывании кластера вместе с первой базой. Логин и пароль dbadmin можно найти на странице информации кластера в блоке Подключение к дефолтной базе данных.

Особенности подключения при использовании пулера соединений

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

  • Если пулер включен: подключение к мастер-узлу автоматически проходит через пулер.

  • Если пулер отключен: подключение к мастер-узлу выполняется напрямую.

Строка подключения при включенном и отключенном пулере не меняется — используется один и тот же IP-адрес и порт.

Подключение к репликам (Standby-узлам) всегда выполняется напрямую, независимо от состояния пулера.

Порядок подключения

  1. Создайте виртуальную машину в том же проекте и той же подсети, где будет располагаться кластер Managed PostgreSQL®.

    В рамках этой инструкции мы используем виртуальную машину с ОС Ubuntu 22.04. Обратите внимание, что команды для других ОС могут отличаться.

  2. Подключитесь по SSH к виртуальной машине, созданной на предыдущем шаге.

  3. Чтобы обновить информацию об установленных пакетах, в терминале виртуальной машины введите команду:

    sudo apt-get update
  4. Установите консольный клиент postgresql:

    sudo apt-get install postgresql
  5. Подключитесь к базе данных:

    psql -h <внутренний_IP> -p <порт> -U <имя_пользователя> -d <название_базы_данных>
  6. Введите пароль пользователя.

  7. Чтобы увидеть список баз данных, введите \l+.

В терминале отобразится таблица с базами данных, размещенными в кластере PostgreSQL®.