pgAdmin 4: как подключиться к PostgreSQL и выполнить запрос

Коротко

• Подключение в pgAdmin называется «регистрацией сервера»: правой кнопкой по Servers → Register → Server.
• Таблицы лежат глубоко: Servers → сервер → Databases → база → Schemas → public → Tables.
• Запросы пишут в Query Tool: правой кнопкой по базе → Query Tool. F5 выполняет скрипт, Alt+F5 — запрос под курсором.
• F7 показывает план запроса, Shift+F7 — план с фактическим временем. F8 сохраняет результат в CSV.
• Мастер-пароль защищает сохранённые пароли серверов. Его спрашивают при запуске, если вы сохраняли пароли.

Установка и первый запуск

На Windows pgAdmin 4 входит в установщик PostgreSQL от EDB — оставьте его отмеченным среди компонентов. На macOS и Linux pgAdmin скачивают отдельно с pgadmin.org. Он работает как настольное приложение, а на сервере его можно запустить в режиме веб-приложения и открывать в браузере.

При первом запуске pgAdmin может попросить задать мастер-пароль. Это не пароль от PostgreSQL: им pgAdmin шифрует пароли серверов, которые вы попросите запомнить. Забыли мастер-пароль — сохранённые пароли придётся сбросить и ввести заново, сами базы не пострадают.

Как подключить сервер

Щёлкните правой кнопкой по пункту Servers в дереве слева и выберите Register → Server. На вкладке General задайте любое понятное имя — например, «Реплика продукта». Основные поля — на вкладке Connection.

Нажмите Save. Если всё верно, сервер появится в дереве и раскроется. Если нет, pgAdmin покажет ошибку подключения — её разбор в конце статьи.

• Сервер за промежуточной машиной: вкладка SSH Tunnel — адрес, порт 22, пользователь и ключ или пароль.
• Облачная база с обязательным шифрованием: вкладка Parameters, параметр SSL mode со значением require.

Где в pgAdmin таблицы

Дерево объектов повторяет устройство PostgreSQL: сервер содержит базы, база — схемы, схема — таблицы. Пользовательские таблицы обычно в схеме public. Путь целиком: Servers → имя сервера → Databases → имя базы → Schemas → public → Tables.

Щелчок по таблице и вкладка Properties покажут описание, Columns внутри таблицы — её столбцы с типами. Посмотреть строки: правой кнопкой по таблице → View/Edit Data → First 100 Rows. Для чтения этого достаточно, но правка в этой сетке меняет настоящие данные — на рабочей базе её лучше не трогать.

Query Tool: где писать запросы

Редактор запросов открывается правой кнопкой по базе → Query Tool или через меню Tools. Окно делится на две части: сверху текст запроса, снизу результат на вкладке Data Output, сообщения сервера на вкладке Messages и план на вкладке Explain.

Запрос из учебной базы ниже считает плательщиков августа по каналам привлечения. Если вы загрузили в свой PostgreSQL данные из песочницы, он вернёт то же, что в песочнице: 283 плательщика из органики, 198 из рекомендаций, 90 от партнёров и 71 из платного поиска.

select
  u.channel,
  count(*) as payers
from users u
where exists (
  select 1
  from payments p
  where p.user_id = u.user_id
    and p.paid_at >= date '2026-08-01'
)
group by u.channel
order by payers desc;

Горячие клавиши Query Tool

Кнопки выполнения есть на панели над редактором, но с клавишами быстрее. На macOS сочетания те же, только Alt — это Option.

• Если в редакторе несколько запросов, F5 выполнит все подряд и покажет результат последнего. Чтобы увидеть результат конкретного запроса, выделите его или используйте Alt+F5.
• По умолчанию Query Tool фиксирует каждое изменение сразу (auto commit). Переключатель — в выпадающем меню рядом с кнопкой выполнения.

План запроса

Кнопка Explain (F7) показывает, как PostgreSQL собирается выполнить запрос: в каком порядке читать таблицы, где использовать индекс, как соединять. Explain Analyze (Shift+F7) действительно выполняет запрос и добавляет фактическое время и число строк на каждом шаге. На вкладке Explain план нарисован схемой, на Data Output — текстом.

Помните, что Explain Analyze выполняет запрос по-настоящему. Для UPDATE или DELETE это значит — изменяет данные. Как читать план и что в нём искать, подробно разобрано в статье про EXPLAIN ANALYZE.

Выгрузка результата в CSV

После выполнения запроса нажмите F8 или кнопку Save results to file над результатом. pgAdmin выгрузит весь результат, а не только видимые строки. Разделитель, кавычки и кодировку задают в настройках: File → Preferences → раздел CSV/TXT Output.

Для Excel на русской Windows поставьте разделитель «;» — тогда столбцы разложатся по ячейкам. Если кириллица в Excel превратилась в кракозябры, откройте файл через «Данные → Из текстового файла» и укажите кодировку UTF-8.

Импорт CSV в таблицу

Сначала создайте таблицу с нужными столбцами — в Query Tool командой CREATE TABLE. Затем правой кнопкой по таблице → Import/Export Data. Выберите Import, укажите файл, формат csv, включите Header, если первая строка — заголовки, и разделитель.

Импорт и экспорт pgAdmin выполняет через утилиту psql. Если он падает с ошибкой про путь к утилитам, укажите каталог bin вашей установки PostgreSQL в File → Preferences → Paths → Binary paths.

ER-диаграмма базы

Правой кнопкой по базе → ERD For Database откроет диаграмму: таблицы и связи между ними по внешним ключам. На новом месте работы это быстрый способ понять, как связаны заказы, пользователи и платежи. Связи появятся, только если в базе объявлены внешние ключи. В аналитических хранилищах их часто нет, и тогда диаграмма покажет отдельные таблицы без линий.

Частые ошибки

Частые вопросы

Если сервер пока не установлен, запросы можно писать в песочнице на учебной базе, а курс «SQL с нуля» проверяет каждое решение.