Menu

CREATE TABLE в PostgreSQL: синтаксис и примеры

CREATE TABLE задаёт столбцы таблицы, их типы и ограничения. Разбираем identity-ключи, NOT NULL, DEFAULT, UNIQUE, CHECK, IF NOT EXISTS, CREATE TABLE AS и LIKE.

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

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 удаляет также зависящие от неё представления и внешние ключи.

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

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

Начать