Поиск
Справочник

Как посмотреть базы и таблицы в PostgreSQL

Список баз в PostgreSQL показывает команда \l, переключиться на базу — \c имя, список таблиц текущей базы — \dt, столбцы таблицы — \d имя. Все эти команды набираются в psql, консоли базы. Размер базы и таблиц показывают функции pg_database_size и pg_total_relation_size.

≈ 8 мин чтения
Содержание 12

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Откройте консоль базы:
sudo -u postgres psql

В начале строки появится postgres=# — это имя базы, к которой вы подключены.

  1. Покажите список баз: наберите \l и нажмите Enter.
  2. Переключитесь на нужную базу, например shop: \c shop. Строка начнётся с shop=#.
  3. Покажите таблицы этой базы: \dt.
  4. Выйдите из консоли: \q.

Если список длинный, psql показывает его постранично: листать — пробелом, выйти из списка — клавишей q.

Список баз

\l
СтолбецЧто значит
Nameимя базы
Ownerвладелец базы
Encodingкодировка, для русского текста нужна UTF8
Collate, Ctypeкак база сортирует строки и сравнивает буквы
Access privilegesкто ещё может подключаться; пусто — права по умолчанию: право подключаться есть у всех пользователей

После установки в списке три базы:

  • postgres — служебная база, она создаётся при установке. psql без имени базы подключается к базе с именем пользователя, поэтому sudo -u postgres psql открывает именно её. Удалять её не нужно.
  • template1 — шаблон: новая база создаётся как её копия.
  • template0 — чистый запасной шаблон, его не меняют.

С плюсом, \l+, в таблице появится ещё столбец Size — сколько места база занимает на диске. Если в нём No Access, у вашего пользователя нет права подключаться к этой базе.

Тот же список без входа в консоль:

sudo -u postgres psql -l

Как переключиться на другую базу

\c shop

psql ответит You are now connected to database "shop" as user "postgres". Подключиться к базе сразу под другим пользователем — \c shop ivan.

Если базы с таким именем нет, psql напишет FATAL: database "shop" does not exist и строку Previous connection kept: вы остались в прежней базе. Разбор — в статье об ошибке.

К какой базе, под каким пользователем и через что вы подключены, покажет \conninfo.

Сразу открыть нужную базу из консоли сервера: sudo -u postgres psql -d shop.

Список таблиц

Сначала переключитесь на базу командой \c, затем:

\dt
СтолбецЧто значит
Schemaсхема — папка внутри базы; таблицы сайта лежат в public, если программа не создала свою
Nameимя таблицы
Typetable — таблица
Ownerвладелец таблицы

\dt+ добавит столбец Size — размер каждой таблицы без её индексов. Размер вместе с индексами — в запросе ниже.

Если на пустой базе \dt ответит Did not find any relations., таблиц в ней нет или вы подключены не к той базе — посмотрите на имя в начале строки.

Таблицы в других схемах:

КомандаЧто покажет
\dnсписок схем в базе
\dt app.*таблицы схемы app
\dt *.ordersтаблицу orders во всех схемах
\dt order*таблицы, имя которых начинается с order

Без схемы в шаблоне \dt показывает только таблицы из схем, которые база ищет по умолчанию: это public и схема с именем пользователя, если она есть. Служебные таблицы самой базы в список не попадают.

Какие столбцы в таблице

\d orders

psql покажет заголовок Table "public.orders" и таблицу столбцов:

СтолбецЧто значит
Columnимя столбца
Typeтип: integer, text, timestamp with time zone и другие
Nullablenot null — столбец нельзя оставить пустым
Defaultчто база подставит, если значение не передали

Ниже таблицы идут индексы (Indexes:) и ограничения: первичный ключ, внешние ключи, проверки. \d+ orders добавит описания столбцов и то, как база хранит их значения.

Без имени таблицы \d покажет список всего, что есть в базе: таблицы, представления, последовательности.

Если строки результата не помещаются в экран, включите вывод столбиком: \x on. Каждая строка выводится блоком «столбец | значение». Выключить — \x off, или \x auto, чтобы psql сам выбирал вид по ширине экрана.

Сколько места занимает база

Все базы, от самой большой:

SELECT datname, pg_size_pretty(pg_database_size(datname)) AS razmer
FROM pg_database
ORDER BY pg_database_size(datname) DESC;

Только текущая база: SELECT pg_size_pretty(pg_database_size(current_database()));.

pg_size_pretty переводит байты в понятный вид: kB, MB, GB. Размер у другого пользователя посчитается, если у него есть право подключаться к базе; у новых баз оно есть у всех.

Сколько PostgreSQL занимает на диске целиком, вместе с журналом изменений: sudo du -sh /var/lib/postgresql/16/main.

Какие таблицы самые большие

Подключитесь к базе командой \c и выполните:

SELECT relname AS tablica,
       pg_size_pretty(pg_total_relation_size(relid)) AS vsego,
       pg_size_pretty(pg_indexes_size(relid)) AS indeksy,
       n_live_tup AS strok_primerno
FROM pg_stat_user_tables
ORDER BY pg_total_relation_size(relid) DESC
LIMIT 10;
СтолбецЧто значит
tablicaимя таблицы
vsegoтаблица вместе с индексами — столько она занимает на диске
indeksyсколько из этого занимают индексы
strok_primernoсколько строк в таблице, по оценке базы

Если индексы занимают больше самой таблицы, проверьте, все ли они нужны: что это за индексы, покажет \d имя_таблицы.

Сколько строк в таблице

Точное число:

SELECT count(*) FROM orders;

На таблице в миллионы строк count(*) читает её всю и работает долго. Быстрая оценка — столбец n_live_tup из запроса выше: база обновляет его по ходу работы, поэтому число примерное.

Пользователи и их права

КомандаЧто покажет
\duсписок пользователей и их особые права: Superuser, Create DB, Create role
\dp ordersкто и что может делать с таблицей orders
\lстолбец Access privileges — кто может подключаться к базам

Как создать пользователя и дать ему права — на страницах Создать пользователя и Права GRANT.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Did not find any relations.в базе нет таблиц или вы подключены не к той базе\l, затем \c имя_базы и снова \dt
Did not find any relation named "orders".таблицы нет в схемах, которые база ищет по умолчанию\dt *.orders — найдёт её в любой схеме
FATAL: database "shop" does not exist после \cбазы с таким именем нетимя — по списку \l; разбор ошибки
ERROR: relation "orders" does not existтаблица в другой схеме или имя записано заглавными буквами\dt *.orders; имя с заглавными буквами пишите в двойных кавычках: "Orders"
ERROR: permission denied for table ordersу пользователя нет права читать таблицудайте права через GRANT
ERROR: permission denied for schema publicу пользователя нет прав на схемуразбор ошибки
No Access в столбце Size у \l+нет права подключаться к базепосмотрите размер под postgres: sudo -u postgres psql -c '\l+'

Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше