PostgreSQL : Документация: 15: 53.58. pg_trigger : Компания Postgres Professional

RU
EN
RU EN

53.58. `pg_trigger`
Пред.	Наверх	Глава 53. Системные каталоги	Начало	След.

53.58. `pg_trigger`

В каталоге pg_trigger хранятся триггеры для таблиц и представлений. За дополнительными сведениями обратитесь к описанию CREATE TRIGGER.

Таблица 53.58. Столбцы pg_trigger

Тип столбца Описание
`oid` `oid` Идентификатор строки
`tgrelid` `oid` (ссылается на `pg_class`.`oid`) Таблица, к которой относится этот триггер
`tgparentid` `oid` (ссылается на `pg_trigger`.`oid`) Родительский триггер, из которого был скопирован данный (это поле заполняется, когда секция создаётся или присоединяется к секционированной таблице); ноль, если данный триггер — не копия
`tgname` `name` Имя триггера (должно быть уникальным среди триггеров одной таблицы)
`tgfoid` `oid` (ссылается на `pg_proc`.`oid`) Вызываемая функция
`tgtype` `int2` Битовая маска, задающая условия срабатывания триггера
`tgenabled` `char` Устанавливает, в каких режимах session_replication_role срабатывает триггер: `O` = триггер срабатывает в режимах «origin» (источник) и «local» (локально), `D` = триггер отключён, `R` = триггер срабатывает в режиме «replica» (реплика), `A` = триггер срабатывает всегда.
`tgisinternal` `bool` True, если триггер создан внутри системы (обычно, для реализации ограничения, заданного в `tgconstraint`)
`tgconstrrelid` `oid` (ссылается на `pg_class`.`oid`) Таблица, задействованная в ограничении ссылочной целостности (ноль, если триггер предназначен не для реализации ограничения ссылочной целостности)
`tgconstrindid` `oid` (ссылается на `pg_class`.`oid`) Индекс, поддерживающий ограничение уникальности, первичного ключа или ссылочной целостности, либо ограничение-исключение (ноль, если триггер предназначен не для реализации таких ограничений)
`tgconstraint` `oid` (ссылается на `pg_constraint`.`oid`) Запись в `pg_constraint`, связанная с этим триггером (ноль, если триггер предназначен не для реализации ограничения)
`tgdeferrable` `bool` True, если триггер ограничения является откладываемым
`tginitdeferred` `bool` True, если триггер ограничения изначально отложенный
`tgnargs` `int2` Число аргументов, передаваемых функции триггера
`tgattr` `int2vector` (ссылается на `pg_attribute`.`attnum`) Номера столбцов, если триггер привязан к столбцам; в противном случае пустой массив
`tgargs` `bytea` Аргументы строкового типа, передаваемые триггеру, с NULL в конце каждого
`tgqual` `pg_node_tree` Дерево выражения (в представлении `nodeToString()`) для условия триггера `WHEN`, либо NULL, если оно отсутствует
`tgoldtable` `name` Предложение `REFERENCING` для `OLD TABLE` или NULL в случае его отсутствия
`tgnewtable` `name` Предложение `REFERENCING` для `NEW TABLE` или NULL в случае его отсутствия

Тип столбца

Описание

oid oid

Идентификатор строки

tgrelid oid (ссылается на pg_class.oid)

Таблица, к которой относится этот триггер

tgparentid oid (ссылается на pg_trigger.oid)

Родительский триггер, из которого был скопирован данный (это поле заполняется, когда секция создаётся или присоединяется к секционированной таблице); ноль, если данный триггер — не копия

tgname name

Имя триггера (должно быть уникальным среди триггеров одной таблицы)

tgfoid oid (ссылается на pg_proc.oid)

Вызываемая функция

tgtype int2

Битовая маска, задающая условия срабатывания триггера

tgenabled char

