CREATE TABLE
CREATE TABLE — создать таблицу
Синтаксис
CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ]имя_таблицы
( [ {имя_столбца
тип_данных
[ COMPRESSIONметод_сжатия
] [ COLLATEправило_сортировки
] [ограничение_столбца
[ ... ] ] |ограничение_таблицы
| LIKEисходная_таблица
[вариант_копирования
... ] } [, ... ] ] ) [ INHERITS (таблица_родитель
[, ... ] ) ] [ PARTITION BY { RANGE | LIST | HASH } ( {имя_столбца
| (выражение
) } [ COLLATEправило_сортировки
] [класс_операторов
] [, ... ] ) ] [ USINGmethod
] [ WITH (параметр_хранения
[=значение
] [, ... ] ) | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] [ TABLESPACEтабл_пространство
] CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ]имя_таблицы
OFимя_типа
[ ( {имя_столбца
[ WITH OPTIONS ] [ограничение_столбца
[ ... ] ] |ограничение_таблицы
} [, ... ] ) ] [ PARTITION BY { RANGE | LIST | HASH } ( {имя_столбца
| (выражение
) } [ COLLATEправило_сортировки
] [класс_операторов
] [, ... ] ) ] [ USINGmethod
] [ WITH (параметр_хранения
[=значение
] [, ... ] ) | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] [ TABLESPACEтабл_пространство
] CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ]имя_таблицы
PARTITION OFтаблица_родитель
[ ( {имя_столбца
[ WITH OPTIONS ] [ограничение_столбца
[ ... ] ] |ограничение_таблицы
} [, ... ] ) ] { FOR VALUESуказание_границ_секции
| DEFAULT } [ PARTITION BY { RANGE | LIST | HASH } ( {имя_столбца
| (выражение
) } [ COLLATEправило_сортировки
] [класс_операторов
] [, ... ] ) ] [ USINGmethod
] [ WITH (параметр_хранения
[=значение
] [, ... ] ) | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] [ TABLESPACEтабл_пространство
] Здесьограничение_столбца
: [ CONSTRAINTимя_ограничения
] { NOT NULL | NULL | CHECK (выражение
) [ NO INHERIT ] | DEFAULTвыражение_по_умолчанию
| GENERATED ALWAYS AS (генерирующее_выражение
) STORED | GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY [ (параметры_последовательности
) ] | UNIQUEпараметры_индекса
| PRIMARY KEYпараметры_индекса
| REFERENCESцелевая_таблица
[ (целевой_столбец
) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETEссылочное_действие
] [ ON UPDATEссылочное_действие
] } [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] иограничение_таблицы
: [ CONSTRAINTимя_ограничения
] { CHECK (выражение
) [ NO INHERIT ] | UNIQUE (имя_столбца
[, ... ] )параметры_индекса
| PRIMARY KEY (имя_столбца
[, ... ] )параметры_индекса
| EXCLUDE [ USINGиндексный_метод
] (элемент_исключения
WITHоператор
[, ... ] )параметры_индекса
[ WHERE (предикат
) ] | FOREIGN KEY (имя_столбца
[, ... ] ) REFERENCESцелевая_таблица
[ (целевой_столбец
[, ... ] ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETEссылочное_действие
] [ ON UPDATEссылочное_действие
] } [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] ивариант_копирования
: { INCLUDING | EXCLUDING } { COMMENTS | COMPRESSION | CONSTRAINTS | DEFAULTS | GENERATED | IDENTITY | INDEXES | STATISTICS | STORAGE | ALL } иуказание_границ_секции
: IN (выражение_границ_секции
[, ...] ) | FROM ( {выражение_границ_секции
| MINVALUE | MAXVALUE } [, ...] ) TO ( {выражение_границ_секции
| MINVALUE | MAXVALUE } [, ...] ) | WITH ( MODULUSчисловая_константа
, REMAINDERчисловая_константа
)параметры_индекса
в ограниченияхUNIQUE
,PRIMARY KEY
иEXCLUDE
: [ INCLUDE (имя_столбца
[, ... ] ) ] [ WITH (параметр_хранения
[=значение
] [, ... ] ) ] [ USING INDEX TABLESPACEтабл_пространство
]элемент_исключения
в ограниченииEXCLUDE
: {имя_столбца
| (выражение
) } [ COLLATEправило_сортировки
] [класс_операторов
[ (параметр_класса_оп
=значение
[, ... ] ) ] ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ]
Описание
CREATE TABLE
создаёт новую, изначально пустую таблицу в текущей базе данных. Владельцем таблицы будет пользователь, выполнивший эту команду.
Если задано имя схемы (например, CREATE TABLE myschema.mytable ...
), таблица создаётся в указанной схеме, в противном случае — в текущей. Временные таблицы существуют в специальной схеме, так что при создании таких таблиц имя схемы задать нельзя. Имя таблицы должно отличаться от имён других таблиц, последовательностей, индексов, представлений или сторонних таблиц в этой схеме.
CREATE TABLE
также автоматически создаёт составной тип данных, соответствующий одной строке таблицы. Таким образом, имя таблицы не может совпадать с именем существующего типа в этой же схеме.
Необязательные предложения ограничений задают ограничения (проверки), которым должны удовлетворять добавляемые или изменяемые строки, чтобы операция добавления или изменения была выполнена успешно. Ограничение представляет собой SQL-объект, помогающий некоторым способом определить множество допустимых значений в таблице.
Определить ограничения можно двумя способами: в виде ограничений таблицы и в виде ограничений столбца. Ограничение столбца определяется как часть определения столбца, а ограничение таблицы не привязывается к конкретному столбцу и может задействовать несколько столбцов. Любые ограничения столбцов можно также записать в виде ограничения таблицы, они введены просто для удобства записи в случаях, когда ограничение затрагивает только один столбец.
Чтобы создать таблицу, необходимо иметь право USAGE
для типов всех столбцов или типа в предложении OF
, соответственно.
Параметры
TEMPORARY
илиTEMP
С таким указанием таблица создаётся как временная. Временные таблицы автоматически удаляются в конце сеанса или могут удаляться в конце текущей транзакции (см. описание
ON COMMIT
ниже). В путь поиска по умолчанию первой включается временная схема, поэтому постоянная таблица с тем же именем не будет выбираться для новых планов запросов, пока существует временная (если имя задаётся без указания схемы). Все индексы, создаваемые для временной таблицы, автоматически также становятся временными.Демон автоочистки не может прочитать и, как следствие, сжимать и анализировать временные таблицы. По этой причине соответствующие операции очистки и анализа следует выполнять, вызывая SQL-команды в рамках сеанса. Например, если временную таблицу планируется использовать в сложных запросах, будет разумным выполнить для неё
ANALYZE
после того, как она будет наполнена.По желанию можно добавить указание
GLOBAL
илиLOCAL
передTEMPORARY
илиTEMP
. В настоящее время это не имеет значения для PostgreSQL и считается устаревшей возможностью; см. раздел Совместимость ниже.UNLOGGED
С этим указанием таблица создаётся как нежурналируемая. Данные, записываемые в нежурналируемые таблицы, не проходят через журнал предзаписи (см. Главу 30), в результате чего такие таблицы работают гораздо быстрее обычных. Однако они не защищены от сбоя; при сбое или аварийном отключении сервера нежурналируемая таблица автоматически усекается. Кроме того, содержимое нежурналируемой таблицы не реплицируется на ведомые серверы. Любые индексы, создаваемые для нежурналируемой таблицы, автоматически становятся нежурналируемыми.
IF NOT EXISTS
Не считать ошибкой, если отношение с таким именем уже существует. В этом случае будет выдано замечание. Заметьте, что нет никакой гарантии, что существующее отношение как-то соотносится с тем, которое могло бы быть создано.
имя_таблицы
Имя создаваемой таблицы (возможно, дополненное схемой).
OF
имя_типа
Создаёт типизированную таблицу, структура которой определяется указанным составным типом (его имя может быть дополнено схемой). Типизированная таблица привязана к породившему её типу; например, при удалении типа (командой
DROP TYPE ... CASCADE
) будет удалена и эта таблица.Когда создаётся типизированная таблица, типы данных её столбцов определяются нижележащим составным типом, а не задаются командой
CREATE TABLE
. НоCREATE TABLE
может добавить в таблицу значения по умолчанию и ограничения, а также задать параметры её хранения.имя_столбца
Имя столбца, создаваемого в новой таблице.
тип_данных
Тип данных столбца (может включать определение массива с этим типом). За дополнительными сведениями о типах данных, которые поддерживает PostgreSQL, обратитесь к Главе 8.
COLLATE
правило_сортировки
Предложение
COLLATE
назначает правило сортировки для столбца (который должен иметь тип, поддерживающий сортировку). Если оно отсутствует, используется правило сортировки по умолчанию, установленное для типа данных столбца.COMPRESSION
метод_сжатия
Указание
COMPRESSION
задаёт метод сжатия для столбца. Сжатие поддерживается только для типов данных переменной длины и применяется только для столбцов с режимом храненияmain
илиextended
. (О режимах хранения столбцов рассказывается в ALTER TABLE.) Заданное для секционированной таблицы это свойство не оказывает прямого действия, так как такие таблицы сами по себе не содержат данные, но установленное значение будут наследовать её новые секции. Поддерживаются следующие методы сжатия:pglz
иlz4
. (lz4
поддерживается, только если PostgreSQL был собран с ключом--with-lz4
.) Кроме того,метод_сжатия
может принимать значениеdefault
, явно выбирающее поведение по умолчанию — когда применяемый метод определяется значением default_toast_compression во время добавления данных.INHERITS (
таблица_родитель
[, ... ] )Необязательное предложение
INHERITS
определяет список таблиц, от которых новая таблица будет автоматически наследовать все столбцы. Родительские таблицы могут быть обычными или сторонними таблицами.При использовании
INHERITS
создаётся постоянная связь дочерней таблицы с родительскими. Изменения схемы в родительских таблицах обычно также отражаются в дочерних, и по умолчанию при чтении родительских таблиц в результат включаются данные дочерней таблицы.Когда в нескольких родительских таблицах оказываются столбцы с одним именем, происходит ошибка, за исключением случая, когда типы данных всех этих столбцов в таблицах совпадают. В этом случае одноимённые столбцы объединяются и формируют один столбец в новой таблице. Если имя столбца новой таблицы совпадает с именем одного из унаследованных столбцов, их типы так же должны совпадать, и в этом случае определения столбцов тоже сливаются в одну. Если в новой таблице явно указывается значение по умолчанию для нового столбца, это значение переопределяет любые значения по умолчанию, унаследованные этим столбцом. В противном случае, если значения по умолчанию определяются в разных родительских таблицах, эти определения должны совпадать, иначе произойдёт ошибка.
Ограничения
CHECK
объединяются вместе по сути так же, как и столбцы: если несколько родительских таблиц и/или определение новой таблицы содержат одноимённые ограниченияCHECK
, этим ограничениям должны соответствовать одинаковые выражения проверки, в противном случае произойдёт ошибка. В случае совпадения выражения, эти ограничения с данным выражением объединяются в одно. При этом ограничения со свойствомNO INHERIT
в родительской таблице исключаются из рассмотрения. Заметьте, что безымянное ограничениеCHECK
в новой таблице никогда не сливается с другими, так как для него всегда выбирается уникальное имя.Параметры
STORAGE
для столбца так же копируются из родительских таблиц.Если столбец в родительской таблице является столбцом идентификации, это свойство не наследуется. Если требуется, в дочерней таблице этот столбец можно объявить столбцом идентификации.
PARTITION BY { RANGE | LIST | HASH } ( {
имя_столбца
| (выражение
) } [класс_операторов
] [, ...] )Необязательное предложение
PARTITION BY
задаёт стратегию секционирования таблицы. Таблица, созданная с этим указанием, называется секционируемой таблицей. Задаваемый в скобках список столбцов или выражений формирует ключ разбиения таблицы. Для разбиения по диапазонам или по хешу ключ разбиения может включать несколько столбцов или выражений (до 32, но этот предел можно изменить при сборке PostgreSQL), но для разбиения по спискам ключ должен состоять из одного столбца или выражения.Для секционирования по диапазонам и по спискам нужен класс операторов B-дерева, тогда как для секционирования по хешу требуется класс операторов хеширования. Если класс операторов не задан явно, будет применён класс операторов по умолчанию для соответствующего типа; в случае отсутствия такого класса выдаётся ошибка. Для секционирования по хешу применяемый класс операторов должен реализовывать опорную функцию 2 (см. Подраздел 38.16.3).
Секционируемая таблица разделяется на подтаблицы (называемые секциями), которые создаются отдельными командами
CREATE TABLE
. Сама по себе секционируемая таблица не содержит данных. Строка данных, вставляемая в эту таблицу, перенаправляется в секцию в зависимости от значений столбцов или выражений в ключе разбиения. Если значениям в новой строке не соответствует ни одна из существующих секций, возникает ошибка.Секционируемые таблицы не поддерживают ограничения
EXCLUDE
; однако вы можете определить такие ограничения в отдельных секциях.Узнать больше о секционировании таблиц можно в Разделе 5.11.
PARTITION OF
таблица_родитель
{ FOR VALUESуказание_границ_секции
| DEFAULT }Создаёт таблицу в виде секции указанной родительской таблицы. Таблицу можно создать либо как секцию для определённых значений (используя
FOR VALUES
), либо как секцию по умолчанию (используяDEFAULT
). Это указание неприемлемо для таблиц, секционируемых по хешу. В создаваемую секцию копируются все индексы, ограничения и пользовательские триггеры уровня строк.Здесь
указание_границ_секции
должно соответствовать методу и ключу секционирования родительской таблицы и не должно конфликтовать с любой существующей секцией того же родителя. Вариант указания сIN
используется для секционирования по спискам, тогда как вариант сFROM
иTO
для секционирования по диапазонам, а сWITH
— для секционирования по хешу.выражение_границ_секции
— любое выражение без переменных (подзапросы, оконные, агрегатные и возвращающие множества функции в нём не допускаются). Его тип данных должен подходить для соответствующего столбца в ключе секционирования. Это выражение вычисляется единожды во время создания таблицы, поэтому в нём могут вызываться даже изменчивые функции, например
.CURRENT_TIMESTAMP
При создании секции с разбиением по спискам возможно указать, что столбец ключа разбиения может содержать NULL, включив в список секции
NULL
. Однако у отдельно взятой родительской таблицы может быть не больше одной такой секции. Для диапазонных секцийNULL
задать нельзя.При создании диапазонной секции нижняя граница, задаваемая во
FROM
, включается в диапазон, а верхняя граница, задаваемая вTO
— исключается. То есть, значения, задаваемые в спискеFROM
, являются допустимыми значениями соответствующих столбцов ключа разбиения для этой секции, а значения в спискеTO
— нет. Заметьте, что это утверждение должно восприниматься с учётом правил сравнения строк таблицы (см. Подраздел 9.24.5). Например, с разбиениемPARTITION BY RANGE (x,y)
, секция с границамиFROM (1, 2) TO (3, 4)
приметx=1
с любым значениемy>=2
,x=2
с любымy
, отличным от NULL, иx=3
с любымy<4
.Специальные значения
MINVALUE
иMAXVALUE
могут использоваться при создании диапазонной секции для указания, что нижняя или верхняя граница для значений столбца отсутствует. Например, секция, определённая с указаниемFROM (MINVALUE) TO (10)
, будет принимать любые значения меньше 10, а секция, определённая с указаниемFROM (10) TO (MAXVALUE)
, — любые значения, которые больше или равны 10.При создании диапазонной секции с более чем одним столбцом может также иметь смысл использовать
MAXVALUE
в определении нижней границы, аMINVALUE
— верхней. Например, секция, определённая с указаниемFROM (0, MAXVALUE) TO (10, MAXVALUE)
, будет принимать любые строки, в которых первый столбец ключа разбиения больше 0 и меньше или равен 10. Подобным образом, секция, определённая с указаниемFROM ('a', MINVALUE) TO ('b', MINVALUE)
, будет принимать строки, в которых первый столбец ключа разбиения начинается с «a».Заметьте, что если для одного столбца в границе секции задаётся
MINVALUE
илиMAXVALUE
, то же значение должно применяться и для всех последующих столбцов. Например, граница(10, MINVALUE, 0)
будет некорректной; допустимая граница:(10, MINVALUE, MINVALUE)
.Также заметьте, что для некоторых типов элементов, таких как
timestamp
, наряду с другими значениями допускается значение "infinity" (бесконечность). Оно отличается от вариантовMINVALUE
иMAXVALUE
, которые на самом деле не обозначают значения, которые можно сохранить, а просто говорят о том, это значение не ограничено.MAXVALUE
можно воспринимать как значение, которое больше любого другого, включая "бесконечность", аMINVALUE
меньше любого другого значения, включая "минус бесконечность". Таким образом, диапазонFROM ('infinity') TO (MAXVALUE)
не будет пустым, а будет принимать ровно одно значение — «infinity».С указанием
DEFAULT
таблица присоединяется к родительской таблице как секция по умолчанию. Для таблиц, разбиваемых по хешу, это указание не поддерживается. Ключ разбиения, не попадающий ни в одну из секций данного родителя, будет отправлен в секцию по умолчанию.Когда у таблицы есть секция по умолчанию (
DEFAULT
) и к ней добавляется новая секция, требуется просканировать секцию по умолчанию и убедиться в том, что она не содержит строки, которые должны относиться к новой секции. Если она содержит большое количество строк, это сканирование может быть длительным. Сканирование не будет выполняться, если секция по умолчанию является сторонней таблицей или в ней есть ограничение, гарантирующее отсутствие в этой секции строк, подлежащих перемещению в новую секцию.При создании секции с разбиением по хешу должен задаваться модуль и остаток. Модулем должно быть положительное число, а остатком неотрицательное число, меньшее модуля. Обычно при начальной настройке таблицы с секционированием по хешу нужно выбрать модуль, равный количеству секций, и назначить каждой секции этот модуль и разные остатки (см. примеры ниже). Однако секциям можно назначить и разные модули, с условием, что модули, назначенные секциям таблицы, разбиваемой по хешу, являются делителями следующих больших модулей. Это позволяет постепенно увеличивать число секций, не производя полное перемещение всех данных. Например, предположим, что у вас есть таблица, разбиваемая по хешу на 8 секций, для каждой из которых назначен модуль 8, и возникла необходимость увеличить число секций до 16. Вы можете отсоединить одну из секций по модулю 8, создать две новые секции по модулю 16, покрывающих ту же часть пространства ключа (одну с остатком, равным остатку отсоединённой секции, а вторую с остатком, равным тому же остатку плюс 8), и вновь наполнить их данными. Вы можете повторять эту операцию (возможно, позже) для остальных секций по модулю 8, пока все они не будут заменены. Хотя и при таком подходе может потребоваться перемещать большие объёмы данных на каждом этапе, это всё же лучше, чем создавать абсолютно новую таблицу и перемещать все данные сразу.
В секции должны содержаться столбцы с теми же именами и типами, что и в секционированной таблице, к которой она относится. Изменение имён и типов столбцов в секционируемой таблице будет автоматически распространяться во все секции. Ограничения
CHECK
будут наследоваться автоматически всеми секциями, но для отдельных секций могут быть заданы дополнительные ограниченияCHECK
; дополнительные ограничения с теми же именами и условиями, как в родительской таблице, будут объединены с родительским ограничением. Также независимо для каждой секции могут быть заданы значения по умолчанию. Но заметьте, что значение по умолчанию, заданное на уровне секции, не будет действовать при добавлении строк через секционированную таблицу.Строки, добавляемые в секционированную таблицу, будут автоматически перенаправляться в соответствующую секцию. Если подходящей секции не найдётся, произойдёт ошибка.
Такие операции, как
TRUNCATE
, обычно затрагивают и саму таблицу, и каскадно распространяются на все дочерние секции, но могут также выполняться в отдельных секциях.Обратите внимание, что для создания секции с использованием
PARTITION OF
требуется применение блокировкиACCESS EXCLUSIVE
для родительской секционированной таблицы. Аналогично для удаления секции с помощьюDROP TABLE
требуется установить блокировкуACCESS EXCLUSIVE
в родительской таблице. Для выполнения этих операций с менее строгой блокировкой можно использовать командуALTER TABLE ATTACH/DETACH PARTITION
, тем самым снизив влияние на параллельные операции с секционированной таблицей.LIKE
исходная_таблица
[вариант_копирования
... ]Предложение
LIKE
определяет таблицу, из которой в новую таблицу будут автоматически скопированы все имена столбцов, их типы данных и их ограничения на NULL.В отличие от
INHERITS
, новая и исходная таблица становятся полностью независимыми после завершения создания. Изменения в исходной таблице не отражаются в новой, а данные новой таблицы не включаются в результат чтения исходной.Кроме того, в отличие от
INHERITS
, столбцы и ограничения, копируемые командойLIKE
, не объединяются с одноимёнными столбцами и ограничениями. Если дублирующееся имя указывается явно или возникает в другом предложенииLIKE
, происходит ошибка.Необязательные предложения
вариант_копирования
указывают, какие дополнительные свойства исходной таблицы будут копироваться. УказаниеINCLUDING
копирует заданное свойство, аEXCLUDING
исключает его. По умолчанию подразумеваетсяEXCLUDING
. Если к одному типу объекта относятся несколько указаний, будет применяться последнее. Допустимые указания:INCLUDING COMMENTS
Копировать комментарии для скопированных столбцов, ограничений и индексов. По умолчанию комментарии не копируются, вследствие чего скопированные столбцы и ограничения в новой таблице оказываются без комментариев.
INCLUDING COMPRESSION
Копировать метод сжатия для столбцов. По умолчанию указания метода сжатия не копируются, вследствие чего для новых столбцов выбирается метод сжатия по умолчанию.
INCLUDING CONSTRAINTS
Копировать ограничения-проверки (
CHECK
). В данном контексте ограничения на уровне столбцов и на уровне таблицы не различаются. Ограничения NOT NULL копируются в новую таблицу всегда.INCLUDING DEFAULTS
Копировать выражения значений по умолчанию в определениях копируемых столбцов. Без этого указания выражения по умолчанию не копируются, вследствие чего в новой таблице скопированные столбцы получают значения по умолчанию NULL. Заметьте, что при копировании подобных выражений, в которых вызываются функции, модифицирующие БД, как например
nextval
, может образовываться функциональная связь исходной таблицы с новой.INCLUDING GENERATED
Копировать выражения, генерирующие значения для копируемых столбцов. По умолчанию все новые столбцы будут обычными базовыми столбцами.
INCLUDING IDENTITY
Копировать характеристики идентификации в определениях копируемых столбцов. Для каждого столбца идентификации в новой таблице создаётся новая последовательность, не зависящая от последовательностей, связанных со старой таблицей.
INCLUDING INDEXES
Создавать в новой таблице индексы, ограничения
PRIMARY KEY
,UNIQUE
иEXCLUDE
, существующие в исходной таблице. Имена для новых индексов и ограничений выбираются согласно стандартным правилам, независимо от того, как назывались исходные. (Это позволяет избежать потенциальных конфликтов с именами новых индексов.)INCLUDING STATISTICS
Копировать в новую таблицу расширенную статистику.
INCLUDING STORAGE
Копировать параметры
STORAGE
в определениях копируемых столбцов. По умолчанию параметрыSTORAGE
исключаются, вследствие чего скопированные столбцы в новой таблице получают параметры по умолчанию, определённые соответствующим типом. Подробнее параметрыSTORAGE
описаны в Разделе 70.2.INCLUDING ALL
Указание
INCLUDING ALL
является сокращённым вариантом выбора всех имеющихся отдельных параметров. (ПослеINCLUDING ALL
можно дополнительно добавить предложенияEXCLUDING
, чтобы выбрать все параметры, за исключением некоторых.)
Предложение
LIKE
может также применяться для копирования определений столбцов из представлений, сторонних таблиц и составных типов. Неприменимые параметры (например,INCLUDING INDEXES
для представления) при этом игнорируются.CONSTRAINT
имя_ограничения
Необязательное имя столбца или ограничения таблицы. При нарушении ограничения его имя будет выводиться в сообщении об ошибках, так что имена ограничений вида
столбец должен быть положительным
могут сообщить полезную информацию об ограничении клиентскому приложению. (Имена ограничений, включающие пробелы, необходимо заключать в двойные кавычки.) Если имя ограничения не указано, система генерирует имя автоматически.NOT NULL
Данный столбец не принимает значения NULL.
NULL
Данный столбец может содержать значения NULL (по умолчанию).
Это предложение предназначено только для совместимости с нестандартными базами данных SQL. Использовать его в новых приложениях не рекомендуется.
CHECK (
выражение
) [ NO INHERIT ]В ограничении
CHECK
задаётся выражение, возвращающее логический результат, по которому определяется, будет ли успешна операция добавления или изменения для конкретных строк. Операция выполняется успешно, если результат выражения равен TRUE или UNKNOWN. Если же для какой-нибудь строки, задействованной в операции добавления или изменения, будет получен результат FALSE, возникает ошибка, и эта операция не меняет ничего в базе данных. Ограничение-проверка, заданное как ограничение столбца, должно ссылаться только на значение самого столбца, тогда как ограничение на уровне таблицы может ссылаться и на несколько столбцов.В настоящее время выражения
CHECK
не могут содержать подзапросы или ссылаться на какие-либо переменные, кроме как на столбцы текущей строки (см. Подраздел 5.4.1). Также допустима ссылка на системный столбецtableoid
, но не на другие системные столбцы.Ограничение с пометкой
NO INHERIT
не будет наследоваться дочерними таблицами.Когда для таблицы задано несколько ограничений
CHECK
, они будут проверяться для каждой строки в алфавитном порядке имён после проверки ограниченийNOT NULL
. (До версии 9.5 в PostgreSQL не было установлено никакого определённого порядка обработки ограниченийCHECK
.)DEFAULT
выражение_по_умолчанию
Предложение
DEFAULT
задаёт значение по умолчанию для столбца, в определении которого оно присутствует. Значение задаётся выражением без переменных (в частности, перекрёстные ссылки на другие столбцы текущей таблицы в нём не допускаются). Также не допускаются подзапросы. Тип данных выражения, задающего значение по умолчанию, должен соответствовать типу данных столбца.Это выражение будет использоваться во всех операциях добавления данных, в которых не задаётся значение данного столбца. Если значение по умолчанию не определено, таким значением будет NULL.
GENERATED ALWAYS AS (
генерирующее_выражение
) STOREDЭто предложение создаёт столбец как генерируемый. В такой столбец нельзя записать данные, а при чтении его возвращается результат указанного выражения.
Ключевое слово
STORED
отмечает, что этот столбец будет вычисляться при записи и сохраняться на диске.Генерирующее выражение может обращаться к другим столбцам таблицы, но не к другим генерируемым столбцам. Все функции и операторы в нём должны быть постоянными. Обращаться к другим таблицам в таких выражениях нельзя.
GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY [ (
параметры_последовательности
) ]С этим предложением столбец создаётся как столбец идентификации. С ним будет связана неявная последовательность, из которой этот столбец будет автоматически получать значения в новых строках. Такому столбцу неявно назначается свойство
NOT NULL
.Предложения
ALWAYS
иBY DEFAULT
определяют, как явно заданные пользователем значения будут обрабатываться командамиINSERT
иUPDATE
.В команде
INSERT
, в случае выбораALWAYS
, пользовательское значение используется, только если в этой команде указаноOVERRIDING SYSTEM VALUE
. С предложениемBY DEFAULT
пользовательскому значению отдаётся предпочтение. За подробностями обратитесь к описанию INSERT. (В командеCOPY
пользовательские значения используются всегда, вне зависимости от выбранного здесь варианта.)В команде
UPDATE
, в случае выбораALWAYS
, попытка поместить в столбец любое значение, отличное отDEFAULT
, будет отвергнута. Если выбран вариантBY DEFAULT
, столбец может быть изменён обычным образом. (ПредложениеOVERRIDING
для командыUPDATE
отсутствует.)Используя необязательное предложение
параметры_последовательности
, можно переопределить свойства последовательности. За подробностями обратитесь к CREATE SEQUENCE.UNIQUE
(ограничение столбца)UNIQUE (
[имя_столбца
[, ... ] )INCLUDE (
] (ограничение таблицы)имя_столбца
[, ...])Ограничение
UNIQUE
определяет, что группа из одного или нескольких столбцов таблицы может содержать только уникальные значения. Ограничение уникальности для таблицы ведёт себя точно так же, как ограничение для столбца, но может охватывать несколько столбцов. Таким образом, ограничение уникальности гарантирует, что любые две строки таблицы различаются как минимум в этих столбцах.При проверке ограничения уникальности значения NULL не считаются равными.
В каждом ограничении уникальности должен задаваться набор столбцов, отличный от набора любого другого ограничения уникальности или первичного ключа в данной таблице. (Избыточные ограничения уникальности будут просто игнорироваться.)
При установлении ограничения уникальности в многоуровневой иерархии секционирования в определение ограничения должны включаться все столбцы ключа разбиения целевой секционированной таблицы, а также столбцы всех подчинённых секционированных таблиц.
При добавлении ограничения уникальности автоматически будет создан уникальный индекс-B-дерево по столбцу или группе столбцов, перечисленных в ограничении.
Необязательное предложение
INCLUDE
добавляет к этому индексу один или несколько столбцов, составляющих просто «дополнительную нагрузку»: для них уникальность не будет требоваться, и искать значения в них по данному индексу нельзя. Однако их содержимое может быть получено при сканировании только индекса. Заметьте, что хотя ограничение по неключевым столбцам не контролируется, оно всё же зависит от них. Как следствие, некоторые операции с этими столбцами (например,DROP COLUMN
) могут повлечь каскадное удаление индекса и ограничения.PRIMARY KEY
(ограничение столбца)PRIMARY KEY (
[имя_столбца
[, ... ] )INCLUDE (
] (ограничение таблицы)имя_столбца
[, ...])Ограничение
PRIMARY KEY
определяет, что столбец или столбцы таблицы могут содержать только уникальные (без повторений) значения, отличные от NULL. Для таблицы может быть задан только один первичный ключ, будь то ограничение столбца или ограничение таблицы.В определении первичного ключа должен задаваться набор столбцов, отличный от набора любого другого ограничения уникальности, установленного для данной таблицы. (В противном случае уникальное ограничение оказывается избыточным и будет отброшено.)
PRIMARY KEY
устанавливает для данных те же ограничения, что и сочетаниеUNIQUE
иNOT NULL
, но созданный по набору столбцов первичный ключ также даёт метаинформацию о конструкции схемы, так как он подразумевает, что другие таблицы могут ссылаться на этот набор столбцов как на уникальный идентификатор строк.Определяемые для секционированной таблицы ограничения
PRIMARY KEY
подчиняются тем же требованиям, что и ограниченияUNIQUE
.При добавлении ограничения
PRIMARY KEY
автоматически будет создан уникальный индекс-B-дерево по столбцу или группе столбцов, перечисленных в ограничении.Необязательное предложение
INCLUDE
добавляет к этому индексу один или несколько столбцов, составляющих просто «дополнительную нагрузку»: для них уникальность не будет требоваться, и искать значения в них по данному индексу нельзя. Однако их содержимое может быть получено при сканировании только индекса. Заметьте, что хотя ограничение по неключевым столбцам не контролируется, оно всё же зависит от них. Как следствие, некоторые операции с этими столбцами (например,DROP COLUMN
) могут повлечь каскадное удаление индекса и ограничения.EXCLUDE [ USING
индексный_метод
] (элемент_исключения
WITHоператор
[, ... ] )параметры_индекса
[ WHERE (предикат
) ]Предложение
EXCLUDE
определяет ограничение-исключение, которое гарантирует, что для любых двух строк, сравниваемых по указанным столбцам или выражениям с указанными операторами, результат не будет равенTRUE
для всех сравнений. Если все указанные операторы проверяют равенство, это ограничение равносильно ограничениюUNIQUE
, хотя обычное ограничение уникальности будет работать быстрее. С другой стороны, в ограничениях-исключениях можно задавать более общие условия, чем простое условие на равенство. Например, можно задать ограничение, требующее, чтобы никакие две строки в таблице не содержали пересекающихся кругов (см. Раздел 8.8), применив оператор&&
. Кроме того, операторы должны быть коммутативными.Ограничения-исключения реализуются с помощью индексов, так что каждый указанный в них оператор должен быть связан с соответствующим классом операторов (см. Раздел 11.10) для
индексного_метода
. В каждомэлементе_исключения
можно дополнительно указать класс оператора и/или параметры сортировки, подробно описанные в CREATE INDEX.Индексный метод доступа должен поддерживать
amgettuple
(см. Главу 62); в настоящее время это означает, что индексы GIN для этого не подходят. Хотя в ограничении-исключении можно использовать B-деревья и хеш-индексы, в этом мало смысла, так как такой подход ничем не лучше обычного ограничения уникальности. Так что на практике методом доступа всегда будет GiST или SP-GiST.Параметр
предикат
позволяет указать ограничение-исключение для подмножества таблицы; внутри при этом создаётся частичный индекс. Заметьте, что предикат необходимо заключить в скобки.REFERENCES
(ограничение столбца)внешняя_таблица
[ (внешний_столбец
) ] [ MATCHтип_совпадения
] [ ON DELETEссылочное_действие
] [ ON UPDATEссылочное_действие
]FOREIGN KEY (
(ограничение таблицы)имя_столбца
[, ... ] ) REFERENCESвнешняя_таблица
[ (внешний_столбец
[, ... ] ) ] [ MATCHтип_совпадения
] [ ON DELETEссылочное_действие
] [ ON UPDATEссылочное_действие
]Эти предложения определяют ограничение внешнего ключа, требующее, чтобы группа из одного или нескольких столбцов новой таблицы содержала только такие значения, которым соответствуют значения в заданных столбцах некоторой строки во внешней таблице. Если список
целевых_столбцов
опущен, в качестве него используется первичный ключцелевой_таблицы
. Если же он задан, в качестве целевых столбцов должны указываться столбцы неоткладываемого уникального ограничения или первичного ключа во внешней таблице, либо столбцы нечастичного уникального индекса. При этом пользователь должен иметь правоREFERENCES
во внешней таблице (либо для всей таблицы, либо только для целевых столбцов). Для добавления ограничения внешнего ключа требуется блокировкаSHARE ROW EXCLUSIVE
в целевой таблице. Обратите внимание, что нельзя определить ограничения внешнего ключа, связывающие временные и постоянные таблицы.Значения, вставляемые в ссылающиеся столбцы, сверяются со значениями во внешних столбцах внешней таблицы с учётом заданного типа совпадения. Возможны три типа совпадения:
MATCH FULL
(полное совпадение),MATCH PARTIAL
(частичное совпадение) и тип по умолчанию,MATCH SIMPLE
(простое совпадение). СMATCH FULL
ни один из столбцов составного внешнего ключа не может содержать NULL, кроме случая, когда все внешние столбцы NULL; в этом случае строка может не иметь соответствия во внешней таблице. СMATCH SIMPLE
любой из столбцов внешнего ключа может содержать NULL; при этом строка с NULL в одном из таких столбцов может не иметь соответствия во внешней таблице. ТипMATCH PARTIAL
ещё не реализован. (Разумеется, чтобы вопросы со сравнением NULL не возникали, к столбцам, ссылающимся на внешние, можно применить ограниченияNOT NULL
.)Кроме того, при изменении значений во внешних столбцах с данными в столбцах этой таблицы могут производиться определённые действия. Предложение
ON DELETE
задаёт действие, производимое при удалении некоторой строки во внешней таблице. ПредложениеON UPDATE
подобным образом задаёт действие, производимое при изменении значения в целевых столбцах внешней таблицы. Если строка изменена, но это изменение не затронуло целевые столбцы, никакое действие не производится. Ссылочные действия, кромеNO ACTION
, нельзя сделать откладываемыми, даже если ограничение объявлено как откладываемое. Для каждого предложения возможные следующие варианты действий:NO ACTION
Выдать ошибку, показывающую, что при удалении или изменении записи произойдёт нарушение ограничения внешнего ключа. Для отложенных ограничений ошибка произойдёт в момент проверки ограничения, если строки, ссылающиеся на эту запись, по-прежнему будут существовать. Этот вариант действия подразумевается по умолчанию.
RESTRICT
Выдать ошибку, показывающую, что при удалении или изменении записи произойдёт нарушение ограничения внешнего ключа. Этот вариант подобен
NO ACTION
, но эта проверка будет неоткладываемой.CASCADE
Удалить все строки, ссылающиеся на удаляемую запись, либо поменять значения в ссылающихся столбцах на новые значения во внешних столбцах, в соответствии с операцией.
SET NULL
Установить ссылающиеся столбцы равными NULL.
SET DEFAULT
Установить в ссылающихся столбцах значения по умолчанию. (Если эти значения не равны NULL, во внешней таблице должна быть строка, соответствующая набору значений по умолчанию; в противном случае операция завершится ошибкой.)
Если внешние столбцы меняются часто, будет разумным добавить индекс для ссылающихся столбцов, чтобы действия по обеспечению ссылочной целостности, связанные с ограничением внешнего ключа, выполнялись более эффективно.
DEFERRABLE
NOT DEFERRABLE
Это предложение определяет, может ли ограничение быть отложенным. Неоткладываемое ограничение будет проверяться немедленно после каждой команды. Проверка откладываемых ограничений может быть отложена до завершения транзакции (обычно с помощью команды
SET CONSTRAINTS
). По умолчанию подразумевается вариантNOT DEFERRABLE
. В настоящее время это предложение принимают только ограниченияUNIQUE
,PRIMARY KEY
,EXCLUDE
иREFERENCES
(внешний ключ). ОграниченияNOT NULL
иCHECK
не могут быть отложенными. Заметьте, что откладываемые ограничения не могут применяться в качестве решающих при конфликте в оператореINSERT
с предложениемON CONFLICT DO UPDATE
.INITIALLY IMMEDIATE
INITIALLY DEFERRED
Для откладываемых ограничений это предложение определяет, когда ограничение должно проверяться по умолчанию. Ограничение с характеристикой
INITIALLY IMMEDIATE
(подразумеваемой по умолчанию) проверяется после каждого оператора. ОграничениеINITIALLY DEFERRED
, напротив, проверяется только в конце транзакции. Время проверки ограничения можно изменить явно с помощью командыSET CONSTRAINTS
.USING
method
Это дополнительное предложение задаёт табличный метод доступа, который будет использоваться для сохранения содержимого новой таблицы; типом этого метода доступа должен быть
TABLE
. Подробнее об этом рассказывается в Главе 61. В случае отсутствия этого указания для новой таблицы выбирается метод доступа по умолчанию. За подробностями обратитесь к default_table_access_method.WITH (
параметр_хранения
[=значение
] [, ... ] )Это предложение определяет дополнительные параметры хранения для таблицы или индекса; за подробностями обратитесь к разделу Параметры хранения ниже. В целях обратной совместимости предложение
WITH
для таблицы также может содержать указаниеOIDS=FALSE
, отмечающее, что строки новой таблицы не должны содержать OID (идентификатор объекта); указаниеOIDS=TRUE
более не поддерживаетсяWITHOUT OIDS
Обеспечивающий обратную совместимость синтаксис создания таблицы с характеристикой
WITHOUT OIDS
; создание таблицы с указаниемWITH OIDS
более не поддерживается.ON COMMIT
Поведением временных таблиц в конце блока транзакции позволяет управлять предложение
ON COMMIT
, которое принимает три параметра:PRESERVE ROWS
Никакое специальное действие в конце транзакции не выполняется. Это поведение по умолчанию.
DELETE ROWS
Все строки в этой временной таблице будут удаляться в конце каждого блока транзакции. По сути, при каждой фиксации транзакции будет автоматически выполняться
TRUNCATE
. В случае секционированной таблицы это действие не распространяется на её секции.DROP
Временная таблица будет удалена в конце текущего блока транзакции. Если это секционированная таблица, будут удалены и все её секции. Если у таблицы есть потомки в иерархии наследования, они также будут удалены.
TABLESPACE
табл_пространство
Здесь
табл_пространство
— имя табличного пространства, в котором будет создаваться новая таблица. Если оно не указано, выбирается default_tablespace для обычных или temp_tablespaces для временных таблиц. Если же этот параметр задаётся для секционируемой таблицы, то ввиду того, что ей самой табличное пространство не требуется, заданное имя переопределяет значениеdefault_tablespace
(табличное пространство по умолчанию), которое применяется для всех создаваемых секций в случае отсутствия явного указания.USING INDEX TABLESPACE
табл_пространство
Это предложение позволяет выбрать табличное пространство, в котором будут создаваться индексы, связанные с ограничениями
UNIQUE
,PRIMARY KEY
илиEXCLUDE
. Если оно не указано, выбирается default_tablespace или temp_tablespaces, если таблица временная.
Параметры хранения
Предложение WITH
позволяет установить параметры хранения для таблиц и индексов, связанных с ограничениями UNIQUE
, PRIMARY KEY
и EXCLUDE
. Параметры хранения для индексов документированы в CREATE INDEX. Поддерживаемые в настоящее время параметры хранения для таблиц перечислены ниже. Как показано, для многих параметров существует дополнительный параметр с тем же именем и префиксом toast.
, который управляет поведением вторичной таблицы TOAST, если она есть (за дополнительными сведениями о TOAST обратитесь к Разделу 70.2). Если значение некоторого параметра задано для таблицы, а значение равнозначного параметра toast.
не определено, для таблицы TOAST будет применяться значение параметра основной таблицы. Возможность задания этих параметров для секционированных таблиц не поддерживается, но вы можете задать их для отдельных конечных секций.
fillfactor
(integer
)Фактор заполнения для таблицы, задаваемый в процентах, от 10 до 100. Значение по умолчанию — 100 (плотное заполнение). При меньшем факторе заполнения операции
INSERT
упаковывают данные в страницы только до заданного процента; оставшееся место резервируется для изменения строк на этой странице. В результатеUPDATE
получает шанс поместить изменённую копию строки в ту же страницу, что и исходную, что гораздо эффективнее, чем размещать её на другой странице, и увеличивает возможности для внесения изменений по схеме кортежи только в куче. Для таблиц, записи в которых никогда не меняются, лучшим выбором будет плотное заполнение, но для активно изменяемых таблиц лучше выбрать меньший фактор заполнения. Этот параметр нельзя задать для таблиц TOAST.toast_tuple_target
(integer
)Параметр toast_tuple_target задаёт минимальную длину кортежа, после превышения которой мы будем пытаться сжимать и/или переносить значения больших столбцов в таблицы TOAST и до которой мы будем пытаться сократить размер кортежа после перехода к TOAST. Это затрагивает столбцы с пометкой External (внешние, которые могут переноситься), Main (основные, которые могут сжиматься) или Extended (расширенные, которые могут и сжиматься, и просто переноситься) и касается только новых кортежей. На существующие кортежи это не влияет. По умолчанию этот параметр имеет значение, позволяющее разместить минимум 4 кортежа в блоке, что при стандартном размере блока составляет 2040 байт. Допустимые значения лежат в интервале от 128 байт до (размер_блока - заголовок), по умолчанию 8160 байт. Изменение этого значения может не отражаться на очень коротких и очень длинных кортежах. Заметьте, что выбранное по умолчанию значение часто близко к оптимальному, и весьма вероятно, что изменение этого параметра в некоторых случаях будет иметь отрицательный эффект. Для таблиц TOAST этот параметр задать нельзя.
parallel_workers
(integer
)Данный параметр задаёт число рабочих процессов, которые должны задействоваться при параллельном сканировании таблицы. Если это значение не задано, система будет определять его, исходя из размера отношения. Фактическое число рабочих процессов, выбранное планировщиком или служебными операторами, выполняющими параллельное сканирование, может быть меньше, например, вследствие ограничения max_worker_processes.
autovacuum_enabled
,toast.autovacuum_enabled
(boolean
)Включает или отключает демон автоочистки для определённой таблицы. Со значением true демон автоочистки будет автоматически выполнять операции
VACUUM
и/илиANALYZE
в этой таблице, согласно правилам, описанным в Подразделе 25.1.6. Со значением false эта таблица не будет подвергаться автоочистке, если только это не потребуется для предотвращения зацикливания идентификаторов транзакций. Более подробно предотвращение зацикливания описывается в Подразделе 25.1.5. Заметьте, что демон автоочистки не будет запускаться вовсе (если только это не потребуется для предотвращения зацикливания), если параметр autovacuum имеет значение false; это нельзя переопределить, установив параметры хранения для отдельных таблиц. Таким образом, явно устанавливать для этого параметра значениеtrue
практически не имеет смысла — полезно только значениеfalse
.vacuum_index_cleanup
,toast.vacuum_index_cleanup
(enum
)Включает или отключает очистку индекса при выполнении в этой таблице операции
VACUUM
. Значение по умолчанию —AUTO
. ЗначениеOFF
отключаёт очистку индекса,ON
— включает, а со значениемAUTO
решение об очистке принимается динамически при каждом выполненииVACUUM
. Динамический выбор позволяет избежать во времяVACUUM
ненужного сканирования индексов, в результате которого удаляются лишь несколько мёртвых кортежей. Принудительное безусловное отключение очистки индексов может очень существенно ускоритьVACUUM
, но также может привести к значительному раздуванию индексов при частых изменениях данных в таблице. Если для командыVACUUM
задаётся параметрINDEX_CLEANUP
, он переопределяет значениеvacuum_index_cleanup
.vacuum_truncate
,toast.vacuum_truncate
(boolean
)Включает или отключает процедуру отсечения пустых страниц в конце таблицы в процессе очистки. Значение по умолчанию —
true
(вкл.). Когда этот параметр включён, операцииVACUUM
и автоочистка пытаются отсечь пустые страницы, чтобы освободившееся место возвратилось операционной системе. Заметьте, что для этого отсечения требуется блокировка таблицы на уровнеACCESS EXCLUSIVE
. Явно заданный параметрTRUNCATE
командыVACUUM
переопределяет значение данного параметра.autovacuum_vacuum_threshold
,toast.autovacuum_vacuum_threshold
(integer
)Значение параметра autovacuum_vacuum_threshold для таблицы.
autovacuum_vacuum_scale_factor
,toast.autovacuum_vacuum_scale_factor
(floating point
)Значение параметра autovacuum_vacuum_scale_factor для таблицы.
autovacuum_vacuum_insert_threshold
,toast.autovacuum_vacuum_insert_threshold
(integer
)Значение параметра autovacuum_vacuum_insert_threshold для таблицы. Особое значение -1 отключает очистку, вызываемую добавлением данных.
autovacuum_vacuum_insert_scale_factor
,toast.autovacuum_vacuum_insert_scale_factor
(floating point
)Значение параметра autovacuum_vacuum_insert_scale_factor для таблицы.
autovacuum_analyze_threshold
(integer
)Значение параметра autovacuum_analyze_threshold для таблицы.
autovacuum_analyze_scale_factor
(floating point
)Значение параметра autovacuum_analyze_scale_factor для таблицы.
autovacuum_vacuum_cost_delay
,toast.autovacuum_vacuum_cost_delay
(floating point
)Значение параметра autovacuum_vacuum_cost_delay для таблицы.
autovacuum_vacuum_cost_limit
,toast.autovacuum_vacuum_cost_limit
(integer
)Значение параметра autovacuum_vacuum_cost_limit для таблицы.
autovacuum_freeze_min_age
,toast.autovacuum_freeze_min_age
(integer
)Значение параметра vacuum_freeze_min_age для таблицы. Учтите, что система будет игнорировать установленные для таблиц значения
autovacuum_freeze_min_age
, превышающие половину системного autovacuum_freeze_max_age.autovacuum_freeze_max_age
,toast.autovacuum_freeze_max_age
(integer
)Значение параметра autovacuum_freeze_max_age для таблицы. Учтите, что система будет игнорировать установленные для таблиц значения
autovacuum_freeze_max_age
, превышающие значение системного параметра (они могут быть только меньше).autovacuum_freeze_table_age
,toast.autovacuum_freeze_table_age
(integer
)Значение параметра vacuum_freeze_table_age для таблицы.
autovacuum_multixact_freeze_min_age
,toast.autovacuum_multixact_freeze_min_age
(integer
)Значение параметра vacuum_multixact_freeze_min_age для таблицы. Учтите, что демон автоочистки будет игнорировать установленные для таблиц значения
autovacuum_multixact_freeze_min_age
, превышающие половину значения системного параметра autovacuum_multixact_freeze_max_age.autovacuum_multixact_freeze_max_age
,toast.autovacuum_multixact_freeze_max_age
(integer
)Значение параметра autovacuum_multixact_freeze_max_age для таблицы. Учтите, что система автоочистки будет игнорировать установленные для таблиц параметры
autovacuum_multixact_freeze_max_age
, превышающие системный параметр (они могут быть только меньше).autovacuum_multixact_freeze_table_age
,toast.autovacuum_multixact_freeze_table_age
(integer
)Значения параметра vacuum_multixact_freeze_table_age для таблицы.
log_autovacuum_min_duration
,toast.log_autovacuum_min_duration
(integer
)Значения параметра log_autovacuum_min_duration для таблицы.
user_catalog_table
(boolean
)Объявляет таблицу как дополнительную таблицу каталога, например для целей логической репликации. За подробностями обратитесь к Подразделу 49.6.2. Для таблиц TOAST этот параметр задать нельзя.
Примечания
PostgreSQL автоматически создаёт индекс, гарантирующий уникальность, для каждого ограничения уникальности и ограничения первичного ключа. Поэтому явно создавать индекс для столбцов первичного ключа не требуется. (За дополнительными сведениями обратитесь к CREATE INDEX.)
Ограничения уникальности и первичные ключи в текущей реализации не наследуются. Вследствие этого ограничения уникальности довольно плохо сочетаются с наследованием.
В таблице не может быть больше 1600 столбцов. (На практике фактический предел обычно ниже из-за ограничения на длину записи.)
Примеры
Создание таблицы films
и таблицы distributors
:
CREATE TABLE films ( code char(5) CONSTRAINT firstkey PRIMARY KEY, title varchar(40) NOT NULL, did integer NOT NULL, date_prod date, kind varchar(10), len interval hour to minute ); CREATE TABLE distributors ( did integer PRIMARY KEY GENERATED BY DEFAULT AS IDENTITY, name varchar(40) NOT NULL CHECK (name <> '') );
Создание таблицы с двумерным массивом:
CREATE TABLE array_int ( vector int[][] );
Определение ограничения уникальности для таблицы films
. Ограничения уникальности могут быть определены для одного или нескольких столбцов таблицы:
CREATE TABLE films ( code char(5), title varchar(40), did integer, date_prod date, kind varchar(10), len interval hour to minute, CONSTRAINT production UNIQUE(date_prod) );
Определение ограничения-проверки для столбца:
CREATE TABLE distributors ( did integer CHECK (did > 100), name varchar(40) );
Определение ограничения-проверки для таблицы:
CREATE TABLE distributors ( did integer, name varchar(40), CONSTRAINT con1 CHECK (did > 100 AND name <> '') );
Определение ограничения первичного ключа для таблицы films
:
CREATE TABLE films ( code char(5), title varchar(40), did integer, date_prod date, kind varchar(10), len interval hour to minute, CONSTRAINT code_title PRIMARY KEY(code,title) );
Определение ограничения первичного ключа для таблицы distributors
. Следующие два примера равнозначны, но в первом используется синтаксис ограничений для таблицы, а во втором — для столбца:
CREATE TABLE distributors ( did integer, name varchar(40), PRIMARY KEY(did) ); CREATE TABLE distributors ( did integer PRIMARY KEY, name varchar(40) );
Определение значений по умолчанию: для столбца name
значением по умолчанию будет строка, для столбца did
— следующее значение объекта последовательности, а для modtime
— время, когда была вставлена запись:
CREATE TABLE distributors ( name varchar(40) DEFAULT 'Luso Films', did integer DEFAULT nextval('distributors_serial'), modtime timestamp DEFAULT current_timestamp );
Определение двух ограничений NOT NULL
для столбцов таблицы distributors
, при этом одному ограничению даётся явное имя:
CREATE TABLE distributors ( did integer CONSTRAINT no_null NOT NULL, name varchar(40) NOT NULL );
Определение ограничения уникальности для столбца name
:
CREATE TABLE distributors ( did integer, name varchar(40) UNIQUE );
То же самое условие, но в виде ограничения таблицы:
CREATE TABLE distributors ( did integer, name varchar(40), UNIQUE(name) );
Создание такой же таблицы с фактором заполнения 70% для таблицы и её уникального индекса:
CREATE TABLE distributors ( did integer, name varchar(40), UNIQUE(name) WITH (fillfactor=70) ) WITH (fillfactor=70);
Создание таблицы circles
с ограничением-исключением, не допускающим пересечения двух кругов:
CREATE TABLE circles ( c circle, EXCLUDE USING gist (c WITH &&) );
Создание таблицы cinemas
в табличном пространстве diskvol1
:
CREATE TABLE cinemas ( id serial, name text, location text ) TABLESPACE diskvol1;
Создание составного типа и типизированной таблицы:
CREATE TYPE employee_type AS (name text, salary numeric); CREATE TABLE employees OF employee_type ( PRIMARY KEY (name), salary WITH OPTIONS DEFAULT 1000 );
Создание таблицы, секционируемой по диапазонам:
CREATE TABLE measurement ( logdate date not null, peaktemp int, unitsales int ) PARTITION BY RANGE (logdate);
Создание таблицы, секционируемой по диапазонам, с ключом разбиения, включающим несколько столбцов:
CREATE TABLE measurement_year_month ( logdate date not null, peaktemp int, unitsales int ) PARTITION BY RANGE (EXTRACT(YEAR FROM logdate), EXTRACT(MONTH FROM logdate));
Создание таблицы, секционируемой по спискам:
CREATE TABLE cities ( city_id bigserial not null, name text not null, population bigint ) PARTITION BY LIST (left(lower(name), 1));
Создание таблицы, секционируемой по хешу:
CREATE TABLE orders ( order_id bigint not null, cust_id bigint not null, status text ) PARTITION BY HASH (order_id);
Создание секции таблицы, секционируемой по диапазонам:
CREATE TABLE measurement_y2016m07 PARTITION OF measurement ( unitsales DEFAULT 0 ) FOR VALUES FROM ('2016-07-01') TO ('2016-08-01');
Создание нескольких секций для таблицы, секционируемой по диапазонам, с ключом разбиения, включающим несколько столбцов:
CREATE TABLE measurement_ym_older PARTITION OF measurement_year_month FOR VALUES FROM (MINVALUE, MINVALUE) TO (2016, 11); CREATE TABLE measurement_ym_y2016m11 PARTITION OF measurement_year_month FOR VALUES FROM (2016, 11) TO (2016, 12); CREATE TABLE measurement_ym_y2016m12 PARTITION OF measurement_year_month FOR VALUES FROM (2016, 12) TO (2017, 01); CREATE TABLE measurement_ym_y2017m01 PARTITION OF measurement_year_month FOR VALUES FROM (2017, 01) TO (2017, 02);
Создание секции таблицы, секционируемой по спискам:
CREATE TABLE cities_ab PARTITION OF cities ( CONSTRAINT city_id_nonzero CHECK (city_id != 0) ) FOR VALUES IN ('a', 'b');
Создание секции таблицы, секционируемой по спискам (при этом сама секция также создаётся секционируемой), и добавление секции в неё:
CREATE TABLE cities_ab PARTITION OF cities ( CONSTRAINT city_id_nonzero CHECK (city_id != 0) ) FOR VALUES IN ('a', 'b') PARTITION BY RANGE (population); CREATE TABLE cities_ab_10000_to_100000 PARTITION OF cities_ab FOR VALUES FROM (10000) TO (100000);
Создание секций таблицы, секционируемой по хешу:
CREATE TABLE orders_p1 PARTITION OF orders FOR VALUES WITH (MODULUS 4, REMAINDER 0); CREATE TABLE orders_p2 PARTITION OF orders FOR VALUES WITH (MODULUS 4, REMAINDER 1); CREATE TABLE orders_p3 PARTITION OF orders FOR VALUES WITH (MODULUS 4, REMAINDER 2); CREATE TABLE orders_p4 PARTITION OF orders FOR VALUES WITH (MODULUS 4, REMAINDER 3);
Создание секции по умолчанию:
CREATE TABLE cities_partdef PARTITION OF cities DEFAULT;
Совместимость
Команда CREATE TABLE
соответствует стандарту SQL, с описанными ниже исключениями.
Временные таблицы
Хотя синтаксис CREATE TEMPORARY TABLE
подобен аналогичному в стандарте SQL, результат получается другим. В стандарте временные таблицы определяются только один раз и существуют (изначально пустые) в каждом сеансе, в котором они используются. PostgreSQL вместо этого требует, чтобы каждый сеанс выполнял собственную команду CREATE TEMPORARY TABLE
для каждой временной таблицы, которая будет использоваться. Это позволяет использовать в разных сеансах таблицы с одинаковыми именами для разных целей, тогда как при подходе, регламентированном стандартом, все экземпляры временной таблицы с одним именем должны иметь одинаковую табличную структуру.
Поведение временных таблиц, описанное в стандарте, в большинстве своём игнорируют и другие СУБД, так что в этом отношении PostgreSQL ведёт себя так же, как и ряд других СУБД.
В стандарте SQL также разделяются глобальные и локальные временные таблицы — в локальной временной таблице содержится отдельный набор данных для каждого модуля SQL в отдельном сеансе, хотя её определение так же разделяется между ними. Так как в PostgreSQL модули SQL не поддерживаются, это различие в PostgreSQL не существует.
Совместимости ради, PostgreSQL принимает ключевые слова GLOBAL
и LOCAL
в объявлении временной таблицы, но в настоящее время они никак не действуют. Использовать их не рекомендуется, так как в будущих версиях PostgreSQL может быть принята их интерпретация, более близкая к стандарту.
Предложение ON COMMIT
для временных таблиц тоже подобно описанному в стандарте SQL, но есть некоторые отличия. Если предложение ON COMMIT
опущено, в SQL подразумевается поведение ON COMMIT DELETE ROWS
. Однако в PostgreSQL по умолчанию действует ON COMMIT PRESERVE ROWS
. Параметр ON COMMIT DROP
в стандарте SQL отсутствует.
Неотложенные ограничения уникальности
Когда ограничение UNIQUE
или PRIMARY KEY
не является отложенным, PostgreSQL проверяет уникальность непосредственно в момент добавления или изменения строки. Стандарт SQL говорит, что уникальность должна обеспечиваться только в конце оператора; это различие проявляется, например когда одна команда изменяет множество ключевых значений. Чтобы получить поведение, оговоренное стандартом, объявите ограничение как откладываемое (DEFERRABLE
), но не отложенное (т. е., INITIALLY IMMEDIATE
). Учтите, что этот вариант может быть значительно медленнее, чем немедленная проверка ограничений.
Ограничения-проверки для столбцов
Стандарт SQL говорит, что ограничение CHECK
, определяемое для столбца, может ссылаться только на столбец, с которым оно связано; только ограничения CHECK
для таблиц могут ссылаться на несколько столбцов. В PostgreSQL этого ограничения нет; он воспринимает ограничения-проверки для столбцов и таблиц одинаково.
Ограничение EXCLUDE
Ограничения EXCLUDE
являются расширением PostgreSQL.
Ограничения внешнего ключа
Возможность ограничения внешнего ключа ссылаться на столбцы уникального индекса вместо столбцов первичного ключа или ограничения уникальности является расширением PostgreSQL.
NULL
«Ограничение»
«Ограничение» NULL
(на самом деле это не ограничение) является расширением PostgreSQL стандарта SQL, которое реализовано для совместимости с некоторыми другими СУБД (и для симметрии с ограничением NOT NULL
). Так как это поведение по умолчанию для любого столбца, его присутствие не несёт смысловой нагрузки.
Имена ограничений
В стандарте SQL говорится, что имена ограничений таблицы и ограничений домена должны быть уникальными в схеме, содержащей эту таблицу или домен. Однако PostgreSQL менее строг: он требует только, чтобы имена были уникальны среди ограничений, присоединённых к данной конкретной таблице или домену. Но такого послабления нет для ограничений, построенных на индексах (ограничений UNIQUE
, PRIMARY KEY
и EXCLUDE
), так как ограничение и связанный с ним индекс имеют одно имя, а имена индексов должны быть уникальны среди всех отношений в их схеме.
В настоящее время в PostgreSQL ограничения NOT NULL
вообще не имеют имён, так что на них требования уникальности не распространяются. Однако это может поменяться в будущих выпусках.
Наследование
Множественное наследование посредством INHERITS
является языковым расширением PostgreSQL. SQL:1999 и более поздние стандарты определяют единичное наследование с другим синтаксисом и смыслом. Наследование в стиле SQL:1999 пока ещё не поддерживается в PostgreSQL.
Таблицы с нулём столбцов
PostgreSQL позволяет создать таблицу без столбцов (например, CREATE TABLE foo();
). Это расширение стандарта SQL, который не допускает таблицы с нулём столбцов. Таблицы с нулём столбцов сами по себе не очень полезны, но если их запретить, возникают странные особые ситуации с командой ALTER TABLE DROP COLUMN
, так что лучшим вариантом кажется игнорировать это требование стандарта.
Множество столбцов идентификации
PostgreSQL позволяет иметь в таблице более одного столбца идентификации. В стандарте же говорится, что в таблице может быть максимум один столбец идентификации. Это ограничение ослаблено в основном для большей гибкости при выполнении изменений в схеме или миграции. Заметьте, что команда INSERT
поддерживает только одно предложение переопределения значения, применяемое ко всему оператору, так что с несколькими столбцами идентификации различное поведение не поддерживается должным образом.
Генерируемые столбцы
Указание STORED
отсутствует в стандарте, но используется и в других реализациях баз данных SQL. Стандарт SQL не предусматривает хранение генерируемых столбцов.
Предложение LIKE
Хотя предложение LIKE
описано в стандарте SQL, многие варианты его использования, допустимые в PostgreSQL, в стандарте не описаны, а некоторые предусмотренные в стандарте возможности не реализованы в PostgreSQL.
Предложение WITH
Предложение WITH
является расширением PostgreSQL; в стандарте параметры хранения не оговариваются.
Табличные пространства
Концепция табличных пространств в PostgreSQL отсутствует в стандарте. Как следствие, предложения TABLESPACE
и USING INDEX TABLESPACE
являются расширениями.
Типизированные таблицы
Типизированные таблицы реализуют подмножество стандарта SQL. Согласно стандарту, типизированная таблица содержит столбцы, соответствующие нижележащему составному типу, и ещё один столбец, ссылающийся на себя. PostgreSQL не поддерживает ссылающиеся на себя столбцы явно.
Предложение PARTITION BY
Предложение PARTITION BY
является расширением PostgreSQL.
Предложение PARTITION OF
Предложение PARTITION OF
является расширением PostgreSQL.