1 -- $Id: psql-initialize.sql,v 1.15 2006-12-23 11:48:58 rurban Exp $
5 --================================================================
6 -- Prefix for table names.
8 -- You should set this to the same value you specify for
9 -- DATABASE_PREFIX in config/config.ini
13 --================================================================
14 -- Which postgres user gets access to the tables?
16 -- You should set this to the name of the postgres
17 -- user who will be accessing the tables.
18 -- See DATABASE_DSN in config.ini
20 -- NOTE: To be able to vacuum the tables from ordinary page requests
21 -- :httpd_user must be the table owner.
22 -- To run autovacuum and disable page requests vacuums edit the
23 -- pqsql backend optimize method in lib/WikiDB/backend/*_psql.php
25 -- Commonly, connections from php are made under
26 -- the user name of 'nobody', 'apache' or 'www'.
28 \set httpd_user 'wikiuser'
30 --================================================================
32 -- Don't modify below this point unless you know what you are doing.
34 --================================================================
36 \set qprefix '\'' :prefix '\''
37 \set qhttp_user '\'' :httpd_user '\''
39 \echo At first init the database with:
40 \echo '$ createdb phpwiki'
41 \echo '$ createuser -S -R -d ' :qhttp_user
42 \echo '$ psql -U ' :qhttp_user ' phpwiki < /usr/share/postgresql/contrib/tsearch2.sql'
43 \echo '$ psql -U ' :qhttp_user ' phpwiki < psql-initialize.sql'
45 \echo Initializing PhpWiki tables with:
46 \echo ' prefix = ' :qprefix
47 \echo ' httpd_user = ' :qhttp_user
49 \echo 'Expect some \'NOTICE: CREATE ... will create implicit sequence/index ...\' messages '
51 \set page_tbl :prefix 'page'
52 \set page_id_seq :prefix 'page_id_seq'
53 \set page_id_idx :prefix 'page_id_idx'
54 \set page_name_idx :prefix 'page_name_idx'
56 \set version_tbl :prefix 'version'
57 \set vers_id_idx :prefix 'vers_id_idx'
58 \set vers_mtime_idx :prefix 'vers_mtime_idx'
60 \set recent_tbl :prefix 'recent'
61 \set recent_id_idx :prefix 'recent_id_idx'
62 \set recent_lv_idx :prefix 'recent_lv_idx'
64 \set nonempty_tbl :prefix 'nonempty'
65 \set nonmt_id_idx :prefix 'nonmt_id_idx'
67 \set link_tbl :prefix 'link'
68 \set link_from_idx :prefix 'link_from_idx'
69 \set link_to_idx :prefix 'link_to_idx'
70 \set relation_idx :prefix 'relation_idx'
72 \set pagedata_tbl :prefix 'pagedata'
73 \set pagedata_id_idx :prefix 'pagedata_id_idx'
74 \set versiondata_tbl :prefix 'versiondata'
75 \set pageperm_tbl :prefix 'pageperm'
76 \set pageperm_id_idx :prefix 'pageperm_id_idx'
77 \set pageperm_access_idx :prefix 'pageperm_access_idx'
78 \set existing_page_view :prefix 'existing_page'
79 \set curr_page_view :prefix 'curr_page'
81 \set session_tbl :prefix 'session'
82 \set sess_id_idx :prefix 'sess_id_idx'
83 \set sess_date_idx :prefix 'sess_date_idx'
84 \set sess_ip_idx :prefix 'sess_ip_idx'
86 \set pref_tbl :prefix 'pref'
87 \set pref_id_idx :prefix 'pref_id_idx'
88 --\set user_tbl :prefix 'users'
89 --\set user_id_idx :prefix 'users_id_idx'
90 \set member_tbl :prefix 'member'
91 \set member_id_idx :prefix 'member_id_idx'
92 \set member_group_idx :prefix 'member_group_idx'
94 \set rating_tbl :prefix 'rating'
95 \set rating_id_idx :prefix 'rating_id_idx'
97 \set accesslog_tbl :prefix 'accesslog'
98 \set accesslog_time_idx :prefix 'log_time_idx'
99 \set accesslog_host_idx :prefix 'log_host_idx'
101 \set update_recent_fn :prefix 'update_recent'
102 \set prepare_rename_fn :prefix 'prepare_rename_page'
104 \echo Creating :page_tbl
105 CREATE TABLE :page_tbl (
106 id SERIAL PRIMARY KEY,
107 pagename VARCHAR(100) NOT NULL UNIQUE CHECK (pagename <> ''),
108 hits INT4 NOT NULL DEFAULT 0,
109 pagedata TEXT NOT NULL DEFAULT '',
110 cached_html bytea DEFAULT ''
112 -- CREATE UNIQUE INDEX :page_id_idx ON :page_tbl (id);
113 -- CREATE UNIQUE INDEX :page_name_idx ON :page_tbl (pagename);
115 -- we use 0 <=> global_data to satisfy the relation = 0 constraint
116 INSERT INTO :page_tbl VALUES (0,'global_data',0,'','');
118 \echo Creating :version_tbl
119 CREATE TABLE :version_tbl (
120 id INT4 REFERENCES :page_tbl,
121 version INT4 NOT NULL,
123 -- FIXME: should use boolean, but that returns 't' or 'f'. not 0 or 1.
124 minor_edit INT2 DEFAULT 0,
125 -- use bytea instead?
126 content TEXT NOT NULL DEFAULT '',
127 versiondata TEXT NOT NULL DEFAULT ''
129 CREATE UNIQUE INDEX :vers_id_idx ON :version_tbl (id, version);
130 CREATE INDEX :vers_mtime_idx ON :version_tbl (mtime);
131 -- deletion order: version, recent, nonempty
133 \echo Creating :recent_tbl
134 CREATE TABLE :recent_tbl (
135 id INT4 REFERENCES :page_tbl,
139 FOREIGN KEY (id, latestversion) REFERENCES :version_tbl (id, version),
140 CHECK (latestminor >= latestmajor)
142 CREATE UNIQUE INDEX :recent_id_idx ON :recent_tbl (id);
143 CREATE INDEX :recent_lv_idx ON :recent_tbl (latestversion);
145 \echo Creating :nonempty_tbl
146 CREATE TABLE :nonempty_tbl (
147 id INT4 NOT NULL REFERENCES :page_tbl
149 CREATE UNIQUE INDEX :nonmt_id_idx ON :nonempty_tbl (id);
151 \echo Creating experimental pagedata (not yet used)
152 CREATE TABLE :pagedata_tbl (
153 id INT4 NOT NULL REFERENCES :page_tbl,
156 rest TEXT NOT NULL DEFAULT ''
158 CREATE INDEX :pagedata_id_idx ON pagedata (id);
160 \echo Creating experimental versiondata (not yet used)
161 CREATE TABLE :versiondata_tbl (
163 version INT4 NOT NULL,
164 markup INT2 DEFAULT 2,
166 author_id VARCHAR(48),
167 pagetype VARCHAR(20) DEFAULT 'wikitext',
168 rest TEXT NOT NULL DEFAULT '',
169 FOREIGN KEY (id, version) REFERENCES :version_tbl (id, version)
171 \echo Creating experimental pageperm (not yet used)
172 CREATE TABLE :pageperm_tbl (
173 id INT4 NOT NULL REFERENCES :page_tbl(id),
174 -- view,edit,create,list,remove,change,dump
175 access CHAR(12) NOT NULL,
176 groupname VARCHAR(48),
179 CREATE INDEX :pageperm_id_idx ON pageperm (id);
180 CREATE INDEX :pageperm_access_idx ON pageperm (access);
182 \echo Creating experimental page views (not yet used)
184 -- nonempty versiondata
185 CREATE VIEW :existing_page_view AS
186 SELECT * FROM :page_tbl P INNER JOIN :nonempty_tbl N USING (id);
188 -- latest page version
189 CREATE VIEW :curr_page_view AS
190 SELECT P.id,P.pagename,P.hits,P.pagedata,P.cached_html,
191 V.version,V.mtime,V.minor_edit,V.content,V.versiondata
193 JOIN :version_tbl V USING (id)
194 JOIN :recent_tbl R ON (V.id=R.id AND V.version=R.latestversion);
196 \echo Creating :link_tbl
197 CREATE TABLE :link_tbl (
198 linkfrom INT4 NOT NULL REFERENCES :page_tbl,
199 linkto INT4 NOT NULL REFERENCES :page_tbl,
202 CREATE INDEX :link_from_idx ON :link_tbl (linkfrom);
203 CREATE INDEX :link_to_idx ON :link_tbl (linkto);
204 CREATE INDEX :relation_idx ON :link_tbl (relation);
206 -- ALTER TABLE link DROP CONSTRAINT link_relation_fkey;
208 -- if you plan to use the wikilens theme
209 \echo Creating :rating_tbl
210 CREATE TABLE :rating_tbl (
211 dimension INTEGER NOT NULL,
212 raterpage INT8 NOT NULL REFERENCES :page_tbl ON DELETE CASCADE,
213 rateepage INT8 NOT NULL REFERENCES :page_tbl ON DELETE CASCADE,
214 ratingvalue FLOAT NOT NULL,
215 rateeversion INT8 NOT NULL,
216 tstamp TIMESTAMP NOT NULL
218 CREATE UNIQUE INDEX :rating_id_idx ON :rating_tbl (dimension, raterpage, rateepage);
220 --================================================================
221 -- end of page relations
222 --================================================================
224 \echo Creating :session_tbl
225 CREATE TABLE :session_tbl (
226 sess_id CHAR(32) PRIMARY KEY,
227 sess_data bytea NOT NULL,
229 sess_ip CHAR(40) NOT NULL
231 -- CREATE UNIQUE INDEX :sess_id_idx ON :session_tbl (sess_id);
232 CREATE INDEX :sess_date_idx ON :session_tbl (sess_date);
233 CREATE INDEX :sess_ip_idx ON :session_tbl (sess_ip);
235 -- Optional DB Auth and Prefs
236 -- For these tables below the default table prefix must be used
237 -- in the DBAuthParam SQL statements also.
239 \echo Creating :pref_tbl
240 CREATE TABLE :pref_tbl (
241 userid CHAR(48) PRIMARY KEY,
242 prefs TEXT NULL DEFAULT '',
243 passwd CHAR(48) DEFAULT '',
244 groupname CHAR(48) DEFAULT 'users'
246 -- CREATE UNIQUE INDEX :pref_id_idx ON :pref_tbl (userid);
247 CREATE INDEX pref_group_idx ON :pref_tbl (groupname);
249 -- Use the member table, if you need it for n:m user-group relations,
250 -- and adjust your DBAUTH_AUTH_ SQL statements.
251 CREATE TABLE :member_tbl (
252 userid CHAR(48) NOT NULL REFERENCES :pref_tbl ON DELETE CASCADE,
253 groupname CHAR(48) NOT NULL DEFAULT 'users'
255 CREATE INDEX :member_id_idx ON :member_tbl (userid);
256 CREATE INDEX :member_group_idx ON :member_tbl (groupname);
258 -- if ACCESS_LOG_SQL > 0
259 -- only if you need fast log-analysis (spam prevention, recent referrers)
260 -- see http://www.outoforder.cc/projects/apache/mod_log_sql/docs-2.0/#id2756178
261 \echo Creating :accesslog_tbl
262 CREATE TABLE :accesslog_tbl (
264 remote_host VARCHAR(100),
265 remote_user VARCHAR(50),
266 request_method VARCHAR(10),
267 request_line VARCHAR(255),
268 request_args VARCHAR(255),
269 request_file VARCHAR(255),
270 request_uri VARCHAR(255),
271 request_time CHAR(28),
274 referer VARCHAR(255),
276 request_duration FLOAT
278 CREATE INDEX :accesslog_time_idx ON :accesslog_tbl (time_stamp);
279 CREATE INDEX :accesslog_host_idx ON :accesslog_tbl (remote_host);
280 -- create extra indices on demand (usually referer. see plugin/AccessLogSql)
282 --================================================================
284 -- Use the tsearch2 fulltextsearch extension: (recommended) 7.4, 8.0, 8.1
285 -- at first init it for the database:
286 -- $ psql phpwiki < /usr/share/postgresql/contrib/tsearch2.sql
288 -- example of ISpell dictionary
289 -- UPDATE pg_ts_dict SET dict_initoption='DictFile="/usr/local/share/ispell/russian.dict" ,AffFile ="/usr/local/share/ispell/russian.aff", StopFile="/usr/local/share/ispell/russian.stop"' WHERE dict_name='ispell_template';
290 -- example of synonym dict
291 -- UPDATE pg_ts_dict SET dict_initoption='/usr/local/share/ispell/english.syn' WHERE dict_id=5;
293 \echo Initializing tsearch2 indices
294 GRANT SELECT ON pg_ts_dict, pg_ts_parser, pg_ts_cfg, pg_ts_cfgmap TO :httpd_user;
295 ALTER TABLE :version_tbl ADD COLUMN idxFTI tsvector;
296 UPDATE :version_tbl SET idxFTI=to_tsvector('default', content);
298 CREATE INDEX idxFTI_idx ON :version_tbl USING gist(idxFTI);
300 CREATE TRIGGER tsvectorupdate BEFORE UPDATE OR INSERT ON :version_tbl
301 FOR EACH ROW EXECUTE PROCEDURE tsearch2(idxFTI, content);
303 --================================================================
305 \echo You might want to ignore the following errors or run
306 \echo /usr/sbin/createuser -S -R -d :httpd_user
308 \echo Applying permissions for role :httpd_user
309 GRANT SELECT,INSERT,UPDATE,DELETE ON :page_tbl TO :httpd_user;
310 GRANT SELECT,INSERT,UPDATE,DELETE ON :version_tbl TO :httpd_user;
311 GRANT SELECT,INSERT,UPDATE,DELETE ON :recent_tbl TO :httpd_user;
312 GRANT SELECT,INSERT,UPDATE,DELETE ON :nonempty_tbl TO :httpd_user;
313 GRANT SELECT,INSERT,UPDATE,DELETE ON :link_tbl TO :httpd_user;
315 GRANT SELECT,INSERT,UPDATE,DELETE ON :session_tbl TO :httpd_user;
316 -- you may want to fine tune this:
317 GRANT SELECT,INSERT,UPDATE,DELETE ON :pref_tbl TO :httpd_user;
318 -- GRANT SELECT ON :user_tbl TO :httpd_user;
319 GRANT SELECT ON :member_tbl TO :httpd_user;
320 GRANT SELECT,INSERT,UPDATE,DELETE ON :rating_tbl TO :httpd_user;
321 GRANT SELECT,INSERT,UPDATE,DELETE ON :accesslog_tbl TO :httpd_user;
323 --================================================================
324 -- some stored procedures to put unneccesary syntax into the server
326 \echo Initializing stored procedures
329 CREATE OR REPLACE FUNCTION :update_recent_fn (INT4, INT4)
330 RETURNS integer AS $$
331 DELETE FROM recent WHERE id = $1;
332 INSERT INTO recent (id, latestversion, latestmajor, latestminor)
333 SELECT id, MAX(version) AS latestversion,
334 MAX(CASE WHEN minor_edit = 0 THEN version END) AS latestmajor,
335 MAX(CASE WHEN minor_edit <> 0 THEN version END) AS latestminor
336 FROM version WHERE id = $2 GROUP BY id;
337 DELETE FROM nonempty WHERE id = $1;
338 INSERT INTO nonempty (id)
341 WHERE recent.id = version.id
342 AND version = latestversion
345 SELECT id FROM nonempty WHERE id = $1;
349 CREATE OR REPLACE FUNCTION :prepare_rename_fn (INT4, INT4)
351 DELETE FROM page WHERE id = $2;
352 DELETE FROM version WHERE id = $2;
353 DELETE FROM recent WHERE id = $2;
354 DELETE FROM nonempty WHERE id = $2;
355 -- We have to fix all referring tables to the old id
356 UPDATE link SET linkfrom = $1 WHERE linkfrom = $2;
357 UPDATE link SET linkto = $1 WHERE linkto = $2;