Устанавливает, в каких режимах session_replication_role срабатывает триггер: O = триггер срабатывает в режимах «origin» (источник) и «local» (локально), D = триггер отключён, R = триггер срабатывает в режиме «replica» (реплика), A = триггер срабатывает всегда.

tgisinternal bool

True, если триггер создан внутри системы (обычно, для реализации ограничения, заданного в tgconstraint)

tgconstrrelid oid (ссылается на pg_class.oid)

Таблица, задействованная в ограничении ссылочной целостности (ноль, если триггер предназначен не для реализации ограничения ссылочной целостности)

tgconstrindid oid (ссылается на pg_class.oid)

Индекс, поддерживающий ограничение уникальности, первичного ключа или ссылочной целостности, либо ограничение-исключение (ноль, если триггер предназначен не для реализации таких ограничений)

tgconstraint oid (ссылается на pg_constraint.oid)

Запись в pg_constraint, связанная с этим триггером (ноль, если триггер предназначен не для реализации ограничения)

tgdeferrable bool

True, если триггер ограничения является откладываемым

tginitdeferred bool

True, если триггер ограничения изначально отложенный

tgnargs int2

Число аргументов, передаваемых функции триггера

tgattr int2vector (ссылается на pg_attribute.attnum)

Номера столбцов, если триггер привязан к столбцам; в противном случае пустой массив

tgargs bytea

Аргументы строкового типа, передаваемые триггеру, с NULL в конце каждого

tgqual pg_node_tree

Дерево выражения (в представлении nodeToString()) для условия триггера WHEN, либо NULL, если оно отсутствует

tgoldtable name

Предложение REFERENCING для OLD TABLE или NULL в случае его отсутствия

tgnewtable name

Предложение REFERENCING для NEW TABLE или NULL в случае его отсутствия

В настоящее время триггеры, привязанные к столбцам, поддерживаются только для событий UPDATE, так что tgattr применимо только к событиям такого типа. Поле tgtype может содержать биты и для других типов событий, но они распространяются только на таблицы, вне зависимости от значения tgattr.

Примечание

Когда tgconstraint содержит не ноль, то есть ссылается на запись в pg_constraint, поля tgconstrrelid, tgconstrindid, tgdeferrable и tginitdeferred по большому счёту избыточны, они повторяют значения в этой записи. Однако возможно связать неоткладываемый триггер с откладываемым ограничением: с ограничениями внешнего ключа могут быть связаны и откладываемые, и неоткладываемые триггеры.

Примечание

Если для отношения есть какие-либо триггеры в этом каталоге, значением pg_class.relhastriggers для неё должно быть true.

Пред.	Наверх	След.
53.57. `pg_transform`	Начало	53.59. `pg_ts_config`

53.58. `pg_trigger`
Prev	Up	Chapter 53. System Catalogs	Home	Next

53.58. `pg_trigger`

The catalog pg_trigger stores triggers on tables and views. See CREATE TRIGGER for more information.

Table 53.58. pg_trigger Columns

