В psql команда \l выводит список баз данных, \c dbname подключается к одной из них, а \dt показывает таблицы текущей базы. Из SQL или любого другого клиента запрашивайте системные каталоги: pg_database для баз данных и information_schema.tables для таблиц.
Запрос вернёт две таблицы с типом BASE TABLE и представление с типом VIEW, все в схеме public. Фильтр WHERE скрывает системные каталоги, иначе в результате были бы сотни строк. Добавьте AND table_type = 'BASE TABLE', чтобы убрать представления.
Команды psql для баз данных и таблиц
Это метакоманды psql. psql превращает каждую из них в запрос к каталогу, поэтому в других клиентах и в коде приложения они не работают.
| Команда | Что показывает |
|---|---|
\l | Базы данных (\l+ добавляет размеры) |
\c shop | Подключается к базе shop |
\conninfo | Базу, пользователя и хост текущего подключения |
\dn | Схемы |
\dt | Таблицы в схемах из вашего search_path |
\dt sales.* | Таблицы в схеме sales |
\dt *.* | Таблицы во всех схемах, включая системные |
\dt+ | Таблицы с размером и описанием |
\dv, \di, \ds | Представления, индексы, последовательности |
\d orders | Столбцы, индексы и ограничения таблицы orders |
\d+ orders | То же плюс хранение и комментарии |
\du | Роли |
Из командной строки psql -l печатает список баз и завершается, а -c выполняет одну команду:
psql -l
psql -d shop -c '\dt'
Запустите psql с ключом -E, и он будет печатать SQL за каждой метакомандой. Это быстрый способ изучить таблицы каталога.
Список баз данных через SQL
Каждая база на сервере представлена строкой в pg_database. template0 и template1 это шаблоны, которые копирует CREATE DATABASE, поэтому отфильтруйте их:
На этой странице каждый запуск получает свежую базу, имя которой начинается с lesson_. В результате вы увидите её и postgres, базу по умолчанию, которую создаёт каждый сервер. SELECT current_database() возвращает базу, к которой вы подключены.
Описание столбцов таблицы
В psql таблицу описывает \d orders. В SQL information_schema.columns содержит по одной строке на каждый столбец:
У id в is_nullable стоит NO, потому что первичный ключ всегда NOT NULL. Его column_default пуст: столбец identity берёт значения из последовательности, а не из значения по умолчанию.
Запросы напрямую к pg_catalog
information_schema это представление из стандарта SQL, и оно показывает только объекты, на которые у вас есть хоть какие-то права. Каталоги PostgreSQL в pg_catalog содержат больше, например определения индексов:
Запрос выведет три индекса: orders_email_key от UNIQUE, orders_pkey от первичного ключа и созданный вами частичный индекс. Для каждого показан оператор CREATE INDEX, который построит его заново. pg_tables перечисляет только таблицы, а pg_views и pg_matviews покрывают представления и материализованные представления.
Число строк в каждой таблице
Каталоги не хранят точное число строк. В pg_class.reltuples лежит оценка планировщика, которую обновляют VACUUM и ANALYZE. Её достаточно, чтобы найти большие таблицы, а -1 означает, что таблицу ещё ни разу не анализировали:
SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;
Чтобы получить точное число, выполните SELECT count(*) FROM orders: этот запрос читает всю таблицу. Таблицы каталога описаны в разделе System Catalogs документации PostgreSQL.
Часто задаваемые вопросы
Есть ли в PostgreSQL SHOW TABLES или SHOW DATABASES?
Нет, это команды MySQL. В PostgreSQL SHOW читает настройку сервера, поэтому SHOW TABLES падает с ошибкой «unrecognized configuration parameter». Используйте \dt и \l в psql или запрашивайте information_schema.tables и pg_database.
Почему \dt пишет «Did not find any relations»?
Либо вы подключены не к той базе, где лежат таблицы, либо таблицы находятся в схеме, которой нет в вашем search_path. Проверьте \conninfo, затем попробуйте \dt *.* или \dt schema_name.*.
Как переключиться на другую базу данных в PostgreSQL?
Подключение относится к одной базе, и оператора USE в SQL нет. В psql выполните \c other_db: эта команда открывает новое подключение. Из командной строки запустите psql -d other_db.
Как узнать размер таблиц в PostgreSQL?
В psql \dt+ добавляет столбец с размером. В SQL pg_size_pretty(pg_total_relation_size('orders')) показывает размер таблицы вместе с её индексами и данными TOAST.