Как посмотреть базы и таблицы в PostgreSQL
Список баз в PostgreSQL показывает команда \l, переключиться на базу — \c имя, список таблиц текущей базы — \dt, столбцы таблицы — \d имя. Все эти команды набираются в psql, консоли базы. Размер базы и таблиц показывают функции pg_database_size и pg_total_relation_size.
Содержание 12
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Откройте консоль базы:
sudo -u postgres psql В начале строки появится postgres=# — это имя базы, к которой вы подключены.
- Покажите список баз: наберите
\lи нажмите Enter. - Переключитесь на нужную базу, например shop:
\c shop. Строка начнётся сshop=#. - Покажите таблицы этой базы:
\dt. - Выйдите из консоли:
\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 shoppsql ответит 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 | имя таблицы |
Type | table — таблица |
Owner | владелец таблицы |
\dt+ добавит столбец Size — размер каждой таблицы без её индексов. Размер вместе с индексами — в запросе ниже.
Если на пустой базе \dt ответит Did not find any relations., таблиц в ней нет или вы подключены не к той базе — посмотрите на имя в начале строки.
Таблицы в других схемах:
| Команда | Что покажет |
|---|---|
\dn | список схем в базе |
\dt app.* | таблицы схемы app |
\dt *.orders | таблицу orders во всех схемах |
\dt order* | таблицы, имя которых начинается с order |
Без схемы в шаблоне \dt показывает только таблицы из схем, которые база ищет по умолчанию: это public и схема с именем пользователя, если она есть. Служебные таблицы самой базы в список не попадают.
Какие столбцы в таблице
\d orderspsql покажет заголовок Table "public.orders" и таблицу столбцов:
| Столбец | Что значит |
|---|---|
Column | имя столбца |
Type | тип: integer, text, timestamp with time zone и другие |
Nullable | not 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.
Источники
- PostgreSQL 16: psql — на английском: команды \l, \c, \conninfo, \dt, \d, \dn, \du, \dp, \x, \q, шаблоны имён и ключ -l.
- PostgreSQL 16: Database Object Management Functions — на английском: pg_database_size, pg_total_relation_size, pg_indexes_size, pg_size_pretty и право CONNECT.
- PostgreSQL 16: Cumulative Statistics System — на английском: pg_stat_user_tables и n_live_tup — оценка числа строк.
- PostgreSQL 16: Template Databases — на английском: template1 — шаблон новых баз, template0 не меняют.
- PostgreSQL 16: Creating a Database — на английском: база postgres создаётся при установке.
- Исходный код PostgreSQL 16: describe.c — столбцы \l, \dt, \d и \du, тексты Did not find any relations и No Access.
- Исходный код PostgreSQL 16: command.c — тексты You are now connected to database и Previous connection kept.
- Исходный код PostgreSQL 16: parse_relation.c — текст relation does not exist.
- Исходный код PostgreSQL 16: aclchk.c — текст permission denied for table.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Создать и удалить базукак завести базу для сайта.
- Резервная копия: pg_dumpкак сохранить базу в файл.
- Медленные запросыкак найти, какой запрос тормозит сайт.
- Настройки PostgreSQLгде лежат файлы настроек и как их перечитать.