mirror of https://github.com/postgres/postgres
They don't actually do anything yet; that will get fixed in a follow-on commit. But this gets the basic infrastructure in place, including CREATE/ALTER/DROP EVENT TRIGGER; support for COMMENT, SECURITY LABEL, and ALTER EXTENSION .. ADD/DROP EVENT TRIGGER; pg_dump and psql support; and documentation for the anticipated initial feature set. Dimitri Fontaine, with review and a bunch of additional hacking by me. Thom Brown extensively reviewed earlier versions of this patch set, but there's not a whole lot of that code left in this commit, as it turns out.pull/3/head
Robert Haas
13 years ago
parent
faf26bf117
commit
3855968f32
@ -0,0 +1,415 @@ |
|||||||
|
<!-- doc/src/sgml/event-trigger.sgml --> |
||||||
|
|
||||||
|
<chapter id="event-triggers"> |
||||||
|
<title>Event Triggers</title> |
||||||
|
|
||||||
|
<indexterm zone="event-triggers"> |
||||||
|
<primary>event trigger</primary> |
||||||
|
</indexterm> |
||||||
|
|
||||||
|
<para> |
||||||
|
To supplement the trigger mechanism discussed in <xref linkend="triggers">, |
||||||
|
<productname>PostgreSQL</> also provides event triggers. Unlike regular |
||||||
|
triggers, which are attached to a single table and capture only DML events, |
||||||
|
event triggers are global to a particular database and are capable of |
||||||
|
capturing DDL events. |
||||||
|
</para> |
||||||
|
|
||||||
|
<para> |
||||||
|
Like regular triggers, event triggers can be written in any procedural |
||||||
|
language that includes event trigger support, or in C, but not in plain |
||||||
|
SQL. |
||||||
|
</para> |
||||||
|
|
||||||
|
<sect1 id="event-trigger-definition"> |
||||||
|
<title>Overview of Event Trigger Behavior</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
An event trigger fires whenever the event with which it is associated |
||||||
|
occurs in the database in which it is defined. Currently, the only |
||||||
|
supported event is <literal>ddl_command_start</>. Support for |
||||||
|
additional events may be added in future releases. |
||||||
|
</para> |
||||||
|
|
||||||
|
<para> |
||||||
|
The <literal>ddl_command_start</> event occurs just before the |
||||||
|
execution of a <literal>CREATE</>, <literal>ALTER</>, or <literal>DROP</> |
||||||
|
commmand. As an exception, however, this event does not occur for |
||||||
|
DDL commands targeting shared objects - databases, roles, and tablespaces |
||||||
|
- or for command targeting event triggers themselves. The event trigger |
||||||
|
mechanism does not support these object types. |
||||||
|
<literal>ddl_command_start</> also occurs just before the execution of a |
||||||
|
<literal>SELECT INTO</literal> command, since this is equivalent to |
||||||
|
<literal>CREATE TABLE AS</literal>. |
||||||
|
</para> |
||||||
|
|
||||||
|
<para> |
||||||
|
For a complete list of commands supported by the event trigger mechanism, |
||||||
|
see <xref linkend="event-trigger-matrix">. |
||||||
|
</para> |
||||||
|
|
||||||
|
<para> |
||||||
|
In order to create an event trigger, you must first create a function with |
||||||
|
the special return type <literal>event_trigger</literal>. This function |
||||||
|
need not (and may not) return a value; the return type serves merely as |
||||||
|
a signal that the function is to be invoked as an event trigger. |
||||||
|
</para> |
||||||
|
|
||||||
|
<para> |
||||||
|
If more than one event trigger is defined for a particular event, they will |
||||||
|
fire in alphabetical order by trigger name. |
||||||
|
</para> |
||||||
|
|
||||||
|
<para> |
||||||
|
A trigger definition can also specify a <literal>WHEN</literal> |
||||||
|
condition so that, for example, a <literal>ddl_command_start</literal> |
||||||
|
trigger can be fired only for particular commands which the user wishes |
||||||
|
to intercept. A common use of such triggers is to restrict the range of |
||||||
|
DDL operations which users may perform. |
||||||
|
</para> |
||||||
|
</sect1> |
||||||
|
|
||||||
|
<sect1 id="event-trigger-matrix"> |
||||||
|
<title>Event Trigger Firing Matrix</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
<xref linkend="event-trigger-by-command-tag"> lists all commands |
||||||
|
for which event triggers are supported. |
||||||
|
</para> |
||||||
|
|
||||||
|
<table id="event-trigger-by-command-tag"> |
||||||
|
<title>Event Trigger Support by Command Tag</title> |
||||||
|
<tgroup cols="2"> |
||||||
|
<thead> |
||||||
|
<row> |
||||||
|
<entry>command tag</entry> |
||||||
|
<entry><literal>ddl_command_start</literal></entry> |
||||||
|
</row> |
||||||
|
</thead> |
||||||
|
<tbody> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER AGGREGATE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER COLLATION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER CONVERSION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER DOMAIN</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER EXTENSION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER FOREIGN DATA WRAPPER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER FOREIGN TABLE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER FUNCTION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER LANGUAGE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER OPERATOR</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER OPERATOR CLASS</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER OPERATOR FAMILY</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER SCHEMA</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER SEQUENCE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER SERVER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER TABLE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER TEXT SEARCH CONFIGURATION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER TEXT SEARCH DICTIONARY</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER TEXT SEARCH PARSER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER TEXT SEARCH TEMPLATE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER TRIGGER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER TYPE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER USER MAPPING</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>ALTER VIEW</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE AGGREGATE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE CAST</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE COLLATION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE CONVERSION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE DOMAIN</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE EXTENSION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE FOREIGN DATA WRAPPER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE FOREIGN TABLE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE FUNCTION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE INDEX</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE LANGUAGE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE OPERATOR</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE OPERATOR CLASS</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE OPERATOR FAMILY</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE RULE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE SCHEMA</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE SEQUENCE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE SERVER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TABLE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TABLE AS</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TEXT SEARCH CONFIGURATION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TEXT SEARCH DICTIONARY</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TEXT SEARCH PARSER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TEXT SEARCH TEMPLATE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TRIGGER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE TYPE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE USER MAPPING</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>CREATE VIEW</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP AGGREGATE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP CAST</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP COLLATION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP CONVERSION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP DOMAIN</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP EXTENSION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP FOREIGN DATA WRAPPER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP FOREIGN TABLE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP FUNCTION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP INDEX</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP LANGUAGE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP OPERATOR</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP OPERATOR CLASS</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP OPERATOR FAMILY</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP RULE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP SCHEMA</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP SEQUENCE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP SERVER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP TABLE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP TEXT SEARCH CONFIGURATION</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP TEXT SEARCH DICTIONARY</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP TEXT SEARCH PARSER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP TEXT SEARCH TEMPLATE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP TRIGGER</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP TYPE</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP USER MAPPING</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>DROP VIEW</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
<row> |
||||||
|
<entry align="left"><literal>SELECT INTO</literal></entry> |
||||||
|
<entry align="center"><literal>X</literal></entry> |
||||||
|
</row> |
||||||
|
</tbody> |
||||||
|
</tgroup> |
||||||
|
</table> |
||||||
|
</sect1> |
||||||
|
|
||||||
|
</chapter> |
||||||
@ -0,0 +1,105 @@ |
|||||||
|
<!-- |
||||||
|
doc/src/sgml/ref/alter_event_trigger.sgml |
||||||
|
PostgreSQL documentation |
||||||
|
--> |
||||||
|
|
||||||
|
<refentry id="SQL-ALTEREVENTTRIGGER"> |
||||||
|
<refmeta> |
||||||
|
<refentrytitle>ALTER EVENT TRIGGER</refentrytitle> |
||||||
|
<manvolnum>7</manvolnum> |
||||||
|
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||||
|
</refmeta> |
||||||
|
|
||||||
|
<refnamediv> |
||||||
|
<refname>ALTER EVENT TRIGGER</refname> |
||||||
|
<refpurpose>change the definition of an event trigger</refpurpose> |
||||||
|
</refnamediv> |
||||||
|
|
||||||
|
<indexterm zone="sql-altereventtrigger"> |
||||||
|
<primary>ALTER EVENT TRIGGER</primary> |
||||||
|
</indexterm> |
||||||
|
|
||||||
|
<refsynopsisdiv> |
||||||
|
<synopsis> |
||||||
|
ALTER EVENT TRIGGER <replaceable class="PARAMETER">name</replaceable> DISABLE |
||||||
|
ALTER EVENT TRIGGER <replaceable class="PARAMETER">name</replaceable> ENABLE [ REPLICA | ALWAYS ] |
||||||
|
ALTER EVENT TRIGGER <replaceable class="PARAMETER">name</replaceable> OWNER TO <replaceable class="PARAMETER">new_owner</replaceable> |
||||||
|
ALTER EVENT TRIGGER <replaceable class="PARAMETER">name</replaceable> RENAME TO <replaceable class="PARAMETER">new_name</replaceable> |
||||||
|
</synopsis> |
||||||
|
</refsynopsisdiv> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>Description</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
<command>ALTER EVENT TRIGGER</command> changes properties of an |
||||||
|
existing event trigger. |
||||||
|
</para> |
||||||
|
|
||||||
|
<para> |
||||||
|
You must be superuser to alter an event trigger. |
||||||
|
</para> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>Parameters</title> |
||||||
|
|
||||||
|
<variablelist> |
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="PARAMETER">name</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
The name of an existing trigger to alter. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="PARAMETER">new_owner</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
The user name of the new owner of the event trigger. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="PARAMETER">new_name</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
The new name of the event trigger. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><literal>DISABLE</literal>/<literal>ENABLE [ REPLICA | ALWAYS ] TRIGGER</literal></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
These forms configure the firing of event triggers. A disabled trigger |
||||||
|
is still known to the system, but is not executed when its triggering |
||||||
|
event occurs. See also <xref linkend="guc-session-replication-role">. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
</variablelist> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1 id="sql-alterventtrigger-compatibility"> |
||||||
|
<title>Compatibility</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
There is no <command>ALTER EVENT TRIGGER</command> statement in the |
||||||
|
SQL standard. |
||||||
|
</para> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>See Also</title> |
||||||
|
|
||||||
|
<simplelist type="inline"> |
||||||
|
<member><xref linkend="sql-createeventtrigger"></member> |
||||||
|
<member><xref linkend="sql-dropeventtrigger"></member> |
||||||
|
</simplelist> |
||||||
|
</refsect1> |
||||||
|
</refentry> |
||||||
@ -0,0 +1,162 @@ |
|||||||
|
<!-- |
||||||
|
doc/src/sgml/ref/create_event_trigger.sgml |
||||||
|
PostgreSQL documentation |
||||||
|
--> |
||||||
|
|
||||||
|
<refentry id="SQL-CREATEEVENTTRIGGER"> |
||||||
|
<refmeta> |
||||||
|
<refentrytitle>CREATE EVENT TRIGGER</refentrytitle> |
||||||
|
<manvolnum>7</manvolnum> |
||||||
|
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||||
|
</refmeta> |
||||||
|
|
||||||
|
<refnamediv> |
||||||
|
<refname>CREATE EVENT TRIGGER</refname> |
||||||
|
<refpurpose>define a new event trigger</refpurpose> |
||||||
|
</refnamediv> |
||||||
|
|
||||||
|
<indexterm zone="sql-createeventtrigger"> |
||||||
|
<primary>CREATE EVENT TRIGGER</primary> |
||||||
|
</indexterm> |
||||||
|
|
||||||
|
<refsynopsisdiv> |
||||||
|
<synopsis> |
||||||
|
CREATE EVENT TRIGGER <replaceable class="PARAMETER">name</replaceable> |
||||||
|
ON <replaceable class="PARAMETER">event</replaceable> |
||||||
|
[ WHEN <replaceable class="PARAMETER">filter_variable</replaceable> IN (filter_value [ AND ... ] ) ] |
||||||
|
EXECUTE PROCEDURE <replaceable class="PARAMETER">function_name</replaceable>() |
||||||
|
</synopsis> |
||||||
|
</refsynopsisdiv> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>Description</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
<command>CREATE EVENT TRIGGER</command> creates a new event trigger. |
||||||
|
Whenever the designated event occurs and the <literal>WHEN</> condition |
||||||
|
associated with the trigger, if any, is satisfied, the trigger function |
||||||
|
will be executed. For a general introduction to event triggers, see |
||||||
|
<xref linkend="event-triggers">. The user who creates an event trigger |
||||||
|
becomes its owner. |
||||||
|
</para> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>Parameters</title> |
||||||
|
|
||||||
|
<variablelist> |
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="parameter">name</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
The name to give the new trigger. This name must be unique within |
||||||
|
the database. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="parameter">event</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
The name of the event that triggers a call to the given function. |
||||||
|
See <xref linkend="event-trigger-definition"> for more information |
||||||
|
on event names. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="parameter">filter_variable</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
The name of a variable used to filter events. This makes it possible |
||||||
|
to restrict the firing of the trigger to a subset of the cases in which |
||||||
|
it is supported. Currently the only supported |
||||||
|
<replaceable class="parameter">filter_variable</replaceable> |
||||||
|
is <literal>TAG</literal>. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="parameter">filter_value</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
A list of values for the |
||||||
|
associated <replaceable class="parameter">filter_variable</replaceable> |
||||||
|
for which the trigger should fire. For <literal>TAG</>, this means a |
||||||
|
list of command tags (e.g. <literal>'DROP FUNCTION'</>). |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="parameter">function_name</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
A user-supplied function that is declared as taking no argument and |
||||||
|
returning type <literal>event_trigger</literal>. |
||||||
|
</para> |
||||||
|
<para> |
||||||
|
If your event trigger is implemented in <literal>C</literal> then it |
||||||
|
will be called with an argument, of |
||||||
|
type <literal>internal</literal>, which is a pointer to |
||||||
|
the <literal>Node *</literal> parse tree. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
</variablelist> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1 id="sql-createeventtrigger-notes"> |
||||||
|
<title>Notes</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
To create a trigger on a event, the user must be superuser. |
||||||
|
</para> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1 id="sql-createeventtrigger-examples"> |
||||||
|
<title>Examples</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
Forbid the execution of any <link linkend="ddl">ddl</link> command: |
||||||
|
|
||||||
|
<programlisting> |
||||||
|
CREATE OR REPLACE FUNCTION abort_any_command() |
||||||
|
RETURNS event_trigger |
||||||
|
LANGUAGE plpgsql |
||||||
|
AS $$ |
||||||
|
BEGIN |
||||||
|
RAISE EXCEPTION 'command % is disabled', tg_tag; |
||||||
|
END; |
||||||
|
$$; |
||||||
|
|
||||||
|
CREATE EVENT TRIGGER abort_ddl ON ddl_command_start |
||||||
|
EXECUTE PROCEDURE abort_any_command(); |
||||||
|
</programlisting> |
||||||
|
</para> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1 id="sql-createeventtrigger-compatibility"> |
||||||
|
<title>Compatibility</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
There is no <command>CREATE EVENT TRIGGER</command> statement in the |
||||||
|
SQL standard. |
||||||
|
</para> |
||||||
|
|
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>See Also</title> |
||||||
|
|
||||||
|
<simplelist type="inline"> |
||||||
|
<member><xref linkend="sql-createfunction"></member> |
||||||
|
<member><xref linkend="sql-altereventtrigger"></member> |
||||||
|
<member><xref linkend="sql-dropeventtrigger"></member> |
||||||
|
</simplelist> |
||||||
|
</refsect1> |
||||||
|
</refentry> |
||||||
@ -0,0 +1,113 @@ |
|||||||
|
<!-- |
||||||
|
doc/src/sgml/ref/drop_event_trigger.sgml |
||||||
|
PostgreSQL documentation |
||||||
|
--> |
||||||
|
|
||||||
|
<refentry id="SQL-DROPEVENTTRIGGER"> |
||||||
|
<refmeta> |
||||||
|
<refentrytitle>DROP EVENT TRIGGER</refentrytitle> |
||||||
|
<manvolnum>7</manvolnum> |
||||||
|
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||||
|
</refmeta> |
||||||
|
|
||||||
|
<refnamediv> |
||||||
|
<refname>DROP EVENT TRIGGER</refname> |
||||||
|
<refpurpose>remove an event trigger</refpurpose> |
||||||
|
</refnamediv> |
||||||
|
|
||||||
|
<indexterm zone="sql-dropeventtrigger"> |
||||||
|
<primary>DROP EVENT TRIGGER</primary> |
||||||
|
</indexterm> |
||||||
|
|
||||||
|
<refsynopsisdiv> |
||||||
|
<synopsis> |
||||||
|
DROP EVENT TRIGGER [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable> [ CASCADE | RESTRICT ] |
||||||
|
</synopsis> |
||||||
|
</refsynopsisdiv> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>Description</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
<command>DROP EVENT TRIGGER</command> removes an existing event trigger. |
||||||
|
To execute this command, the current user must be the owner of the event |
||||||
|
trigger. |
||||||
|
</para> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>Parameters</title> |
||||||
|
|
||||||
|
<variablelist> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><literal>IF EXISTS</literal></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
Do not throw an error if the event trigger does not exist. A notice |
||||||
|
is issued in this case. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><replaceable class="PARAMETER">name</replaceable></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
The name of the event trigger to remove. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><literal>CASCADE</literal></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
Automatically drop objects that depend on the trigger. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
|
||||||
|
<varlistentry> |
||||||
|
<term><literal>RESTRICT</literal></term> |
||||||
|
<listitem> |
||||||
|
<para> |
||||||
|
Refuse to drop the trigger if any objects depend on it. This is |
||||||
|
the default. |
||||||
|
</para> |
||||||
|
</listitem> |
||||||
|
</varlistentry> |
||||||
|
</variablelist> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1 id="sql-dropeventtrigger-examples"> |
||||||
|
<title>Examples</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
Destroy the trigger <literal>snitch</literal>: |
||||||
|
|
||||||
|
<programlisting> |
||||||
|
DROP EVENT TRIGGER snitch; |
||||||
|
</programlisting></para> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1 id="sql-dropeventtrigger-compatibility"> |
||||||
|
<title>Compatibility</title> |
||||||
|
|
||||||
|
<para> |
||||||
|
There is no <command>DROP EVENT TRIGGER</command> statement in the |
||||||
|
SQL standard. |
||||||
|
</para> |
||||||
|
|
||||||
|
</refsect1> |
||||||
|
|
||||||
|
<refsect1> |
||||||
|
<title>See Also</title> |
||||||
|
|
||||||
|
<simplelist type="inline"> |
||||||
|
<member><xref linkend="sql-createeventtrigger"></member> |
||||||
|
<member><xref linkend="sql-altereventtrigger"></member> |
||||||
|
</simplelist> |
||||||
|
</refsect1> |
||||||
|
|
||||||
|
</refentry> |
||||||
@ -0,0 +1,539 @@ |
|||||||
|
/*-------------------------------------------------------------------------
|
||||||
|
* |
||||||
|
* event_trigger.c |
||||||
|
* PostgreSQL EVENT TRIGGER support code. |
||||||
|
* |
||||||
|
* Portions Copyright (c) 1996-2012, PostgreSQL Global Development Group |
||||||
|
* Portions Copyright (c) 1994, Regents of the University of California |
||||||
|
* |
||||||
|
* IDENTIFICATION |
||||||
|
* src/backend/commands/event_trigger.c |
||||||
|
* |
||||||
|
*------------------------------------------------------------------------- |
||||||
|
*/ |
||||||
|
#include "postgres.h" |
||||||
|
|
||||||
|
#include "catalog/dependency.h" |
||||||
|
#include "catalog/indexing.h" |
||||||
|
#include "catalog/objectaccess.h" |
||||||
|
#include "catalog/pg_event_trigger.h" |
||||||
|
#include "catalog/pg_proc.h" |
||||||
|
#include "catalog/pg_trigger.h" |
||||||
|
#include "catalog/pg_type.h" |
||||||
|
#include "commands/dbcommands.h" |
||||||
|
#include "commands/event_trigger.h" |
||||||
|
#include "commands/trigger.h" |
||||||
|
#include "parser/parse_func.h" |
||||||
|
#include "pgstat.h" |
||||||
|
#include "miscadmin.h" |
||||||
|
#include "utils/acl.h" |
||||||
|
#include "utils/builtins.h" |
||||||
|
#include "utils/fmgroids.h" |
||||||
|
#include "utils/lsyscache.h" |
||||||
|
#include "utils/memutils.h" |
||||||
|
#include "utils/rel.h" |
||||||
|
#include "utils/tqual.h" |
||||||
|
#include "utils/syscache.h" |
||||||
|
#include "tcop/utility.h" |
||||||
|
|
||||||
|
typedef struct |
||||||
|
{ |
||||||
|
const char *obtypename; |
||||||
|
ObjectType obtype; |
||||||
|
bool supported; |
||||||
|
} event_trigger_support_data; |
||||||
|
|
||||||
|
static event_trigger_support_data event_trigger_support[] = { |
||||||
|
{ "AGGREGATE", OBJECT_AGGREGATE, true }, |
||||||
|
{ "CAST", OBJECT_CAST, true }, |
||||||
|
{ "CONSTRAINT", OBJECT_CONSTRAINT, true }, |
||||||
|
{ "COLLATION", OBJECT_COLLATION, true }, |
||||||
|
{ "CONVERSION", OBJECT_CONVERSION, true }, |
||||||
|
{ "DATABASE", OBJECT_DATABASE, false }, |
||||||
|
{ "DOMAIN", OBJECT_DOMAIN, true }, |
||||||
|
{ "EXTENSION", OBJECT_EXTENSION, true }, |
||||||
|
{ "EVENT TRIGGER", OBJECT_EVENT_TRIGGER, false }, |
||||||
|
{ "FOREIGN DATA WRAPPER", OBJECT_FDW, true }, |
||||||
|
{ "FOREIGN SERVER", OBJECT_FOREIGN_SERVER, true }, |
||||||
|
{ "FOREIGN TABLE", OBJECT_FOREIGN_TABLE, true }, |
||||||
|
{ "FUNCTION", OBJECT_FUNCTION, true }, |
||||||
|
{ "INDEX", OBJECT_INDEX, true }, |
||||||
|
{ "LANGUAGE", OBJECT_LANGUAGE, true }, |
||||||
|
{ "OPERATOR", OBJECT_OPERATOR, true }, |
||||||
|
{ "OPERATOR CLASS", OBJECT_OPCLASS, true }, |
||||||
|
{ "OPERATOR FAMILY", OBJECT_OPFAMILY, true }, |
||||||
|
{ "ROLE", OBJECT_ROLE, false }, |
||||||
|
{ "RULE", OBJECT_RULE, true }, |
||||||
|
{ "SCHEMA", OBJECT_SCHEMA, true }, |
||||||
|
{ "SEQUENCE", OBJECT_SEQUENCE, true }, |
||||||
|
{ "TABLE", OBJECT_TABLE, true }, |
||||||
|
{ "TABLESPACE", OBJECT_TABLESPACE, false}, |
||||||
|
{ "TRIGGER", OBJECT_TRIGGER, true }, |
||||||
|
{ "TEXT SEARCH CONFIGURATION", OBJECT_TSCONFIGURATION, true }, |
||||||
|
{ "TEXT SEARCH DICTIONARY", OBJECT_TSDICTIONARY, true }, |
||||||
|
{ "TEXT SEARCH PARSER", OBJECT_TSPARSER, true }, |
||||||
|
{ "TEXT SEARCH TEMPLATE", OBJECT_TSTEMPLATE, true }, |
||||||
|
{ "TYPE", OBJECT_TYPE, true }, |
||||||
|
{ "VIEW", OBJECT_VIEW, true }, |
||||||
|
{ NULL, (ObjectType) 0, false } |
||||||
|
}; |
||||||
|
|
||||||
|
static void AlterEventTriggerOwner_internal(Relation rel, |
||||||
|
HeapTuple tup, |
||||||
|
Oid newOwnerId); |
||||||
|
static void error_duplicate_filter_variable(const char *defname); |
||||||
|
static void error_unrecognized_filter_value(const char *var, const char *val); |
||||||
|
static Datum filter_list_to_array(List *filterlist); |
||||||
|
static void insert_event_trigger_tuple(char *trigname, char *eventname, |
||||||
|
Oid evtOwner, Oid funcoid, List *tags); |
||||||
|
static void validate_ddl_tags(const char *filtervar, List *taglist); |
||||||
|
|
||||||
|
/*
|
||||||
|
* Create an event trigger. |
||||||
|
*/ |
||||||
|
void |
||||||
|
CreateEventTrigger(CreateEventTrigStmt *stmt) |
||||||
|
{ |
||||||
|
HeapTuple tuple; |
||||||
|
Oid funcoid; |
||||||
|
Oid funcrettype; |
||||||
|
Oid evtowner = GetUserId(); |
||||||
|
ListCell *lc; |
||||||
|
List *tags = NULL; |
||||||
|
|
||||||
|
/*
|
||||||
|
* It would be nice to allow database owners or even regular users to do |
||||||
|
* this, but there are obvious privilege escalation risks which would have |
||||||
|
* to somehow be plugged first. |
||||||
|
*/ |
||||||
|
if (!superuser()) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE), |
||||||
|
errmsg("permission denied to create event trigger \"%s\"", |
||||||
|
stmt->trigname), |
||||||
|
errhint("Must be superuser to create an event trigger."))); |
||||||
|
|
||||||
|
/* Validate event name. */ |
||||||
|
if (strcmp(stmt->eventname, "ddl_command_start") != 0) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_SYNTAX_ERROR), |
||||||
|
errmsg("unrecognized event name \"%s\"", |
||||||
|
stmt->eventname))); |
||||||
|
|
||||||
|
/* Validate filter conditions. */ |
||||||
|
foreach (lc, stmt->whenclause) |
||||||
|
{ |
||||||
|
DefElem *def = (DefElem *) lfirst(lc); |
||||||
|
|
||||||
|
if (strcmp(def->defname, "tag") == 0) |
||||||
|
{ |
||||||
|
if (tags != NULL) |
||||||
|
error_duplicate_filter_variable(def->defname); |
||||||
|
tags = (List *) def->arg; |
||||||
|
} |
||||||
|
else |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_SYNTAX_ERROR), |
||||||
|
errmsg("unrecognized filter variable \"%s\"", def->defname))); |
||||||
|
} |
||||||
|
|
||||||
|
/* Validate tag list, if any. */ |
||||||
|
if (strcmp(stmt->eventname, "ddl_command_start") == 0 && tags != NULL) |
||||||
|
validate_ddl_tags("tag", tags); |
||||||
|
|
||||||
|
/*
|
||||||
|
* Give user a nice error message if an event trigger of the same name |
||||||
|
* already exists. |
||||||
|
*/ |
||||||
|
tuple = SearchSysCache1(EVENTTRIGGERNAME, CStringGetDatum(stmt->trigname)); |
||||||
|
if (HeapTupleIsValid(tuple)) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_DUPLICATE_OBJECT), |
||||||
|
errmsg("event trigger \"%s\" already exists", |
||||||
|
stmt->trigname))); |
||||||
|
|
||||||
|
/* Find and validate the trigger function. */ |
||||||
|
funcoid = LookupFuncName(stmt->funcname, 0, NULL, false); |
||||||
|
funcrettype = get_func_rettype(funcoid); |
||||||
|
if (funcrettype != EVTTRIGGEROID) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_INVALID_OBJECT_DEFINITION), |
||||||
|
errmsg("function \"%s\" must return type \"event_trigger\"", |
||||||
|
NameListToString(stmt->funcname)))); |
||||||
|
|
||||||
|
/* Insert catalog entries. */ |
||||||
|
insert_event_trigger_tuple(stmt->trigname, stmt->eventname, |
||||||
|
evtowner, funcoid, tags); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* Validate DDL command tags. |
||||||
|
*/ |
||||||
|
static void |
||||||
|
validate_ddl_tags(const char *filtervar, List *taglist) |
||||||
|
{ |
||||||
|
ListCell *lc; |
||||||
|
|
||||||
|
foreach (lc, taglist) |
||||||
|
{ |
||||||
|
const char *tag = strVal(lfirst(lc)); |
||||||
|
const char *obtypename = NULL; |
||||||
|
event_trigger_support_data *etsd; |
||||||
|
|
||||||
|
/*
|
||||||
|
* As a special case, SELECT INTO is considered DDL, since it creates |
||||||
|
* a table. |
||||||
|
*/ |
||||||
|
if (strcmp(tag, "SELECT INTO") == 0) |
||||||
|
continue; |
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Otherwise, it should be CREATE, ALTER, or DROP. |
||||||
|
*/ |
||||||
|
if (pg_strncasecmp(tag, "CREATE ", 7) == 0) |
||||||
|
obtypename = tag + 7; |
||||||
|
else if (pg_strncasecmp(tag, "ALTER ", 6) == 0) |
||||||
|
obtypename = tag + 6; |
||||||
|
else if (pg_strncasecmp(tag, "DROP ", 5) == 0) |
||||||
|
obtypename = tag + 5; |
||||||
|
if (obtypename == NULL) |
||||||
|
error_unrecognized_filter_value(filtervar, tag); |
||||||
|
|
||||||
|
/*
|
||||||
|
* ...and the object type should be something recognizable. |
||||||
|
*/ |
||||||
|
for (etsd = event_trigger_support; etsd->obtypename != NULL; etsd++) |
||||||
|
if (pg_strcasecmp(etsd->obtypename, obtypename) == 0) |
||||||
|
break; |
||||||
|
if (etsd->obtypename == NULL) |
||||||
|
error_unrecognized_filter_value(filtervar, tag); |
||||||
|
if (!etsd->supported) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_FEATURE_NOT_SUPPORTED), |
||||||
|
/* translator: %s represents an SQL statement name */ |
||||||
|
errmsg("event triggers are not supported for \"%s\"", |
||||||
|
tag))); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* Complain about a duplicate filter variable. |
||||||
|
*/ |
||||||
|
static void |
||||||
|
error_duplicate_filter_variable(const char *defname) |
||||||
|
{ |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_SYNTAX_ERROR), |
||||||
|
errmsg("filter variable \"%s\" specified more than once", |
||||||
|
defname))); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* Complain about an invalid filter value. |
||||||
|
*/ |
||||||
|
static void |
||||||
|
error_unrecognized_filter_value(const char *var, const char *val) |
||||||
|
{ |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_SYNTAX_ERROR), |
||||||
|
errmsg("filter value \"%s\" not recognized for filter variable \"%s\"", |
||||||
|
val, var))); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* Insert the new pg_event_trigger row and record dependencies. |
||||||
|
*/ |
||||||
|
static void |
||||||
|
insert_event_trigger_tuple(char *trigname, char *eventname, Oid evtOwner, |
||||||
|
Oid funcoid, List *taglist) |
||||||
|
{ |
||||||
|
Relation tgrel; |
||||||
|
Oid trigoid; |
||||||
|
HeapTuple tuple; |
||||||
|
Datum values[Natts_pg_trigger]; |
||||||
|
bool nulls[Natts_pg_trigger]; |
||||||
|
ObjectAddress myself, referenced; |
||||||
|
|
||||||
|
/* Open pg_event_trigger. */ |
||||||
|
tgrel = heap_open(EventTriggerRelationId, RowExclusiveLock); |
||||||
|
|
||||||
|
/* Build the new pg_trigger tuple. */ |
||||||
|
memset(nulls, false, sizeof(nulls)); |
||||||
|
values[Anum_pg_event_trigger_evtname - 1] = NameGetDatum(trigname); |
||||||
|
values[Anum_pg_event_trigger_evtevent - 1] = NameGetDatum(eventname); |
||||||
|
values[Anum_pg_event_trigger_evtowner - 1] = ObjectIdGetDatum(evtOwner); |
||||||
|
values[Anum_pg_event_trigger_evtfoid - 1] = ObjectIdGetDatum(funcoid); |
||||||
|
values[Anum_pg_event_trigger_evtenabled - 1] = |
||||||
|
CharGetDatum(TRIGGER_FIRES_ON_ORIGIN); |
||||||
|
if (taglist == NIL) |
||||||
|
nulls[Anum_pg_event_trigger_evttags - 1] = true; |
||||||
|
else |
||||||
|
values[Anum_pg_event_trigger_evttags - 1] = |
||||||
|
filter_list_to_array(taglist); |
||||||
|
|
||||||
|
/* Insert heap tuple. */ |
||||||
|
tuple = heap_form_tuple(tgrel->rd_att, values, nulls); |
||||||
|
trigoid = simple_heap_insert(tgrel, tuple); |
||||||
|
CatalogUpdateIndexes(tgrel, tuple); |
||||||
|
heap_freetuple(tuple); |
||||||
|
|
||||||
|
/* Depend on owner. */ |
||||||
|
recordDependencyOnOwner(EventTriggerRelationId, trigoid, evtOwner); |
||||||
|
|
||||||
|
/* Depend on event trigger function. */ |
||||||
|
myself.classId = EventTriggerRelationId; |
||||||
|
myself.objectId = trigoid; |
||||||
|
myself.objectSubId = 0; |
||||||
|
referenced.classId = ProcedureRelationId; |
||||||
|
referenced.objectId = funcoid; |
||||||
|
referenced.objectSubId = 0; |
||||||
|
recordDependencyOn(&myself, &referenced, DEPENDENCY_NORMAL); |
||||||
|
|
||||||
|
/* Post creation hook for new operator family */ |
||||||
|
InvokeObjectAccessHook(OAT_POST_CREATE, |
||||||
|
EventTriggerRelationId, trigoid, 0, NULL); |
||||||
|
|
||||||
|
/* Close pg_event_trigger. */ |
||||||
|
heap_close(tgrel, RowExclusiveLock); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* In the parser, a clause like WHEN tag IN ('cmd1', 'cmd2') is represented |
||||||
|
* by a DefElem whose value is a List of String nodes; in the catalog, we |
||||||
|
* store the list of strings as a text array. This function transforms the |
||||||
|
* former representation into the latter one. |
||||||
|
* |
||||||
|
* For cleanliness, we store command tags in the catalog as text. It's |
||||||
|
* possible (although not currently anticipated) that we might have |
||||||
|
* a case-sensitive filter variable in the future, in which case this would |
||||||
|
* need some further adjustment. |
||||||
|
*/ |
||||||
|
static Datum |
||||||
|
filter_list_to_array(List *filterlist) |
||||||
|
{ |
||||||
|
ListCell *lc; |
||||||
|
Datum *data; |
||||||
|
int i = 0, |
||||||
|
l = list_length(filterlist); |
||||||
|
|
||||||
|
data = (Datum *) palloc(l * sizeof(Datum)); |
||||||
|
|
||||||
|
foreach(lc, filterlist) |
||||||
|
{ |
||||||
|
const char *value = strVal(lfirst(lc)); |
||||||
|
char *result, |
||||||
|
*p; |
||||||
|
|
||||||
|
result = pstrdup(value); |
||||||
|
for (p = result; *p; p++) |
||||||
|
*p = pg_ascii_toupper((unsigned char) *p); |
||||||
|
data[i++] = PointerGetDatum(cstring_to_text(result)); |
||||||
|
pfree(result); |
||||||
|
} |
||||||
|
|
||||||
|
return PointerGetDatum(construct_array(data, l, TEXTOID, -1, false, 'i')); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* Guts of event trigger deletion. |
||||||
|
*/ |
||||||
|
void |
||||||
|
RemoveEventTriggerById(Oid trigOid) |
||||||
|
{ |
||||||
|
Relation tgrel; |
||||||
|
HeapTuple tup; |
||||||
|
|
||||||
|
tgrel = heap_open(EventTriggerRelationId, RowExclusiveLock); |
||||||
|
|
||||||
|
tup = SearchSysCache1(EVENTTRIGGEROID, ObjectIdGetDatum(trigOid)); |
||||||
|
if (!HeapTupleIsValid(tup)) |
||||||
|
elog(ERROR, "cache lookup failed for event trigger %u", trigOid); |
||||||
|
|
||||||
|
simple_heap_delete(tgrel, &tup->t_self); |
||||||
|
|
||||||
|
ReleaseSysCache(tup); |
||||||
|
|
||||||
|
heap_close(tgrel, RowExclusiveLock); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* ALTER EVENT TRIGGER foo ENABLE|DISABLE|ENABLE ALWAYS|REPLICA |
||||||
|
*/ |
||||||
|
void |
||||||
|
AlterEventTrigger(AlterEventTrigStmt *stmt) |
||||||
|
{ |
||||||
|
Relation tgrel; |
||||||
|
HeapTuple tup; |
||||||
|
Form_pg_event_trigger evtForm; |
||||||
|
char tgenabled = stmt->tgenabled; |
||||||
|
|
||||||
|
tgrel = heap_open(EventTriggerRelationId, RowExclusiveLock); |
||||||
|
|
||||||
|
tup = SearchSysCacheCopy1(EVENTTRIGGERNAME, |
||||||
|
CStringGetDatum(stmt->trigname)); |
||||||
|
if (!HeapTupleIsValid(tup)) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_UNDEFINED_OBJECT), |
||||||
|
errmsg("event trigger \"%s\" does not exist", |
||||||
|
stmt->trigname))); |
||||||
|
if (!pg_event_trigger_ownercheck(HeapTupleGetOid(tup), GetUserId())) |
||||||
|
aclcheck_error(ACLCHECK_NOT_OWNER, ACL_KIND_EVENT_TRIGGER, |
||||||
|
stmt->trigname); |
||||||
|
|
||||||
|
/* tuple is a copy, so we can modify it below */ |
||||||
|
evtForm = (Form_pg_event_trigger) GETSTRUCT(tup); |
||||||
|
evtForm->evtenabled = tgenabled; |
||||||
|
|
||||||
|
simple_heap_update(tgrel, &tup->t_self, tup); |
||||||
|
CatalogUpdateIndexes(tgrel, tup); |
||||||
|
|
||||||
|
/* clean up */ |
||||||
|
heap_freetuple(tup); |
||||||
|
heap_close(tgrel, RowExclusiveLock); |
||||||
|
} |
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Rename event trigger |
||||||
|
*/ |
||||||
|
void |
||||||
|
RenameEventTrigger(const char *trigname, const char *newname) |
||||||
|
{ |
||||||
|
HeapTuple tup; |
||||||
|
Relation rel; |
||||||
|
Form_pg_event_trigger evtForm; |
||||||
|
|
||||||
|
rel = heap_open(EventTriggerRelationId, RowExclusiveLock); |
||||||
|
|
||||||
|
/* newname must be available */ |
||||||
|
if (SearchSysCacheExists1(EVENTTRIGGERNAME, CStringGetDatum(newname))) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_DUPLICATE_OBJECT), |
||||||
|
errmsg("event trigger \"%s\" already exists", newname))); |
||||||
|
|
||||||
|
/* trigname must exists */ |
||||||
|
tup = SearchSysCacheCopy1(EVENTTRIGGERNAME, CStringGetDatum(trigname)); |
||||||
|
if (!HeapTupleIsValid(tup)) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_UNDEFINED_OBJECT), |
||||||
|
errmsg("event trigger \"%s\" does not exist", trigname))); |
||||||
|
if (!pg_event_trigger_ownercheck(HeapTupleGetOid(tup), GetUserId())) |
||||||
|
aclcheck_error(ACLCHECK_NOT_OWNER, ACL_KIND_EVENT_TRIGGER, |
||||||
|
trigname); |
||||||
|
|
||||||
|
evtForm = (Form_pg_event_trigger) GETSTRUCT(tup); |
||||||
|
|
||||||
|
/* tuple is a copy, so we can rename it now */ |
||||||
|
namestrcpy(&(evtForm->evtname), newname); |
||||||
|
simple_heap_update(rel, &tup->t_self, tup); |
||||||
|
CatalogUpdateIndexes(rel, tup); |
||||||
|
|
||||||
|
heap_freetuple(tup); |
||||||
|
heap_close(rel, RowExclusiveLock); |
||||||
|
} |
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Change event trigger's owner -- by name |
||||||
|
*/ |
||||||
|
void |
||||||
|
AlterEventTriggerOwner(const char *name, Oid newOwnerId) |
||||||
|
{ |
||||||
|
HeapTuple tup; |
||||||
|
Relation rel; |
||||||
|
|
||||||
|
rel = heap_open(EventTriggerRelationId, RowExclusiveLock); |
||||||
|
|
||||||
|
tup = SearchSysCacheCopy1(EVENTTRIGGERNAME, CStringGetDatum(name)); |
||||||
|
|
||||||
|
if (!HeapTupleIsValid(tup)) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_UNDEFINED_OBJECT), |
||||||
|
errmsg("event trigger \"%s\" does not exist", name))); |
||||||
|
|
||||||
|
AlterEventTriggerOwner_internal(rel, tup, newOwnerId); |
||||||
|
|
||||||
|
heap_freetuple(tup); |
||||||
|
|
||||||
|
heap_close(rel, RowExclusiveLock); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* Change extension owner, by OID |
||||||
|
*/ |
||||||
|
void |
||||||
|
AlterEventTriggerOwner_oid(Oid trigOid, Oid newOwnerId) |
||||||
|
{ |
||||||
|
HeapTuple tup; |
||||||
|
Relation rel; |
||||||
|
|
||||||
|
rel = heap_open(EventTriggerRelationId, RowExclusiveLock); |
||||||
|
|
||||||
|
tup = SearchSysCacheCopy1(EVENTTRIGGEROID, ObjectIdGetDatum(trigOid)); |
||||||
|
|
||||||
|
if (!HeapTupleIsValid(tup)) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_UNDEFINED_OBJECT), |
||||||
|
errmsg("event trigger with OID %u does not exist", trigOid))); |
||||||
|
|
||||||
|
AlterEventTriggerOwner_internal(rel, tup, newOwnerId); |
||||||
|
|
||||||
|
heap_freetuple(tup); |
||||||
|
|
||||||
|
heap_close(rel, RowExclusiveLock); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* Internal workhorse for changing an event trigger's owner |
||||||
|
*/ |
||||||
|
static void |
||||||
|
AlterEventTriggerOwner_internal(Relation rel, HeapTuple tup, Oid newOwnerId) |
||||||
|
{ |
||||||
|
Form_pg_event_trigger form; |
||||||
|
|
||||||
|
form = (Form_pg_event_trigger) GETSTRUCT(tup); |
||||||
|
|
||||||
|
if (form->evtowner == newOwnerId) |
||||||
|
return; |
||||||
|
|
||||||
|
if (!pg_event_trigger_ownercheck(HeapTupleGetOid(tup), GetUserId())) |
||||||
|
aclcheck_error(ACLCHECK_NOT_OWNER, ACL_KIND_EVENT_TRIGGER, |
||||||
|
NameStr(form->evtname)); |
||||||
|
|
||||||
|
/* New owner must be a superuser */ |
||||||
|
if (!superuser_arg(newOwnerId)) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE), |
||||||
|
errmsg("permission denied to change owner of event trigger \"%s\"", |
||||||
|
NameStr(form->evtname)), |
||||||
|
errhint("The owner of an event trigger must be a superuser."))); |
||||||
|
|
||||||
|
form->evtowner = newOwnerId; |
||||||
|
simple_heap_update(rel, &tup->t_self, tup); |
||||||
|
CatalogUpdateIndexes(rel, tup); |
||||||
|
|
||||||
|
/* Update owner dependency reference */ |
||||||
|
changeDependencyOnOwner(EventTriggerRelationId, |
||||||
|
HeapTupleGetOid(tup), |
||||||
|
newOwnerId); |
||||||
|
} |
||||||
|
|
||||||
|
/*
|
||||||
|
* get_event_trigger_oid - Look up an event trigger by name to find its OID. |
||||||
|
* |
||||||
|
* If missing_ok is false, throw an error if trigger not found. If |
||||||
|
* true, just return InvalidOid. |
||||||
|
*/ |
||||||
|
Oid |
||||||
|
get_event_trigger_oid(const char *trigname, bool missing_ok) |
||||||
|
{ |
||||||
|
Oid oid; |
||||||
|
|
||||||
|
oid = GetSysCacheOid1(EVENTTRIGGERNAME, CStringGetDatum(trigname)); |
||||||
|
if (!OidIsValid(oid) && !missing_ok) |
||||||
|
ereport(ERROR, |
||||||
|
(errcode(ERRCODE_UNDEFINED_OBJECT), |
||||||
|
errmsg("event trigger \"%s\" does not exist", trigname))); |
||||||
|
return oid; |
||||||
|
} |
||||||
@ -0,0 +1,63 @@ |
|||||||
|
/*-------------------------------------------------------------------------
|
||||||
|
* |
||||||
|
* pg_event_trigger.h |
||||||
|
* definition of the system "event trigger" relation (pg_event_trigger) |
||||||
|
* along with the relation's initial contents. |
||||||
|
* |
||||||
|
* |
||||||
|
* Portions Copyright (c) 1996-2011, PostgreSQL Global Development Group |
||||||
|
* Portions Copyright (c) 1994, Regents of the University of California |
||||||
|
* |
||||||
|
* src/include/catalog/pg_event_trigger.h |
||||||
|
* |
||||||
|
* NOTES |
||||||
|
* the genbki.pl script reads this file and generates .bki |
||||||
|
* information from the DATA() statements. |
||||||
|
* |
||||||
|
*------------------------------------------------------------------------- |
||||||
|
*/ |
||||||
|
#ifndef PG_EVENT_TRIGGER_H |
||||||
|
#define PG_EVENT_TRIGGER_H |
||||||
|
|
||||||
|
#include "catalog/genbki.h" |
||||||
|
|
||||||
|
/* ----------------
|
||||||
|
* pg_event_trigger definition. cpp turns this into |
||||||
|
* typedef struct FormData_pg_event_trigger |
||||||
|
* ---------------- |
||||||
|
*/ |
||||||
|
#define EventTriggerRelationId 3466 |
||||||
|
|
||||||
|
CATALOG(pg_event_trigger,3466) |
||||||
|
{ |
||||||
|
NameData evtname; /* trigger's name */ |
||||||
|
NameData evtevent; /* trigger's event */ |
||||||
|
Oid evtowner; /* trigger's owner */ |
||||||
|
Oid evtfoid; /* OID of function to be called */ |
||||||
|
char evtenabled; /* trigger's firing configuration WRT
|
||||||
|
* session_replication_role */ |
||||||
|
#ifdef CATALOG_VARLEN |
||||||
|
text evttags[1]; /* command TAGs this event trigger targets */ |
||||||
|
#endif |
||||||
|
} FormData_pg_event_trigger; |
||||||
|
|
||||||
|
/* ----------------
|
||||||
|
* Form_pg_event_trigger corresponds to a pointer to a tuple with |
||||||
|
* the format of pg_event_trigger relation. |
||||||
|
* ---------------- |
||||||
|
*/ |
||||||
|
typedef FormData_pg_event_trigger *Form_pg_event_trigger; |
||||||
|
|
||||||
|
/* ----------------
|
||||||
|
* compiler constants for pg_event_trigger |
||||||
|
* ---------------- |
||||||
|
*/ |
||||||
|
#define Natts_pg_event_trigger 6 |
||||||
|
#define Anum_pg_event_trigger_evtname 1 |
||||||
|
#define Anum_pg_event_trigger_evtevent 2 |
||||||
|
#define Anum_pg_event_trigger_evtowner 3 |
||||||
|
#define Anum_pg_event_trigger_evtfoid 4 |
||||||
|
#define Anum_pg_event_trigger_evtenabled 5 |
||||||
|
#define Anum_pg_event_trigger_evttags 6 |
||||||
|
|
||||||
|
#endif /* PG_EVENT_TRIGGER_H */ |
||||||
@ -0,0 +1,28 @@ |
|||||||
|
/*-------------------------------------------------------------------------
|
||||||
|
* |
||||||
|
* event_trigger.h |
||||||
|
* Declarations for command trigger handling. |
||||||
|
* |
||||||
|
* Portions Copyright (c) 1996-2011, PostgreSQL Global Development Group |
||||||
|
* Portions Copyright (c) 1994, Regents of the University of California |
||||||
|
* |
||||||
|
* src/include/commands/event_trigger.h |
||||||
|
* |
||||||
|
*------------------------------------------------------------------------- |
||||||
|
*/ |
||||||
|
#ifndef EVENT_TRIGGER_H |
||||||
|
#define EVENT_TRIGGER_H |
||||||
|
|
||||||
|
#include "catalog/pg_event_trigger.h" |
||||||
|
#include "nodes/parsenodes.h" |
||||||
|
|
||||||
|
extern void CreateEventTrigger(CreateEventTrigStmt *stmt); |
||||||
|
extern void RemoveEventTriggerById(Oid ctrigOid); |
||||||
|
extern Oid get_event_trigger_oid(const char *trigname, bool missing_ok); |
||||||
|
|
||||||
|
extern void AlterEventTrigger(AlterEventTrigStmt *stmt); |
||||||
|
extern void RenameEventTrigger(const char* trigname, const char *newname); |
||||||
|
extern void AlterEventTriggerOwner(const char *name, Oid newOwnerId); |
||||||
|
extern void AlterEventTriggerOwner_oid(Oid, Oid newOwnerId); |
||||||
|
|
||||||
|
#endif /* EVENT_TRIGGER_H */ |
||||||
@ -0,0 +1,90 @@ |
|||||||
|
-- should fail, return type mismatch |
||||||
|
create event trigger regress_event_trigger |
||||||
|
on ddl_command_start |
||||||
|
execute procedure pg_backend_pid(); |
||||||
|
ERROR: function "pg_backend_pid" must return type "event_trigger" |
||||||
|
-- cheesy hack for testing purposes |
||||||
|
create function fake_event_trigger() |
||||||
|
returns event_trigger |
||||||
|
language internal |
||||||
|
as 'pg_backend_pid'; |
||||||
|
-- should fail, no elephant_bootstrap entry point |
||||||
|
create event trigger regress_event_trigger on elephant_bootstrap |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
ERROR: unrecognized event name "elephant_bootstrap" |
||||||
|
-- OK |
||||||
|
create event trigger regress_event_trigger on ddl_command_start |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
-- should fail, food is not a valid filter variable |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when food in ('sandwhich') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
ERROR: unrecognized filter variable "food" |
||||||
|
-- should fail, sandwhich is not a valid command tag |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('sandwhich') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
ERROR: filter value "sandwhich" not recognized for filter variable "tag" |
||||||
|
-- should fail, create skunkcabbage is not a valid comand tag |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('create table', 'create skunkcabbage') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
ERROR: filter value "create skunkcabbage" not recognized for filter variable "tag" |
||||||
|
-- should fail, can't have event triggers on event triggers |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('DROP EVENT TRIGGER') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
ERROR: event triggers are not supported for "DROP EVENT TRIGGER" |
||||||
|
-- should fail, can't have same filter variable twice |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('create table') and tag in ('CREATE FUNCTION') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
ERROR: filter variable "tag" specified more than once |
||||||
|
-- OK |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('create table', 'CREATE FUNCTION') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
-- OK |
||||||
|
comment on event trigger regress_event_trigger is 'test comment'; |
||||||
|
-- should fail, event triggers are not schema objects |
||||||
|
comment on event trigger wrong.regress_event_trigger is 'test comment'; |
||||||
|
ERROR: event trigger name cannot be qualified |
||||||
|
-- drop as non-superuser should fail |
||||||
|
create role regression_bob; |
||||||
|
set role regression_bob; |
||||||
|
create event trigger regress_event_trigger_noperms on ddl_command_start |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
ERROR: permission denied to create event trigger "regress_event_trigger_noperms" |
||||||
|
HINT: Must be superuser to create an event trigger. |
||||||
|
reset role; |
||||||
|
-- all OK |
||||||
|
alter event trigger regress_event_trigger disable; |
||||||
|
alter event trigger regress_event_trigger enable replica; |
||||||
|
alter event trigger regress_event_trigger enable always; |
||||||
|
alter event trigger regress_event_trigger enable; |
||||||
|
-- alter owner to non-superuser should fail |
||||||
|
alter event trigger regress_event_trigger owner to regression_bob; |
||||||
|
ERROR: permission denied to change owner of event trigger "regress_event_trigger" |
||||||
|
HINT: The owner of an event trigger must be a superuser. |
||||||
|
-- alter owner to superuser should work |
||||||
|
alter role regression_bob superuser; |
||||||
|
alter event trigger regress_event_trigger owner to regression_bob; |
||||||
|
-- should fail, name collision |
||||||
|
alter event trigger regress_event_trigger rename to regress_event_trigger2; |
||||||
|
ERROR: event trigger "regress_event_trigger2" already exists |
||||||
|
-- OK |
||||||
|
alter event trigger regress_event_trigger rename to regress_event_trigger3; |
||||||
|
-- should fail, doesn't exist any more |
||||||
|
drop event trigger regress_event_trigger; |
||||||
|
ERROR: event trigger "regress_event_trigger" does not exist |
||||||
|
-- should fail, regression_bob owns regress_event_trigger2/3 |
||||||
|
drop role regression_bob; |
||||||
|
ERROR: role "regression_bob" cannot be dropped because some objects depend on it |
||||||
|
DETAIL: owner of event trigger regress_event_trigger3 |
||||||
|
-- these are all OK; the second one should emit a NOTICE |
||||||
|
drop event trigger if exists regress_event_trigger2; |
||||||
|
drop event trigger if exists regress_event_trigger2; |
||||||
|
NOTICE: event trigger "regress_event_trigger2" does not exist, skipping |
||||||
|
drop event trigger regress_event_trigger3; |
||||||
|
drop function fake_event_trigger(); |
||||||
|
drop role regression_bob; |
||||||
@ -0,0 +1,93 @@ |
|||||||
|
-- should fail, return type mismatch |
||||||
|
create event trigger regress_event_trigger |
||||||
|
on ddl_command_start |
||||||
|
execute procedure pg_backend_pid(); |
||||||
|
|
||||||
|
-- cheesy hack for testing purposes |
||||||
|
create function fake_event_trigger() |
||||||
|
returns event_trigger |
||||||
|
language internal |
||||||
|
as 'pg_backend_pid'; |
||||||
|
|
||||||
|
-- should fail, no elephant_bootstrap entry point |
||||||
|
create event trigger regress_event_trigger on elephant_bootstrap |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- OK |
||||||
|
create event trigger regress_event_trigger on ddl_command_start |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- should fail, food is not a valid filter variable |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when food in ('sandwhich') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- should fail, sandwhich is not a valid command tag |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('sandwhich') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- should fail, create skunkcabbage is not a valid comand tag |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('create table', 'create skunkcabbage') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- should fail, can't have event triggers on event triggers |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('DROP EVENT TRIGGER') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- should fail, can't have same filter variable twice |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('create table') and tag in ('CREATE FUNCTION') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- OK |
||||||
|
create event trigger regress_event_trigger2 on ddl_command_start |
||||||
|
when tag in ('create table', 'CREATE FUNCTION') |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
|
||||||
|
-- OK |
||||||
|
comment on event trigger regress_event_trigger is 'test comment'; |
||||||
|
|
||||||
|
-- should fail, event triggers are not schema objects |
||||||
|
comment on event trigger wrong.regress_event_trigger is 'test comment'; |
||||||
|
|
||||||
|
-- drop as non-superuser should fail |
||||||
|
create role regression_bob; |
||||||
|
set role regression_bob; |
||||||
|
create event trigger regress_event_trigger_noperms on ddl_command_start |
||||||
|
execute procedure fake_event_trigger(); |
||||||
|
reset role; |
||||||
|
|
||||||
|
-- all OK |
||||||
|
alter event trigger regress_event_trigger disable; |
||||||
|
alter event trigger regress_event_trigger enable replica; |
||||||
|
alter event trigger regress_event_trigger enable always; |
||||||
|
alter event trigger regress_event_trigger enable; |
||||||
|
|
||||||
|
-- alter owner to non-superuser should fail |
||||||
|
alter event trigger regress_event_trigger owner to regression_bob; |
||||||
|
|
||||||
|
-- alter owner to superuser should work |
||||||
|
alter role regression_bob superuser; |
||||||
|
alter event trigger regress_event_trigger owner to regression_bob; |
||||||
|
|
||||||
|
-- should fail, name collision |
||||||
|
alter event trigger regress_event_trigger rename to regress_event_trigger2; |
||||||
|
|
||||||
|
-- OK |
||||||
|
alter event trigger regress_event_trigger rename to regress_event_trigger3; |
||||||
|
|
||||||
|
-- should fail, doesn't exist any more |
||||||
|
drop event trigger regress_event_trigger; |
||||||
|
|
||||||
|
-- should fail, regression_bob owns regress_event_trigger2/3 |
||||||
|
drop role regression_bob; |
||||||
|
|
||||||
|
-- these are all OK; the second one should emit a NOTICE |
||||||
|
drop event trigger if exists regress_event_trigger2; |
||||||
|
drop event trigger if exists regress_event_trigger2; |
||||||
|
drop event trigger regress_event_trigger3; |
||||||
|
drop function fake_event_trigger(); |
||||||
|
drop role regression_bob; |
||||||
Loading…
Reference in new issue