1 -- Experimental table definitions for MySQL 4.1 and 5.0 with
2 -- content-holding fields switched to explicit binary charset.
4 -- Binary is used instead of UTF-8 or UCS-2 so that all of
5 -- Unicode may be used as UTF-8 (MySQL still does not allow
6 -- use of characters outside the BMP in UTF-8 and has no UTF-16
9 -- This should provide compatibility with our current MySQL 4.0
10 -- behavior (safe for full UTF-8, but ugly sorting) on newer
11 -- versions of MySQL server, without the conversion surprises
12 -- you get from piggybacking on "Latin-1" fields.
14 -- UTF-8 is used for the searchindex fields, as the fulltext index
15 -- doesn't seem to like the binary encoding.
17 -- Not fully tested, may have surprises!
19 -- TODO: Test various fields
21 -- ------------------------------------------------------------
23 -- SQL to create the initial tables for the MediaWiki database.
24 -- This is read and executed by the install script; you should
25 -- not have to run it by itself unless doing a manual install.
30 -- If possible, create tables as InnoDB to benefit from the
31 -- superior resiliency against crashes and ability to read
32 -- during writes (and write during reads!)
34 -- Only the 'searchindex' table requires MyISAM due to the
35 -- requirement for fulltext index support, which is missing
39 -- The MySQL table backend for MediaWiki currently uses
40 -- 14-character CHAR or VARCHAR fields to store timestamps.
41 -- The format is YYYYMMDDHHMMSS, which is derived from the
42 -- text format of MySQL's TIMESTAMP fields.
44 -- Historically TIMESTAMP fields were used, but abandoned
45 -- in early 2002 after a lot of trouble with the fields
48 -- The Postgres backend uses DATETIME fields for timestamps,
49 -- and we will migrate the MySQL definitions at some point as
53 -- The /*$wgDBprefix*/ comments in this and other files are
54 -- replaced with the defined table prefix by the installer
55 -- and updater scripts. If you are installing or running
56 -- updates manually, you will need to manually insert the
57 -- table prefix if any when running these scripts.
62 -- The user table contains basic account information,
63 -- authentication keys, etc.
65 -- Some multi-wiki sites may share a single central user table
66 -- between separate wikis using the $wgSharedDB setting.
68 -- Note that when a external authentication plugin is used,
69 -- user table entries still need to be created to store
70 -- preferences and to key tracking information in the other
73 CREATE TABLE /*$wgDBprefix*/user (
74 user_id
int(5) unsigned
NOT NULL auto_increment
,
76 -- Usernames must be unique, must not be in the form of
77 -- an IP address. _Shouldn't_ allow slashes or case
78 -- conflicts. Spaces are allowed, and are _not_ converted
79 -- to underscores like titles. See the User::newFromName() for
80 -- the specific tests that usernames have to pass.
81 user_name
varchar(255) binary NOT NULL default '',
83 -- Optional 'real name' to be displayed in credit listings
84 user_real_name
varchar(255) binary NOT NULL default '',
86 -- Password hashes, normally hashed like so:
87 -- MD5(CONCAT(user_id,'-',MD5(plaintext_password))), see
88 -- wfEncryptPassword() in GlobalFunctions.php
89 user_password tinyblob
NOT NULL,
91 -- When using 'mail me a new password', a random
92 -- password is generated and the hash stored here.
93 -- The previous password is left in place until
94 -- someone actually logs in with the new password,
95 -- at which point the hash is moved to user_password
96 -- and the old password is invalidated.
97 user_newpassword tinyblob
NOT NULL,
99 -- Timestamp of the last time when a new password was
100 -- sent, for throttling purposes
101 user_newpass_time
char(14) binary,
103 -- Note: email should be restricted, not public info.
104 -- Same with passwords.
105 user_email tinytext
NOT NULL,
107 -- Newline-separated list of name=value defining the user
109 user_options
blob NOT NULL,
111 -- This is a timestamp which is updated when a user
112 -- logs in, logs out, changes preferences, or performs
113 -- some other action requiring HTML cache invalidation
114 -- to ensure that the UI is updated.
115 user_touched
char(14) binary NOT NULL default '',
117 -- A pseudorandomly generated value that is stored in
118 -- a cookie when the "remember password" feature is
119 -- used (previously, a hash of the password was used, but
120 -- this was vulnerable to cookie-stealing attacks)
121 user_token
char(32) binary NOT NULL default '',
123 -- Initially NULL; when a user's e-mail address has been
124 -- validated by returning with a mailed token, this is
125 -- set to the current timestamp.
126 user_email_authenticated
char(14) binary,
128 -- Randomly generated token created when the e-mail address
129 -- is set and a confirmation test mail sent.
130 user_email_token
char(32) binary,
132 -- Expiration date for the user_email_token
133 user_email_token_expires
char(14) binary,
135 -- Timestamp of account registration.
136 -- Accounts predating this schema addition may contain NULL.
137 user_registration
char(14) binary,
139 -- Count of edits and edit-like actions.
141 -- *NOT* intended to be an accurate copy of COUNT(*) WHERE rev_user=user_id
142 -- May contain NULL for old accounts if batch-update scripts haven't been
143 -- run, as well as listing deleted edits and other myriad ways it could be
146 -- Meant primarily for heuristic checks to give an impression of whether
147 -- the account has been used much.
151 PRIMARY KEY user_id (user_id
),
152 UNIQUE INDEX user_name (user_name
),
153 INDEX (user_email_token
)
155 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
158 -- User permissions have been broken out to a separate table;
159 -- this allows sites with a shared user table to have different
160 -- permissions assigned to a user in each project.
162 -- This table replaces the old user_rights field which used a
163 -- comma-separated blob.
165 CREATE TABLE /*$wgDBprefix*/user_groups (
167 ug_user
int(5) unsigned
NOT NULL default '0',
169 -- Group names are short symbolic string keys.
170 -- The set of group names is open-ended, though in practice
171 -- only some predefined ones are likely to be used.
173 -- At runtime $wgGroupPermissions will associate group keys
174 -- with particular permissions. A user will have the combined
175 -- permissions of any group they're explicitly in, plus
176 -- the implicit '*' and 'user' groups.
177 ug_group
char(16) NOT NULL default '',
179 PRIMARY KEY (ug_user
,ug_group
),
181 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
183 -- Stores notifications of user talk page changes, for the display
184 -- of the "you have new messages" box
185 CREATE TABLE /*$wgDBprefix*/user_newtalk (
186 -- Key to user.user_id
187 user_id
int(5) NOT NULL default '0',
188 -- If the user is an anonymous user hir IP address is stored here
189 -- since the user_id of 0 is ambiguous
190 user_ip
varchar(40) NOT NULL default '',
191 INDEX user_id (user_id
),
192 INDEX user_ip (user_ip
)
194 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
198 -- Core of the wiki: each page has an entry here which identifies
199 -- it by title and contains some essential metadata.
201 CREATE TABLE /*$wgDBprefix*/page (
202 -- Unique identifier number. The page_id will be preserved across
203 -- edits and rename operations, but not deletions and recreations.
204 page_id
int(8) unsigned
NOT NULL auto_increment
,
206 -- A page name is broken into a namespace and a title.
207 -- The namespace keys are UI-language-independent constants,
208 -- defined in includes/Defines.php
209 page_namespace
int NOT NULL,
211 -- The rest of the title, as text.
212 -- Spaces are transformed into underscores in title storage.
213 page_title
varchar(255) binary NOT NULL,
215 -- Comma-separated set of permission keys indicating who
216 -- can move or edit the page.
217 page_restrictions tinyblob
NOT NULL,
219 -- Number of times this page has been viewed.
220 page_counter
bigint(20) unsigned
NOT NULL default '0',
222 -- 1 indicates the article is a redirect.
223 page_is_redirect
tinyint(1) unsigned
NOT NULL default '0',
225 -- 1 indicates this is a new entry, with only one edit.
226 -- Not all pages with one edit are new pages.
227 page_is_new
tinyint(1) unsigned
NOT NULL default '0',
229 -- Random value between 0 and 1, used for Special:Randompage
230 page_random
real unsigned
NOT NULL,
232 -- This timestamp is updated whenever the page changes in
233 -- a way requiring it to be re-rendered, invalidating caches.
234 -- Aside from editing this includes permission changes,
235 -- creation or deletion of linked pages, and alteration
236 -- of contained templates.
237 page_touched
char(14) binary NOT NULL default '',
239 -- Handy key to revision.rev_id of the current revision.
240 -- This may be 0 during page creation, but that shouldn't
241 -- happen outside of a transaction... hopefully.
242 page_latest
int(8) unsigned
NOT NULL,
244 -- Uncompressed length in bytes of the page's current source text.
245 page_len
int(8) unsigned
NOT NULL,
247 PRIMARY KEY page_id (page_id
),
248 UNIQUE INDEX name_title (page_namespace
,page_title
),
250 -- Special-purpose indexes
254 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
257 -- Every edit of a page creates also a revision row.
258 -- This stores metadata about the revision, and a reference
259 -- to the text storage backend.
261 CREATE TABLE /*$wgDBprefix*/revision (
262 rev_id
int(8) unsigned
NOT NULL auto_increment
,
264 -- Key to page_id. This should _never_ be invalid.
265 rev_page
int(8) unsigned
NOT NULL,
267 -- Key to text.old_id, where the actual bulk text is stored.
268 -- It's possible for multiple revisions to use the same text,
269 -- for instance revisions where only metadata is altered
270 -- or a rollback to a previous version.
271 rev_text_id
int(8) unsigned
NOT NULL,
273 -- Text comment summarizing the change.
274 -- This text is shown in the history and other changes lists,
275 -- rendered in a subset of wiki markup by Linker::formatComment()
276 rev_comment tinyblob
NOT NULL,
278 -- Key to user.user_id of the user who made this edit.
279 -- Stores 0 for anonymous edits and for some mass imports.
280 rev_user
int(5) unsigned
NOT NULL default '0',
282 -- Text username or IP address of the editor.
283 rev_user_text
varchar(255) binary NOT NULL default '',
286 rev_timestamp
char(14) binary NOT NULL default '',
288 -- Records whether the user marked the 'minor edit' checkbox.
289 -- Many automated edits are marked as minor.
290 rev_minor_edit
tinyint(1) unsigned
NOT NULL default '0',
292 -- Not yet used; reserved for future changes to the deletion system.
293 rev_deleted
tinyint(1) unsigned
NOT NULL default '0',
295 -- Length of this revision in bytes
296 rev_len
int(8) unsigned
,
298 -- Key to revision.rev_id
299 -- This field is used to add support for a tree structure (The Adjacency List Model)
300 rev_parent_id
int(8) unsigned
default NULL,
302 PRIMARY KEY rev_page_id (rev_page
, rev_id
),
303 UNIQUE INDEX rev_id (rev_id
),
304 INDEX rev_timestamp (rev_timestamp
),
305 INDEX page_timestamp (rev_page
,rev_timestamp
),
306 INDEX user_timestamp (rev_user
,rev_timestamp
),
307 INDEX usertext_timestamp (rev_user_text
,rev_timestamp
)
309 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
313 -- Holds text of individual page revisions.
315 -- Field names are a holdover from the 'old' revisions table in
316 -- MediaWiki 1.4 and earlier: an upgrade will transform that
317 -- table into the 'text' table to minimize unnecessary churning
318 -- and downtime. If upgrading, the other fields will be left unused.
320 CREATE TABLE /*$wgDBprefix*/text (
321 -- Unique text storage key number.
322 -- Note that the 'oldid' parameter used in URLs does *not*
323 -- refer to this number anymore, but to rev_id.
325 -- revision.rev_text_id is a key to this column
326 old_id
int(8) unsigned
NOT NULL auto_increment
,
328 -- Depending on the contents of the old_flags field, the text
329 -- may be convenient plain text, or it may be funkily encoded.
330 old_text mediumblob
NOT NULL,
332 -- Comma-separated list of flags:
333 -- gzip: text is compressed with PHP's gzdeflate() function.
334 -- utf8: text was stored as UTF-8.
335 -- If $wgLegacyEncoding option is on, rows *without* this flag
336 -- will be converted to UTF-8 transparently at load time.
337 -- object: text field contained a serialized PHP object.
338 -- The object either contains multiple versions compressed
339 -- together to achieve a better compression ratio, or it refers
340 -- to another row where the text can be found.
341 old_flags tinyblob
NOT NULL,
343 PRIMARY KEY old_id (old_id
)
345 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
348 -- Holding area for deleted articles, which may be viewed
349 -- or restored by admins through the Special:Undelete interface.
350 -- The fields generally correspond to the page, revision, and text
351 -- fields, with several caveats.
353 CREATE TABLE /*$wgDBprefix*/archive (
354 ar_namespace
int NOT NULL default '0',
355 ar_title
varchar(255) binary NOT NULL default '',
357 -- Newly deleted pages will not store text in this table,
358 -- but will reference the separately existing text rows.
359 -- This field is retained for backwards compatibility,
360 -- so old archived pages will remain accessible after
361 -- upgrading from 1.4 to 1.5.
362 -- Text may be gzipped or otherwise funky.
363 ar_text mediumblob
NOT NULL,
365 -- Basic revision stuff...
366 ar_comment tinyblob
NOT NULL,
367 ar_user
int(5) unsigned
NOT NULL default '0',
368 ar_user_text
varchar(255) binary NOT NULL,
369 ar_timestamp
char(14) binary NOT NULL default '',
370 ar_minor_edit
tinyint(1) NOT NULL default '0',
373 ar_flags tinyblob
NOT NULL,
375 -- When revisions are deleted, their unique rev_id is stored
376 -- here so it can be retained after undeletion. This is necessary
377 -- to retain permalinks to given revisions after accidental delete
378 -- cycles or messy operations like history merges.
380 -- Old entries from 1.4 will be NULL here, and a new rev_id will
381 -- be created on undeletion for those revisions.
382 ar_rev_id
int(8) unsigned
,
384 -- For newly deleted revisions, this is the text.old_id key to the
385 -- actual stored text. To avoid breaking the block-compression scheme
386 -- and otherwise making storage changes harder, the actual text is
387 -- *not* deleted from the text table, merely hidden by removal of the
388 -- page and revision entries.
390 -- Old entries deleted under 1.2-1.4 will have NULL here, and their
391 -- ar_text and ar_flags fields will be used to create a new text
392 -- row upon undeletion.
393 ar_text_id
int(8) unsigned
,
395 -- rev_deleted for archives
396 ar_deleted
tinyint(1) unsigned
NOT NULL default '0',
397 -- Length of this revision in bytes
398 ar_len
int(8) unsigned
,
400 KEY name_title_timestamp (ar_namespace
,ar_title
,ar_timestamp
)
402 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
406 -- Track page-to-page hyperlinks within the wiki.
408 CREATE TABLE /*$wgDBprefix*/pagelinks (
409 -- Key to the page_id of the page containing the link.
410 pl_from
int(8) unsigned
NOT NULL default '0',
412 -- Key to page_namespace/page_title of the target page.
413 -- The target page may or may not exist, and due to renames
414 -- and deletions may refer to different page records as time
416 pl_namespace
int NOT NULL default '0',
417 pl_title
varchar(255) binary NOT NULL default '',
419 UNIQUE KEY pl_from (pl_from
,pl_namespace
,pl_title
),
420 KEY (pl_namespace
,pl_title
,pl_from
)
422 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
426 -- Track template inclusions.
428 CREATE TABLE /*$wgDBprefix*/templatelinks (
429 -- Key to the page_id of the page containing the link.
430 tl_from
int(8) unsigned
NOT NULL default '0',
432 -- Key to page_namespace/page_title of the target page.
433 -- The target page may or may not exist, and due to renames
434 -- and deletions may refer to different page records as time
436 tl_namespace
int NOT NULL default '0',
437 tl_title
varchar(255) binary NOT NULL default '',
439 UNIQUE KEY tl_from (tl_from
,tl_namespace
,tl_title
),
440 KEY (tl_namespace
,tl_title
,tl_from
)
442 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
445 -- Track links to images *used inline*
446 -- We don't distinguish live from broken links here, so
447 -- they do not need to be changed on upload/removal.
449 CREATE TABLE /*$wgDBprefix*/imagelinks (
450 -- Key to page_id of the page containing the image / media link.
451 il_from
int(8) unsigned
NOT NULL default '0',
453 -- Filename of target image.
454 -- This is also the page_title of the file's description page;
455 -- all such pages are in namespace 6 (NS_IMAGE).
456 il_to
varchar(255) binary NOT NULL default '',
458 UNIQUE KEY il_from (il_from
,il_to
),
461 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
464 -- Track category inclusions *used inline*
465 -- This tracks a single level of category membership
466 -- (folksonomic tagging, really).
468 CREATE TABLE /*$wgDBprefix*/categorylinks (
469 -- Key to page_id of the page defined as a category member.
470 cl_from
int(8) unsigned
NOT NULL default '0',
472 -- Name of the category.
473 -- This is also the page_title of the category's description page;
474 -- all such pages are in namespace 14 (NS_CATEGORY).
475 cl_to
varchar(255) binary NOT NULL default '',
477 -- The title of the linking page, or an optional override
478 -- to determine sort order. Sorting is by binary order, which
479 -- isn't always ideal, but collations seem to be an exciting
480 -- and dangerous new world in MySQL... The sortkey is updated
481 -- if no override exists and cl_from is renamed.
483 -- For MySQL 4.1+ with charset set to utf8, the sort key *index*
484 -- needs cut to be smaller than 1024 bytes (at 3 bytes per char).
485 -- To sort properly on the shorter key, this field needs to be
486 -- the same shortness.
487 cl_sortkey
varchar(86) binary NOT NULL default '',
489 -- This isn't really used at present. Provided for an optional
490 -- sorting method by approximate addition time.
491 cl_timestamp
timestamp NOT NULL,
493 UNIQUE KEY cl_from (cl_from
,cl_to
),
495 -- We always sort within a given category...
496 KEY cl_sortkey (cl_to
,cl_sortkey
),
499 KEY cl_timestamp (cl_to
,cl_timestamp
)
501 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
504 -- Track links to external URLs
506 CREATE TABLE /*$wgDBprefix*/externallinks (
507 -- page_id of the referring page
508 el_from
int(8) unsigned
NOT NULL default '0',
513 -- In the case of HTTP URLs, this is the URL with any username or password
514 -- removed, and with the labels in the hostname reversed and converted to
515 -- lower case. An extra dot is added to allow for matching of either
516 -- example.com or *.example.com in a single scan.
518 -- http://user:password@sub.example.com/page.html
520 -- http://com.example.sub./page.html
521 -- which allows for fast searching for all pages under example.com with the
523 -- WHERE el_index LIKE 'http://com.example.%'
524 el_index
blob NOT NULL,
526 KEY (el_from
, el_to(40)),
527 KEY (el_to(60), el_from
),
529 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
532 -- Track interlanguage links
534 CREATE TABLE /*$wgDBprefix*/langlinks (
535 -- page_id of the referring page
536 ll_from
int(8) unsigned
NOT NULL default '0',
538 -- Language code of the target
539 ll_lang
varchar(10) binary NOT NULL default '',
541 -- Title of the target, including namespace
542 ll_title
varchar(255) binary NOT NULL default '',
544 UNIQUE KEY (ll_from
, ll_lang
),
545 KEY (ll_lang
, ll_title
)
546 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
549 -- Contains a single row with some aggregate info
550 -- on the state of the site.
552 CREATE TABLE /*$wgDBprefix*/site_stats (
553 -- The single row should contain 1 here.
554 ss_row_id
int(8) unsigned
NOT NULL,
556 -- Total number of page views, if hit counters are enabled.
557 ss_total_views
bigint(20) unsigned
default '0',
559 -- Total number of edits performed.
560 ss_total_edits
bigint(20) unsigned
default '0',
562 -- An approximate count of pages matching the following criteria:
565 -- * contains the text '[['
566 -- See Article::isCountable() in includes/Article.php
567 ss_good_articles
bigint(20) unsigned
default '0',
569 -- Total pages, theoretically equal to SELECT COUNT(*) FROM page; except faster
570 ss_total_pages
bigint(20) default '-1',
572 -- Number of users, theoretically equal to SELECT COUNT(*) FROM user;
573 ss_users
bigint(20) default '-1',
575 -- Deprecated, no longer updated as of 1.5
576 ss_admins
int(10) default '-1',
578 -- Number of images, equivalent to SELECT COUNT(*) FROM image
579 ss_images
int(10) default '0',
581 UNIQUE KEY ss_row_id (ss_row_id
)
586 -- Stores an ID for every time any article is visited;
587 -- depending on $wgHitcounterUpdateFreq, it is
588 -- periodically cleared and the page_counter column
589 -- in the page table updated for the all articles
590 -- that have been visited.)
592 CREATE TABLE /*$wgDBprefix*/hitcounter (
593 hc_id
int unsigned
NOT NULL
594 ) ENGINE
=HEAP MAX_ROWS
=25000;
598 -- The internet is full of jerks, alas. Sometimes it's handy
599 -- to block a vandal or troll account.
601 CREATE TABLE /*$wgDBprefix*/ipblocks (
602 -- Primary key, introduced for privacy.
603 ipb_id
int(8) NOT NULL auto_increment
,
605 -- Blocked IP address in dotted-quad form or user name.
606 ipb_address tinyblob
NOT NULL,
608 -- Blocked user ID or 0 for IP blocks.
609 ipb_user
int(8) unsigned
NOT NULL default '0',
611 -- User ID who made the block.
612 ipb_by
int(8) unsigned
NOT NULL default '0',
614 -- Text comment made by blocker.
615 ipb_reason tinyblob
NOT NULL,
617 -- Creation (or refresh) date in standard YMDHMS form.
618 -- IP blocks expire automatically.
619 ipb_timestamp
char(14) binary NOT NULL default '',
621 -- Indicates that the IP address was banned because a banned
622 -- user accessed a page through it. If this is 1, ipb_address
623 -- will be hidden, and the block identified by block ID number.
624 ipb_auto bool
NOT NULL default 0,
626 -- If set to 1, block applies only to logged-out users
627 ipb_anon_only bool
NOT NULL default 0,
629 -- Block prevents account creation from matching IP addresses
630 ipb_create_account bool
NOT NULL default 1,
632 -- Block triggers autoblocks
633 ipb_enable_autoblock bool
NOT NULL default '1',
635 -- Time at which the block will expire.
636 ipb_expiry
char(14) binary NOT NULL default '',
638 -- Start and end of an address range, in hexadecimal
639 -- Size chosen to allow IPv6
640 ipb_range_start tinyblob
NOT NULL,
641 ipb_range_end tinyblob
NOT NULL,
642 -- Flag for entries hidden from users and Sysops
643 ipb_deleted bool
NOT NULL default 0,
645 PRIMARY KEY ipb_id (ipb_id
),
647 -- Unique index to support "user already blocked" messages
648 -- Any new options which prevent collisions should be included
649 UNIQUE INDEX ipb_address (ipb_address(255), ipb_user
, ipb_auto
, ipb_anon_only
),
651 INDEX ipb_user (ipb_user
),
652 INDEX ipb_range (ipb_range_start(8), ipb_range_end(8)),
653 INDEX ipb_timestamp (ipb_timestamp
),
654 INDEX ipb_expiry (ipb_expiry
)
656 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
660 -- Uploaded images and other files.
662 CREATE TABLE /*$wgDBprefix*/image (
664 -- This is also the title of the associated description page,
665 -- which will be in namespace 6 (NS_IMAGE).
666 img_name
varchar(255) binary NOT NULL default '',
668 -- File size in bytes.
669 img_size
int(8) unsigned
NOT NULL default '0',
671 -- For images, size in pixels.
672 img_width
int(5) NOT NULL default '0',
673 img_height
int(5) NOT NULL default '0',
675 -- Extracted EXIF metadata stored as a serialized PHP array.
676 img_metadata mediumblob
NOT NULL,
678 -- For images, bits per pixel if known.
679 img_bits
int(3) NOT NULL default '0',
681 -- Media type as defined by the MEDIATYPE_xxx constants
682 img_media_type
ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
684 -- major part of a MIME media type as defined by IANA
685 -- see http://www.iana.org/assignments/media-types/
686 img_major_mime
ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
688 -- minor part of a MIME media type as defined by IANA
689 -- the minor parts are not required to adher to any standard
690 -- but should be consistent throughout the database
691 -- see http://www.iana.org/assignments/media-types/
692 img_minor_mime
varchar(32) NOT NULL default "unknown",
694 -- Description field as entered by the uploader.
695 -- This is displayed in image upload history and logs.
696 img_description tinyblob
NOT NULL,
698 -- user_id and user_name of uploader.
699 img_user
int(5) unsigned
NOT NULL default '0',
700 img_user_text
varchar(255) binary NOT NULL,
702 -- Time of the upload.
703 img_timestamp
char(14) binary NOT NULL default '',
705 PRIMARY KEY img_name (img_name
),
707 -- Used by Special:Imagelist for sort-by-size
708 INDEX img_size (img_size
),
710 -- Used by Special:Newimages and Special:Imagelist
711 INDEX img_timestamp (img_timestamp
)
713 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
716 -- Previous revisions of uploaded files.
717 -- Awkwardly, image rows have to be moved into
718 -- this table at re-upload time.
720 CREATE TABLE /*$wgDBprefix*/oldimage (
721 -- Base filename: key to image.img_name
722 oi_name
varchar(255) binary NOT NULL default '',
724 -- Filename of the archived file.
725 -- This is generally a timestamp and '!' prepended to the base name.
726 oi_archive_name
varchar(255) binary NOT NULL default '',
728 -- Other fields as in image...
729 oi_size
int(8) unsigned
NOT NULL default 0,
730 oi_width
int(5) NOT NULL default 0,
731 oi_height
int(5) NOT NULL default 0,
732 oi_bits
int(3) NOT NULL default 0,
733 oi_description tinyblob
NOT NULL,
734 oi_user
int(5) unsigned
NOT NULL default '0',
735 oi_user_text
varchar(255) binary NOT NULL,
736 oi_timestamp
char(14) binary NOT NULL default '',
738 INDEX oi_name (oi_name(10))
740 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
743 -- Record of deleted file data
745 CREATE TABLE /*$wgDBprefix*/filearchive (
747 fa_id
int NOT NULL auto_increment
,
749 -- Original base filename; key to image.img_name, page.page_title, etc
750 fa_name
varchar(255) binary NOT NULL default '',
752 -- Filename of archived file, if an old revision
753 fa_archive_name
varchar(255) binary default '',
755 -- Which storage bin (directory tree or object store) the file data
756 -- is stored in. Should be 'deleted' for files that have been deleted;
757 -- any other bin is not yet in use.
758 fa_storage_group
varchar(16),
760 -- SHA-1 of the file contents plus extension, used as a key for storage.
761 -- eg 8f8a562add37052a1848ff7771a2c515db94baa9.jpg
763 -- If NULL, the file was missing at deletion time or has been purged
764 -- from the archival storage.
765 fa_storage_key
varchar(64) binary default '',
767 -- Deletion information, if this file is deleted.
769 fa_deleted_timestamp
char(14) binary default '',
770 fa_deleted_reason
text,
772 -- Duped fields from image
773 fa_size
int(8) unsigned
default '0',
774 fa_width
int(5) default '0',
775 fa_height
int(5) default '0',
776 fa_metadata mediumblob
,
777 fa_bits
int(3) default '0',
778 fa_media_type
ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
779 fa_major_mime
ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") default "unknown",
780 fa_minor_mime
varchar(32) default "unknown",
781 fa_description tinyblob
,
782 fa_user
int(5) unsigned
default '0',
783 fa_user_text
varchar(255) binary,
784 fa_timestamp
char(14) binary default '',
786 -- Visibility of deleted revisions, bitfield
787 fa_deleted
tinyint(1) unsigned
NOT NULL default '0',
790 INDEX (fa_name
, fa_timestamp
), -- pick out by image name
791 INDEX (fa_storage_group
, fa_storage_key
), -- pick out dupe files
792 INDEX (fa_deleted_timestamp
), -- sort by deletion time
793 INDEX (fa_deleted_user
) -- sort by deleter
795 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
798 -- Primarily a summary table for Special:Recentchanges,
799 -- this table contains some additional info on edits from
800 -- the last few days, see Article::editUpdates()
802 CREATE TABLE /*$wgDBprefix*/recentchanges (
803 rc_id
int(8) NOT NULL auto_increment
,
804 rc_timestamp
varchar(14) binary NOT NULL default '',
805 rc_cur_time
varchar(14) binary NOT NULL default '',
808 rc_user
int(10) unsigned
NOT NULL default '0',
809 rc_user_text
varchar(255) binary NOT NULL,
811 -- When pages are renamed, their RC entries do _not_ change.
812 rc_namespace
int NOT NULL default '0',
813 rc_title
varchar(255) binary NOT NULL default '',
816 rc_comment
varchar(255) binary NOT NULL default '',
817 rc_minor
tinyint(3) unsigned
NOT NULL default '0',
819 -- Edits by user accounts with the 'bot' rights key are
820 -- marked with a 1 here, and will be hidden from the
822 rc_bot
tinyint(3) unsigned
NOT NULL default '0',
824 rc_new
tinyint(3) unsigned
NOT NULL default '0',
826 -- Key to page_id (was cur_id prior to 1.5).
827 -- This will keep links working after moves while
828 -- retaining the at-the-time name in the changes list.
829 rc_cur_id
int(10) unsigned
NOT NULL default '0',
831 -- rev_id of the given revision
832 rc_this_oldid
int(10) unsigned
NOT NULL default '0',
834 -- rev_id of the prior revision, for generating diff links.
835 rc_last_oldid
int(10) unsigned
NOT NULL default '0',
837 -- These may no longer be used, with the new move log.
838 rc_type
tinyint(3) unsigned
NOT NULL default '0',
839 rc_moved_to_ns
tinyint(3) unsigned
NOT NULL default '0',
840 rc_moved_to_title
varchar(255) binary NOT NULL default '',
842 -- If the Recent Changes Patrol option is enabled,
843 -- users may mark edits as having been reviewed to
844 -- remove a warning flag on the RC list.
845 -- A value of 1 indicates the page has been reviewed.
846 rc_patrolled
tinyint(3) unsigned
NOT NULL default '0',
848 -- Recorded IP address the edit was made from, if the
849 -- $wgPutIPinRC option is enabled.
850 rc_ip
char(15) NOT NULL default '',
852 -- Text length in characters before
853 -- and after the edit
857 -- Visibility of deleted revisions, bitfield
858 rc_deleted
tinyint(1) unsigned
NOT NULL default '0',
860 -- Value corresonding to log_id, specific log entries
861 rc_logid
int(10) unsigned
NOT NULL default '0',
862 -- Store log type info here, or null
863 rc_log_type
varchar(255) binary NULL default NULL,
864 -- Store log action or null
865 rc_log_action
varchar(255) binary NULL default NULL,
867 rc_params
blob NOT NULL default '',
869 PRIMARY KEY rc_id (rc_id
),
870 INDEX rc_timestamp (rc_timestamp
),
871 INDEX rc_namespace_title (rc_namespace
, rc_title
),
872 INDEX rc_cur_id (rc_cur_id
),
873 INDEX new_name_timestamp (rc_new
,rc_namespace
,rc_timestamp
),
875 INDEX rc_ns_usertext (rc_namespace
, rc_user_text
),
876 INDEX rc_user_text (rc_user_text
, rc_timestamp
)
878 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
880 CREATE TABLE /*$wgDBprefix*/watchlist (
881 -- Key to user.user_id
882 wl_user
int(5) unsigned
NOT NULL,
884 -- Key to page_namespace/page_title
885 -- Note that users may watch pages which do not exist yet,
886 -- or existed in the past but have been deleted.
887 wl_namespace
int NOT NULL default '0',
888 wl_title
varchar(255) binary NOT NULL default '',
890 -- Timestamp when user was last sent a notification e-mail;
891 -- cleared when the user visits the page.
892 wl_notificationtimestamp
varchar(14) binary,
894 UNIQUE KEY (wl_user
, wl_namespace
, wl_title
),
895 KEY namespace_title (wl_namespace
, wl_title
)
897 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
901 -- Used by the math module to keep track
902 -- of previously-rendered items.
904 CREATE TABLE /*$wgDBprefix*/math (
905 -- Binary MD5 hash of the latex fragment, used as an identifier key.
906 math_inputhash
varbinary(16) NOT NULL,
908 -- Not sure what this is, exactly...
909 math_outputhash
varbinary(16) NOT NULL,
911 -- texvc reports how well it thinks the HTML conversion worked;
912 -- if it's a low level the PNG rendering may be preferred.
913 math_html_conservativeness
tinyint(1) NOT NULL,
915 -- HTML output from texvc, if any
918 -- MathML output from texvc, if any
921 UNIQUE KEY math_inputhash (math_inputhash
)
923 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
926 -- When using the default MySQL search backend, page titles
927 -- and text are munged to strip markup, do Unicode case folding,
928 -- and prepare the result for MySQL's fulltext index.
930 -- This table must be MyISAM; InnoDB does not support the needed
933 CREATE TABLE /*$wgDBprefix*/searchindex (
935 si_page
int(8) unsigned
NOT NULL,
937 -- Munged version of title
938 si_title
varchar(255) NOT NULL default '',
940 -- Munged version of body text
941 si_text mediumtext
NOT NULL,
943 UNIQUE KEY (si_page
),
944 FULLTEXT
si_title (si_title
),
945 FULLTEXT
si_text (si_text
)
947 ) ENGINE
=MyISAM
, DEFAULT CHARSET
=utf8
;
950 -- Recognized interwiki link prefixes
952 CREATE TABLE /*$wgDBprefix*/interwiki (
953 -- The interwiki prefix, (e.g. "Meatball", or the language prefix "de")
954 iw_prefix
char(32) NOT NULL,
956 -- The URL of the wiki, with "$1" as a placeholder for an article name.
957 -- Any spaces in the name will be transformed to underscores before
959 iw_url
char(127) NOT NULL,
961 -- A boolean value indicating whether the wiki is in this project
962 -- (used, for example, to detect redirect loops)
963 iw_local bool
NOT NULL,
965 -- Boolean value indicating whether interwiki transclusions are allowed.
966 iw_trans
tinyint(1) NOT NULL default 0,
968 UNIQUE KEY iw_prefix (iw_prefix
)
970 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
973 -- Used for caching expensive grouped queries
975 CREATE TABLE /*$wgDBprefix*/querycache (
976 -- A key name, generally the base name of of the special page.
977 qc_type
char(32) NOT NULL,
979 -- Some sort of stored value. Sizes, counts...
980 qc_value
int(5) unsigned
NOT NULL default '0',
982 -- Target namespace+title
983 qc_namespace
int NOT NULL default '0',
984 qc_title
char(255) binary NOT NULL default '',
986 KEY (qc_type
,qc_value
)
988 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
991 -- For a few generic cache operations if not using Memcached
993 CREATE TABLE /*$wgDBprefix*/objectcache (
994 keyname
char(255) binary NOT NULL default '',
997 UNIQUE KEY (keyname
),
1000 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
1003 -- Cache of interwiki transclusion
1005 CREATE TABLE /*$wgDBprefix*/transcache (
1006 tc_url
varchar(255) NOT NULL,
1008 tc_time
int NOT NULL,
1009 UNIQUE INDEX tc_url_idx (tc_url
)
1010 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
1012 CREATE TABLE /*$wgDBprefix*/logging (
1013 -- Symbolic keys for the general log type and the action type
1014 -- within the log. The output format will be controlled by the
1015 -- action field, but only the type controls categorization.
1016 log_type
char(10) NOT NULL default '',
1017 log_action
char(10) NOT NULL default '',
1020 log_timestamp
char(14) NOT NULL default '19700101000000',
1022 -- The user who performed this action; key to user_id
1023 log_user
int unsigned
NOT NULL default 0,
1025 -- Key to the page affected. Where a user is the target,
1026 -- this will point to the user page.
1027 log_namespace
int NOT NULL default 0,
1028 log_title
varchar(255) binary NOT NULL default '',
1030 -- Freeform text. Interpreted as edit history comments.
1031 log_comment
varchar(255) NOT NULL default '',
1033 -- LF separated list of miscellaneous parameters
1034 log_params
blob NOT NULL,
1036 -- rev_deleted for logs
1037 log_deleted
tinyint(1) unsigned
NOT NULL default '0',
1039 KEY type_time (log_type
, log_timestamp
),
1040 KEY user_time (log_user
, log_timestamp
),
1041 KEY page_time (log_namespace
, log_title
, log_timestamp
),
1042 KEY times (log_timestamp
)
1044 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
1046 CREATE TABLE /*$wgDBprefix*/trackbacks (
1047 tb_id
int auto_increment
,
1048 tb_page
int REFERENCES page(page_id
) ON DELETE CASCADE,
1049 tb_title
varchar(255) NOT NULL,
1050 tb_url
varchar(255) NOT NULL,
1052 tb_name
varchar(255),
1054 PRIMARY KEY (tb_id
),
1056 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
1059 -- Jobs performed by parallel apache threads or a command-line daemon
1060 CREATE TABLE /*$wgDBprefix*/job (
1061 job_id
int(9) unsigned
NOT NULL auto_increment
,
1063 -- Command name, currently only refreshLinks is defined
1064 job_cmd
varchar(255) NOT NULL default '',
1066 -- Namespace and title to act on
1067 -- Should be 0 and '' if the command does not operate on a title
1068 job_namespace
int NOT NULL,
1069 job_title
varchar(255) binary NOT NULL,
1071 -- Any other parameters to the command
1072 -- Presently unused, format undefined
1073 job_params
blob NOT NULL,
1075 PRIMARY KEY job_id (job_id
),
1076 KEY (job_cmd
, job_namespace
, job_title
)
1077 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
1080 -- Details of updates to cached special pages
1081 CREATE TABLE /*$wgDBprefix*/querycache_info (
1083 -- Special page name
1084 -- Corresponds to a qc_type value
1085 qci_type
varchar(32) NOT NULL default '',
1087 -- Timestamp of last update
1088 qci_timestamp
char(14) NOT NULL default '19700101000000',
1090 UNIQUE KEY ( qci_type
)
1094 -- For each redirect, this table contains exactly one row defining its target
1095 CREATE TABLE /*$wgDBprefix*/redirect (
1096 -- Key to the page_id of the redirect page
1097 rd_from
int(8) unsigned
NOT NULL default '0',
1099 -- Key to page_namespace/page_title of the target page.
1100 -- The target page may or may not exist, and due to renames
1101 -- and deletions may refer to different page records as time
1103 rd_namespace
int NOT NULL default '0',
1104 rd_title
varchar(255) binary NOT NULL default '',
1106 PRIMARY KEY rd_from (rd_from
),
1107 KEY rd_ns_title (rd_namespace
,rd_title
,rd_from
)
1108 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
1110 -- Used for caching expensive grouped queries that need two links (for example double-redirects)
1111 CREATE TABLE /*$wgDBprefix*/querycachetwo (
1112 -- A key name, generally the base name of of the special page.
1113 qcc_type
char(32) NOT NULL,
1115 -- Some sort of stored value. Sizes, counts...
1116 qcc_value
int(5) unsigned
NOT NULL default '0',
1118 -- Target namespace+title
1119 qcc_namespace
int NOT NULL default '0',
1120 qcc_title
char(255) binary NOT NULL default '',
1122 -- Target namespace+title2
1123 qcc_namespacetwo
int NOT NULL default '0',
1124 qcc_titletwo
char(255) binary NOT NULL default '',
1126 KEY qcc_type (qcc_type
,qcc_value
),
1127 KEY qcc_title (qcc_type
,qcc_namespace
,qcc_title
),
1128 KEY qcc_titletwo (qcc_type
,qcc_namespacetwo
,qcc_titletwo
)
1130 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;
1132 --- Used for storing page restrictions (i.e. protection levels)
1133 CREATE TABLE /*$wgDBprefix*/page_restrictions (
1134 -- Page to apply restrictions to (Foreign Key to page).
1135 pr_page
int(8) NOT NULL,
1136 -- The protection type (edit, move, etc)
1137 pr_type
varchar(255) NOT NULL,
1138 -- The protection level (Sysop, autoconfirmed, etc)
1139 pr_level
varchar(255) NOT NULL,
1140 -- Whether or not to cascade the protection down to pages transcluded.
1141 pr_cascade
tinyint(4) NOT NULL,
1142 -- Field for future support of per-user restriction.
1143 pr_user
int(8) NULL,
1144 -- Field for time-limited protection.
1145 pr_expiry
char(14) binary NULL,
1147 PRIMARY KEY pr_pagetype (pr_page
,pr_type
),
1149 KEY pr_page (pr_page
),
1150 KEY pr_typelevel (pr_type
,pr_level
),
1151 KEY pr_level (pr_level
),
1152 KEY pr_cascade (pr_cascade
)
1153 ) ENGINE
=InnoDB
, DEFAULT CHARSET
=binary;