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.
8 -- If possible, create tables as InnoDB to benefit from the
9 -- superior resiliency against crashes and ability to read
10 -- during writes (and write during reads!)
12 -- Only the 'searchindex' table requires MyISAM due to the
13 -- requirement for fulltext index support, which is missing
17 -- The MySQL table backend for MediaWiki currently uses
18 -- 14-character BINARY or VARBINARY fields to store timestamps.
19 -- The format is YYYYMMDDHHMMSS, which is derived from the
20 -- text format of MySQL's TIMESTAMP fields.
22 -- Historically TIMESTAMP fields were used, but abandoned
23 -- in early 2002 after a lot of trouble with the fields
26 -- The Postgres backend uses DATETIME fields for timestamps,
27 -- and we will migrate the MySQL definitions at some point as
31 -- The /*$wgDBprefix*/ comments in this and other files are
32 -- replaced with the defined table prefix by the installer
33 -- and updater scripts. If you are installing or running
34 -- updates manually, you will need to manually insert the
35 -- table prefix if any when running these scripts.
40 -- The user table contains basic account information,
41 -- authentication keys, etc.
43 -- Some multi-wiki sites may share a single central user table
44 -- between separate wikis using the $wgSharedDB setting.
46 -- Note that when a external authentication plugin is used,
47 -- user table entries still need to be created to store
48 -- preferences and to key tracking information in the other
51 CREATE TABLE /*$wgDBprefix*/user (
52 user_id int unsigned NOT NULL auto_increment,
54 -- Usernames must be unique, must not be in the form of
55 -- an IP address. _Shouldn't_ allow slashes or case
56 -- conflicts. Spaces are allowed, and are _not_ converted
57 -- to underscores like titles. See the User::newFromName() for
58 -- the specific tests that usernames have to pass.
59 user_name varchar(255) binary NOT NULL default '',
61 -- Optional 'real name' to be displayed in credit listings
62 user_real_name varchar(255) binary NOT NULL default '',
64 -- Password hashes, normally hashed like so:
65 -- MD5(CONCAT(user_id,'-',MD5(plaintext_password))), see
66 -- wfEncryptPassword() in GlobalFunctions.php
67 user_password tinyblob NOT NULL,
69 -- When using 'mail me a new password', a random
70 -- password is generated and the hash stored here.
71 -- The previous password is left in place until
72 -- someone actually logs in with the new password,
73 -- at which point the hash is moved to user_password
74 -- and the old password is invalidated.
75 user_newpassword tinyblob NOT NULL,
77 -- Timestamp of the last time when a new password was
78 -- sent, for throttling purposes
79 user_newpass_time binary(14),
81 -- Note: email should be restricted, not public info.
82 -- Same with passwords.
83 user_email tinytext NOT NULL,
85 -- Newline-separated list of name=value defining the user
87 user_options blob NOT NULL,
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 '',
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 '',
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),
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),
110 -- Expiration date for the user_email_token
111 user_email_token_expires binary(14),
113 -- Timestamp of account registration.
114 -- Accounts predating this schema addition may contain NULL.
115 user_registration binary(14),
117 -- Count of edits and edit-like actions.
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
124 -- Meant primarily for heuristic checks to give an impression of whether
125 -- the account has been used much.
129 PRIMARY KEY user_id (user_id),
130 UNIQUE INDEX user_name (user_name),
131 INDEX (user_email_token)
133 ) /*$wgDBTableOptions*/;
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.
140 -- This table replaces the old user_rights field which used a
141 -- comma-separated blob.
143 CREATE TABLE /*$wgDBprefix*/user_groups (
145 ug_user int unsigned NOT NULL default '0',
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.
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(16) NOT NULL default '',
157 PRIMARY KEY (ug_user,ug_group),
159 ) /*$wgDBTableOptions*/;
161 -- Stores notifications of user talk page changes, for the display
162 -- of the "you have new messages" box
163 CREATE TABLE /*$wgDBprefix*/user_newtalk (
164 -- Key to user.user_id
165 user_id int NOT NULL default '0',
166 -- If the user is an anonymous user their IP address is stored here
167 -- since the user_id of 0 is ambiguous
168 user_ip varbinary(40) NOT NULL default '',
169 INDEX user_id (user_id),
170 INDEX user_ip (user_ip)
172 ) /*$wgDBTableOptions*/;
176 -- Core of the wiki: each page has an entry here which identifies
177 -- it by title and contains some essential metadata.
179 CREATE TABLE /*$wgDBprefix*/page (
180 -- Unique identifier number. The page_id will be preserved across
181 -- edits and rename operations, but not deletions and recreations.
182 page_id int unsigned NOT NULL auto_increment,
184 -- A page name is broken into a namespace and a title.
185 -- The namespace keys are UI-language-independent constants,
186 -- defined in includes/Defines.php
187 page_namespace int NOT NULL,
189 -- The rest of the title, as text.
190 -- Spaces are transformed into underscores in title storage.
191 page_title varchar(255) binary NOT NULL,
193 -- Comma-separated set of permission keys indicating who
194 -- can move or edit the page.
195 page_restrictions tinyblob NOT NULL,
197 -- Number of times this page has been viewed.
198 page_counter bigint unsigned NOT NULL default '0',
200 -- 1 indicates the article is a redirect.
201 page_is_redirect tinyint unsigned NOT NULL default '0',
203 -- 1 indicates this is a new entry, with only one edit.
204 -- Not all pages with one edit are new pages.
205 page_is_new tinyint unsigned NOT NULL default '0',
207 -- Random value between 0 and 1, used for Special:Randompage
208 page_random real unsigned NOT NULL,
210 -- This timestamp is updated whenever the page changes in
211 -- a way requiring it to be re-rendered, invalidating caches.
212 -- Aside from editing this includes permission changes,
213 -- creation or deletion of linked pages, and alteration
214 -- of contained templates.
215 page_touched binary(14) NOT NULL default '',
217 -- Handy key to revision.rev_id of the current revision.
218 -- This may be 0 during page creation, but that shouldn't
219 -- happen outside of a transaction... hopefully.
220 page_latest int unsigned NOT NULL,
222 -- Uncompressed length in bytes of the page's current source text.
223 page_len int unsigned NOT NULL,
225 PRIMARY KEY page_id (page_id),
226 UNIQUE INDEX name_title (page_namespace,page_title),
228 -- Special-purpose indexes
232 ) /*$wgDBTableOptions*/;
235 -- Every edit of a page creates also a revision row.
236 -- This stores metadata about the revision, and a reference
237 -- to the text storage backend.
239 CREATE TABLE /*$wgDBprefix*/revision (
240 rev_id int unsigned NOT NULL auto_increment,
242 -- Key to page_id. This should _never_ be invalid.
243 rev_page int unsigned NOT NULL,
245 -- Key to text.old_id, where the actual bulk text is stored.
246 -- It's possible for multiple revisions to use the same text,
247 -- for instance revisions where only metadata is altered
248 -- or a rollback to a previous version.
249 rev_text_id int unsigned NOT NULL,
251 -- Text comment summarizing the change.
252 -- This text is shown in the history and other changes lists,
253 -- rendered in a subset of wiki markup by Linker::formatComment()
254 rev_comment tinyblob NOT NULL,
256 -- Key to user.user_id of the user who made this edit.
257 -- Stores 0 for anonymous edits and for some mass imports.
258 rev_user int unsigned NOT NULL default '0',
260 -- Text username or IP address of the editor.
261 rev_user_text varchar(255) binary NOT NULL default '',
264 rev_timestamp binary(14) NOT NULL default '',
266 -- Records whether the user marked the 'minor edit' checkbox.
267 -- Many automated edits are marked as minor.
268 rev_minor_edit tinyint unsigned NOT NULL default '0',
270 -- Not yet used; reserved for future changes to the deletion system.
271 rev_deleted tinyint unsigned NOT NULL default '0',
273 -- Length of this revision in bytes
274 rev_len int unsigned,
276 -- Key to revision.rev_id
277 -- This field is used to add support for a tree structure (The Adjacency List Model)
278 rev_parent_id int unsigned default NULL,
280 PRIMARY KEY rev_page_id (rev_page, rev_id),
281 UNIQUE INDEX rev_id (rev_id),
282 INDEX rev_timestamp (rev_timestamp),
283 INDEX page_timestamp (rev_page,rev_timestamp),
284 INDEX user_timestamp (rev_user,rev_timestamp),
285 INDEX usertext_timestamp (rev_user_text,rev_timestamp)
287 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=1024;
288 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
291 -- Holds text of individual page revisions.
293 -- Field names are a holdover from the 'old' revisions table in
294 -- MediaWiki 1.4 and earlier: an upgrade will transform that
295 -- table into the 'text' table to minimize unnecessary churning
296 -- and downtime. If upgrading, the other fields will be left unused.
298 CREATE TABLE /*$wgDBprefix*/text (
299 -- Unique text storage key number.
300 -- Note that the 'oldid' parameter used in URLs does *not*
301 -- refer to this number anymore, but to rev_id.
303 -- revision.rev_text_id is a key to this column
304 old_id int unsigned NOT NULL auto_increment,
306 -- Depending on the contents of the old_flags field, the text
307 -- may be convenient plain text, or it may be funkily encoded.
308 old_text mediumblob NOT NULL,
310 -- Comma-separated list of flags:
311 -- gzip: text is compressed with PHP's gzdeflate() function.
312 -- utf8: text was stored as UTF-8.
313 -- If $wgLegacyEncoding option is on, rows *without* this flag
314 -- will be converted to UTF-8 transparently at load time.
315 -- object: text field contained a serialized PHP object.
316 -- The object either contains multiple versions compressed
317 -- together to achieve a better compression ratio, or it refers
318 -- to another row where the text can be found.
319 old_flags tinyblob NOT NULL,
321 PRIMARY KEY old_id (old_id)
323 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=10240;
324 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
327 -- Holding area for deleted articles, which may be viewed
328 -- or restored by admins through the Special:Undelete interface.
329 -- The fields generally correspond to the page, revision, and text
330 -- fields, with several caveats.
332 CREATE TABLE /*$wgDBprefix*/archive (
333 ar_namespace int NOT NULL default '0',
334 ar_title varchar(255) binary NOT NULL default '',
336 -- Newly deleted pages will not store text in this table,
337 -- but will reference the separately existing text rows.
338 -- This field is retained for backwards compatibility,
339 -- so old archived pages will remain accessible after
340 -- upgrading from 1.4 to 1.5.
341 -- Text may be gzipped or otherwise funky.
342 ar_text mediumblob NOT NULL,
344 -- Basic revision stuff...
345 ar_comment tinyblob NOT NULL,
346 ar_user int unsigned NOT NULL default '0',
347 ar_user_text varchar(255) binary NOT NULL,
348 ar_timestamp binary(14) NOT NULL default '',
349 ar_minor_edit tinyint NOT NULL default '0',
352 ar_flags tinyblob NOT NULL,
354 -- When revisions are deleted, their unique rev_id is stored
355 -- here so it can be retained after undeletion. This is necessary
356 -- to retain permalinks to given revisions after accidental delete
357 -- cycles or messy operations like history merges.
359 -- Old entries from 1.4 will be NULL here, and a new rev_id will
360 -- be created on undeletion for those revisions.
361 ar_rev_id int unsigned,
363 -- For newly deleted revisions, this is the text.old_id key to the
364 -- actual stored text. To avoid breaking the block-compression scheme
365 -- and otherwise making storage changes harder, the actual text is
366 -- *not* deleted from the text table, merely hidden by removal of the
367 -- page and revision entries.
369 -- Old entries deleted under 1.2-1.4 will have NULL here, and their
370 -- ar_text and ar_flags fields will be used to create a new text
371 -- row upon undeletion.
372 ar_text_id int unsigned,
374 -- rev_deleted for archives
375 ar_deleted tinyint unsigned NOT NULL default '0',
377 -- Length of this revision in bytes
380 -- Reference to page_id. Useful for sysadmin fixing of large pages
381 -- merged together in the archives, or for cleanly restoring a page
382 -- at its original ID number if possible.
384 -- Will be NULL for pages deleted prior to 1.11.
385 ar_page_id int unsigned,
387 KEY name_title_timestamp (ar_namespace,ar_title,ar_timestamp),
388 KEY usertext_timestamp (ar_user_text,ar_timestamp)
390 ) /*$wgDBTableOptions*/;
394 -- Track page-to-page hyperlinks within the wiki.
396 CREATE TABLE /*$wgDBprefix*/pagelinks (
397 -- Key to the page_id of the page containing the link.
398 pl_from int unsigned NOT NULL default '0',
400 -- Key to page_namespace/page_title of the target page.
401 -- The target page may or may not exist, and due to renames
402 -- and deletions may refer to different page records as time
404 pl_namespace int NOT NULL default '0',
405 pl_title varchar(255) binary NOT NULL default '',
407 UNIQUE KEY pl_from (pl_from,pl_namespace,pl_title),
408 KEY (pl_namespace,pl_title,pl_from)
410 ) /*$wgDBTableOptions*/;
414 -- Track template inclusions.
416 CREATE TABLE /*$wgDBprefix*/templatelinks (
417 -- Key to the page_id of the page containing the link.
418 tl_from int unsigned NOT NULL default '0',
420 -- Key to page_namespace/page_title of the target page.
421 -- The target page may or may not exist, and due to renames
422 -- and deletions may refer to different page records as time
424 tl_namespace int NOT NULL default '0',
425 tl_title varchar(255) binary NOT NULL default '',
427 UNIQUE KEY tl_from (tl_from,tl_namespace,tl_title),
428 KEY (tl_namespace,tl_title,tl_from)
430 ) /*$wgDBTableOptions*/;
433 -- Track links to images *used inline*
434 -- We don't distinguish live from broken links here, so
435 -- they do not need to be changed on upload/removal.
437 CREATE TABLE /*$wgDBprefix*/imagelinks (
438 -- Key to page_id of the page containing the image / media link.
439 il_from int unsigned NOT NULL default '0',
441 -- Filename of target image.
442 -- This is also the page_title of the file's description page;
443 -- all such pages are in namespace 6 (NS_IMAGE).
444 il_to varchar(255) binary NOT NULL default '',
446 UNIQUE KEY il_from (il_from,il_to),
449 ) /*$wgDBTableOptions*/;
452 -- Track category inclusions *used inline*
453 -- This tracks a single level of category membership
454 -- (folksonomic tagging, really).
456 CREATE TABLE /*$wgDBprefix*/categorylinks (
457 -- Key to page_id of the page defined as a category member.
458 cl_from int unsigned NOT NULL default '0',
460 -- Name of the category.
461 -- This is also the page_title of the category's description page;
462 -- all such pages are in namespace 14 (NS_CATEGORY).
463 cl_to varchar(255) binary NOT NULL default '',
465 -- The title of the linking page, or an optional override
466 -- to determine sort order. Sorting is by binary order, which
467 -- isn't always ideal, but collations seem to be an exciting
468 -- and dangerous new world in MySQL... The sortkey is updated
469 -- if no override exists and cl_from is renamed.
471 -- Truncate so that the cl_sortkey key fits in 1000 bytes
472 -- (MyISAM 5 with server_character_set=utf8)
473 cl_sortkey varchar(70) binary NOT NULL default '',
475 -- This isn't really used at present. Provided for an optional
476 -- sorting method by approximate addition time.
477 cl_timestamp timestamp NOT NULL,
479 UNIQUE KEY cl_from (cl_from,cl_to),
481 -- We always sort within a given category...
482 KEY cl_sortkey (cl_to,cl_sortkey,cl_from),
485 KEY cl_timestamp (cl_to,cl_timestamp)
487 ) /*$wgDBTableOptions*/;
490 -- Track links to external URLs
492 CREATE TABLE /*$wgDBprefix*/externallinks (
493 -- page_id of the referring page
494 el_from int unsigned NOT NULL default '0',
499 -- In the case of HTTP URLs, this is the URL with any username or password
500 -- removed, and with the labels in the hostname reversed and converted to
501 -- lower case. An extra dot is added to allow for matching of either
502 -- example.com or *.example.com in a single scan.
504 -- http://user:password@sub.example.com/page.html
506 -- http://com.example.sub./page.html
507 -- which allows for fast searching for all pages under example.com with the
509 -- WHERE el_index LIKE 'http://com.example.%'
510 el_index blob NOT NULL,
512 KEY (el_from, el_to(40)),
513 KEY (el_to(60), el_from),
515 ) /*$wgDBTableOptions*/;
518 -- Track interlanguage links
520 CREATE TABLE /*$wgDBprefix*/langlinks (
521 -- page_id of the referring page
522 ll_from int unsigned NOT NULL default '0',
524 -- Language code of the target
525 ll_lang varbinary(20) NOT NULL default '',
527 -- Title of the target, including namespace
528 ll_title varchar(255) binary NOT NULL default '',
530 UNIQUE KEY (ll_from, ll_lang),
531 KEY (ll_lang, ll_title)
532 ) /*$wgDBTableOptions*/;
535 -- Contains a single row with some aggregate info
536 -- on the state of the site.
538 CREATE TABLE /*$wgDBprefix*/site_stats (
539 -- The single row should contain 1 here.
540 ss_row_id int unsigned NOT NULL,
542 -- Total number of page views, if hit counters are enabled.
543 ss_total_views bigint unsigned default '0',
545 -- Total number of edits performed.
546 ss_total_edits bigint unsigned default '0',
548 -- An approximate count of pages matching the following criteria:
551 -- * contains the text '[['
552 -- See Article::isCountable() in includes/Article.php
553 ss_good_articles bigint unsigned default '0',
555 -- Total pages, theoretically equal to SELECT COUNT(*) FROM page; except faster
556 ss_total_pages bigint default '-1',
558 -- Number of users, theoretically equal to SELECT COUNT(*) FROM user;
559 ss_users bigint default '-1',
561 -- Deprecated, no longer updated as of 1.5
562 ss_admins int default '-1',
564 -- Number of images, equivalent to SELECT COUNT(*) FROM image
565 ss_images int default '0',
567 UNIQUE KEY ss_row_id (ss_row_id)
569 ) /*$wgDBTableOptions*/;
572 -- Stores an ID for every time any article is visited;
573 -- depending on $wgHitcounterUpdateFreq, it is
574 -- periodically cleared and the page_counter column
575 -- in the page table updated for the all articles
576 -- that have been visited.)
578 CREATE TABLE /*$wgDBprefix*/hitcounter (
579 hc_id int unsigned NOT NULL
580 ) TYPE=HEAP MAX_ROWS=25000;
584 -- The internet is full of jerks, alas. Sometimes it's handy
585 -- to block a vandal or troll account.
587 CREATE TABLE /*$wgDBprefix*/ipblocks (
588 -- Primary key, introduced for privacy.
589 ipb_id int NOT NULL auto_increment,
591 -- Blocked IP address in dotted-quad form or user name.
592 ipb_address tinyblob NOT NULL,
594 -- Blocked user ID or 0 for IP blocks.
595 ipb_user int unsigned NOT NULL default '0',
597 -- User ID who made the block.
598 ipb_by int unsigned NOT NULL default '0',
600 -- Text comment made by blocker.
601 ipb_reason tinyblob NOT NULL,
603 -- Creation (or refresh) date in standard YMDHMS form.
604 -- IP blocks expire automatically.
605 ipb_timestamp binary(14) NOT NULL default '',
607 -- Indicates that the IP address was banned because a banned
608 -- user accessed a page through it. If this is 1, ipb_address
609 -- will be hidden, and the block identified by block ID number.
610 ipb_auto bool NOT NULL default 0,
612 -- If set to 1, block applies only to logged-out users
613 ipb_anon_only bool NOT NULL default 0,
615 -- Block prevents account creation from matching IP addresses
616 ipb_create_account bool NOT NULL default 1,
618 -- Block triggers autoblocks
619 ipb_enable_autoblock bool NOT NULL default '1',
621 -- Time at which the block will expire.
623 ipb_expiry varbinary(14) NOT NULL default '',
625 -- Start and end of an address range, in hexadecimal
626 -- Size chosen to allow IPv6
627 ipb_range_start tinyblob NOT NULL,
628 ipb_range_end tinyblob NOT NULL,
630 -- Flag for entries hidden from users and Sysops
631 ipb_deleted bool NOT NULL default 0,
633 -- Block prevents user from accessing Special:Emailuser
634 ipb_block_email bool NOT NULL default 0,
636 PRIMARY KEY ipb_id (ipb_id),
638 -- Unique index to support "user already blocked" messages
639 -- Any new options which prevent collisions should be included
640 UNIQUE INDEX ipb_address (ipb_address(255), ipb_user, ipb_auto, ipb_anon_only),
642 INDEX ipb_user (ipb_user),
643 INDEX ipb_range (ipb_range_start(8), ipb_range_end(8)),
644 INDEX ipb_timestamp (ipb_timestamp),
645 INDEX ipb_expiry (ipb_expiry)
647 ) /*$wgDBTableOptions*/;
651 -- Uploaded images and other files.
653 CREATE TABLE /*$wgDBprefix*/image (
655 -- This is also the title of the associated description page,
656 -- which will be in namespace 6 (NS_IMAGE).
657 img_name varchar(255) binary NOT NULL default '',
659 -- File size in bytes.
660 img_size int unsigned NOT NULL default '0',
662 -- For images, size in pixels.
663 img_width int NOT NULL default '0',
664 img_height int NOT NULL default '0',
666 -- Extracted EXIF metadata stored as a serialized PHP array.
667 img_metadata mediumblob NOT NULL,
669 -- For images, bits per pixel if known.
670 img_bits int NOT NULL default '0',
672 -- Media type as defined by the MEDIATYPE_xxx constants
673 img_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
675 -- major part of a MIME media type as defined by IANA
676 -- see http://www.iana.org/assignments/media-types/
677 img_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
679 -- minor part of a MIME media type as defined by IANA
680 -- the minor parts are not required to adher to any standard
681 -- but should be consistent throughout the database
682 -- see http://www.iana.org/assignments/media-types/
683 img_minor_mime varbinary(32) NOT NULL default "unknown",
685 -- Description field as entered by the uploader.
686 -- This is displayed in image upload history and logs.
687 img_description tinyblob NOT NULL,
689 -- user_id and user_name of uploader.
690 img_user int unsigned NOT NULL default '0',
691 img_user_text varchar(255) binary NOT NULL,
693 -- Time of the upload.
694 img_timestamp varbinary(14) NOT NULL default '',
696 -- SHA-1 content hash in base-36
697 img_sha1 varbinary(32) NOT NULL default '',
699 PRIMARY KEY img_name (img_name),
701 INDEX img_usertext_timestamp (img_user_text,img_timestamp),
702 -- Used by Special:Imagelist for sort-by-size
703 INDEX img_size (img_size),
704 -- Used by Special:Newimages and Special:Imagelist
705 INDEX img_timestamp (img_timestamp),
708 INDEX img_sha1 (img_sha1)
711 ) /*$wgDBTableOptions*/;
714 -- Previous revisions of uploaded files.
715 -- Awkwardly, image rows have to be moved into
716 -- this table at re-upload time.
718 CREATE TABLE /*$wgDBprefix*/oldimage (
719 -- Base filename: key to image.img_name
720 oi_name varchar(255) binary NOT NULL default '',
722 -- Filename of the archived file.
723 -- This is generally a timestamp and '!' prepended to the base name.
724 oi_archive_name varchar(255) binary NOT NULL default '',
726 -- Other fields as in image...
727 oi_size int unsigned NOT NULL default 0,
728 oi_width int NOT NULL default 0,
729 oi_height int NOT NULL default 0,
730 oi_bits int NOT NULL default 0,
731 oi_description tinyblob NOT NULL,
732 oi_user int unsigned NOT NULL default '0',
733 oi_user_text varchar(255) binary NOT NULL,
734 oi_timestamp binary(14) NOT NULL default '',
736 oi_metadata mediumblob NOT NULL,
737 oi_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
738 oi_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
739 oi_minor_mime varbinary(32) NOT NULL default "unknown",
740 oi_deleted tinyint unsigned NOT NULL default '0',
741 oi_sha1 varbinary(32) NOT NULL default '',
743 INDEX oi_usertext_timestamp (oi_user_text,oi_timestamp),
744 INDEX oi_name_timestamp (oi_name,oi_timestamp),
745 -- oi_archive_name truncated to 14 to avoid key length overflow
746 INDEX oi_name_archive_name (oi_name,oi_archive_name(14)),
747 INDEX oi_sha1 (oi_sha1)
749 ) /*$wgDBTableOptions*/;
752 -- Record of deleted file data
754 CREATE TABLE /*$wgDBprefix*/filearchive (
756 fa_id int NOT NULL auto_increment,
758 -- Original base filename; key to image.img_name, page.page_title, etc
759 fa_name varchar(255) binary NOT NULL default '',
761 -- Filename of archived file, if an old revision
762 fa_archive_name varchar(255) binary default '',
764 -- Which storage bin (directory tree or object store) the file data
765 -- is stored in. Should be 'deleted' for files that have been deleted;
766 -- any other bin is not yet in use.
767 fa_storage_group varbinary(16),
769 -- SHA-1 of the file contents plus extension, used as a key for storage.
770 -- eg 8f8a562add37052a1848ff7771a2c515db94baa9.jpg
772 -- If NULL, the file was missing at deletion time or has been purged
773 -- from the archival storage.
774 fa_storage_key varbinary(64) default '',
776 -- Deletion information, if this file is deleted.
778 fa_deleted_timestamp binary(14) default '',
779 fa_deleted_reason text,
781 -- Duped fields from image
782 fa_size int unsigned default '0',
783 fa_width int default '0',
784 fa_height int default '0',
785 fa_metadata mediumblob,
786 fa_bits int default '0',
787 fa_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
788 fa_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") default "unknown",
789 fa_minor_mime varbinary(32) default "unknown",
790 fa_description tinyblob,
791 fa_user int unsigned default '0',
792 fa_user_text varchar(255) binary,
793 fa_timestamp binary(14) default '',
795 -- Visibility of deleted revisions, bitfield
796 fa_deleted tinyint unsigned NOT NULL default '0',
799 INDEX (fa_name, fa_timestamp), -- pick out by image name
800 INDEX (fa_storage_group, fa_storage_key), -- pick out dupe files
801 INDEX (fa_deleted_timestamp), -- sort by deletion time
802 INDEX (fa_deleted_user) -- sort by deleter
804 ) /*$wgDBTableOptions*/;
807 -- Primarily a summary table for Special:Recentchanges,
808 -- this table contains some additional info on edits from
809 -- the last few days, see Article::editUpdates()
811 CREATE TABLE /*$wgDBprefix*/recentchanges (
812 rc_id int NOT NULL auto_increment,
813 rc_timestamp varbinary(14) NOT NULL default '',
814 rc_cur_time varbinary(14) NOT NULL default '',
817 rc_user int unsigned NOT NULL default '0',
818 rc_user_text varchar(255) binary NOT NULL,
820 -- When pages are renamed, their RC entries do _not_ change.
821 rc_namespace int NOT NULL default '0',
822 rc_title varchar(255) binary NOT NULL default '',
825 rc_comment varchar(255) binary NOT NULL default '',
826 rc_minor tinyint unsigned NOT NULL default '0',
828 -- Edits by user accounts with the 'bot' rights key are
829 -- marked with a 1 here, and will be hidden from the
831 rc_bot tinyint unsigned NOT NULL default '0',
833 rc_new tinyint unsigned NOT NULL default '0',
835 -- Key to page_id (was cur_id prior to 1.5).
836 -- This will keep links working after moves while
837 -- retaining the at-the-time name in the changes list.
838 rc_cur_id int unsigned NOT NULL default '0',
840 -- rev_id of the given revision
841 rc_this_oldid int unsigned NOT NULL default '0',
843 -- rev_id of the prior revision, for generating diff links.
844 rc_last_oldid int unsigned NOT NULL default '0',
846 -- These may no longer be used, with the new move log.
847 rc_type tinyint unsigned NOT NULL default '0',
848 rc_moved_to_ns tinyint unsigned NOT NULL default '0',
849 rc_moved_to_title varchar(255) binary NOT NULL default '',
851 -- If the Recent Changes Patrol option is enabled,
852 -- users may mark edits as having been reviewed to
853 -- remove a warning flag on the RC list.
854 -- A value of 1 indicates the page has been reviewed.
855 rc_patrolled tinyint unsigned NOT NULL default '0',
857 -- Recorded IP address the edit was made from, if the
858 -- $wgPutIPinRC option is enabled.
859 rc_ip varbinary(40) NOT NULL default '',
861 -- Text length in characters before
862 -- and after the edit
866 -- Visibility of deleted revisions, bitfield
867 rc_deleted tinyint unsigned NOT NULL default '0',
869 -- Value corresonding to log_id, specific log entries
870 rc_logid int unsigned NOT NULL default '0',
871 -- Store log type info here, or null
872 rc_log_type varbinary(255) NULL default NULL,
873 -- Store log action or null
874 rc_log_action varbinary(255) NULL default NULL,
878 PRIMARY KEY rc_id (rc_id),
879 INDEX rc_timestamp (rc_timestamp),
880 INDEX rc_namespace_title (rc_namespace, rc_title),
881 INDEX rc_cur_id (rc_cur_id),
882 INDEX new_name_timestamp (rc_new,rc_namespace,rc_timestamp),
884 INDEX rc_ns_usertext (rc_namespace, rc_user_text),
885 INDEX rc_user_text (rc_user_text, rc_timestamp)
887 ) /*$wgDBTableOptions*/;
889 CREATE TABLE /*$wgDBprefix*/watchlist (
890 -- Key to user.user_id
891 wl_user int unsigned NOT NULL,
893 -- Key to page_namespace/page_title
894 -- Note that users may watch pages which do not exist yet,
895 -- or existed in the past but have been deleted.
896 wl_namespace int NOT NULL default '0',
897 wl_title varchar(255) binary NOT NULL default '',
899 -- Timestamp when user was last sent a notification e-mail;
900 -- cleared when the user visits the page.
901 wl_notificationtimestamp varbinary(14),
903 UNIQUE KEY (wl_user, wl_namespace, wl_title),
904 KEY namespace_title (wl_namespace, wl_title)
906 ) /*$wgDBTableOptions*/;
910 -- Used by the math module to keep track
911 -- of previously-rendered items.
913 CREATE TABLE /*$wgDBprefix*/math (
914 -- Binary MD5 hash of the latex fragment, used as an identifier key.
915 math_inputhash varbinary(16) NOT NULL,
917 -- Not sure what this is, exactly...
918 math_outputhash varbinary(16) NOT NULL,
920 -- texvc reports how well it thinks the HTML conversion worked;
921 -- if it's a low level the PNG rendering may be preferred.
922 math_html_conservativeness tinyint NOT NULL,
924 -- HTML output from texvc, if any
927 -- MathML output from texvc, if any
930 UNIQUE KEY math_inputhash (math_inputhash)
932 ) /*$wgDBTableOptions*/;
935 -- When using the default MySQL search backend, page titles
936 -- and text are munged to strip markup, do Unicode case folding,
937 -- and prepare the result for MySQL's fulltext index.
939 -- This table must be MyISAM; InnoDB does not support the needed
942 CREATE TABLE /*$wgDBprefix*/searchindex (
944 si_page int unsigned NOT NULL,
946 -- Munged version of title
947 si_title varchar(255) NOT NULL default '',
949 -- Munged version of body text
950 si_text mediumtext NOT NULL,
952 UNIQUE KEY (si_page),
953 FULLTEXT si_title (si_title),
954 FULLTEXT si_text (si_text)
959 -- Recognized interwiki link prefixes
961 CREATE TABLE /*$wgDBprefix*/interwiki (
962 -- The interwiki prefix, (e.g. "Meatball", or the language prefix "de")
963 iw_prefix varchar(32) NOT NULL,
965 -- The URL of the wiki, with "$1" as a placeholder for an article name.
966 -- Any spaces in the name will be transformed to underscores before
968 iw_url blob NOT NULL,
970 -- A boolean value indicating whether the wiki is in this project
971 -- (used, for example, to detect redirect loops)
972 iw_local bool NOT NULL,
974 -- Boolean value indicating whether interwiki transclusions are allowed.
975 iw_trans tinyint NOT NULL default 0,
977 UNIQUE KEY iw_prefix (iw_prefix)
979 ) /*$wgDBTableOptions*/;
982 -- Used for caching expensive grouped queries
984 CREATE TABLE /*$wgDBprefix*/querycache (
985 -- A key name, generally the base name of of the special page.
986 qc_type varbinary(32) NOT NULL,
988 -- Some sort of stored value. Sizes, counts...
989 qc_value int unsigned NOT NULL default '0',
991 -- Target namespace+title
992 qc_namespace int NOT NULL default '0',
993 qc_title varchar(255) binary NOT NULL default '',
995 KEY (qc_type,qc_value)
997 ) /*$wgDBTableOptions*/;
1000 -- For a few generic cache operations if not using Memcached
1002 CREATE TABLE /*$wgDBprefix*/objectcache (
1003 keyname varbinary(255) NOT NULL default '',
1006 UNIQUE KEY (keyname),
1009 ) /*$wgDBTableOptions*/;
1012 -- Cache of interwiki transclusion
1014 CREATE TABLE /*$wgDBprefix*/transcache (
1015 tc_url varbinary(255) NOT NULL,
1017 tc_time int NOT NULL,
1018 UNIQUE INDEX tc_url_idx (tc_url)
1019 ) /*$wgDBTableOptions*/;
1021 CREATE TABLE /*$wgDBprefix*/logging (
1022 -- Symbolic keys for the general log type and the action type
1023 -- within the log. The output format will be controlled by the
1024 -- action field, but only the type controls categorization.
1025 log_type varbinary(10) NOT NULL default '',
1026 log_action varbinary(10) NOT NULL default '',
1029 log_timestamp binary(14) NOT NULL default '19700101000000',
1031 -- The user who performed this action; key to user_id
1032 log_user int unsigned NOT NULL default 0,
1034 -- Key to the page affected. Where a user is the target,
1035 -- this will point to the user page.
1036 log_namespace int NOT NULL default 0,
1037 log_title varchar(255) binary NOT NULL default '',
1039 -- Freeform text. Interpreted as edit history comments.
1040 log_comment varchar(255) NOT NULL default '',
1042 -- LF separated list of miscellaneous parameters
1043 log_params blob NOT NULL,
1045 -- Log ID, for referring to this specific log entry, probably for deletion and such.
1046 log_id int unsigned NOT NULL auto_increment,
1048 -- rev_deleted for logs
1049 log_deleted tinyint unsigned NOT NULL default '0',
1051 PRIMARY KEY log_id (log_id),
1052 KEY type_time (log_type, log_timestamp),
1053 KEY user_time (log_user, log_timestamp),
1054 KEY page_time (log_namespace, log_title, log_timestamp),
1055 KEY times (log_timestamp)
1057 ) /*$wgDBTableOptions*/;
1059 CREATE TABLE /*$wgDBprefix*/trackbacks (
1060 tb_id int auto_increment,
1061 tb_page int REFERENCES page(page_id) ON DELETE CASCADE,
1062 tb_title varchar(255) NOT NULL,
1063 tb_url blob NOT NULL,
1065 tb_name varchar(255),
1067 PRIMARY KEY (tb_id),
1069 ) /*$wgDBTableOptions*/;
1072 -- Jobs performed by parallel apache threads or a command-line daemon
1073 CREATE TABLE /*$wgDBprefix*/job (
1074 job_id int unsigned NOT NULL auto_increment,
1077 -- Limited to 60 to prevent key length overflow
1078 job_cmd varbinary(60) NOT NULL default '',
1080 -- Namespace and title to act on
1081 -- Should be 0 and '' if the command does not operate on a title
1082 job_namespace int NOT NULL,
1083 job_title varchar(255) binary NOT NULL,
1085 -- Any other parameters to the command
1086 -- Presently unused, format undefined
1087 job_params blob NOT NULL,
1089 PRIMARY KEY job_id (job_id),
1090 KEY (job_cmd, job_namespace, job_title)
1091 ) /*$wgDBTableOptions*/;
1094 -- Details of updates to cached special pages
1095 CREATE TABLE /*$wgDBprefix*/querycache_info (
1097 -- Special page name
1098 -- Corresponds to a qc_type value
1099 qci_type varbinary(32) NOT NULL default '',
1101 -- Timestamp of last update
1102 qci_timestamp binary(14) NOT NULL default '19700101000000',
1104 UNIQUE KEY ( qci_type )
1106 ) /*$wgDBTableOptions*/;
1108 -- For each redirect, this table contains exactly one row defining its target
1109 CREATE TABLE /*$wgDBprefix*/redirect (
1110 -- Key to the page_id of the redirect page
1111 rd_from int unsigned NOT NULL default '0',
1113 -- Key to page_namespace/page_title of the target page.
1114 -- The target page may or may not exist, and due to renames
1115 -- and deletions may refer to different page records as time
1117 rd_namespace int NOT NULL default '0',
1118 rd_title varchar(255) binary NOT NULL default '',
1120 PRIMARY KEY rd_from (rd_from),
1121 KEY rd_ns_title (rd_namespace,rd_title,rd_from)
1122 ) /*$wgDBTableOptions*/;
1124 -- Used for caching expensive grouped queries that need two links (for example double-redirects)
1125 CREATE TABLE /*$wgDBprefix*/querycachetwo (
1126 -- A key name, generally the base name of of the special page.
1127 qcc_type varbinary(32) NOT NULL,
1129 -- Some sort of stored value. Sizes, counts...
1130 qcc_value int unsigned NOT NULL default '0',
1132 -- Target namespace+title
1133 qcc_namespace int NOT NULL default '0',
1134 qcc_title varchar(255) binary NOT NULL default '',
1136 -- Target namespace+title2
1137 qcc_namespacetwo int NOT NULL default '0',
1138 qcc_titletwo varchar(255) binary NOT NULL default '',
1140 KEY qcc_type (qcc_type,qcc_value),
1141 KEY qcc_title (qcc_type,qcc_namespace,qcc_title),
1142 KEY qcc_titletwo (qcc_type,qcc_namespacetwo,qcc_titletwo)
1144 ) /*$wgDBTableOptions*/;
1146 -- Used for storing page restrictions (i.e. protection levels)
1147 CREATE TABLE /*$wgDBprefix*/page_restrictions (
1148 -- Page to apply restrictions to (Foreign Key to page).
1149 pr_page int NOT NULL,
1150 -- The protection type (edit, move, etc)
1151 pr_type varbinary(60) NOT NULL,
1152 -- The protection level (Sysop, autoconfirmed, etc)
1153 pr_level varbinary(60) NOT NULL,
1154 -- Whether or not to cascade the protection down to pages transcluded.
1155 pr_cascade tinyint NOT NULL,
1156 -- Field for future support of per-user restriction.
1158 -- Field for time-limited protection.
1159 pr_expiry varbinary(14) NULL,
1160 -- Field for an ID for this restrictions row (sort-key for Special:ProtectedPages)
1161 pr_id int unsigned NOT NULL auto_increment,
1163 PRIMARY KEY pr_pagetype (pr_page,pr_type),
1165 UNIQUE KEY pr_id (pr_id),
1166 KEY pr_typelevel (pr_type,pr_level),
1167 KEY pr_level (pr_level),
1168 KEY pr_cascade (pr_cascade)
1169 ) /*$wgDBTableOptions*/;
1171 -- vim: sw=2 sts=2 et