CREATE TABLE name (column type constraints, ...) создаёт таблицу. У каждого столбца есть имя и тип данных, а за ними необязательные ограничения, такие как PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE или CHECK.
Столбец id нумеруется сам, plan получает 'free', если вставка его не указала, а created_at записывает время вставки. Самые распространённые типы столбцов перечислены на странице о типах данных.
Ограничения столбцов
| Ограничение | Что делает |
|---|---|
PRIMARY KEY | Уникален и не NULL; один на таблицу |
NOT NULL | В столбце обязательно должно быть значение |
DEFAULT expr | Значение, если вставка не указала столбец |
UNIQUE | Ни у каких двух строк нет одинакового значения (несколько NULL допустимы) |
CHECK (expr) | Отклоняет строки, для которых выражение ложно |
REFERENCES t (col) | Внешний ключ на другую таблицу |
Начиная с PostgreSQL 15, UNIQUE NULLS NOT DISTINCT считает NULL равными, поэтому NULL в этом столбце может быть только у одной строки.
Правила для нескольких столбцов
Ограничение на несколько столбцов записывается отдельной строкой после столбцов. Если дать ему имя через CONSTRAINT name, сообщения об ошибках станут понятнее, а удалить его потом можно будет по имени.
Запрос выводит три ограничения. Безымянные получили сгенерированные имена bookings_guests_check и bookings_pkey.
Создать таблицу, только если её нет
С IF NOT EXISTS второй CREATE TABLE выдаёт уведомление, а не ошибку. Проверяется только имя. Если таблица logs уже есть, но с другими столбцами, ничего не изменится.
Создать таблицу из запроса или по образцу другой
CREATE TABLE ... AS создаёт таблицу из результата SELECT, со столбцами и типами этого результата. LIKE копирует определение другой таблицы без её строк, а INCLUDING ALL переносит заодно значения по умолчанию, ограничения, identity и индексы.
В big_orders одна строка. У orders_archive столбцы и ограничения orders, но строк нет.
Генерируемые столбцы
Генерируемый столбец вычисляется из других столбцов той же строки, и вставка не может записать в него значение. В PostgreSQL 17 он должен быть STORED: значение вычисляется при записи и хранится на диске.
Итоги равны 13.5 и 20.
Временные и нежурналируемые таблицы
CREATE TEMP TABLE создаёт таблицу, которую видит только текущая сессия; она удаляется, когда сессия заканчивается. Это удобно для промежуточных результатов в длинном скрипте. CREATE UNLOGGED TABLE не пишет в журнал предзаписи (WAL), поэтому запись быстрее. После сбоя такая таблица очищается и на реплики не копируется, так что храните в ней только данные, которые можно восстановить.
CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);
Чтобы изменить уже созданную таблицу, используйте ALTER TABLE. Все параметры перечислены в справочнике по CREATE TABLE.
Часто задаваемые вопросы
Учитывает ли PostgreSQL регистр в именах таблиц?
Имена без кавычек приводятся к нижнему регистру, поэтому CREATE TABLE Users создаёт users. Имя в кавычках, например "Users", сохраняет регистр, но тогда его придётся брать в кавычки в каждом запросе. Поэтому принято писать имена в нижнем регистре через подчёркивание (snake_case).
Как посмотреть структуру таблицы в PostgreSQL?
В psql команда \d table_name показывает столбцы, типы, значения по умолчанию, индексы и ограничения. Из SQL выполните запрос к information_schema.columns WHERE table_name = 'table_name'.
Как скопировать таблицу в PostgreSQL?
CREATE TABLE copy AS TABLE original; копирует столбцы и строки, но не ограничения и индексы. CREATE TABLE copy (LIKE original INCLUDING ALL); копирует структуру со значениями по умолчанию, ограничениями и индексами, но без строк.
Как удалить таблицу в PostgreSQL?
DROP TABLE table_name; удаляет таблицу вместе с данными. DROP TABLE IF EXISTS table_name; не выдаёт ошибку, если таблицы нет, а CASCADE удаляет также зависящие от неё представления и внешние ключи.