Localisation updates from http://translatewiki.net.
[mediawiki.git] / maintenance / tables.sql
blob7fc6bb895cbb9c71f8ee8a7a56c210fb5a0e0571
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.
5 -- This is a shared schema file used for both MySQL and SQLite installs.
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!)
14 -- Only the 'searchindex' table requires MyISAM due to the
15 -- requirement for fulltext index support, which is missing
16 -- from InnoDB.
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.
24 -- Historically TIMESTAMP fields were used, but abandoned
25 -- in early 2002 after a lot of trouble with the fields
26 -- auto-updating.
28 -- The Postgres backend uses TIMESTAMPTZ fields for timestamps,
29 -- and we will migrate the MySQL definitions at some point as
30 -- well.
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.
42 -- The user table contains basic account information,
43 -- authentication keys, etc.
45 -- Some multi-wiki sites may share a single central user table
46 -- between separate wikis using the $wgSharedDB setting.
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.
53 CREATE TABLE /*_*/user (
54   user_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
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 '',
63   -- Optional 'real name' to be displayed in credit listings
64   user_real_name varchar(255) binary NOT NULL default '',
66   -- Password hashes, see User::crypt() and User::comparePasswords()
67   -- in User.php for the algorithm
68   user_password tinyblob NOT NULL,
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,
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),
85   -- Note: email should be restricted, not public info.
86   -- Same with passwords.
87   user_email tinytext NOT NULL,
89   -- If the browser sends an If-Modified-Since header, a 304 response is
90   -- suppressed if the value in this field for the current user is later than
91   -- the value in the IMS header. That is, this field is an invalidation timestamp
92   -- for the browser cache of logged-in users. Among other things, it is used
93   -- to prevent pages generated for a previously logged in user from being
94   -- displayed after a session expiry followed by a fresh login.
95   user_touched binary(14) NOT NULL default '',
97   -- A pseudorandomly generated value that is stored in
98   -- a cookie when the "remember password" feature is
99   -- used (previously, a hash of the password was used, but
100   -- this was vulnerable to cookie-stealing attacks)
101   user_token binary(32) NOT NULL default '',
103   -- Initially NULL; when a user's e-mail address has been
104   -- validated by returning with a mailed token, this is
105   -- set to the current timestamp.
106   user_email_authenticated binary(14),
108   -- Randomly generated token created when the e-mail address
109   -- is set and a confirmation test mail sent.
110   user_email_token binary(32),
112   -- Expiration date for the user_email_token
113   user_email_token_expires binary(14),
115   -- Timestamp of account registration.
116   -- Accounts predating this schema addition may contain NULL.
117   user_registration binary(14),
119   -- Count of edits and edit-like actions.
120   --
121   -- *NOT* intended to be an accurate copy of COUNT(*) WHERE rev_user=user_id
122   -- May contain NULL for old accounts if batch-update scripts haven't been
123   -- run, as well as listing deleted edits and other myriad ways it could be
124   -- out of sync.
125   --
126   -- Meant primarily for heuristic checks to give an impression of whether
127   -- the account has been used much.
128   --
129   user_editcount int
130 ) /*$wgDBTableOptions*/;
132 CREATE UNIQUE INDEX /*i*/user_name ON /*_*/user (user_name);
133 CREATE INDEX /*i*/user_email_token ON /*_*/user (user_email_token);
134 CREATE INDEX /*i*/user_email ON /*_*/user (user_email(50));
138 -- User permissions have been broken out to a separate table;
139 -- this allows sites with a shared user table to have different
140 -- permissions assigned to a user in each project.
142 -- This table replaces the old user_rights field which used a
143 -- comma-separated blob.
145 CREATE TABLE /*_*/user_groups (
146   -- Key to user_id
147   ug_user int unsigned NOT NULL default 0,
149   -- Group names are short symbolic string keys.
150   -- The set of group names is open-ended, though in practice
151   -- only some predefined ones are likely to be used.
152   --
153   -- At runtime $wgGroupPermissions will associate group keys
154   -- with particular permissions. A user will have the combined
155   -- permissions of any group they're explicitly in, plus
156   -- the implicit '*' and 'user' groups.
157   ug_group varbinary(255) NOT NULL default ''
158 ) /*$wgDBTableOptions*/;
160 CREATE UNIQUE INDEX /*i*/ug_user_group ON /*_*/user_groups (ug_user,ug_group);
161 CREATE INDEX /*i*/ug_group ON /*_*/user_groups (ug_group);
163 -- Stores the groups the user has once belonged to.
164 -- The user may still belong to these groups (check user_groups).
165 -- Users are not autopromoted to groups from which they were removed.
166 CREATE TABLE /*_*/user_former_groups (
167   -- Key to user_id
168   ufg_user int unsigned NOT NULL default 0,
169   ufg_group varbinary(255) NOT NULL default ''
170 ) /*$wgDBTableOptions*/;
172 CREATE UNIQUE INDEX /*i*/ufg_user_group ON /*_*/user_former_groups (ufg_user,ufg_group);
175 -- Stores notifications of user talk page changes, for the display
176 -- of the "you have new messages" box
178 CREATE TABLE /*_*/user_newtalk (
179   -- Key to user.user_id
180   user_id int NOT NULL default 0,
181   -- If the user is an anonymous user their IP address is stored here
182   -- since the user_id of 0 is ambiguous
183   user_ip varbinary(40) NOT NULL default '',
184   -- The highest timestamp of revisions of the talk page viewed
185   -- by this user
186   user_last_timestamp varbinary(14) NULL default NULL
187 ) /*$wgDBTableOptions*/;
189 -- Indexes renamed for SQLite in 1.14
190 CREATE INDEX /*i*/un_user_id ON /*_*/user_newtalk (user_id);
191 CREATE INDEX /*i*/un_user_ip ON /*_*/user_newtalk (user_ip);
195 -- User preferences and perhaps other fun stuff. :)
196 -- Replaces the old user.user_options blob, with a couple nice properties:
198 -- 1) We only store non-default settings, so changes to the defauls
199 --    are now reflected for everybody, not just new accounts.
200 -- 2) We can more easily do bulk lookups, statistics, or modifications of
201 --    saved options since it's a sane table structure.
203 CREATE TABLE /*_*/user_properties (
204   -- Foreign key to user.user_id
205   up_user int NOT NULL,
207   -- Name of the option being saved. This is indexed for bulk lookup.
208   up_property varbinary(255) NOT NULL,
210   -- Property value as a string.
211   up_value blob
212 ) /*$wgDBTableOptions*/;
214 CREATE UNIQUE INDEX /*i*/user_properties_user_property ON /*_*/user_properties (up_user,up_property);
215 CREATE INDEX /*i*/user_properties_property ON /*_*/user_properties (up_property);
218 -- Core of the wiki: each page has an entry here which identifies
219 -- it by title and contains some essential metadata.
221 CREATE TABLE /*_*/page (
222   -- Unique identifier number. The page_id will be preserved across
223   -- edits and rename operations, but not deletions and recreations.
224   page_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
226   -- A page name is broken into a namespace and a title.
227   -- The namespace keys are UI-language-independent constants,
228   -- defined in includes/Defines.php
229   page_namespace int NOT NULL,
231   -- The rest of the title, as text.
232   -- Spaces are transformed into underscores in title storage.
233   page_title varchar(255) binary NOT NULL,
235   -- Comma-separated set of permission keys indicating who
236   -- can move or edit the page.
237   page_restrictions tinyblob NOT NULL,
239   -- Number of times this page has been viewed.
240   page_counter bigint unsigned NOT NULL default 0,
242   -- 1 indicates the article is a redirect.
243   page_is_redirect tinyint unsigned NOT NULL default 0,
245   -- 1 indicates this is a new entry, with only one edit.
246   -- Not all pages with one edit are new pages.
247   page_is_new tinyint unsigned NOT NULL default 0,
249   -- Random value between 0 and 1, used for Special:Randompage
250   page_random real unsigned NOT NULL,
252   -- This timestamp is updated whenever the page changes in
253   -- a way requiring it to be re-rendered, invalidating caches.
254   -- Aside from editing this includes permission changes,
255   -- creation or deletion of linked pages, and alteration
256   -- of contained templates.
257   page_touched binary(14) NOT NULL default '',
259   -- Handy key to revision.rev_id of the current revision.
260   -- This may be 0 during page creation, but that shouldn't
261   -- happen outside of a transaction... hopefully.
262   page_latest int unsigned NOT NULL,
264   -- Uncompressed length in bytes of the page's current source text.
265   page_len int unsigned NOT NULL,
267   -- content model, see CONTENT_MODEL_XXX constants
268   page_content_model varbinary(32) DEFAULT NULL
269 ) /*$wgDBTableOptions*/;
271 CREATE UNIQUE INDEX /*i*/name_title ON /*_*/page (page_namespace,page_title);
272 CREATE INDEX /*i*/page_random ON /*_*/page (page_random);
273 CREATE INDEX /*i*/page_len ON /*_*/page (page_len);
274 CREATE INDEX /*i*/page_redirect_namespace_len ON /*_*/page (page_is_redirect, page_namespace, page_len);
277 -- Every edit of a page creates also a revision row.
278 -- This stores metadata about the revision, and a reference
279 -- to the text storage backend.
281 CREATE TABLE /*_*/revision (
282   -- Unique ID to identify each revision
283   rev_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
285   -- Key to page_id. This should _never_ be invalid.
286   rev_page int unsigned NOT NULL,
288   -- Key to text.old_id, where the actual bulk text is stored.
289   -- It's possible for multiple revisions to use the same text,
290   -- for instance revisions where only metadata is altered
291   -- or a rollback to a previous version.
292   rev_text_id int unsigned NOT NULL,
294   -- Text comment summarizing the change.
295   -- This text is shown in the history and other changes lists,
296   -- rendered in a subset of wiki markup by Linker::formatComment()
297   rev_comment tinyblob NOT NULL,
299   -- Key to user.user_id of the user who made this edit.
300   -- Stores 0 for anonymous edits and for some mass imports.
301   rev_user int unsigned NOT NULL default 0,
303   -- Text username or IP address of the editor.
304   rev_user_text varchar(255) binary NOT NULL default '',
306   -- Timestamp of when revision was created
307   rev_timestamp binary(14) NOT NULL default '',
309   -- Records whether the user marked the 'minor edit' checkbox.
310   -- Many automated edits are marked as minor.
311   rev_minor_edit tinyint unsigned NOT NULL default 0,
313   -- Restrictions on who can access this revision
314   rev_deleted tinyint unsigned NOT NULL default 0,
316   -- Length of this revision in bytes
317   rev_len int unsigned,
319   -- Key to revision.rev_id
320   -- This field is used to add support for a tree structure (The Adjacency List Model)
321   rev_parent_id int unsigned default NULL,
323   -- SHA-1 text content hash in base-36
324   rev_sha1 varbinary(32) NOT NULL default '',
326   -- content model, see CONTENT_MODEL_XXX constants
327   rev_content_model varbinary(32) DEFAULT NULL,
329   -- content format, see CONTENT_FORMAT_XXX constants
330   rev_content_format varbinary(64) DEFAULT NULL
332 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=1024;
333 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
335 CREATE UNIQUE INDEX /*i*/rev_page_id ON /*_*/revision (rev_page, rev_id);
336 CREATE INDEX /*i*/rev_timestamp ON /*_*/revision (rev_timestamp);
337 CREATE INDEX /*i*/page_timestamp ON /*_*/revision (rev_page,rev_timestamp);
338 CREATE INDEX /*i*/user_timestamp ON /*_*/revision (rev_user,rev_timestamp);
339 CREATE INDEX /*i*/usertext_timestamp ON /*_*/revision (rev_user_text,rev_timestamp);
340 CREATE INDEX /*i*/page_user_timestamp ON /*_*/revision (rev_page,rev_user,rev_timestamp);
343 -- Holds text of individual page revisions.
345 -- Field names are a holdover from the 'old' revisions table in
346 -- MediaWiki 1.4 and earlier: an upgrade will transform that
347 -- table into the 'text' table to minimize unnecessary churning
348 -- and downtime. If upgrading, the other fields will be left unused.
350 CREATE TABLE /*_*/text (
351   -- Unique text storage key number.
352   -- Note that the 'oldid' parameter used in URLs does *not*
353   -- refer to this number anymore, but to rev_id.
354   --
355   -- revision.rev_text_id is a key to this column
356   old_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
358   -- Depending on the contents of the old_flags field, the text
359   -- may be convenient plain text, or it may be funkily encoded.
360   old_text mediumblob NOT NULL,
362   -- Comma-separated list of flags:
363   -- gzip: text is compressed with PHP's gzdeflate() function.
364   -- utf8: text was stored as UTF-8.
365   --       If $wgLegacyEncoding option is on, rows *without* this flag
366   --       will be converted to UTF-8 transparently at load time.
367   -- object: text field contained a serialized PHP object.
368   --         The object either contains multiple versions compressed
369   --         together to achieve a better compression ratio, or it refers
370   --         to another row where the text can be found.
371   old_flags tinyblob NOT NULL
372 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=10240;
373 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
377 -- Holding area for deleted articles, which may be viewed
378 -- or restored by admins through the Special:Undelete interface.
379 -- The fields generally correspond to the page, revision, and text
380 -- fields, with several caveats.
382 CREATE TABLE /*_*/archive (
383   ar_namespace int NOT NULL default 0,
384   ar_title varchar(255) binary NOT NULL default '',
386   -- Newly deleted pages will not store text in this table,
387   -- but will reference the separately existing text rows.
388   -- This field is retained for backwards compatibility,
389   -- so old archived pages will remain accessible after
390   -- upgrading from 1.4 to 1.5.
391   -- Text may be gzipped or otherwise funky.
392   ar_text mediumblob NOT NULL,
394   -- Basic revision stuff...
395   ar_comment tinyblob NOT NULL,
396   ar_user int unsigned NOT NULL default 0,
397   ar_user_text varchar(255) binary NOT NULL,
398   ar_timestamp binary(14) NOT NULL default '',
399   ar_minor_edit tinyint NOT NULL default 0,
401   -- See ar_text note.
402   ar_flags tinyblob NOT NULL,
404   -- When revisions are deleted, their unique rev_id is stored
405   -- here so it can be retained after undeletion. This is necessary
406   -- to retain permalinks to given revisions after accidental delete
407   -- cycles or messy operations like history merges.
408   --
409   -- Old entries from 1.4 will be NULL here, and a new rev_id will
410   -- be created on undeletion for those revisions.
411   ar_rev_id int unsigned,
413   -- For newly deleted revisions, this is the text.old_id key to the
414   -- actual stored text. To avoid breaking the block-compression scheme
415   -- and otherwise making storage changes harder, the actual text is
416   -- *not* deleted from the text table, merely hidden by removal of the
417   -- page and revision entries.
418   --
419   -- Old entries deleted under 1.2-1.4 will have NULL here, and their
420   -- ar_text and ar_flags fields will be used to create a new text
421   -- row upon undeletion.
422   ar_text_id int unsigned,
424   -- rev_deleted for archives
425   ar_deleted tinyint unsigned NOT NULL default 0,
427   -- Length of this revision in bytes
428   ar_len int unsigned,
430   -- Reference to page_id. Useful for sysadmin fixing of large pages
431   -- merged together in the archives, or for cleanly restoring a page
432   -- at its original ID number if possible.
433   --
434   -- Will be NULL for pages deleted prior to 1.11.
435   ar_page_id int unsigned,
437   -- Original previous revision
438   ar_parent_id int unsigned default NULL,
440   -- SHA-1 text content hash in base-36
441   ar_sha1 varbinary(32) NOT NULL default '',
443   -- content model, see CONTENT_MODEL_XXX constants
444   ar_content_model varbinary(32) DEFAULT NULL,
446   -- content format, see CONTENT_FORMAT_XXX constants
447   ar_content_format varbinary(64) DEFAULT NULL
449 ) /*$wgDBTableOptions*/;
451 CREATE INDEX /*i*/name_title_timestamp ON /*_*/archive (ar_namespace,ar_title,ar_timestamp);
452 CREATE INDEX /*i*/ar_usertext_timestamp ON /*_*/archive (ar_user_text,ar_timestamp);
453 CREATE INDEX /*i*/ar_revid ON /*_*/archive (ar_rev_id);
457 -- Track page-to-page hyperlinks within the wiki.
459 CREATE TABLE /*_*/pagelinks (
460   -- Key to the page_id of the page containing the link.
461   pl_from int unsigned NOT NULL default 0,
463   -- Key to page_namespace/page_title of the target page.
464   -- The target page may or may not exist, and due to renames
465   -- and deletions may refer to different page records as time
466   -- goes by.
467   pl_namespace int NOT NULL default 0,
468   pl_title varchar(255) binary NOT NULL default ''
469 ) /*$wgDBTableOptions*/;
471 CREATE UNIQUE INDEX /*i*/pl_from ON /*_*/pagelinks (pl_from,pl_namespace,pl_title);
472 CREATE UNIQUE INDEX /*i*/pl_namespace ON /*_*/pagelinks (pl_namespace,pl_title,pl_from);
476 -- Track template inclusions.
478 CREATE TABLE /*_*/templatelinks (
479   -- Key to the page_id of the page containing the link.
480   tl_from int unsigned NOT NULL default 0,
482   -- Key to page_namespace/page_title of the target page.
483   -- The target page may or may not exist, and due to renames
484   -- and deletions may refer to different page records as time
485   -- goes by.
486   tl_namespace int NOT NULL default 0,
487   tl_title varchar(255) binary NOT NULL default ''
488 ) /*$wgDBTableOptions*/;
490 CREATE UNIQUE INDEX /*i*/tl_from ON /*_*/templatelinks (tl_from,tl_namespace,tl_title);
491 CREATE UNIQUE INDEX /*i*/tl_namespace ON /*_*/templatelinks (tl_namespace,tl_title,tl_from);
495 -- Track links to images *used inline*
496 -- We don't distinguish live from broken links here, so
497 -- they do not need to be changed on upload/removal.
499 CREATE TABLE /*_*/imagelinks (
500   -- Key to page_id of the page containing the image / media link.
501   il_from int unsigned NOT NULL default 0,
503   -- Filename of target image.
504   -- This is also the page_title of the file's description page;
505   -- all such pages are in namespace 6 (NS_FILE).
506   il_to varchar(255) binary NOT NULL default ''
507 ) /*$wgDBTableOptions*/;
509 CREATE UNIQUE INDEX /*i*/il_from ON /*_*/imagelinks (il_from,il_to);
510 CREATE UNIQUE INDEX /*i*/il_to ON /*_*/imagelinks (il_to,il_from);
514 -- Track category inclusions *used inline*
515 -- This tracks a single level of category membership
517 CREATE TABLE /*_*/categorylinks (
518   -- Key to page_id of the page defined as a category member.
519   cl_from int unsigned NOT NULL default 0,
521   -- Name of the category.
522   -- This is also the page_title of the category's description page;
523   -- all such pages are in namespace 14 (NS_CATEGORY).
524   cl_to varchar(255) binary NOT NULL default '',
526   -- A binary string obtained by applying a sortkey generation algorithm
527   -- (Collation::getSortKey()) to page_title, or cl_sortkey_prefix . "\n"
528   -- . page_title if cl_sortkey_prefix is nonempty.
529   cl_sortkey varbinary(230) NOT NULL default '',
531   -- A prefix for the raw sortkey manually specified by the user, either via
532   -- [[Category:Foo|prefix]] or {{defaultsort:prefix}}.  If nonempty, it's
533   -- concatenated with a line break followed by the page title before the sortkey
534   -- conversion algorithm is run.  We store this so that we can update
535   -- collations without reparsing all pages.
536   -- Note: If you change the length of this field, you also need to change
537   -- code in LinksUpdate.php. See bug 25254.
538   cl_sortkey_prefix varchar(255) binary NOT NULL default '',
540   -- This isn't really used at present. Provided for an optional
541   -- sorting method by approximate addition time.
542   cl_timestamp timestamp NOT NULL,
544   -- Stores $wgCategoryCollation at the time cl_sortkey was generated.  This
545   -- can be used to install new collation versions, tracking which rows are not
546   -- yet updated.  '' means no collation, this is a legacy row that needs to be
547   -- updated by updateCollation.php.  In the future, it might be possible to
548   -- specify different collations per category.
549   cl_collation varbinary(32) NOT NULL default '',
551   -- Stores whether cl_from is a category, file, or other page, so we can
552   -- paginate the three categories separately.  This never has to be updated
553   -- after the page is created, since none of these page types can be moved to
554   -- any other.
555   cl_type ENUM('page', 'subcat', 'file') NOT NULL default 'page'
556 ) /*$wgDBTableOptions*/;
558 CREATE UNIQUE INDEX /*i*/cl_from ON /*_*/categorylinks (cl_from,cl_to);
560 -- We always sort within a given category, and within a given type.  FIXME:
561 -- Formerly this index didn't cover cl_type (since that didn't exist), so old
562 -- callers won't be using an index: fix this?
563 CREATE INDEX /*i*/cl_sortkey ON /*_*/categorylinks (cl_to,cl_type,cl_sortkey,cl_from);
565 -- Used by the API (and some extensions)
566 CREATE INDEX /*i*/cl_timestamp ON /*_*/categorylinks (cl_to,cl_timestamp);
568 -- FIXME: Not used, delete this
569 CREATE INDEX /*i*/cl_collation ON /*_*/categorylinks (cl_collation);
572 -- Track all existing categories.  Something is a category if 1) it has an en-
573 -- try somewhere in categorylinks, or 2) it once did.  Categories might not
574 -- have corresponding pages, so they need to be tracked separately.
576 CREATE TABLE /*_*/category (
577   -- Primary key
578   cat_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
580   -- Name of the category, in the same form as page_title (with underscores).
581   -- If there is a category page corresponding to this category, by definition,
582   -- it has this name (in the Category namespace).
583   cat_title varchar(255) binary NOT NULL,
585   -- The numbers of member pages (including categories and media), subcatego-
586   -- ries, and Image: namespace members, respectively.  These are signed to
587   -- make underflow more obvious.  We make the first number include the second
588   -- two for better sorting: subtracting for display is easy, adding for order-
589   -- ing is not.
590   cat_pages int signed NOT NULL default 0,
591   cat_subcats int signed NOT NULL default 0,
592   cat_files int signed NOT NULL default 0
593 ) /*$wgDBTableOptions*/;
595 CREATE UNIQUE INDEX /*i*/cat_title ON /*_*/category (cat_title);
597 -- For Special:Mostlinkedcategories
598 CREATE INDEX /*i*/cat_pages ON /*_*/category (cat_pages);
602 -- Track links to external URLs
604 CREATE TABLE /*_*/externallinks (
605   -- page_id of the referring page
606   el_from int unsigned NOT NULL default 0,
608   -- The URL
609   el_to blob NOT NULL,
611   -- In the case of HTTP URLs, this is the URL with any username or password
612   -- removed, and with the labels in the hostname reversed and converted to
613   -- lower case. An extra dot is added to allow for matching of either
614   -- example.com or *.example.com in a single scan.
615   -- Example:
616   --      http://user:password@sub.example.com/page.html
617   --   becomes
618   --      http://com.example.sub./page.html
619   -- which allows for fast searching for all pages under example.com with the
620   -- clause:
621   --      WHERE el_index LIKE 'http://com.example.%'
622   el_index blob NOT NULL
623 ) /*$wgDBTableOptions*/;
625 CREATE INDEX /*i*/el_from ON /*_*/externallinks (el_from, el_to(40));
626 CREATE INDEX /*i*/el_to ON /*_*/externallinks (el_to(60), el_from);
627 CREATE INDEX /*i*/el_index ON /*_*/externallinks (el_index(60));
630 -- Track interlanguage links
632 CREATE TABLE /*_*/langlinks (
633   -- page_id of the referring page
634   ll_from int unsigned NOT NULL default 0,
636   -- Language code of the target
637   ll_lang varbinary(20) NOT NULL default '',
639   -- Title of the target, including namespace
640   ll_title varchar(255) binary NOT NULL default ''
641 ) /*$wgDBTableOptions*/;
643 CREATE UNIQUE INDEX /*i*/ll_from ON /*_*/langlinks (ll_from, ll_lang);
644 CREATE INDEX /*i*/ll_lang ON /*_*/langlinks (ll_lang, ll_title);
648 -- Track inline interwiki links
650 CREATE TABLE /*_*/iwlinks (
651   -- page_id of the referring page
652   iwl_from int unsigned NOT NULL default 0,
654   -- Interwiki prefix code of the target
655   iwl_prefix varbinary(20) NOT NULL default '',
657   -- Title of the target, including namespace
658   iwl_title varchar(255) binary NOT NULL default ''
659 ) /*$wgDBTableOptions*/;
661 CREATE UNIQUE INDEX /*i*/iwl_from ON /*_*/iwlinks (iwl_from, iwl_prefix, iwl_title);
662 CREATE INDEX /*i*/iwl_prefix_title_from ON /*_*/iwlinks (iwl_prefix, iwl_title, iwl_from);
663 CREATE INDEX /*i*/iwl_prefix_from_title ON /*_*/iwlinks (iwl_prefix, iwl_from, iwl_title);
667 -- Contains a single row with some aggregate info
668 -- on the state of the site.
670 CREATE TABLE /*_*/site_stats (
671   -- The single row should contain 1 here.
672   ss_row_id int unsigned NOT NULL,
674   -- Total number of page views, if hit counters are enabled.
675   ss_total_views bigint unsigned default 0,
677   -- Total number of edits performed.
678   ss_total_edits bigint unsigned default 0,
680   -- An approximate count of pages matching the following criteria:
681   -- * in namespace 0
682   -- * not a redirect
683   -- * contains the text '[['
684   -- See Article::isCountable() in includes/Article.php
685   ss_good_articles bigint unsigned default 0,
687   -- Total pages, theoretically equal to SELECT COUNT(*) FROM page; except faster
688   ss_total_pages bigint default '-1',
690   -- Number of users, theoretically equal to SELECT COUNT(*) FROM user;
691   ss_users bigint default '-1',
693   -- Number of users that still edit
694   ss_active_users bigint default '-1',
696   -- Number of images, equivalent to SELECT COUNT(*) FROM image
697   ss_images int default 0
698 ) /*$wgDBTableOptions*/;
700 -- Pointless index to assuage developer superstitions
701 CREATE UNIQUE INDEX /*i*/ss_row_id ON /*_*/site_stats (ss_row_id);
705 -- Stores an ID for every time any article is visited;
706 -- depending on $wgHitcounterUpdateFreq, it is
707 -- periodically cleared and the page_counter column
708 -- in the page table updated for all the articles
709 -- that have been visited.)
711 CREATE TABLE /*_*/hitcounter (
712   hc_id int unsigned NOT NULL
713 ) ENGINE=HEAP MAX_ROWS=25000;
717 -- The internet is full of jerks, alas. Sometimes it's handy
718 -- to block a vandal or troll account.
720 CREATE TABLE /*_*/ipblocks (
721   -- Primary key, introduced for privacy.
722   ipb_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
724   -- Blocked IP address in dotted-quad form or user name.
725   ipb_address tinyblob NOT NULL,
727   -- Blocked user ID or 0 for IP blocks.
728   ipb_user int unsigned NOT NULL default 0,
730   -- User ID who made the block.
731   ipb_by int unsigned NOT NULL default 0,
733   -- User name of blocker
734   ipb_by_text varchar(255) binary NOT NULL default '',
736   -- Text comment made by blocker.
737   ipb_reason tinyblob NOT NULL,
739   -- Creation (or refresh) date in standard YMDHMS form.
740   -- IP blocks expire automatically.
741   ipb_timestamp binary(14) NOT NULL default '',
743   -- Indicates that the IP address was banned because a banned
744   -- user accessed a page through it. If this is 1, ipb_address
745   -- will be hidden, and the block identified by block ID number.
746   ipb_auto bool NOT NULL default 0,
748   -- If set to 1, block applies only to logged-out users
749   ipb_anon_only bool NOT NULL default 0,
751   -- Block prevents account creation from matching IP addresses
752   ipb_create_account bool NOT NULL default 1,
754   -- Block triggers autoblocks
755   ipb_enable_autoblock bool NOT NULL default '1',
757   -- Time at which the block will expire.
758   -- May be "infinity"
759   ipb_expiry varbinary(14) NOT NULL default '',
761   -- Start and end of an address range, in hexadecimal
762   -- Size chosen to allow IPv6
763   -- FIXME: these fields were originally blank for single-IP blocks,
764   -- but now they are populated. No migration was ever done. They 
765   -- should be fixed to be blank again for such blocks (bug 49504).
766   ipb_range_start tinyblob NOT NULL,
767   ipb_range_end tinyblob NOT NULL,
769   -- Flag for entries hidden from users and Sysops
770   ipb_deleted bool NOT NULL default 0,
772   -- Block prevents user from accessing Special:Emailuser
773   ipb_block_email bool NOT NULL default 0,
775   -- Block allows user to edit their own talk page
776   ipb_allow_usertalk bool NOT NULL default 0,
778   -- ID of the block that caused this block to exist
779   -- Autoblocks set this to the original block
780   -- so that the original block being deleted also
781   -- deletes the autoblocks
782   ipb_parent_block_id int default NULL
784 ) /*$wgDBTableOptions*/;
786 -- Unique index to support "user already blocked" messages
787 -- Any new options which prevent collisions should be included
788 CREATE UNIQUE INDEX /*i*/ipb_address ON /*_*/ipblocks (ipb_address(255), ipb_user, ipb_auto, ipb_anon_only);
790 CREATE INDEX /*i*/ipb_user ON /*_*/ipblocks (ipb_user);
791 CREATE INDEX /*i*/ipb_range ON /*_*/ipblocks (ipb_range_start(8), ipb_range_end(8));
792 CREATE INDEX /*i*/ipb_timestamp ON /*_*/ipblocks (ipb_timestamp);
793 CREATE INDEX /*i*/ipb_expiry ON /*_*/ipblocks (ipb_expiry);
794 CREATE INDEX /*i*/ipb_parent_block_id ON /*_*/ipblocks (ipb_parent_block_id);
798 -- Uploaded images and other files.
800 CREATE TABLE /*_*/image (
801   -- Filename.
802   -- This is also the title of the associated description page,
803   -- which will be in namespace 6 (NS_FILE).
804   img_name varchar(255) binary NOT NULL default '' PRIMARY KEY,
806   -- File size in bytes.
807   img_size int unsigned NOT NULL default 0,
809   -- For images, size in pixels.
810   img_width int NOT NULL default 0,
811   img_height int NOT NULL default 0,
813   -- Extracted Exif metadata stored as a serialized PHP array.
814   img_metadata mediumblob NOT NULL,
816   -- For images, bits per pixel if known.
817   img_bits int NOT NULL default 0,
819   -- Media type as defined by the MEDIATYPE_xxx constants
820   img_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
822   -- major part of a MIME media type as defined by IANA
823   -- see http://www.iana.org/assignments/media-types/
824   img_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
826   -- minor part of a MIME media type as defined by IANA
827   -- the minor parts are not required to adher to any standard
828   -- but should be consistent throughout the database
829   -- see http://www.iana.org/assignments/media-types/
830   img_minor_mime varbinary(100) NOT NULL default "unknown",
832   -- Description field as entered by the uploader.
833   -- This is displayed in image upload history and logs.
834   img_description tinyblob NOT NULL,
836   -- user_id and user_name of uploader.
837   img_user int unsigned NOT NULL default 0,
838   img_user_text varchar(255) binary NOT NULL,
840   -- Time of the upload.
841   img_timestamp varbinary(14) NOT NULL default '',
843   -- SHA-1 content hash in base-36
844   img_sha1 varbinary(32) NOT NULL default ''
845 ) /*$wgDBTableOptions*/;
847 CREATE INDEX /*i*/img_usertext_timestamp ON /*_*/image (img_user_text,img_timestamp);
848 -- Used by Special:ListFiles for sort-by-size
849 CREATE INDEX /*i*/img_size ON /*_*/image (img_size);
850 -- Used by Special:Newimages and Special:ListFiles
851 CREATE INDEX /*i*/img_timestamp ON /*_*/image (img_timestamp);
852 -- Used in API and duplicate search
853 CREATE INDEX /*i*/img_sha1 ON /*_*/image (img_sha1(10));
854 -- Used to get media of one type
855 CREATE INDEX /*i*/img_media_mime ON /*_*/image (img_media_type,img_major_mime,img_minor_mime);
859 -- Previous revisions of uploaded files.
860 -- Awkwardly, image rows have to be moved into
861 -- this table at re-upload time.
863 CREATE TABLE /*_*/oldimage (
864   -- Base filename: key to image.img_name
865   oi_name varchar(255) binary NOT NULL default '',
867   -- Filename of the archived file.
868   -- This is generally a timestamp and '!' prepended to the base name.
869   oi_archive_name varchar(255) binary NOT NULL default '',
871   -- Other fields as in image...
872   oi_size int unsigned NOT NULL default 0,
873   oi_width int NOT NULL default 0,
874   oi_height int NOT NULL default 0,
875   oi_bits int NOT NULL default 0,
876   oi_description tinyblob NOT NULL,
877   oi_user int unsigned NOT NULL default 0,
878   oi_user_text varchar(255) binary NOT NULL,
879   oi_timestamp binary(14) NOT NULL default '',
881   oi_metadata mediumblob NOT NULL,
882   oi_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
883   oi_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
884   oi_minor_mime varbinary(100) NOT NULL default "unknown",
885   oi_deleted tinyint unsigned NOT NULL default 0,
886   oi_sha1 varbinary(32) NOT NULL default ''
887 ) /*$wgDBTableOptions*/;
889 CREATE INDEX /*i*/oi_usertext_timestamp ON /*_*/oldimage (oi_user_text,oi_timestamp);
890 CREATE INDEX /*i*/oi_name_timestamp ON /*_*/oldimage (oi_name,oi_timestamp);
891 -- oi_archive_name truncated to 14 to avoid key length overflow
892 CREATE INDEX /*i*/oi_name_archive_name ON /*_*/oldimage (oi_name,oi_archive_name(14));
893 CREATE INDEX /*i*/oi_sha1 ON /*_*/oldimage (oi_sha1(10));
897 -- Record of deleted file data
899 CREATE TABLE /*_*/filearchive (
900   -- Unique row id
901   fa_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
903   -- Original base filename; key to image.img_name, page.page_title, etc
904   fa_name varchar(255) binary NOT NULL default '',
906   -- Filename of archived file, if an old revision
907   fa_archive_name varchar(255) binary default '',
909   -- Which storage bin (directory tree or object store) the file data
910   -- is stored in. Should be 'deleted' for files that have been deleted;
911   -- any other bin is not yet in use.
912   fa_storage_group varbinary(16),
914   -- SHA-1 of the file contents plus extension, used as a key for storage.
915   -- eg 8f8a562add37052a1848ff7771a2c515db94baa9.jpg
916   --
917   -- If NULL, the file was missing at deletion time or has been purged
918   -- from the archival storage.
919   fa_storage_key varbinary(64) default '',
921   -- Deletion information, if this file is deleted.
922   fa_deleted_user int,
923   fa_deleted_timestamp binary(14) default '',
924   fa_deleted_reason text,
926   -- Duped fields from image
927   fa_size int unsigned default 0,
928   fa_width int default 0,
929   fa_height int default 0,
930   fa_metadata mediumblob,
931   fa_bits int default 0,
932   fa_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
933   fa_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") default "unknown",
934   fa_minor_mime varbinary(100) default "unknown",
935   fa_description tinyblob,
936   fa_user int unsigned default 0,
937   fa_user_text varchar(255) binary,
938   fa_timestamp binary(14) default '',
940   -- Visibility of deleted revisions, bitfield
941   fa_deleted tinyint unsigned NOT NULL default 0,
943   -- sha1 hash of file content
944   fa_sha1 varbinary(32) NOT NULL default ''
945 ) /*$wgDBTableOptions*/;
947 -- pick out by image name
948 CREATE INDEX /*i*/fa_name ON /*_*/filearchive (fa_name, fa_timestamp);
949 -- pick out dupe files
950 CREATE INDEX /*i*/fa_storage_group ON /*_*/filearchive (fa_storage_group, fa_storage_key);
951 -- sort by deletion time
952 CREATE INDEX /*i*/fa_deleted_timestamp ON /*_*/filearchive (fa_deleted_timestamp);
953 -- sort by uploader
954 CREATE INDEX /*i*/fa_user_timestamp ON /*_*/filearchive (fa_user_text,fa_timestamp);
955 -- find file by sha1, 10 bytes will be enough for hashes to be indexed
956 CREATE INDEX /*i*/fa_sha1 ON /*_*/filearchive (fa_sha1(10));
960 -- Store information about newly uploaded files before they're
961 -- moved into the actual filestore
963 CREATE TABLE /*_*/uploadstash (
964   us_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
966   -- the user who uploaded the file.
967   us_user int unsigned NOT NULL,
969   -- file key. this is how applications actually search for the file.
970   -- this might go away, or become the primary key.
971   us_key varchar(255) NOT NULL,
973   -- the original path
974   us_orig_path varchar(255) NOT NULL,
976   -- the temporary path at which the file is actually stored
977   us_path varchar(255) NOT NULL,
979   -- which type of upload the file came from (sometimes)
980   us_source_type varchar(50),
982   -- the date/time on which the file was added
983   us_timestamp varbinary(14) NOT NULL,
985   us_status varchar(50) NOT NULL,
987   -- chunk counter starts at 0, current offset is stored in us_size
988   us_chunk_inx int unsigned NULL,
990   -- Serialized file properties from File::getPropsFromPath
991   us_props blob,
993   -- file size in bytes
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
1005 ) /*$wgDBTableOptions*/;
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);
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()
1020 CREATE TABLE /*_*/recentchanges (
1021   rc_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
1022   rc_timestamp varbinary(14) NOT NULL default '',
1024   -- This is no longer used
1025   rc_cur_time varbinary(14) NOT NULL default '',
1027   -- As in revision
1028   rc_user int unsigned NOT NULL default 0,
1029   rc_user_text varchar(255) binary NOT NULL,
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 '',
1035   -- as in revision...
1036   rc_comment varchar(255) binary NOT NULL default '',
1037   rc_minor tinyint unsigned NOT NULL default 0,
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,
1044   -- Set if this change corresponds to a page creation
1045   rc_new tinyint unsigned NOT NULL default 0,
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,
1052   -- rev_id of the given revision
1053   rc_this_oldid int unsigned NOT NULL default 0,
1055   -- rev_id of the prior revision, for generating diff links.
1056   rc_last_oldid int unsigned NOT NULL default 0,
1058   -- The type of change entry (RC_EDIT,RC_NEW,RC_LOG,RC_EXTERNAL)
1059   rc_type tinyint unsigned NOT NULL default 0,
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,
1067   -- Recorded IP address the edit was made from, if the
1068   -- $wgPutIPinRC option is enabled.
1069   rc_ip varbinary(40) NOT NULL default '',
1071   -- Text length in characters before
1072   -- and after the edit
1073   rc_old_len int,
1074   rc_new_len int,
1076   -- Visibility of recent changes items, bitfield
1077   rc_deleted tinyint unsigned NOT NULL default 0,
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*/;
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);
1098 CREATE TABLE /*_*/watchlist (
1099   -- Key to user.user_id
1100   wl_user int unsigned NOT NULL,
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 '',
1108   -- Timestamp when user was last sent a notification e-mail;
1109   -- cleared when the user visits the page.
1110   wl_notificationtimestamp varbinary(14)
1112 ) /*$wgDBTableOptions*/;
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);
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.
1123 -- This table must be MyISAM; InnoDB does not support the needed
1124 -- fulltext index.
1126 CREATE TABLE /*_*/searchindex (
1127   -- Key to page_id
1128   si_page int unsigned NOT NULL,
1130   -- Munged version of title
1131   si_title varchar(255) NOT NULL default '',
1133   -- Munged version of body text
1134   si_text mediumtext NOT NULL
1135 ) ENGINE=MyISAM;
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);
1143 -- Recognized interwiki link prefixes
1145 CREATE TABLE /*_*/interwiki (
1146   -- The interwiki prefix, (e.g. "Meatball", or the language prefix "de")
1147   iw_prefix varchar(32) NOT NULL,
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,
1154   -- The URL of the file api.php
1155   iw_api blob NOT NULL,
1157   -- The name of the database (for a connection to be established with wfGetLB( 'wikiid' ))
1158   iw_wikiid varchar(64) NOT NULL,
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,
1164   -- Boolean value indicating whether interwiki transclusions are allowed.
1165   iw_trans tinyint NOT NULL default 0
1166 ) /*$wgDBTableOptions*/;
1168 CREATE UNIQUE INDEX /*i*/iw_prefix ON /*_*/interwiki (iw_prefix);
1172 -- Used for caching expensive grouped queries
1174 CREATE TABLE /*_*/querycache (
1175   -- A key name, generally the base name of of the special page.
1176   qc_type varbinary(32) NOT NULL,
1178   -- Some sort of stored value. Sizes, counts...
1179   qc_value int unsigned NOT NULL default 0,
1181   -- Target namespace+title
1182   qc_namespace int NOT NULL default 0,
1183   qc_title varchar(255) binary NOT NULL default ''
1184 ) /*$wgDBTableOptions*/;
1186 CREATE INDEX /*i*/qc_type ON /*_*/querycache (qc_type,qc_value);
1190 -- For a few generic cache operations if not using Memcached
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);
1201 -- Cache of interwiki transclusion
1203 CREATE TABLE /*_*/transcache (
1204   tc_url varbinary(255) NOT NULL,
1205   tc_contents text,
1206   tc_time binary(14) NOT NULL
1207 ) /*$wgDBTableOptions*/;
1209 CREATE UNIQUE INDEX /*i*/tc_url_idx ON /*_*/transcache (tc_url);
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,
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 '',
1222   -- Timestamp. Duh.
1223   log_timestamp binary(14) NOT NULL default '19700101000000',
1225   -- The user who performed this action; key to user_id
1226   log_user int unsigned NOT NULL default 0,
1228   -- Name of the user who performed this action
1229   log_user_text varchar(255) binary NOT NULL default '',
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,
1237   -- Freeform text. Interpreted as edit history comments.
1238   log_comment varchar(255) NOT NULL default '',
1240   -- miscellaneous parameters:
1241   -- LF separated list (old system) or serialized PHP array (new system)
1242   log_params blob NOT NULL,
1244   -- rev_deleted for logs
1245   log_deleted tinyint unsigned NOT NULL default 0
1246 ) /*$wgDBTableOptions*/;
1248 CREATE INDEX /*i*/type_time ON /*_*/logging (log_type, log_timestamp);
1249 CREATE INDEX /*i*/user_time ON /*_*/logging (log_user, log_timestamp);
1250 CREATE INDEX /*i*/page_time ON /*_*/logging (log_namespace, log_title, log_timestamp);
1251 CREATE INDEX /*i*/times ON /*_*/logging (log_timestamp);
1252 CREATE INDEX /*i*/log_user_type_time ON /*_*/logging (log_user, log_type, log_timestamp);
1253 CREATE INDEX /*i*/log_page_id_time ON /*_*/logging (log_page,log_timestamp);
1254 CREATE INDEX /*i*/type_action ON /*_*/logging (log_type, log_action, log_timestamp);
1257 CREATE TABLE /*_*/log_search (
1258   -- The type of ID (rev ID, log ID, rev timestamp, username)
1259   ls_field varbinary(32) NOT NULL,
1260   -- The value of the ID
1261   ls_value varchar(255) NOT NULL,
1262   -- Key to log_id
1263   ls_log_id int unsigned NOT NULL default 0
1264 ) /*$wgDBTableOptions*/;
1265 CREATE UNIQUE INDEX /*i*/ls_field_val ON /*_*/log_search (ls_field,ls_value,ls_log_id);
1266 CREATE INDEX /*i*/ls_log_id ON /*_*/log_search (ls_log_id);
1269 -- Jobs performed by parallel apache threads or a command-line daemon
1270 CREATE TABLE /*_*/job (
1271   job_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1273   -- Command name
1274   -- Limited to 60 to prevent key length overflow
1275   job_cmd varbinary(60) NOT NULL default '',
1277   -- Namespace and title to act on
1278   -- Should be 0 and '' if the command does not operate on a title
1279   job_namespace int NOT NULL,
1280   job_title varchar(255) binary NOT NULL,
1282   -- Timestamp of when the job was inserted
1283   -- NULL for jobs added before addition of the timestamp
1284   job_timestamp varbinary(14) NULL default NULL,
1286   -- Any other parameters to the command
1287   -- Stored as a PHP serialized array, or an empty string if there are no parameters
1288   job_params blob NOT NULL,
1290   -- Random, non-unique, number used for job acquisition (for lock concurrency)
1291   job_random integer unsigned NOT NULL default 0,
1293   -- The number of times this job has been locked
1294   job_attempts integer unsigned NOT NULL default 0,
1296   -- Field that conveys process locks on rows via process UUIDs
1297   job_token varbinary(32) NOT NULL default '',
1299   -- Timestamp when the job was locked
1300   job_token_timestamp varbinary(14) NULL default NULL,
1302   -- Base 36 SHA1 of the job parameters relevant to detecting duplicates
1303   job_sha1 varbinary(32) NOT NULL default ''
1304 ) /*$wgDBTableOptions*/;
1306 CREATE INDEX /*i*/job_sha1 ON /*_*/job (job_sha1);
1307 CREATE INDEX /*i*/job_cmd_token ON /*_*/job (job_cmd,job_token,job_random);
1308 CREATE INDEX /*i*/job_cmd_token_id ON /*_*/job (job_cmd,job_token,job_id);
1309 CREATE INDEX /*i*/job_cmd ON /*_*/job (job_cmd, job_namespace, job_title, job_params(128));
1310 CREATE INDEX /*i*/job_timestamp ON /*_*/job (job_timestamp);
1313 -- Details of updates to cached special pages
1314 CREATE TABLE /*_*/querycache_info (
1315   -- Special page name
1316   -- Corresponds to a qc_type value
1317   qci_type varbinary(32) NOT NULL default '',
1319   -- Timestamp of last update
1320   qci_timestamp binary(14) NOT NULL default '19700101000000'
1321 ) /*$wgDBTableOptions*/;
1323 CREATE UNIQUE INDEX /*i*/qci_type ON /*_*/querycache_info (qci_type);
1326 -- For each redirect, this table contains exactly one row defining its target
1327 CREATE TABLE /*_*/redirect (
1328   -- Key to the page_id of the redirect page
1329   rd_from int unsigned NOT NULL default 0 PRIMARY KEY,
1331   -- Key to page_namespace/page_title of the target page.
1332   -- The target page may or may not exist, and due to renames
1333   -- and deletions may refer to different page records as time
1334   -- goes by.
1335   rd_namespace int NOT NULL default 0,
1336   rd_title varchar(255) binary NOT NULL default '',
1337   rd_interwiki varchar(32) default NULL,
1338   rd_fragment varchar(255) binary default NULL
1339 ) /*$wgDBTableOptions*/;
1341 CREATE INDEX /*i*/rd_ns_title ON /*_*/redirect (rd_namespace,rd_title,rd_from);
1344 -- Used for caching expensive grouped queries that need two links (for example double-redirects)
1345 CREATE TABLE /*_*/querycachetwo (
1346   -- A key name, generally the base name of of the special page.
1347   qcc_type varbinary(32) NOT NULL,
1349   -- Some sort of stored value. Sizes, counts...
1350   qcc_value int unsigned NOT NULL default 0,
1352   -- Target namespace+title
1353   qcc_namespace int NOT NULL default 0,
1354   qcc_title varchar(255) binary NOT NULL default '',
1356   -- Target namespace+title2
1357   qcc_namespacetwo int NOT NULL default 0,
1358   qcc_titletwo varchar(255) binary NOT NULL default ''
1359 ) /*$wgDBTableOptions*/;
1361 CREATE INDEX /*i*/qcc_type ON /*_*/querycachetwo (qcc_type,qcc_value);
1362 CREATE INDEX /*i*/qcc_title ON /*_*/querycachetwo (qcc_type,qcc_namespace,qcc_title);
1363 CREATE INDEX /*i*/qcc_titletwo ON /*_*/querycachetwo (qcc_type,qcc_namespacetwo,qcc_titletwo);
1366 -- Used for storing page restrictions (i.e. protection levels)
1367 CREATE TABLE /*_*/page_restrictions (
1368   -- Page to apply restrictions to (Foreign Key to page).
1369   pr_page int NOT NULL,
1370   -- The protection type (edit, move, etc)
1371   pr_type varbinary(60) NOT NULL,
1372   -- The protection level (Sysop, autoconfirmed, etc)
1373   pr_level varbinary(60) NOT NULL,
1374   -- Whether or not to cascade the protection down to pages transcluded.
1375   pr_cascade tinyint NOT NULL,
1376   -- Field for future support of per-user restriction.
1377   pr_user int NULL,
1378   -- Field for time-limited protection.
1379   pr_expiry varbinary(14) NULL,
1380   -- Field for an ID for this restrictions row (sort-key for Special:ProtectedPages)
1381   pr_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT
1382 ) /*$wgDBTableOptions*/;
1384 CREATE UNIQUE INDEX /*i*/pr_pagetype ON /*_*/page_restrictions (pr_page,pr_type);
1385 CREATE INDEX /*i*/pr_typelevel ON /*_*/page_restrictions (pr_type,pr_level);
1386 CREATE INDEX /*i*/pr_level ON /*_*/page_restrictions (pr_level);
1387 CREATE INDEX /*i*/pr_cascade ON /*_*/page_restrictions (pr_cascade);
1390 -- Protected titles - nonexistent pages that have been protected
1391 CREATE TABLE /*_*/protected_titles (
1392   pt_namespace int NOT NULL,
1393   pt_title varchar(255) binary NOT NULL,
1394   pt_user int unsigned NOT NULL,
1395   pt_reason tinyblob,
1396   pt_timestamp binary(14) NOT NULL,
1397   pt_expiry varbinary(14) NOT NULL default '',
1398   pt_create_perm varbinary(60) NOT NULL
1399 ) /*$wgDBTableOptions*/;
1401 CREATE UNIQUE INDEX /*i*/pt_namespace_title ON /*_*/protected_titles (pt_namespace,pt_title);
1402 CREATE INDEX /*i*/pt_timestamp ON /*_*/protected_titles (pt_timestamp);
1405 -- Name/value pairs indexed by page_id
1406 CREATE TABLE /*_*/page_props (
1407   pp_page int NOT NULL,
1408   pp_propname varbinary(60) NOT NULL,
1409   pp_value blob NOT NULL
1410 ) /*$wgDBTableOptions*/;
1412 CREATE UNIQUE INDEX /*i*/pp_page_propname ON /*_*/page_props (pp_page,pp_propname);
1413 CREATE UNIQUE INDEX /*i*/pp_propname_page ON /*_*/page_props (pp_propname,pp_page);
1416 -- A table to log updates, one text key row per update.
1417 CREATE TABLE /*_*/updatelog (
1418   ul_key varchar(255) NOT NULL PRIMARY KEY,
1419   ul_value blob
1420 ) /*$wgDBTableOptions*/;
1423 -- A table to track tags for revisions, logs and recent changes.
1424 CREATE TABLE /*_*/change_tag (
1425   -- RCID for the change
1426   ct_rc_id int NULL,
1427   -- LOGID for the change
1428   ct_log_id int NULL,
1429   -- REVID for the change
1430   ct_rev_id int NULL,
1431   -- Tag applied
1432   ct_tag varchar(255) NOT NULL,
1433   -- Parameters for the tag, presently unused
1434   ct_params blob NULL
1435 ) /*$wgDBTableOptions*/;
1437 CREATE UNIQUE INDEX /*i*/change_tag_rc_tag ON /*_*/change_tag (ct_rc_id,ct_tag);
1438 CREATE UNIQUE INDEX /*i*/change_tag_log_tag ON /*_*/change_tag (ct_log_id,ct_tag);
1439 CREATE UNIQUE INDEX /*i*/change_tag_rev_tag ON /*_*/change_tag (ct_rev_id,ct_tag);
1440 -- Covering index, so we can pull all the info only out of the index.
1441 CREATE INDEX /*i*/change_tag_tag_id ON /*_*/change_tag (ct_tag,ct_rc_id,ct_rev_id,ct_log_id);
1444 -- Rollup table to pull a LIST of tags simply without ugly GROUP_CONCAT
1445 -- that only works on MySQL 4.1+
1446 CREATE TABLE /*_*/tag_summary (
1447   -- RCID for the change
1448   ts_rc_id int NULL,
1449   -- LOGID for the change
1450   ts_log_id int NULL,
1451   -- REVID for the change
1452   ts_rev_id int NULL,
1453   -- Comma-separated list of tags
1454   ts_tags blob NOT NULL
1455 ) /*$wgDBTableOptions*/;
1457 CREATE UNIQUE INDEX /*i*/tag_summary_rc_id ON /*_*/tag_summary (ts_rc_id);
1458 CREATE UNIQUE INDEX /*i*/tag_summary_log_id ON /*_*/tag_summary (ts_log_id);
1459 CREATE UNIQUE INDEX /*i*/tag_summary_rev_id ON /*_*/tag_summary (ts_rev_id);
1462 CREATE TABLE /*_*/valid_tag (
1463   vt_tag varchar(255) NOT NULL PRIMARY KEY
1464 ) /*$wgDBTableOptions*/;
1466 -- Table for storing localisation data
1467 CREATE TABLE /*_*/l10n_cache (
1468   -- Language code
1469   lc_lang varbinary(32) NOT NULL,
1470   -- Cache key
1471   lc_key varchar(255) NOT NULL,
1472   -- Value
1473   lc_value mediumblob NOT NULL
1474 ) /*$wgDBTableOptions*/;
1475 CREATE INDEX /*i*/lc_lang_key ON /*_*/l10n_cache (lc_lang, lc_key);
1477 -- Table for caching JSON message blobs for the resource loader
1478 CREATE TABLE /*_*/msg_resource (
1479   -- Resource name
1480   mr_resource varbinary(255) NOT NULL,
1481   -- Language code
1482   mr_lang varbinary(32) NOT NULL,
1483   -- JSON blob
1484   mr_blob mediumblob NOT NULL,
1485   -- Timestamp of last update
1486   mr_timestamp binary(14) NOT NULL
1487 ) /*$wgDBTableOptions*/;
1488 CREATE UNIQUE INDEX /*i*/mr_resource_lang ON /*_*/msg_resource (mr_resource, mr_lang);
1490 -- Table for administering which message is contained in which resource
1491 CREATE TABLE /*_*/msg_resource_links (
1492   mrl_resource varbinary(255) NOT NULL,
1493   -- Message key
1494   mrl_message varbinary(255) NOT NULL
1495 ) /*$wgDBTableOptions*/;
1496 CREATE UNIQUE INDEX /*i*/mrl_message_resource ON /*_*/msg_resource_links (mrl_message, mrl_resource);
1498 -- Table caching which local files a module depends on that aren't
1499 -- registered directly, used for fast retrieval of file dependency.
1500 -- Currently only used for tracking images that CSS depends on
1501 CREATE TABLE /*_*/module_deps (
1502   -- Module name
1503   md_module varbinary(255) NOT NULL,
1504   -- Skin name
1505   md_skin varbinary(32) NOT NULL,
1506   -- JSON blob with file dependencies
1507   md_deps mediumblob NOT NULL
1508 ) /*$wgDBTableOptions*/;
1509 CREATE UNIQUE INDEX /*i*/md_module_skin ON /*_*/module_deps (md_module, md_skin);
1511 -- Holds all the sites known to the wiki.
1512 CREATE TABLE /*_*/sites (
1513 -- Numeric id of the site
1514   site_id                    INT UNSIGNED        NOT NULL PRIMARY KEY AUTO_INCREMENT,
1516   -- Global identifier for the site, ie 'enwiktionary'
1517   site_global_key            varbinary(32)       NOT NULL,
1519   -- Type of the site, ie 'mediawiki'
1520   site_type                  varbinary(32)       NOT NULL,
1522   -- Group of the site, ie 'wikipedia'
1523   site_group                 varbinary(32)       NOT NULL,
1525   -- Source of the site data, ie 'local', 'wikidata', 'my-magical-repo'
1526   site_source                varbinary(32)       NOT NULL,
1528   -- Language code of the sites primary language.
1529   site_language              varbinary(32)       NOT NULL,
1531   -- Protocol of the site, ie 'http://', 'irc://', '//'
1532   -- This field is an index for lookups and is build from type specific data in site_data.
1533   site_protocol              varbinary(32)       NOT NULL,
1535   -- Domain of the site in reverse order, ie 'org.mediawiki.www.'
1536   -- This field is an index for lookups and is build from type specific data in site_data.
1537   site_domain                VARCHAR(255)        NOT NULL,
1539   -- Type dependent site data.
1540   site_data                  BLOB                NOT NULL,
1542   -- If site.tld/path/key:pageTitle should forward users to  the page on
1543   -- the actual site, where "key" is the local identifier.
1544   site_forward              bool                NOT NULL,
1546   -- Type dependent site config.
1547   -- For instance if template transclusion should be allowed if it's a MediaWiki.
1548   site_config               BLOB                NOT NULL
1549 ) /*$wgDBTableOptions*/;
1551 CREATE UNIQUE INDEX /*i*/sites_global_key ON /*_*/sites (site_global_key);
1552 CREATE INDEX /*i*/sites_type ON /*_*/sites (site_type);
1553 CREATE INDEX /*i*/sites_group ON /*_*/sites (site_group);
1554 CREATE INDEX /*i*/sites_source ON /*_*/sites (site_source);
1555 CREATE INDEX /*i*/sites_language ON /*_*/sites (site_language);
1556 CREATE INDEX /*i*/sites_protocol ON /*_*/sites (site_protocol);
1557 CREATE INDEX /*i*/sites_domain ON /*_*/sites (site_domain);
1558 CREATE INDEX /*i*/sites_forward ON /*_*/sites (site_forward);
1560 -- Links local site identifiers to their corresponding site.
1561 CREATE TABLE /*_*/site_identifiers (
1562   -- Key on site.site_id
1563   si_site                    INT UNSIGNED        NOT NULL,
1565   -- local key type, ie 'interwiki' or 'langlink'
1566   si_type                    varbinary(32)       NOT NULL,
1568   -- local key value, ie 'en' or 'wiktionary'
1569   si_key                     varbinary(32)       NOT NULL
1570 ) /*$wgDBTableOptions*/;
1572 CREATE UNIQUE INDEX /*i*/site_ids_type ON /*_*/site_identifiers (si_type, si_key);
1573 CREATE INDEX /*i*/site_ids_site ON /*_*/site_identifiers (si_site);
1574 CREATE INDEX /*i*/site_ids_key ON /*_*/site_identifiers (si_key);
1576 -- vim: sw=2 sts=2 et