merge latest master into Wikidata branch
[lhc/web/wiklou.git] / maintenance / tables.sql
1 -- SQL to create the initial tables for the MediaWiki database.
2 -- This is read and executed by the install script; you should
3 -- not have to run it by itself unless doing a manual install.
4
5 -- This is a shared schema file used for both MySQL and SQLite installs.
6
7 --
8 -- General notes:
9 --
10 -- If possible, create tables as InnoDB to benefit from the
11 -- superior resiliency against crashes and ability to read
12 -- during writes (and write during reads!)
13 --
14 -- Only the 'searchindex' table requires MyISAM due to the
15 -- requirement for fulltext index support, which is missing
16 -- from InnoDB.
17 --
18 --
19 -- The MySQL table backend for MediaWiki currently uses
20 -- 14-character BINARY or VARBINARY fields to store timestamps.
21 -- The format is YYYYMMDDHHMMSS, which is derived from the
22 -- text format of MySQL's TIMESTAMP fields.
23 --
24 -- Historically TIMESTAMP fields were used, but abandoned
25 -- in early 2002 after a lot of trouble with the fields
26 -- auto-updating.
27 --
28 -- The Postgres backend uses TIMESTAMPTZ fields for timestamps,
29 -- and we will migrate the MySQL definitions at some point as
30 -- well.
31 --
32 --
33 -- The /*_*/ comments in this and other files are
34 -- replaced with the defined table prefix by the installer
35 -- and updater scripts. If you are installing or running
36 -- updates manually, you will need to manually insert the
37 -- table prefix if any when running these scripts.
38 --
39
40
41 --
42 -- The user table contains basic account information,
43 -- authentication keys, etc.
44 --
45 -- Some multi-wiki sites may share a single central user table
46 -- between separate wikis using the $wgSharedDB setting.
47 --
48 -- Note that when a external authentication plugin is used,
49 -- user table entries still need to be created to store
50 -- preferences and to key tracking information in the other
51 -- tables.
52 --
53 CREATE TABLE /*_*/user (
54 user_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
55
56 -- Usernames must be unique, must not be in the form of
57 -- an IP address. _Shouldn't_ allow slashes or case
58 -- conflicts. Spaces are allowed, and are _not_ converted
59 -- to underscores like titles. See the User::newFromName() for
60 -- the specific tests that usernames have to pass.
61 user_name varchar(255) binary NOT NULL default '',
62
63 -- Optional 'real name' to be displayed in credit listings
64 user_real_name varchar(255) binary NOT NULL default '',
65
66 -- Password hashes, see User::crypt() and User::comparePasswords()
67 -- in User.php for the algorithm
68 user_password tinyblob NOT NULL,
69
70 -- When using 'mail me a new password', a random
71 -- password is generated and the hash stored here.
72 -- The previous password is left in place until
73 -- someone actually logs in with the new password,
74 -- at which point the hash is moved to user_password
75 -- and the old password is invalidated.
76 user_newpassword tinyblob NOT NULL,
77
78 -- Timestamp of the last time when a new password was
79 -- sent, for throttling and expiring purposes
80 -- Emailed passwords will expire $wgNewPasswordExpiry
81 -- (a week) after being set. If user_newpass_time is NULL
82 -- (eg. created by mail) it doesn't expire.
83 user_newpass_time binary(14),
84
85 -- Note: email should be restricted, not public info.
86 -- Same with passwords.
87 user_email tinytext NOT NULL,
88
89 -- This is a timestamp which is updated when a user
90 -- logs in, logs out, changes preferences, or performs
91 -- some other action requiring HTML cache invalidation
92 -- to ensure that the UI is updated.
93 user_touched binary(14) NOT NULL default '',
94
95 -- A pseudorandomly generated value that is stored in
96 -- a cookie when the "remember password" feature is
97 -- used (previously, a hash of the password was used, but
98 -- this was vulnerable to cookie-stealing attacks)
99 user_token binary(32) NOT NULL default '',
100
101 -- Initially NULL; when a user's e-mail address has been
102 -- validated by returning with a mailed token, this is
103 -- set to the current timestamp.
104 user_email_authenticated binary(14),
105
106 -- Randomly generated token created when the e-mail address
107 -- is set and a confirmation test mail sent.
108 user_email_token binary(32),
109
110 -- Expiration date for the user_email_token
111 user_email_token_expires binary(14),
112
113 -- Timestamp of account registration.
114 -- Accounts predating this schema addition may contain NULL.
115 user_registration binary(14),
116
117 -- Count of edits and edit-like actions.
118 --
119 -- *NOT* intended to be an accurate copy of COUNT(*) WHERE rev_user=user_id
120 -- May contain NULL for old accounts if batch-update scripts haven't been
121 -- run, as well as listing deleted edits and other myriad ways it could be
122 -- out of sync.
123 --
124 -- Meant primarily for heuristic checks to give an impression of whether
125 -- the account has been used much.
126 --
127 user_editcount int
128 ) /*$wgDBTableOptions*/;
129
130 CREATE UNIQUE INDEX /*i*/user_name ON /*_*/user (user_name);
131 CREATE INDEX /*i*/user_email_token ON /*_*/user (user_email_token);
132 CREATE INDEX /*i*/user_email ON /*_*/user (user_email(50));
133
134
135 --
136 -- User permissions have been broken out to a separate table;
137 -- this allows sites with a shared user table to have different
138 -- permissions assigned to a user in each project.
139 --
140 -- This table replaces the old user_rights field which used a
141 -- comma-separated blob.
142 --
143 CREATE TABLE /*_*/user_groups (
144 -- Key to user_id
145 ug_user int unsigned NOT NULL default 0,
146
147 -- Group names are short symbolic string keys.
148 -- The set of group names is open-ended, though in practice
149 -- only some predefined ones are likely to be used.
150 --
151 -- At runtime $wgGroupPermissions will associate group keys
152 -- with particular permissions. A user will have the combined
153 -- permissions of any group they're explicitly in, plus
154 -- the implicit '*' and 'user' groups.
155 ug_group varbinary(32) NOT NULL default ''
156 ) /*$wgDBTableOptions*/;
157
158 CREATE UNIQUE INDEX /*i*/ug_user_group ON /*_*/user_groups (ug_user,ug_group);
159 CREATE INDEX /*i*/ug_group ON /*_*/user_groups (ug_group);
160
161 -- Stores the groups the user has once belonged to.
162 -- The user may still belong to these groups (check user_groups).
163 -- Users are not autopromoted to groups from which they were removed.
164 CREATE TABLE /*_*/user_former_groups (
165 -- Key to user_id
166 ufg_user int unsigned NOT NULL default 0,
167 ufg_group varbinary(32) NOT NULL default ''
168 ) /*$wgDBTableOptions*/;
169
170 CREATE UNIQUE INDEX /*i*/ufg_user_group ON /*_*/user_former_groups (ufg_user,ufg_group);
171
172 --
173 -- Stores notifications of user talk page changes, for the display
174 -- of the "you have new messages" box
175 --
176 CREATE TABLE /*_*/user_newtalk (
177 -- Key to user.user_id
178 user_id int NOT NULL default 0,
179 -- If the user is an anonymous user their IP address is stored here
180 -- since the user_id of 0 is ambiguous
181 user_ip varbinary(40) NOT NULL default '',
182 -- The highest timestamp of revisions of the talk page viewed
183 -- by this user
184 user_last_timestamp varbinary(14) NULL default NULL
185 ) /*$wgDBTableOptions*/;
186
187 -- Indexes renamed for SQLite in 1.14
188 CREATE INDEX /*i*/un_user_id ON /*_*/user_newtalk (user_id);
189 CREATE INDEX /*i*/un_user_ip ON /*_*/user_newtalk (user_ip);
190
191
192 --
193 -- User preferences and perhaps other fun stuff. :)
194 -- Replaces the old user.user_options blob, with a couple nice properties:
195 --
196 -- 1) We only store non-default settings, so changes to the defauls
197 -- are now reflected for everybody, not just new accounts.
198 -- 2) We can more easily do bulk lookups, statistics, or modifications of
199 -- saved options since it's a sane table structure.
200 --
201 CREATE TABLE /*_*/user_properties (
202 -- Foreign key to user.user_id
203 up_user int NOT NULL,
204
205 -- Name of the option being saved. This is indexed for bulk lookup.
206 up_property varbinary(255) NOT NULL,
207
208 -- Property value as a string.
209 up_value blob
210 ) /*$wgDBTableOptions*/;
211
212 CREATE UNIQUE INDEX /*i*/user_properties_user_property ON /*_*/user_properties (up_user,up_property);
213 CREATE INDEX /*i*/user_properties_property ON /*_*/user_properties (up_property);
214
215 --
216 -- Core of the wiki: each page has an entry here which identifies
217 -- it by title and contains some essential metadata.
218 --
219 CREATE TABLE /*_*/page (
220 -- Unique identifier number. The page_id will be preserved across
221 -- edits and rename operations, but not deletions and recreations.
222 page_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
223
224 -- A page name is broken into a namespace and a title.
225 -- The namespace keys are UI-language-independent constants,
226 -- defined in includes/Defines.php
227 page_namespace int NOT NULL,
228
229 -- The rest of the title, as text.
230 -- Spaces are transformed into underscores in title storage.
231 page_title varchar(255) binary NOT NULL,
232
233 -- Comma-separated set of permission keys indicating who
234 -- can move or edit the page.
235 page_restrictions tinyblob NOT NULL,
236
237 -- Number of times this page has been viewed.
238 page_counter bigint unsigned NOT NULL default 0,
239
240 -- 1 indicates the article is a redirect.
241 page_is_redirect tinyint unsigned NOT NULL default 0,
242
243 -- 1 indicates this is a new entry, with only one edit.
244 -- Not all pages with one edit are new pages.
245 page_is_new tinyint unsigned NOT NULL default 0,
246
247 -- Random value between 0 and 1, used for Special:Randompage
248 page_random real unsigned NOT NULL,
249
250 -- This timestamp is updated whenever the page changes in
251 -- a way requiring it to be re-rendered, invalidating caches.
252 -- Aside from editing this includes permission changes,
253 -- creation or deletion of linked pages, and alteration
254 -- of contained templates.
255 page_touched binary(14) NOT NULL default '',
256
257 -- Handy key to revision.rev_id of the current revision.
258 -- This may be 0 during page creation, but that shouldn't
259 -- happen outside of a transaction... hopefully.
260 page_latest int unsigned NOT NULL,
261
262 -- Uncompressed length in bytes of the page's current source text.
263 page_len int unsigned NOT NULL,
264
265 -- content model, see CONTENT_MODEL_XXX constants
266 page_content_model int unsigned default NULL
267 ) /*$wgDBTableOptions*/;
268
269 CREATE UNIQUE INDEX /*i*/name_title ON /*_*/page (page_namespace,page_title);
270 CREATE INDEX /*i*/page_random ON /*_*/page (page_random);
271 CREATE INDEX /*i*/page_len ON /*_*/page (page_len);
272 CREATE INDEX /*i*/page_redirect_namespace_len ON /*_*/page (page_is_redirect, page_namespace, page_len);
273
274 --
275 -- Every edit of a page creates also a revision row.
276 -- This stores metadata about the revision, and a reference
277 -- to the text storage backend.
278 --
279 CREATE TABLE /*_*/revision (
280 -- Unique ID to identify each revision
281 rev_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
282
283 -- Key to page_id. This should _never_ be invalid.
284 rev_page int unsigned NOT NULL,
285
286 -- Key to text.old_id, where the actual bulk text is stored.
287 -- It's possible for multiple revisions to use the same text,
288 -- for instance revisions where only metadata is altered
289 -- or a rollback to a previous version.
290 rev_text_id int unsigned NOT NULL,
291
292 -- Text comment summarizing the change.
293 -- This text is shown in the history and other changes lists,
294 -- rendered in a subset of wiki markup by Linker::formatComment()
295 rev_comment tinyblob NOT NULL,
296
297 -- Key to user.user_id of the user who made this edit.
298 -- Stores 0 for anonymous edits and for some mass imports.
299 rev_user int unsigned NOT NULL default 0,
300
301 -- Text username or IP address of the editor.
302 rev_user_text varchar(255) binary NOT NULL default '',
303
304 -- Timestamp of when revision was created
305 rev_timestamp binary(14) NOT NULL default '',
306
307 -- Records whether the user marked the 'minor edit' checkbox.
308 -- Many automated edits are marked as minor.
309 rev_minor_edit tinyint unsigned NOT NULL default 0,
310
311 -- Restrictions on who can access this revision
312 rev_deleted tinyint unsigned NOT NULL default 0,
313
314 -- Length of this revision in bytes
315 rev_len int unsigned,
316
317 -- Key to revision.rev_id
318 -- This field is used to add support for a tree structure (The Adjacency List Model)
319 rev_parent_id int unsigned default NULL,
320
321 -- SHA-1 text content hash in base-36
322 rev_sha1 varbinary(32) NOT NULL default '',
323
324 -- content model, see CONTENT_MODEL_XXX constants
325 rev_content_model int unsigned default NULL,
326
327 -- content format, see CONTENT_FORMAT_XXX constants
328 rev_content_format int unsigned default NULL
329
330 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=1024;
331 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
332
333 CREATE UNIQUE INDEX /*i*/rev_page_id ON /*_*/revision (rev_page, rev_id);
334 CREATE INDEX /*i*/rev_timestamp ON /*_*/revision (rev_timestamp);
335 CREATE INDEX /*i*/page_timestamp ON /*_*/revision (rev_page,rev_timestamp);
336 CREATE INDEX /*i*/user_timestamp ON /*_*/revision (rev_user,rev_timestamp);
337 CREATE INDEX /*i*/usertext_timestamp ON /*_*/revision (rev_user_text,rev_timestamp);
338 CREATE INDEX /*i*/page_user_timestamp ON /*_*/revision (rev_page,rev_user,rev_timestamp);
339
340 --
341 -- Holds text of individual page revisions.
342 --
343 -- Field names are a holdover from the 'old' revisions table in
344 -- MediaWiki 1.4 and earlier: an upgrade will transform that
345 -- table into the 'text' table to minimize unnecessary churning
346 -- and downtime. If upgrading, the other fields will be left unused.
347 --
348 CREATE TABLE /*_*/text (
349 -- Unique text storage key number.
350 -- Note that the 'oldid' parameter used in URLs does *not*
351 -- refer to this number anymore, but to rev_id.
352 --
353 -- revision.rev_text_id is a key to this column
354 old_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
355
356 -- Depending on the contents of the old_flags field, the text
357 -- may be convenient plain text, or it may be funkily encoded.
358 old_text mediumblob NOT NULL,
359
360 -- Comma-separated list of flags:
361 -- gzip: text is compressed with PHP's gzdeflate() function.
362 -- utf8: text was stored as UTF-8.
363 -- If $wgLegacyEncoding option is on, rows *without* this flag
364 -- will be converted to UTF-8 transparently at load time.
365 -- object: text field contained a serialized PHP object.
366 -- The object either contains multiple versions compressed
367 -- together to achieve a better compression ratio, or it refers
368 -- to another row where the text can be found.
369 old_flags tinyblob NOT NULL
370 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=10240;
371 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
372
373
374 --
375 -- Holding area for deleted articles, which may be viewed
376 -- or restored by admins through the Special:Undelete interface.
377 -- The fields generally correspond to the page, revision, and text
378 -- fields, with several caveats.
379 --
380 CREATE TABLE /*_*/archive (
381 ar_namespace int NOT NULL default 0,
382 ar_title varchar(255) binary NOT NULL default '',
383
384 -- Newly deleted pages will not store text in this table,
385 -- but will reference the separately existing text rows.
386 -- This field is retained for backwards compatibility,
387 -- so old archived pages will remain accessible after
388 -- upgrading from 1.4 to 1.5.
389 -- Text may be gzipped or otherwise funky.
390 ar_text mediumblob NOT NULL,
391
392 -- Basic revision stuff...
393 ar_comment tinyblob NOT NULL,
394 ar_user int unsigned NOT NULL default 0,
395 ar_user_text varchar(255) binary NOT NULL,
396 ar_timestamp binary(14) NOT NULL default '',
397 ar_minor_edit tinyint NOT NULL default 0,
398
399 -- See ar_text note.
400 ar_flags tinyblob NOT NULL,
401
402 -- When revisions are deleted, their unique rev_id is stored
403 -- here so it can be retained after undeletion. This is necessary
404 -- to retain permalinks to given revisions after accidental delete
405 -- cycles or messy operations like history merges.
406 --
407 -- Old entries from 1.4 will be NULL here, and a new rev_id will
408 -- be created on undeletion for those revisions.
409 ar_rev_id int unsigned,
410
411 -- For newly deleted revisions, this is the text.old_id key to the
412 -- actual stored text. To avoid breaking the block-compression scheme
413 -- and otherwise making storage changes harder, the actual text is
414 -- *not* deleted from the text table, merely hidden by removal of the
415 -- page and revision entries.
416 --
417 -- Old entries deleted under 1.2-1.4 will have NULL here, and their
418 -- ar_text and ar_flags fields will be used to create a new text
419 -- row upon undeletion.
420 ar_text_id int unsigned,
421
422 -- rev_deleted for archives
423 ar_deleted tinyint unsigned NOT NULL default 0,
424
425 -- Length of this revision in bytes
426 ar_len int unsigned,
427
428 -- Reference to page_id. Useful for sysadmin fixing of large pages
429 -- merged together in the archives, or for cleanly restoring a page
430 -- at its original ID number if possible.
431 --
432 -- Will be NULL for pages deleted prior to 1.11.
433 ar_page_id int unsigned,
434
435 -- Original previous revision
436 ar_parent_id int unsigned default NULL,
437
438 -- SHA-1 text content hash in base-36
439 ar_sha1 varbinary(32) NOT NULL default '',
440
441 -- content model, see CONTENT_MODEL_XXX constants
442 ar_content_model int unsigned default NULL,
443
444 -- content format, see CONTENT_FORMAT_XXX constants
445 ar_content_format int unsigned default NULL
446
447 ) /*$wgDBTableOptions*/;
448
449 CREATE INDEX /*i*/name_title_timestamp ON /*_*/archive (ar_namespace,ar_title,ar_timestamp);
450 CREATE INDEX /*i*/ar_usertext_timestamp ON /*_*/archive (ar_user_text,ar_timestamp);
451 CREATE INDEX /*i*/ar_revid ON /*_*/archive (ar_rev_id);
452
453
454 --
455 -- Track page-to-page hyperlinks within the wiki.
456 --
457 CREATE TABLE /*_*/pagelinks (
458 -- Key to the page_id of the page containing the link.
459 pl_from int unsigned NOT NULL default 0,
460
461 -- Key to page_namespace/page_title of the target page.
462 -- The target page may or may not exist, and due to renames
463 -- and deletions may refer to different page records as time
464 -- goes by.
465 pl_namespace int NOT NULL default 0,
466 pl_title varchar(255) binary NOT NULL default ''
467 ) /*$wgDBTableOptions*/;
468
469 CREATE UNIQUE INDEX /*i*/pl_from ON /*_*/pagelinks (pl_from,pl_namespace,pl_title);
470 CREATE UNIQUE INDEX /*i*/pl_namespace ON /*_*/pagelinks (pl_namespace,pl_title,pl_from);
471
472
473 --
474 -- Track template inclusions.
475 --
476 CREATE TABLE /*_*/templatelinks (
477 -- Key to the page_id of the page containing the link.
478 tl_from int unsigned NOT NULL default 0,
479
480 -- Key to page_namespace/page_title of the target page.
481 -- The target page may or may not exist, and due to renames
482 -- and deletions may refer to different page records as time
483 -- goes by.
484 tl_namespace int NOT NULL default 0,
485 tl_title varchar(255) binary NOT NULL default ''
486 ) /*$wgDBTableOptions*/;
487
488 CREATE UNIQUE INDEX /*i*/tl_from ON /*_*/templatelinks (tl_from,tl_namespace,tl_title);
489 CREATE UNIQUE INDEX /*i*/tl_namespace ON /*_*/templatelinks (tl_namespace,tl_title,tl_from);
490
491
492 --
493 -- Track links to images *used inline*
494 -- We don't distinguish live from broken links here, so
495 -- they do not need to be changed on upload/removal.
496 --
497 CREATE TABLE /*_*/imagelinks (
498 -- Key to page_id of the page containing the image / media link.
499 il_from int unsigned NOT NULL default 0,
500
501 -- Filename of target image.
502 -- This is also the page_title of the file's description page;
503 -- all such pages are in namespace 6 (NS_FILE).
504 il_to varchar(255) binary NOT NULL default ''
505 ) /*$wgDBTableOptions*/;
506
507 CREATE UNIQUE INDEX /*i*/il_from ON /*_*/imagelinks (il_from,il_to);
508 CREATE UNIQUE INDEX /*i*/il_to ON /*_*/imagelinks (il_to,il_from);
509
510
511 --
512 -- Track category inclusions *used inline*
513 -- This tracks a single level of category membership
514 --
515 CREATE TABLE /*_*/categorylinks (
516 -- Key to page_id of the page defined as a category member.
517 cl_from int unsigned NOT NULL default 0,
518
519 -- Name of the category.
520 -- This is also the page_title of the category's description page;
521 -- all such pages are in namespace 14 (NS_CATEGORY).
522 cl_to varchar(255) binary NOT NULL default '',
523
524 -- A binary string obtained by applying a sortkey generation algorithm
525 -- (Collation::getSortKey()) to page_title, or cl_sortkey_prefix . "\n"
526 -- . page_title if cl_sortkey_prefix is nonempty.
527 cl_sortkey varbinary(230) NOT NULL default '',
528
529 -- A prefix for the raw sortkey manually specified by the user, either via
530 -- [[Category:Foo|prefix]] or {{defaultsort:prefix}}. If nonempty, it's
531 -- concatenated with a line break followed by the page title before the sortkey
532 -- conversion algorithm is run. We store this so that we can update
533 -- collations without reparsing all pages.
534 -- Note: If you change the length of this field, you also need to change
535 -- code in LinksUpdate.php. See bug 25254.
536 cl_sortkey_prefix varchar(255) binary NOT NULL default '',
537
538 -- This isn't really used at present. Provided for an optional
539 -- sorting method by approximate addition time.
540 cl_timestamp timestamp NOT NULL,
541
542 -- Stores $wgCategoryCollation at the time cl_sortkey was generated. This
543 -- can be used to install new collation versions, tracking which rows are not
544 -- yet updated. '' means no collation, this is a legacy row that needs to be
545 -- updated by updateCollation.php. In the future, it might be possible to
546 -- specify different collations per category.
547 cl_collation varbinary(32) NOT NULL default '',
548
549 -- Stores whether cl_from is a category, file, or other page, so we can
550 -- paginate the three categories separately. This never has to be updated
551 -- after the page is created, since none of these page types can be moved to
552 -- any other.
553 cl_type ENUM('page', 'subcat', 'file') NOT NULL default 'page'
554 ) /*$wgDBTableOptions*/;
555
556 CREATE UNIQUE INDEX /*i*/cl_from ON /*_*/categorylinks (cl_from,cl_to);
557
558 -- We always sort within a given category, and within a given type. FIXME:
559 -- Formerly this index didn't cover cl_type (since that didn't exist), so old
560 -- callers won't be using an index: fix this?
561 CREATE INDEX /*i*/cl_sortkey ON /*_*/categorylinks (cl_to,cl_type,cl_sortkey,cl_from);
562
563 -- Not really used?
564 CREATE INDEX /*i*/cl_timestamp ON /*_*/categorylinks (cl_to,cl_timestamp);
565
566 -- For finding rows with outdated collation
567 CREATE INDEX /*i*/cl_collation ON /*_*/categorylinks (cl_collation);
568
569 --
570 -- Track all existing categories. Something is a category if 1) it has an en-
571 -- try somewhere in categorylinks, or 2) it once did. Categories might not
572 -- have corresponding pages, so they need to be tracked separately.
573 --
574 CREATE TABLE /*_*/category (
575 -- Primary key
576 cat_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
577
578 -- Name of the category, in the same form as page_title (with underscores).
579 -- If there is a category page corresponding to this category, by definition,
580 -- it has this name (in the Category namespace).
581 cat_title varchar(255) binary NOT NULL,
582
583 -- The numbers of member pages (including categories and media), subcatego-
584 -- ries, and Image: namespace members, respectively. These are signed to
585 -- make underflow more obvious. We make the first number include the second
586 -- two for better sorting: subtracting for display is easy, adding for order-
587 -- ing is not.
588 cat_pages int signed NOT NULL default 0,
589 cat_subcats int signed NOT NULL default 0,
590 cat_files int signed NOT NULL default 0
591 ) /*$wgDBTableOptions*/;
592
593 CREATE UNIQUE INDEX /*i*/cat_title ON /*_*/category (cat_title);
594
595 -- For Special:Mostlinkedcategories
596 CREATE INDEX /*i*/cat_pages ON /*_*/category (cat_pages);
597
598
599 --
600 -- Track links to external URLs
601 --
602 CREATE TABLE /*_*/externallinks (
603 -- page_id of the referring page
604 el_from int unsigned NOT NULL default 0,
605
606 -- The URL
607 el_to blob NOT NULL,
608
609 -- In the case of HTTP URLs, this is the URL with any username or password
610 -- removed, and with the labels in the hostname reversed and converted to
611 -- lower case. An extra dot is added to allow for matching of either
612 -- example.com or *.example.com in a single scan.
613 -- Example:
614 -- http://user:password@sub.example.com/page.html
615 -- becomes
616 -- http://com.example.sub./page.html
617 -- which allows for fast searching for all pages under example.com with the
618 -- clause:
619 -- WHERE el_index LIKE 'http://com.example.%'
620 el_index blob NOT NULL
621 ) /*$wgDBTableOptions*/;
622
623 CREATE INDEX /*i*/el_from ON /*_*/externallinks (el_from, el_to(40));
624 CREATE INDEX /*i*/el_to ON /*_*/externallinks (el_to(60), el_from);
625 CREATE INDEX /*i*/el_index ON /*_*/externallinks (el_index(60));
626
627
628 --
629 -- Track external user accounts, if ExternalAuth is used
630 --
631 CREATE TABLE /*_*/external_user (
632 -- Foreign key to user_id
633 eu_local_id int unsigned NOT NULL PRIMARY KEY,
634
635 -- Some opaque identifier provided by the external database
636 eu_external_id varchar(255) binary NOT NULL
637 ) /*$wgDBTableOptions*/;
638
639 CREATE UNIQUE INDEX /*i*/eu_external_id ON /*_*/external_user (eu_external_id);
640
641
642 --
643 -- Track interlanguage links
644 --
645 CREATE TABLE /*_*/langlinks (
646 -- page_id of the referring page
647 ll_from int unsigned NOT NULL default 0,
648
649 -- Language code of the target
650 ll_lang varbinary(20) NOT NULL default '',
651
652 -- Title of the target, including namespace
653 ll_title varchar(255) binary NOT NULL default ''
654 ) /*$wgDBTableOptions*/;
655
656 CREATE UNIQUE INDEX /*i*/ll_from ON /*_*/langlinks (ll_from, ll_lang);
657 CREATE INDEX /*i*/ll_lang ON /*_*/langlinks (ll_lang, ll_title);
658
659
660 --
661 -- Track inline interwiki links
662 --
663 CREATE TABLE /*_*/iwlinks (
664 -- page_id of the referring page
665 iwl_from int unsigned NOT NULL default 0,
666
667 -- Interwiki prefix code of the target
668 iwl_prefix varbinary(20) NOT NULL default '',
669
670 -- Title of the target, including namespace
671 iwl_title varchar(255) binary NOT NULL default ''
672 ) /*$wgDBTableOptions*/;
673
674 CREATE UNIQUE INDEX /*i*/iwl_from ON /*_*/iwlinks (iwl_from, iwl_prefix, iwl_title);
675 CREATE UNIQUE INDEX /*i*/iwl_prefix_title_from ON /*_*/iwlinks (iwl_prefix, iwl_title, iwl_from);
676
677
678 --
679 -- Contains a single row with some aggregate info
680 -- on the state of the site.
681 --
682 CREATE TABLE /*_*/site_stats (
683 -- The single row should contain 1 here.
684 ss_row_id int unsigned NOT NULL,
685
686 -- Total number of page views, if hit counters are enabled.
687 ss_total_views bigint unsigned default 0,
688
689 -- Total number of edits performed.
690 ss_total_edits bigint unsigned default 0,
691
692 -- An approximate count of pages matching the following criteria:
693 -- * in namespace 0
694 -- * not a redirect
695 -- * contains the text '[['
696 -- See Article::isCountable() in includes/Article.php
697 ss_good_articles bigint unsigned default 0,
698
699 -- Total pages, theoretically equal to SELECT COUNT(*) FROM page; except faster
700 ss_total_pages bigint default '-1',
701
702 -- Number of users, theoretically equal to SELECT COUNT(*) FROM user;
703 ss_users bigint default '-1',
704
705 -- Number of users that still edit
706 ss_active_users bigint default '-1',
707
708 -- Number of images, equivalent to SELECT COUNT(*) FROM image
709 ss_images int default 0
710 ) /*$wgDBTableOptions*/;
711
712 -- Pointless index to assuage developer superstitions
713 CREATE UNIQUE INDEX /*i*/ss_row_id ON /*_*/site_stats (ss_row_id);
714
715
716 --
717 -- Stores an ID for every time any article is visited;
718 -- depending on $wgHitcounterUpdateFreq, it is
719 -- periodically cleared and the page_counter column
720 -- in the page table updated for all the articles
721 -- that have been visited.)
722 --
723 CREATE TABLE /*_*/hitcounter (
724 hc_id int unsigned NOT NULL
725 ) ENGINE=HEAP MAX_ROWS=25000;
726
727
728 --
729 -- The internet is full of jerks, alas. Sometimes it's handy
730 -- to block a vandal or troll account.
731 --
732 CREATE TABLE /*_*/ipblocks (
733 -- Primary key, introduced for privacy.
734 ipb_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
735
736 -- Blocked IP address in dotted-quad form or user name.
737 ipb_address tinyblob NOT NULL,
738
739 -- Blocked user ID or 0 for IP blocks.
740 ipb_user int unsigned NOT NULL default 0,
741
742 -- User ID who made the block.
743 ipb_by int unsigned NOT NULL default 0,
744
745 -- User name of blocker
746 ipb_by_text varchar(255) binary NOT NULL default '',
747
748 -- Text comment made by blocker.
749 ipb_reason tinyblob NOT NULL,
750
751 -- Creation (or refresh) date in standard YMDHMS form.
752 -- IP blocks expire automatically.
753 ipb_timestamp binary(14) NOT NULL default '',
754
755 -- Indicates that the IP address was banned because a banned
756 -- user accessed a page through it. If this is 1, ipb_address
757 -- will be hidden, and the block identified by block ID number.
758 ipb_auto bool NOT NULL default 0,
759
760 -- If set to 1, block applies only to logged-out users
761 ipb_anon_only bool NOT NULL default 0,
762
763 -- Block prevents account creation from matching IP addresses
764 ipb_create_account bool NOT NULL default 1,
765
766 -- Block triggers autoblocks
767 ipb_enable_autoblock bool NOT NULL default '1',
768
769 -- Time at which the block will expire.
770 -- May be "infinity"
771 ipb_expiry varbinary(14) NOT NULL default '',
772
773 -- Start and end of an address range, in hexadecimal
774 -- Size chosen to allow IPv6
775 ipb_range_start tinyblob NOT NULL,
776 ipb_range_end tinyblob NOT NULL,
777
778 -- Flag for entries hidden from users and Sysops
779 ipb_deleted bool NOT NULL default 0,
780
781 -- Block prevents user from accessing Special:Emailuser
782 ipb_block_email bool NOT NULL default 0,
783
784 -- Block allows user to edit their own talk page
785 ipb_allow_usertalk bool NOT NULL default 0,
786
787 -- ID of the block that caused this block to exist
788 -- Autoblocks set this to the original block
789 -- so that the original block being deleted also
790 -- deletes the autoblocks
791 ipb_parent_block_id int default NULL
792
793 ) /*$wgDBTableOptions*/;
794
795 -- Unique index to support "user already blocked" messages
796 -- Any new options which prevent collisions should be included
797 CREATE UNIQUE INDEX /*i*/ipb_address ON /*_*/ipblocks (ipb_address(255), ipb_user, ipb_auto, ipb_anon_only);
798
799 CREATE INDEX /*i*/ipb_user ON /*_*/ipblocks (ipb_user);
800 CREATE INDEX /*i*/ipb_range ON /*_*/ipblocks (ipb_range_start(8), ipb_range_end(8));
801 CREATE INDEX /*i*/ipb_timestamp ON /*_*/ipblocks (ipb_timestamp);
802 CREATE INDEX /*i*/ipb_expiry ON /*_*/ipblocks (ipb_expiry);
803 CREATE INDEX /*i*/ipb_parent_block_id ON /*_*/ipblocks (ipb_parent_block_id);
804
805
806 --
807 -- Uploaded images and other files.
808 --
809 CREATE TABLE /*_*/image (
810 -- Filename.
811 -- This is also the title of the associated description page,
812 -- which will be in namespace 6 (NS_FILE).
813 img_name varchar(255) binary NOT NULL default '' PRIMARY KEY,
814
815 -- File size in bytes.
816 img_size int unsigned NOT NULL default 0,
817
818 -- For images, size in pixels.
819 img_width int NOT NULL default 0,
820 img_height int NOT NULL default 0,
821
822 -- Extracted EXIF metadata stored as a serialized PHP array.
823 img_metadata mediumblob NOT NULL,
824
825 -- For images, bits per pixel if known.
826 img_bits int NOT NULL default 0,
827
828 -- Media type as defined by the MEDIATYPE_xxx constants
829 img_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
830
831 -- major part of a MIME media type as defined by IANA
832 -- see http://www.iana.org/assignments/media-types/
833 img_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
834
835 -- minor part of a MIME media type as defined by IANA
836 -- the minor parts are not required to adher to any standard
837 -- but should be consistent throughout the database
838 -- see http://www.iana.org/assignments/media-types/
839 img_minor_mime varbinary(100) NOT NULL default "unknown",
840
841 -- Description field as entered by the uploader.
842 -- This is displayed in image upload history and logs.
843 img_description tinyblob NOT NULL,
844
845 -- user_id and user_name of uploader.
846 img_user int unsigned NOT NULL default 0,
847 img_user_text varchar(255) binary NOT NULL,
848
849 -- Time of the upload.
850 img_timestamp varbinary(14) NOT NULL default '',
851
852 -- SHA-1 content hash in base-36
853 img_sha1 varbinary(32) NOT NULL default ''
854 ) /*$wgDBTableOptions*/;
855
856 CREATE INDEX /*i*/img_usertext_timestamp ON /*_*/image (img_user_text,img_timestamp);
857 -- Used by Special:ListFiles for sort-by-size
858 CREATE INDEX /*i*/img_size ON /*_*/image (img_size);
859 -- Used by Special:Newimages and Special:ListFiles
860 CREATE INDEX /*i*/img_timestamp ON /*_*/image (img_timestamp);
861 -- Used in API and duplicate search
862 CREATE INDEX /*i*/img_sha1 ON /*_*/image (img_sha1(10));
863
864
865 --
866 -- Previous revisions of uploaded files.
867 -- Awkwardly, image rows have to be moved into
868 -- this table at re-upload time.
869 --
870 CREATE TABLE /*_*/oldimage (
871 -- Base filename: key to image.img_name
872 oi_name varchar(255) binary NOT NULL default '',
873
874 -- Filename of the archived file.
875 -- This is generally a timestamp and '!' prepended to the base name.
876 oi_archive_name varchar(255) binary NOT NULL default '',
877
878 -- Other fields as in image...
879 oi_size int unsigned NOT NULL default 0,
880 oi_width int NOT NULL default 0,
881 oi_height int NOT NULL default 0,
882 oi_bits int NOT NULL default 0,
883 oi_description tinyblob NOT NULL,
884 oi_user int unsigned NOT NULL default 0,
885 oi_user_text varchar(255) binary NOT NULL,
886 oi_timestamp binary(14) NOT NULL default '',
887
888 oi_metadata mediumblob NOT NULL,
889 oi_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
890 oi_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
891 oi_minor_mime varbinary(100) NOT NULL default "unknown",
892 oi_deleted tinyint unsigned NOT NULL default 0,
893 oi_sha1 varbinary(32) NOT NULL default ''
894 ) /*$wgDBTableOptions*/;
895
896 CREATE INDEX /*i*/oi_usertext_timestamp ON /*_*/oldimage (oi_user_text,oi_timestamp);
897 CREATE INDEX /*i*/oi_name_timestamp ON /*_*/oldimage (oi_name,oi_timestamp);
898 -- oi_archive_name truncated to 14 to avoid key length overflow
899 CREATE INDEX /*i*/oi_name_archive_name ON /*_*/oldimage (oi_name,oi_archive_name(14));
900 CREATE INDEX /*i*/oi_sha1 ON /*_*/oldimage (oi_sha1(10));
901
902
903 --
904 -- Record of deleted file data
905 --
906 CREATE TABLE /*_*/filearchive (
907 -- Unique row id
908 fa_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
909
910 -- Original base filename; key to image.img_name, page.page_title, etc
911 fa_name varchar(255) binary NOT NULL default '',
912
913 -- Filename of archived file, if an old revision
914 fa_archive_name varchar(255) binary default '',
915
916 -- Which storage bin (directory tree or object store) the file data
917 -- is stored in. Should be 'deleted' for files that have been deleted;
918 -- any other bin is not yet in use.
919 fa_storage_group varbinary(16),
920
921 -- SHA-1 of the file contents plus extension, used as a key for storage.
922 -- eg 8f8a562add37052a1848ff7771a2c515db94baa9.jpg
923 --
924 -- If NULL, the file was missing at deletion time or has been purged
925 -- from the archival storage.
926 fa_storage_key varbinary(64) default '',
927
928 -- Deletion information, if this file is deleted.
929 fa_deleted_user int,
930 fa_deleted_timestamp binary(14) default '',
931 fa_deleted_reason text,
932
933 -- Duped fields from image
934 fa_size int unsigned default 0,
935 fa_width int default 0,
936 fa_height int default 0,
937 fa_metadata mediumblob,
938 fa_bits int default 0,
939 fa_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
940 fa_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") default "unknown",
941 fa_minor_mime varbinary(100) default "unknown",
942 fa_description tinyblob,
943 fa_user int unsigned default 0,
944 fa_user_text varchar(255) binary,
945 fa_timestamp binary(14) default '',
946
947 -- Visibility of deleted revisions, bitfield
948 fa_deleted tinyint unsigned NOT NULL default 0
949 ) /*$wgDBTableOptions*/;
950
951 -- pick out by image name
952 CREATE INDEX /*i*/fa_name ON /*_*/filearchive (fa_name, fa_timestamp);
953 -- pick out dupe files
954 CREATE INDEX /*i*/fa_storage_group ON /*_*/filearchive (fa_storage_group, fa_storage_key);
955 -- sort by deletion time
956 CREATE INDEX /*i*/fa_deleted_timestamp ON /*_*/filearchive (fa_deleted_timestamp);
957 -- sort by uploader
958 CREATE INDEX /*i*/fa_user_timestamp ON /*_*/filearchive (fa_user_text,fa_timestamp);
959
960
961 --
962 -- Store information about newly uploaded files before they're
963 -- moved into the actual filestore
964 --
965 CREATE TABLE /*_*/uploadstash (
966 us_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
967
968 -- the user who uploaded the file.
969 us_user int unsigned NOT NULL,
970
971 -- file key. this is how applications actually search for the file.
972 -- this might go away, or become the primary key.
973 us_key varchar(255) NOT NULL,
974
975 -- the original path
976 us_orig_path varchar(255) NOT NULL,
977
978 -- the temporary path at which the file is actually stored
979 us_path varchar(255) NOT NULL,
980
981 -- which type of upload the file came from (sometimes)
982 us_source_type varchar(50),
983
984 -- the date/time on which the file was added
985 us_timestamp varbinary(14) NOT NULL,
986
987 us_status varchar(50) NOT NULL,
988
989 -- chunk counter starts at 0, current offset is stored in us_size
990 us_chunk_inx int unsigned NULL,
991
992 -- file properties from File::getPropsFromPath. these may prove unnecessary.
993 --
994 us_size int unsigned NOT NULL,
995 -- this hash comes from File::sha1Base36(), and is 31 characters
996 us_sha1 varchar(31) NOT NULL,
997 us_mime varchar(255),
998 -- Media type as defined by the MEDIATYPE_xxx constants, should duplicate definition in the image table
999 us_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
1000 -- image-specific properties
1001 us_image_width int unsigned,
1002 us_image_height int unsigned,
1003 us_image_bits smallint unsigned
1004
1005 ) /*$wgDBTableOptions*/;
1006
1007 -- sometimes there's a delete for all of a user's stuff.
1008 CREATE INDEX /*i*/us_user ON /*_*/uploadstash (us_user);
1009 -- pick out files by key, enforce key uniqueness
1010 CREATE UNIQUE INDEX /*i*/us_key ON /*_*/uploadstash (us_key);
1011 -- the abandoned upload cleanup script needs this
1012 CREATE INDEX /*i*/us_timestamp ON /*_*/uploadstash (us_timestamp);
1013
1014
1015 --
1016 -- Primarily a summary table for Special:Recentchanges,
1017 -- this table contains some additional info on edits from
1018 -- the last few days, see Article::editUpdates()
1019 --
1020 CREATE TABLE /*_*/recentchanges (
1021 rc_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
1022 rc_timestamp varbinary(14) NOT NULL default '',
1023
1024 -- This is no longer used
1025 rc_cur_time varbinary(14) NOT NULL default '',
1026
1027 -- As in revision
1028 rc_user int unsigned NOT NULL default 0,
1029 rc_user_text varchar(255) binary NOT NULL,
1030
1031 -- When pages are renamed, their RC entries do _not_ change.
1032 rc_namespace int NOT NULL default 0,
1033 rc_title varchar(255) binary NOT NULL default '',
1034
1035 -- as in revision...
1036 rc_comment varchar(255) binary NOT NULL default '',
1037 rc_minor tinyint unsigned NOT NULL default 0,
1038
1039 -- Edits by user accounts with the 'bot' rights key are
1040 -- marked with a 1 here, and will be hidden from the
1041 -- default view.
1042 rc_bot tinyint unsigned NOT NULL default 0,
1043
1044 -- Set if this change corresponds to a page creation
1045 rc_new tinyint unsigned NOT NULL default 0,
1046
1047 -- Key to page_id (was cur_id prior to 1.5).
1048 -- This will keep links working after moves while
1049 -- retaining the at-the-time name in the changes list.
1050 rc_cur_id int unsigned NOT NULL default 0,
1051
1052 -- rev_id of the given revision
1053 rc_this_oldid int unsigned NOT NULL default 0,
1054
1055 -- rev_id of the prior revision, for generating diff links.
1056 rc_last_oldid int unsigned NOT NULL default 0,
1057
1058 -- The type of change entry (RC_EDIT,RC_NEW,RC_LOG)
1059 rc_type tinyint unsigned NOT NULL default 0,
1060
1061 -- If the Recent Changes Patrol option is enabled,
1062 -- users may mark edits as having been reviewed to
1063 -- remove a warning flag on the RC list.
1064 -- A value of 1 indicates the page has been reviewed.
1065 rc_patrolled tinyint unsigned NOT NULL default 0,
1066
1067 -- Recorded IP address the edit was made from, if the
1068 -- $wgPutIPinRC option is enabled.
1069 rc_ip varbinary(40) NOT NULL default '',
1070
1071 -- Text length in characters before
1072 -- and after the edit
1073 rc_old_len int,
1074 rc_new_len int,
1075
1076 -- Visibility of recent changes items, bitfield
1077 rc_deleted tinyint unsigned NOT NULL default 0,
1078
1079 -- Value corresonding to log_id, specific log entries
1080 rc_logid int unsigned NOT NULL default 0,
1081 -- Store log type info here, or null
1082 rc_log_type varbinary(255) NULL default NULL,
1083 -- Store log action or null
1084 rc_log_action varbinary(255) NULL default NULL,
1085 -- Log params
1086 rc_params blob NULL
1087 ) /*$wgDBTableOptions*/;
1088
1089 CREATE INDEX /*i*/rc_timestamp ON /*_*/recentchanges (rc_timestamp);
1090 CREATE INDEX /*i*/rc_namespace_title ON /*_*/recentchanges (rc_namespace, rc_title);
1091 CREATE INDEX /*i*/rc_cur_id ON /*_*/recentchanges (rc_cur_id);
1092 CREATE INDEX /*i*/new_name_timestamp ON /*_*/recentchanges (rc_new,rc_namespace,rc_timestamp);
1093 CREATE INDEX /*i*/rc_ip ON /*_*/recentchanges (rc_ip);
1094 CREATE INDEX /*i*/rc_ns_usertext ON /*_*/recentchanges (rc_namespace, rc_user_text);
1095 CREATE INDEX /*i*/rc_user_text ON /*_*/recentchanges (rc_user_text, rc_timestamp);
1096
1097
1098 CREATE TABLE /*_*/watchlist (
1099 -- Key to user.user_id
1100 wl_user int unsigned NOT NULL,
1101
1102 -- Key to page_namespace/page_title
1103 -- Note that users may watch pages which do not exist yet,
1104 -- or existed in the past but have been deleted.
1105 wl_namespace int NOT NULL default 0,
1106 wl_title varchar(255) binary NOT NULL default '',
1107
1108 -- Timestamp when user was last sent a notification e-mail;
1109 -- cleared when the user visits the page.
1110 wl_notificationtimestamp varbinary(14)
1111
1112 ) /*$wgDBTableOptions*/;
1113
1114 CREATE UNIQUE INDEX /*i*/wl_user ON /*_*/watchlist (wl_user, wl_namespace, wl_title);
1115 CREATE INDEX /*i*/namespace_title ON /*_*/watchlist (wl_namespace, wl_title);
1116
1117
1118 --
1119 -- When using the default MySQL search backend, page titles
1120 -- and text are munged to strip markup, do Unicode case folding,
1121 -- and prepare the result for MySQL's fulltext index.
1122 --
1123 -- This table must be MyISAM; InnoDB does not support the needed
1124 -- fulltext index.
1125 --
1126 CREATE TABLE /*_*/searchindex (
1127 -- Key to page_id
1128 si_page int unsigned NOT NULL,
1129
1130 -- Munged version of title
1131 si_title varchar(255) NOT NULL default '',
1132
1133 -- Munged version of body text
1134 si_text mediumtext NOT NULL
1135 ) ENGINE=MyISAM;
1136
1137 CREATE UNIQUE INDEX /*i*/si_page ON /*_*/searchindex (si_page);
1138 CREATE FULLTEXT INDEX /*i*/si_title ON /*_*/searchindex (si_title);
1139 CREATE FULLTEXT INDEX /*i*/si_text ON /*_*/searchindex (si_text);
1140
1141
1142 --
1143 -- Recognized interwiki link prefixes
1144 --
1145 CREATE TABLE /*_*/interwiki (
1146 -- The interwiki prefix, (e.g. "Meatball", or the language prefix "de")
1147 iw_prefix varchar(32) NOT NULL,
1148
1149 -- The URL of the wiki, with "$1" as a placeholder for an article name.
1150 -- Any spaces in the name will be transformed to underscores before
1151 -- insertion.
1152 iw_url blob NOT NULL,
1153
1154 -- The URL of the file api.php
1155 iw_api blob NOT NULL,
1156
1157 -- The name of the database (for a connection to be established with wfGetLB( 'wikiid' ))
1158 iw_wikiid varchar(64) NOT NULL,
1159
1160 -- A boolean value indicating whether the wiki is in this project
1161 -- (used, for example, to detect redirect loops)
1162 iw_local bool NOT NULL,
1163
1164 -- Boolean value indicating whether interwiki transclusions are allowed.
1165 iw_trans tinyint NOT NULL default 0
1166 ) /*$wgDBTableOptions*/;
1167
1168 CREATE UNIQUE INDEX /*i*/iw_prefix ON /*_*/interwiki (iw_prefix);
1169
1170
1171 --
1172 -- Used for caching expensive grouped queries
1173 --
1174 CREATE TABLE /*_*/querycache (
1175 -- A key name, generally the base name of of the special page.
1176 qc_type varbinary(32) NOT NULL,
1177
1178 -- Some sort of stored value. Sizes, counts...
1179 qc_value int unsigned NOT NULL default 0,
1180
1181 -- Target namespace+title
1182 qc_namespace int NOT NULL default 0,
1183 qc_title varchar(255) binary NOT NULL default ''
1184 ) /*$wgDBTableOptions*/;
1185
1186 CREATE INDEX /*i*/qc_type ON /*_*/querycache (qc_type,qc_value);
1187
1188
1189 --
1190 -- For a few generic cache operations if not using Memcached
1191 --
1192 CREATE TABLE /*_*/objectcache (
1193 keyname varbinary(255) NOT NULL default '' PRIMARY KEY,
1194 value mediumblob,
1195 exptime datetime
1196 ) /*$wgDBTableOptions*/;
1197 CREATE INDEX /*i*/exptime ON /*_*/objectcache (exptime);
1198
1199
1200 --
1201 -- Cache of interwiki transclusion
1202 --
1203 CREATE TABLE /*_*/transcache (
1204 tc_url varbinary(255) NOT NULL,
1205 tc_contents text,
1206 tc_time binary(14) NOT NULL
1207 ) /*$wgDBTableOptions*/;
1208
1209 CREATE UNIQUE INDEX /*i*/tc_url_idx ON /*_*/transcache (tc_url);
1210
1211
1212 CREATE TABLE /*_*/logging (
1213 -- Log ID, for referring to this specific log entry, probably for deletion and such.
1214 log_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1215
1216 -- Symbolic keys for the general log type and the action type
1217 -- within the log. The output format will be controlled by the
1218 -- action field, but only the type controls categorization.
1219 log_type varbinary(32) NOT NULL default '',
1220 log_action varbinary(32) NOT NULL default '',
1221
1222 -- Timestamp. Duh.
1223 log_timestamp binary(14) NOT NULL default '19700101000000',
1224
1225 -- The user who performed this action; key to user_id
1226 log_user int unsigned NOT NULL default 0,
1227
1228 -- Name of the user who performed this action
1229 log_user_text varchar(255) binary NOT NULL default '',
1230
1231 -- Key to the page affected. Where a user is the target,
1232 -- this will point to the user page.
1233 log_namespace int NOT NULL default 0,
1234 log_title varchar(255) binary NOT NULL default '',
1235 log_page int unsigned NULL,
1236
1237 -- Freeform text. Interpreted as edit history comments.
1238 log_comment varchar(255) NOT NULL default '',
1239
1240 -- LF separated list of miscellaneous parameters
1241 log_params blob NOT NULL,
1242
1243 -- rev_deleted for logs
1244 log_deleted tinyint unsigned NOT NULL default 0
1245 ) /*$wgDBTableOptions*/;
1246
1247 CREATE INDEX /*i*/type_time ON /*_*/logging (log_type, log_timestamp);
1248 CREATE INDEX /*i*/user_time ON /*_*/logging (log_user, log_timestamp);
1249 CREATE INDEX /*i*/page_time ON /*_*/logging (log_namespace, log_title, log_timestamp);
1250 CREATE INDEX /*i*/times ON /*_*/logging (log_timestamp);
1251 CREATE INDEX /*i*/log_user_type_time ON /*_*/logging (log_user, log_type, log_timestamp);
1252 CREATE INDEX /*i*/log_page_id_time ON /*_*/logging (log_page,log_timestamp);
1253 CREATE INDEX /*i*/type_action ON /*_*/logging (log_type, log_action, log_timestamp);
1254
1255
1256 CREATE TABLE /*_*/log_search (
1257 -- The type of ID (rev ID, log ID, rev timestamp, username)
1258 ls_field varbinary(32) NOT NULL,
1259 -- The value of the ID
1260 ls_value varchar(255) NOT NULL,
1261 -- Key to log_id
1262 ls_log_id int unsigned NOT NULL default 0
1263 ) /*$wgDBTableOptions*/;
1264 CREATE UNIQUE INDEX /*i*/ls_field_val ON /*_*/log_search (ls_field,ls_value,ls_log_id);
1265 CREATE INDEX /*i*/ls_log_id ON /*_*/log_search (ls_log_id);
1266
1267
1268 -- Jobs performed by parallel apache threads or a command-line daemon
1269 CREATE TABLE /*_*/job (
1270 job_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1271
1272 -- Command name
1273 -- Limited to 60 to prevent key length overflow
1274 job_cmd varbinary(60) NOT NULL default '',
1275
1276 -- Namespace and title to act on
1277 -- Should be 0 and '' if the command does not operate on a title
1278 job_namespace int NOT NULL,
1279 job_title varchar(255) binary NOT NULL,
1280
1281 -- Timestamp of when the job was inserted
1282 -- NULL for jobs added before addition of the timestamp
1283 job_timestamp varbinary(14) NULL default NULL,
1284
1285 -- Any other parameters to the command
1286 -- Stored as a PHP serialized array, or an empty string if there are no parameters
1287 job_params blob NOT NULL
1288 ) /*$wgDBTableOptions*/;
1289
1290 CREATE INDEX /*i*/job_cmd ON /*_*/job (job_cmd, job_namespace, job_title, job_params(128));
1291 CREATE INDEX /*i*/job_timestamp ON /*_*/job (job_timestamp);
1292
1293
1294 -- Details of updates to cached special pages
1295 CREATE TABLE /*_*/querycache_info (
1296 -- Special page name
1297 -- Corresponds to a qc_type value
1298 qci_type varbinary(32) NOT NULL default '',
1299
1300 -- Timestamp of last update
1301 qci_timestamp binary(14) NOT NULL default '19700101000000'
1302 ) /*$wgDBTableOptions*/;
1303
1304 CREATE UNIQUE INDEX /*i*/qci_type ON /*_*/querycache_info (qci_type);
1305
1306
1307 -- For each redirect, this table contains exactly one row defining its target
1308 CREATE TABLE /*_*/redirect (
1309 -- Key to the page_id of the redirect page
1310 rd_from int unsigned NOT NULL default 0 PRIMARY KEY,
1311
1312 -- Key to page_namespace/page_title of the target page.
1313 -- The target page may or may not exist, and due to renames
1314 -- and deletions may refer to different page records as time
1315 -- goes by.
1316 rd_namespace int NOT NULL default 0,
1317 rd_title varchar(255) binary NOT NULL default '',
1318 rd_interwiki varchar(32) default NULL,
1319 rd_fragment varchar(255) binary default NULL
1320 ) /*$wgDBTableOptions*/;
1321
1322 CREATE INDEX /*i*/rd_ns_title ON /*_*/redirect (rd_namespace,rd_title,rd_from);
1323
1324
1325 -- Used for caching expensive grouped queries that need two links (for example double-redirects)
1326 CREATE TABLE /*_*/querycachetwo (
1327 -- A key name, generally the base name of of the special page.
1328 qcc_type varbinary(32) NOT NULL,
1329
1330 -- Some sort of stored value. Sizes, counts...
1331 qcc_value int unsigned NOT NULL default 0,
1332
1333 -- Target namespace+title
1334 qcc_namespace int NOT NULL default 0,
1335 qcc_title varchar(255) binary NOT NULL default '',
1336
1337 -- Target namespace+title2
1338 qcc_namespacetwo int NOT NULL default 0,
1339 qcc_titletwo varchar(255) binary NOT NULL default ''
1340 ) /*$wgDBTableOptions*/;
1341
1342 CREATE INDEX /*i*/qcc_type ON /*_*/querycachetwo (qcc_type,qcc_value);
1343 CREATE INDEX /*i*/qcc_title ON /*_*/querycachetwo (qcc_type,qcc_namespace,qcc_title);
1344 CREATE INDEX /*i*/qcc_titletwo ON /*_*/querycachetwo (qcc_type,qcc_namespacetwo,qcc_titletwo);
1345
1346
1347 -- Used for storing page restrictions (i.e. protection levels)
1348 CREATE TABLE /*_*/page_restrictions (
1349 -- Page to apply restrictions to (Foreign Key to page).
1350 pr_page int NOT NULL,
1351 -- The protection type (edit, move, etc)
1352 pr_type varbinary(60) NOT NULL,
1353 -- The protection level (Sysop, autoconfirmed, etc)
1354 pr_level varbinary(60) NOT NULL,
1355 -- Whether or not to cascade the protection down to pages transcluded.
1356 pr_cascade tinyint NOT NULL,
1357 -- Field for future support of per-user restriction.
1358 pr_user int NULL,
1359 -- Field for time-limited protection.
1360 pr_expiry varbinary(14) NULL,
1361 -- Field for an ID for this restrictions row (sort-key for Special:ProtectedPages)
1362 pr_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT
1363 ) /*$wgDBTableOptions*/;
1364
1365 CREATE UNIQUE INDEX /*i*/pr_pagetype ON /*_*/page_restrictions (pr_page,pr_type);
1366 CREATE INDEX /*i*/pr_typelevel ON /*_*/page_restrictions (pr_type,pr_level);
1367 CREATE INDEX /*i*/pr_level ON /*_*/page_restrictions (pr_level);
1368 CREATE INDEX /*i*/pr_cascade ON /*_*/page_restrictions (pr_cascade);
1369
1370
1371 -- Protected titles - nonexistent pages that have been protected
1372 CREATE TABLE /*_*/protected_titles (
1373 pt_namespace int NOT NULL,
1374 pt_title varchar(255) binary NOT NULL,
1375 pt_user int unsigned NOT NULL,
1376 pt_reason tinyblob,
1377 pt_timestamp binary(14) NOT NULL,
1378 pt_expiry varbinary(14) NOT NULL default '',
1379 pt_create_perm varbinary(60) NOT NULL
1380 ) /*$wgDBTableOptions*/;
1381
1382 CREATE UNIQUE INDEX /*i*/pt_namespace_title ON /*_*/protected_titles (pt_namespace,pt_title);
1383 CREATE INDEX /*i*/pt_timestamp ON /*_*/protected_titles (pt_timestamp);
1384
1385
1386 -- Name/value pairs indexed by page_id
1387 CREATE TABLE /*_*/page_props (
1388 pp_page int NOT NULL,
1389 pp_propname varbinary(60) NOT NULL,
1390 pp_value blob NOT NULL
1391 ) /*$wgDBTableOptions*/;
1392
1393 CREATE UNIQUE INDEX /*i*/pp_page_propname ON /*_*/page_props (pp_page,pp_propname);
1394
1395
1396 -- A table to log updates, one text key row per update.
1397 CREATE TABLE /*_*/updatelog (
1398 ul_key varchar(255) NOT NULL PRIMARY KEY,
1399 ul_value blob
1400 ) /*$wgDBTableOptions*/;
1401
1402
1403 -- A table to track tags for revisions, logs and recent changes.
1404 CREATE TABLE /*_*/change_tag (
1405 -- RCID for the change
1406 ct_rc_id int NULL,
1407 -- LOGID for the change
1408 ct_log_id int NULL,
1409 -- REVID for the change
1410 ct_rev_id int NULL,
1411 -- Tag applied
1412 ct_tag varchar(255) NOT NULL,
1413 -- Parameters for the tag, presently unused
1414 ct_params blob NULL
1415 ) /*$wgDBTableOptions*/;
1416
1417 CREATE UNIQUE INDEX /*i*/change_tag_rc_tag ON /*_*/change_tag (ct_rc_id,ct_tag);
1418 CREATE UNIQUE INDEX /*i*/change_tag_log_tag ON /*_*/change_tag (ct_log_id,ct_tag);
1419 CREATE UNIQUE INDEX /*i*/change_tag_rev_tag ON /*_*/change_tag (ct_rev_id,ct_tag);
1420 -- Covering index, so we can pull all the info only out of the index.
1421 CREATE INDEX /*i*/change_tag_tag_id ON /*_*/change_tag (ct_tag,ct_rc_id,ct_rev_id,ct_log_id);
1422
1423
1424 -- Rollup table to pull a LIST of tags simply without ugly GROUP_CONCAT
1425 -- that only works on MySQL 4.1+
1426 CREATE TABLE /*_*/tag_summary (
1427 -- RCID for the change
1428 ts_rc_id int NULL,
1429 -- LOGID for the change
1430 ts_log_id int NULL,
1431 -- REVID for the change
1432 ts_rev_id int NULL,
1433 -- Comma-separated list of tags
1434 ts_tags blob NOT NULL
1435 ) /*$wgDBTableOptions*/;
1436
1437 CREATE UNIQUE INDEX /*i*/tag_summary_rc_id ON /*_*/tag_summary (ts_rc_id);
1438 CREATE UNIQUE INDEX /*i*/tag_summary_log_id ON /*_*/tag_summary (ts_log_id);
1439 CREATE UNIQUE INDEX /*i*/tag_summary_rev_id ON /*_*/tag_summary (ts_rev_id);
1440
1441
1442 CREATE TABLE /*_*/valid_tag (
1443 vt_tag varchar(255) NOT NULL PRIMARY KEY
1444 ) /*$wgDBTableOptions*/;
1445
1446 -- Table for storing localisation data
1447 CREATE TABLE /*_*/l10n_cache (
1448 -- Language code
1449 lc_lang varbinary(32) NOT NULL,
1450 -- Cache key
1451 lc_key varchar(255) NOT NULL,
1452 -- Value
1453 lc_value mediumblob NOT NULL
1454 ) /*$wgDBTableOptions*/;
1455 CREATE INDEX /*i*/lc_lang_key ON /*_*/l10n_cache (lc_lang, lc_key);
1456
1457 -- Table for caching JSON message blobs for the resource loader
1458 CREATE TABLE /*_*/msg_resource (
1459 -- Resource name
1460 mr_resource varbinary(255) NOT NULL,
1461 -- Language code
1462 mr_lang varbinary(32) NOT NULL,
1463 -- JSON blob
1464 mr_blob mediumblob NOT NULL,
1465 -- Timestamp of last update
1466 mr_timestamp binary(14) NOT NULL
1467 ) /*$wgDBTableOptions*/;
1468 CREATE UNIQUE INDEX /*i*/mr_resource_lang ON /*_*/msg_resource (mr_resource, mr_lang);
1469
1470 -- Table for administering which message is contained in which resource
1471 CREATE TABLE /*_*/msg_resource_links (
1472 mrl_resource varbinary(255) NOT NULL,
1473 -- Message key
1474 mrl_message varbinary(255) NOT NULL
1475 ) /*$wgDBTableOptions*/;
1476 CREATE UNIQUE INDEX /*i*/mrl_message_resource ON /*_*/msg_resource_links (mrl_message, mrl_resource);
1477
1478 -- Table caching which local files a module depends on that aren't
1479 -- registered directly, used for fast retrieval of file dependency.
1480 -- Currently only used for tracking images that CSS depends on
1481 CREATE TABLE /*_*/module_deps (
1482 -- Module name
1483 md_module varbinary(255) NOT NULL,
1484 -- Skin name
1485 md_skin varbinary(32) NOT NULL,
1486 -- JSON blob with file dependencies
1487 md_deps mediumblob NOT NULL
1488 ) /*$wgDBTableOptions*/;
1489 CREATE UNIQUE INDEX /*i*/md_module_skin ON /*_*/module_deps (md_module, md_skin);
1490
1491 -- Table for holding configuration changes
1492 CREATE TABLE /*_*/config (
1493 -- Config var name
1494 cf_name varbinary(255) NOT NULL PRIMARY KEY,
1495 -- Config var value
1496 cf_value blob NOT NULL
1497 ) /*$wgDBTableOptions*/;
1498 -- Should cover *most* configuration - strings, ints, bools, etc.
1499 CREATE INDEX /*i*/cf_name_value ON /*_*/config (cf_name,cf_value(255));
1500
1501 -- vim: sw=2 sts=2 et