Menu

PostgreSQL: список баз данных и таблиц (psql и SQL)

В psql команда \l показывает базы данных, \c переключает на другую базу, а \dt выводит её таблицы. В SQL используйте pg_database, information_schema.tables и information_schema.columns.

На этой странице есть исполняемые редакторы: меняйте, запускайте и сразу видите результат.

В 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.

Иллюстрация языков программирования Coddy

Учитесь программировать с Coddy

Начать