Column Type Description
`oid` `oid` Row identifier
`tgrelid` `oid` (references `pg_class`.`oid`) The table this trigger is on
`tgparentid` `oid` (references `pg_trigger`.`oid`) Parent trigger that this trigger is cloned from (this happens when partitions are created or attached to a partitioned table); zero if not a clone
`tgname` `name` Trigger name (must be unique among triggers of same table)
`tgfoid` `oid` (references `pg_proc`.`oid`) The function to be called
`tgtype` `int2` Bit mask identifying trigger firing conditions
`tgenabled` `char` Controls in which session_replication_role modes the trigger fires. `O` = trigger fires in “origin” and “local” modes, `D` = trigger is disabled, `R` = trigger fires in “replica” mode, `A` = trigger fires always.
`tgisinternal` `bool` True if trigger is internally generated (usually, to enforce the constraint identified by `tgconstraint`)
`tgconstrrelid` `oid` (references `pg_class`.`oid`) The table referenced by a referential integrity constraint (zero if trigger is not for a referential integrity constraint)
`tgconstrindid` `oid` (references `pg_class`.`oid`) The index supporting a unique, primary key, referential integrity, or exclusion constraint (zero if trigger is not for one of these types of constraint)
`tgconstraint` `oid` (references `pg_constraint`.`oid`) The `pg_constraint` entry associated with the trigger (zero if trigger is not for a constraint)
`tgdeferrable` `bool` True if constraint trigger is deferrable
`tginitdeferred` `bool` True if constraint trigger is initially deferred
`tgnargs` `int2` Number of argument strings passed to trigger function
`tgattr` `int2vector` (references `pg_attribute`.`attnum`) Column numbers, if trigger is column-specific; otherwise an empty array
`tgargs` `bytea` Argument strings to pass to trigger, each NULL-terminated
`tgqual` `pg_node_tree` Expression tree (in `nodeToString()` representation) for the trigger's `WHEN` condition, or null if none
`tgoldtable` `name` `REFERENCING` clause name for `OLD TABLE`, or null if none
`tgnewtable` `name` `REFERENCING` clause name for `NEW TABLE`, or null if none

Column Type

Description

oid oid

Row identifier

tgrelid oid (references pg_class.oid)

The table this trigger is on

tgparentid oid (references pg_trigger.oid)

Parent trigger that this trigger is cloned from (this happens when partitions are created or attached to a partitioned table); zero if not a clone

tgname name

Trigger name (must be unique among triggers of same table)

tgfoid oid (references pg_proc.oid)

The function to be called

tgtype int2

Bit mask identifying trigger firing conditions

tgenabled char

Controls in which session_replication_role modes the trigger fires. O = trigger fires in “origin” and “local” modes, D = trigger is disabled, R = trigger fires in “replica” mode, A = trigger fires always.

tgisinternal bool

True if trigger is internally generated (usually, to enforce the constraint identified by tgconstraint)

tgconstrrelid oid (references pg_class.oid)

The table referenced by a referential integrity constraint (zero if trigger is not for a referential integrity constraint)

tgconstrindid oid (references pg_class.oid)

The index supporting a unique, primary key, referential integrity, or exclusion constraint (zero if trigger is not for one of these types of constraint)

tgconstraint oid (references pg_constraint.oid)

The pg_constraint entry associated with the trigger (zero if trigger is not for a constraint)

tgdeferrable bool

True if constraint trigger is deferrable

tginitdeferred bool

True if constraint trigger is initially deferred

tgnargs int2

Number of argument strings passed to trigger function

tgattr int2vector (references pg_attribute.attnum)

Column numbers, if trigger is column-specific; otherwise an empty array

tgargs bytea

Argument strings to pass to trigger, each NULL-terminated

tgqual pg_node_tree

Expression tree (in nodeToString() representation) for the trigger's WHEN condition, or null if none

tgoldtable name

REFERENCING clause name for OLD TABLE, or null if none

tgnewtable name

REFERENCING clause name for NEW TABLE, or null if none

Currently, column-specific triggering is supported only for UPDATE events, and so tgattr is relevant only for that event type. tgtype might contain bits for other event types as well, but those are presumed to be table-wide regardless of what is in tgattr.

Note

When tgconstraint is nonzero, tgconstrrelid, tgconstrindid, tgdeferrable, and tginitdeferred are largely redundant with the referenced pg_constraint entry. However, it is possible for a non-deferrable trigger to be associated with a deferrable constraint: foreign key constraints can have some deferrable and some non-deferrable triggers.

Note

pg_class.relhastriggers must be true if a relation has any triggers in this catalog.

Prev	Up	Next
53.57. `pg_transform`	Home	53.59. `pg_ts_config`

Вход в личный кабинет

Восстановление пароля

Подтверждение аккаунта

Изменение пароля

53.58. pg_trigger

Примечание

Примечание

53.58. pg_trigger

Note

Note

53.58. `pg_trigger`

53.58. `pg_trigger`