summaryrefslogtreecommitdiff
path: root/contrib/spi
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2000-06-19 13:54:50 +0000
committerBruce Momjian <bruce@momjian.us>2000-06-19 13:54:50 +0000
commit6de7d4fe91b1f037eb9ad612a22e972037426100 (patch)
tree1661370f02a7ce6aa212a35b15d35f344faccad1 /contrib/spi
parentb2c56574e1a83d4f71f72f9243423eeddbdbbe20 (diff)
downloadpostgresql-6de7d4fe91b1f037eb9ad612a22e972037426100.tar.gz
Update to /contrib from Karel.
Diffstat (limited to 'contrib/spi')
-rw-r--r--contrib/spi/Makefile10
-rw-r--r--contrib/spi/README104
-rw-r--r--contrib/spi/autoinc.source0
-rw-r--r--contrib/spi/insert_username.source0
-rw-r--r--contrib/spi/moddatetime.source0
-rw-r--r--contrib/spi/new_example.sql68
-rw-r--r--contrib/spi/refint.source0
-rw-r--r--contrib/spi/timetravel.source0
8 files changed, 5 insertions, 177 deletions
diff --git a/contrib/spi/Makefile b/contrib/spi/Makefile
index 1922d4be68..43105293e4 100644
--- a/contrib/spi/Makefile
+++ b/contrib/spi/Makefile
@@ -1,19 +1,19 @@
#
-# $Header: /cvsroot/pgsql/contrib/spi/Makefile,v 1.14 2000/06/16 18:59:17 momjian Exp $
+# $Header: /cvsroot/pgsql/contrib/spi/Makefile,v 1.15 2000/06/19 13:54:15 momjian Exp $
#
TOPDIR=../..
include ../Makefile.global
-NAME = spi
+NAME =
PROGRAM =
OBJS = autoinc.o insert_username.o moddatetime.o refint.o timetravel.o
-DOCS = README
+DOCS = README.spi
SQLS = $(OBJS:.o=.sql)
BINS =
-EXAMPLES= $(OBJS:.o=.example)
+EXAMPLES= $(OBJS:.o=.example) new_example.example
MODS = $(OBJS:.o=$(DLSUFFIX))
CFLAGS += -I. $(CFLAGS_SL)
@@ -33,7 +33,7 @@ install: install_doc install_sql install_mod install_example
install_doc:
for inst_file in $(DOCS); do \
- $(INSTALL) $(INSTL_LIB_OPTS) $$inst_file $(CONTRIB_DOCDIR)/$(DOCS).$(NAME); \
+ $(INSTALL) $(INSTL_LIB_OPTS) $$inst_file $(CONTRIB_DOCDIR); \
done
install_sql:
diff --git a/contrib/spi/README b/contrib/spi/README
index 65868f0fc7..e69de29bb2 100644
--- a/contrib/spi/README
+++ b/contrib/spi/README
@@ -1,104 +0,0 @@
-
-Here are general trigger functions provided as workable examples
-of using SPI and triggers. "General" means that functions may be
-used for defining triggers for any tables but you have to specify
-table/field names (as described below) while creating a trigger.
-
-1. refint.c - functions for implementing referential integrity.
-
-check_primary_key () is to used for foreign keys of a table.
-
- You are to create trigger (BEFORE INSERT OR UPDATE) using this
-function on a table referencing another table. You are to specify
-as function arguments: triggered table column names which correspond
-to foreign key, referenced table name and column names in referenced
-table which correspond to primary/unique key.
- You may create as many triggers as you need - one trigger for
-one reference.
-
-check_foreign_key () is to used for primary/unique keys of a table.
-
- You are to create trigger (BEFORE DELETE OR UPDATE) using this
-function on a table referenced by another table(s). You are to specify
-as function arguments: number of references for which function has to
-performe checking, action if referencing key found ('cascade' - to delete
-corresponding foreign key, 'restrict' - to abort transaction if foreign keys
-exist, 'setnull' - to set foreign key referencing primary/unique key
-being deleted to null), triggered table column names which correspond
-to primary/unique key, referencing table name and column names corresponding
-to foreign key (, ... - as many referencing tables/keys as specified
-by first argument).
- Note, that NOT NULL constraint and unique index have to be defined by
-youself.
-
- There are examples in refint.example and regression tests
-(sql/triggers.sql).
-
- To CREATE FUNCTIONs use refint.sql (will be made by gmake from
-refint.source).
-
-
-2. timetravel.c - functions for implementing time travel feature.
-
- Old internally supported time-travel (TT) used insert/delete
-transaction commit times. To get the same feature using triggers
-you are to add to a table two columns of abstime type to store
-date when a tuple was inserted (start_date) and changed/deleted
-(stop_date):
-
-CREATE TABLE XXX (
- ... ...
- date_on abstime default currabstime(),
- date_off abstime default 'infinity'
- ... ...
-);
-
-- so, tuples being inserted with NULLs in date_on/date_off will get
-_current_date_ in date_on (name of start_date column in XXX) and INFINITY in
-date_off (name of stop_date column in XXX).
-
- Tuples with stop_date equal INFINITY are "valid now": when trigger will
-be fired for UPDATE/DELETE of a tuple with stop_date NOT equal INFINITY then
-this tuple will not be changed/deleted!
-
- If stop_date equal INFINITY then on
-
-UPDATE: only stop_date in tuple being updated will be changed to current
-date and new tuple with new data (coming from SET ... in UPDATE) will be
-inserted. Start_date in this new tuple will be setted to current date and
-stop_date - to INFINITY.
-
-DELETE: new tuple will be inserted with stop_date setted to current date
-(and with the same data in other columns as in tuple being deleted).
-
- NOTE:
-1. To get tuples "valid now" you are to add _stop_date_ = 'infinity'
- to WHERE. Internally supported TT allowed to avoid this...
- Fixed rewriting RULEs could help here...
- As work arround you may use VIEWs...
-2. You can't change start/stop date columns with UPDATE!
- Use set_timetravel (below) if you need in this.
-
- FUNCTIONs:
-
-timetravel() is general trigger function.
-
- You are to create trigger BEFORE (!!!) UPDATE OR DELETE using this
-function on a time-traveled table. You are to specify two arguments: name of
-start_date column and name of stop_date column in triggered table.
-
-currabstime() may be used in DEFAULT for start_date column to get
-current date.
-
-set_timetravel() allows you turn time-travel ON/OFF for a table:
-
- set_timetravel('XXX', 1) will turn TT ON for table XXX (and report
-old status).
- set_timetravel('XXX', 0) will turn TT OFF for table XXX (-"-).
-
-Turning TT OFF allows you do with a table ALL what you want.
-
- There is example in timetravel.example.
-
- To CREATE FUNCTIONs use timetravel.sql (will be made by gmake from
-timetravel.source).
diff --git a/contrib/spi/autoinc.source b/contrib/spi/autoinc.source
deleted file mode 100644
index e69de29bb2..0000000000
--- a/contrib/spi/autoinc.source
+++ /dev/null
diff --git a/contrib/spi/insert_username.source b/contrib/spi/insert_username.source
deleted file mode 100644
index e69de29bb2..0000000000
--- a/contrib/spi/insert_username.source
+++ /dev/null
diff --git a/contrib/spi/moddatetime.source b/contrib/spi/moddatetime.source
deleted file mode 100644
index e69de29bb2..0000000000
--- a/contrib/spi/moddatetime.source
+++ /dev/null
diff --git a/contrib/spi/new_example.sql b/contrib/spi/new_example.sql
index 0204907894..e69de29bb2 100644
--- a/contrib/spi/new_example.sql
+++ b/contrib/spi/new_example.sql
@@ -1,68 +0,0 @@
---Column ID of table A is primary key:
-
-CREATE TABLE A (
- ID int4 not null,
- id1 int4 not null,
-primary key (ID,ID1)
-);
-
---Columns REFB of table B and REFC of C are foreign keys referenting ID of A:
-
-CREATE TABLE B (
- REFB int4,
- REFB1 INT4
-);
-CREATE INDEX BI ON B (REFB);
-
-CREATE TABLE C (
- REFC int4,
- REFC1 int4
-);
-CREATE INDEX CI ON C (REFC);
-
---Trigger for table A:
-
-CREATE TRIGGER AT BEFORE DELETE ON A FOR EACH ROW
-EXECUTE PROCEDURE
-check_foreign_key (2, 'cascade', 'ID','id1', 'B', 'REFB','REFB1', 'C', 'REFC','REFC1');
-
-
-CREATE TRIGGER AT1 AFTER UPDATE ON A FOR EACH ROW
-EXECUTE PROCEDURE
-check_foreign_key (2, 'cascade', 'ID','id1', 'B', 'REFB','REFB1', 'C', 'REFC','REFC1');
-
-
-CREATE TRIGGER BT BEFORE INSERT OR UPDATE ON B FOR EACH ROW
-EXECUTE PROCEDURE
-check_primary_key ('REFB','REFB1', 'A', 'ID','ID1');
-
-CREATE TRIGGER CT BEFORE INSERT OR UPDATE ON C FOR EACH ROW
-EXECUTE PROCEDURE
-check_primary_key ('REFC','REFC1', 'A', 'ID','ID1');
-
-
-
--- Now try
-
-INSERT INTO A VALUES (10,10);
-INSERT INTO A VALUES (20,20);
-INSERT INTO A VALUES (30,30);
-INSERT INTO A VALUES (40,41);
-INSERT INTO A VALUES (50,50);
-
-INSERT INTO B VALUES (1); -- invalid reference
-INSERT INTO B VALUES (10,10);
-INSERT INTO B VALUES (30,30);
-INSERT INTO B VALUES (30,30);
-
-INSERT INTO C VALUES (11); -- invalid reference
-INSERT INTO C VALUES (20,20);
-INSERT INTO C VALUES (20,21);
-INSERT INTO C VALUES (30,30);
-
--- now update work well
-update A set ID = 100 , ID1 = 199 where ID=30 ;
-
-SELECT * FROM A;
-SELECT * FROM B;
-SELECT * FROM C;
diff --git a/contrib/spi/refint.source b/contrib/spi/refint.source
deleted file mode 100644
index e69de29bb2..0000000000
--- a/contrib/spi/refint.source
+++ /dev/null
diff --git a/contrib/spi/timetravel.source b/contrib/spi/timetravel.source
deleted file mode 100644
index e69de29bb2..0000000000
--- a/contrib/spi/timetravel.source
+++ /dev/null