maintenance/tables.sql

   1 -- SQL to create the initial tables for the MediaWiki database.
   2 -- This is read and executed by the install script; you should
   3 -- not have to run it by itself unless doing a manual install.
   4
   5 --
   6 -- General notes:
   7 --
   8 -- If possible, create tables as InnoDB to benefit from the
   9 -- superior resiliency against crashes and ability to read
  10 -- during writes (and write during reads!)
  11 --
  12 -- Only the 'searchindex' table requires MyISAM due to the
  13 -- requirement for fulltext index support, which is missing
  14 -- from InnoDB.
  15 --
  16 --
  17 -- The MySQL table backend for MediaWiki currently uses
  18 -- 14-character CHAR or VARCHAR fields to store timestamps.
  19 -- The format is YYYYMMDDHHMMSS, which is derived from the
  20 -- text format of MySQL's TIMESTAMP fields.
  21 --
  22 -- Historically TIMESTAMP fields were used, but abandoned
  23 -- in early 2002 after a lot of trouble with the fields
  24 -- auto-updating.
  25 --
  26 -- The PostgreSQL backend uses DATETIME fields for timestamps,
  27 -- and we will migrate the MySQL definitions at some point as
  28 -- well.
  29 --
  30 --
  31 -- The /*$wgDBprefix*/ comments in this and other files are
  32 -- replaced with the defined table prefix by the installer
  33 -- and updater scripts. If you are installing or running
  34 -- updates manually, you will need to manually insert the
  35 -- table prefix if any when running these scripts.
  36 --
  37
  38
  39 --
  40 -- The user table contains basic account information,
  41 -- authentication keys, etc.
  42 --
  43 -- Some multi-wiki sites may share a single central user table
  44 -- between separate wikis using the $wgSharedDB setting.
  45 --
  46 -- Note that when a external authentication plugin is used,
  47 -- user table entries still need to be created to store
  48 -- preferences and to key tracking information in the other
  49 -- tables.
  50 --
  51 CREATE TABLE /*$wgDBprefix*/user (
  52   user_id int(5) unsigned NOT NULL auto_increment,
  53
  54   -- Usernames must be unique, must not be in the form of
  55   -- an IP address. _Shouldn't_ allow slashes or case
  56   -- conflicts. Spaces are allowed, and are _not_ converted
  57   -- to underscores like titles. (Conflicts?)
  58   user_name varchar(255) binary NOT NULL default '',
  59
  60   -- Optional 'real name' to be displayed in credit listings
  61   user_real_name varchar(255) binary NOT NULL default '',
  62
  63   -- Password hashes, normally hashed like so:
  64   -- MD5(CONCAT(user_id,'-',MD5(plaintext_password)))
  65   user_password tinyblob NOT NULL default '',
  66
  67   -- When using 'mail me a new password', a random
  68   -- password is generated and the hash stored here.
  69   -- The previous password is left in place until
  70   -- someone actually logs in with the new password,
  71   -- at which point the hash is moved to user_password
  72   -- and the old password is invalidated.
  73   user_newpassword tinyblob NOT NULL default '',
  74
  75   -- Note: email should be restricted, not public info.
  76   -- Same with passwords.
  77   user_email tinytext NOT NULL default '',
  78
  79   -- Newline-separated list of name=value pairs.
  80   user_options blob NOT NULL default '',
  81
  82   -- This is a timestamp which is updated when a user
  83   -- logs in, logs out, changes preferences, or performs
  84   -- some other action requiring HTML cache invalidation
  85   -- to ensure that the UI is updated.
  86   user_touched char(14) binary NOT NULL default '',
  87
  88   -- A pseudorandomly generated value that is stored in
  89   -- a cookie when the "remember password" feature is
  90   -- used (previously, a hash of the password was used, but
  91   -- this was vulnerable to cookie-stealing attacks)
  92   user_token char(32) binary NOT NULL default '',
  93
  94   -- Initially NULL; when a user's e-mail address has been
  95   -- validated by returning with a mailed token, this is
  96   -- set to the current timestamp.
  97   user_email_authenticated CHAR(14) BINARY,
  98
  99   -- Randomly generated token created when the e-mail address
 100   -- is set and a confirmation test mail sent.
 101   user_email_token CHAR(32) BINARY,
 102
 103   -- Expiration date for the
 104   user_email_token_expires CHAR(14) BINARY,
 105
 106   PRIMARY KEY user_id (user_id),
 107   INDEX user_name (user_name(10)),
 108   INDEX (user_email_token)
 109
 110 ) TYPE=InnoDB;
 111
 112 --
 113 -- User permissions have been broken out to a separate table;
 114 -- this allows sites with a shared user table to have different
 115 -- permissions assigned to a user in each project.
 116 --
 117 -- TODO: de-blob this; it should be a property table
 118 --
 119 CREATE TABLE /*$wgDBprefix*/user_rights (
 120   -- Key to user_id
 121   ur_user int(5) unsigned NOT NULL,
 122
 123   -- Comma-separated list of permission keys
 124   ur_rights tinyblob NOT NULL default '',
 125
 126   UNIQUE KEY ur_user (ur_user)
 127
 128 ) TYPE=InnoDB;
 129
 130 -- The following table is no longer needed with Enotif >= 2.00
 131 -- Entries for newtalk on user_talk page are handled like in the watchlist table
 132 -- CREATE TABLE /*$wgDBprefix*/user_newtalk (
 133 --  user_id int(5) NOT NULL default '0',
 134 --  user_ip varchar(40) NOT NULL default '',
 135 --  INDEX user_id (user_id),
 136 --  INDEX user_ip (user_ip)
 137 -- );
 138
 139
 140 --
 141 -- Core of the wiki: each page has an entry here which identifies
 142 -- it by title and contains some essential metadata.
 143 --
 144 CREATE TABLE /*$wgDBprefix*/page (
 145   -- Unique identifier number. The page_id will be preserved across
 146   -- edits and rename operations, but not deletions and recreations.
 147   page_id int(8) unsigned NOT NULL auto_increment,
 148
 149   -- A page name is broken into a namespace and a title.
 150   -- The namespace keys are UI-language-independent constants,
 151   -- defined in Namespace.php.
 152   page_namespace int NOT NULL,
 153
 154   -- The rest of the title, as text.
 155   -- Spaces are transformed into underscores in title storage.
 156   page_title varchar(255) binary NOT NULL,
 157
 158   -- Comma-separated set of permission keys indicating who
 159   -- can move or edit the page.
 160   page_restrictions tinyblob NOT NULL default '',
 161
 162   -- Number of times this page has been viewed.
 163   page_counter bigint(20) unsigned NOT NULL default '0',
 164
 165   -- 1 indicates the article is a redirect.
 166   page_is_redirect tinyint(1) unsigned NOT NULL default '0',
 167
 168   -- 1 indicates this is a new entry, with only one edit.
 169   -- Not all pages with one edit are new pages.
 170   page_is_new tinyint(1) unsigned NOT NULL default '0',
 171
 172   -- Random value between 0 and 1, used for Special:Randompage
 173   page_random real unsigned NOT NULL,
 174
 175   -- This timestamp is updated whenever the page changes in
 176   -- a way requiring it to be re-rendered, invalidating caches.
 177   -- Aside from editing this includes permission changes,
 178   -- creation or deletion of linked pages, and alteration
 179   -- of contained templates.
 180   page_touched char(14) binary NOT NULL default '',
 181
 182   -- Handy key to revision.rev_id of the current revision.
 183   -- This may be 0 during page creation, but that shouldn't
 184   -- happen outside of a transaction... hopefully.
 185   page_latest int(8) unsigned NOT NULL,
 186
 187   -- Uncompressed length in bytes of the page's current source text.
 188   page_len int(8) unsigned NOT NULL,
 189
 190   PRIMARY KEY page_id (page_id),
 191   UNIQUE INDEX name_title (page_namespace,page_title),
 192
 193   -- Special-purpose indexes
 194   INDEX (page_random),
 195   INDEX (page_len)
 196
 197 ) TYPE=InnoDB;
 198
 199 --
 200 -- Every edit of a page creates also a revision row.
 201 -- This stores metadata about the revision, and a reference
 202 -- to the text storage backend.
 203 --
 204 CREATE TABLE /*$wgDBprefix*/revision (
 205   rev_id int(8) unsigned NOT NULL auto_increment,
 206
 207   -- Key to page_id. This should _never_ be invalid.
 208   rev_page int(8) unsigned NOT NULL,
 209
 210   -- Key to text.old_id, where the actual bulk text is stored.
 211   -- It's possible for multiple revisions to use the same text,
 212   -- for instance revisions where only metadata is altered
 213   -- or a rollback to a previous version.
 214   rev_text_id int(8) unsigned NOT NULL,
 215
 216   -- Text comment summarizing the change.
 217   -- This text is shown in the history and other changes lists,
 218   -- rendered in a subset of wiki markup.
 219   rev_comment tinyblob NOT NULL default '',
 220
 221   -- Key to user_id of the user who made this edit.
 222   -- Stores 0 for anonymous edits and for some mass imports.
 223   rev_user int(5) unsigned NOT NULL default '0',
 224
 225   -- Text username or IP address of the editor.
 226   rev_user_text varchar(255) binary NOT NULL default '',
 227
 228   -- Timestamp
 229   rev_timestamp char(14) binary NOT NULL default '',
 230
 231   -- Records whether the user marked the 'minor edit' checkbox.
 232   -- Many automated edits are marked as minor.
 233   rev_minor_edit tinyint(1) unsigned NOT NULL default '0',
 234
 235   -- Not yet used; reserved for future changes to the deletion system.
 236   rev_deleted tinyint(1) unsigned NOT NULL default '0',
 237
 238   PRIMARY KEY rev_page_id (rev_page, rev_id),
 239   UNIQUE INDEX rev_id (rev_id),
 240   INDEX rev_timestamp (rev_timestamp),
 241   INDEX page_timestamp (rev_page,rev_timestamp),
 242   INDEX user_timestamp (rev_user,rev_timestamp),
 243   INDEX usertext_timestamp (rev_user_text,rev_timestamp)
 244
 245 ) TYPE=InnoDB;
 246
 247
 248 --
 249 -- Holds text of individual page revisions.
 250 --
 251 -- Field names are a holdover from the 'old' revisions table in
 252 -- MediaWiki 1.4 and earlier: an upgrade will transform that
 253 -- table into the 'text' table to minimize unnecessary churning
 254 -- and downtime. If upgrading, the other fields will be left unused.
 255 --
 256 CREATE TABLE /*$wgDBprefix*/text (
 257   -- Unique text storage key number.
 258   -- Note that the 'oldid' parameter used in URLs does *not*
 259   -- refer to this number anymore, but to rev_id.
 260   old_id int(8) unsigned NOT NULL auto_increment,
 261
 262   -- Depending on the contents of the old_flags field, the text
 263   -- may be convenient plain text, or it may be funkily encoded.
 264   old_text mediumtext NOT NULL default '',
 265
 266   -- Comma-separated list of flags:
 267   -- gzip: text is compressed with PHP's gzdeflate() function.
 268   -- utf8: text was stored as UTF-8.
 269   --       If $wgLegacyEncoding option is on, rows *without* this flag
 270   --       will be converted to UTF-8 transparently at load time.
 271   -- object: text field contained a serialized PHP object.
 272   --         The object either contains multiple versions compressed
 273   --         together to achieve a better compression ratio, or it refers
 274   --         to another row where the text can be found.
 275   old_flags tinyblob NOT NULL default '',
 276
 277   PRIMARY KEY old_id (old_id)
 278
 279 ) TYPE=InnoDB;
 280
 281 --
 282 -- Holding area for deleted articles, which may be viewed
 283 -- or restored by admins through the Special:Undelete interface.
 284 -- The fields generally correspond to the page, revision, and text
 285 -- fields, with several caveats.
 286 --
 287 CREATE TABLE /*$wgDBprefix*/archive (
 288   ar_namespace int NOT NULL default '0',
 289   ar_title varchar(255) binary NOT NULL default '',
 290
 291   -- Newly deleted pages will not store text in this table,
 292   -- but will reference the separately existing text rows.
 293   -- This field is retained for backwards compatibility,
 294   -- so old archived pages will remain accessible after
 295   -- upgrading from 1.4 to 1.5.
 296   ar_text mediumtext NOT NULL default '',
 297
 298   -- Basic revision stuff...
 299   ar_comment tinyblob NOT NULL default '',
 300   ar_user int(5) unsigned NOT NULL default '0',
 301   ar_user_text varchar(255) binary NOT NULL,
 302   ar_timestamp char(14) binary NOT NULL default '',
 303   ar_minor_edit tinyint(1) NOT NULL default '0',
 304
 305   -- See ar_text note.
 306   ar_flags tinyblob NOT NULL default '',
 307
 308   -- When revisions are deleted, their unique rev_id is stored
 309   -- here so it can be retained after undeletion. This is necessary
 310   -- to retain permalinks to given revisions after accidental delete
 311   -- cycles or messy operations like history merges.
 312   --
 313   -- Old entries from 1.4 will be NULL here, and a new rev_id will
 314   -- be created on undeletion for those revisions.
 315   ar_rev_id int(8) unsigned,
 316
 317   -- For newly deleted revisions, this is the text.old_id key to the
 318   -- actual stored text. To avoid breaking the block-compression scheme
 319   -- and otherwise making storage changes harder, the actual text is
 320   -- *not* deleted from the text table, merely hidden by removal of the
 321   -- page and revision entries.
 322   --
 323   -- Old entries deleted under 1.2-1.4 will have NULL here, and their
 324   -- ar_text and ar_flags fields will be used to create a new text
 325   -- row upon undeletion.
 326   ar_text_id int(8) unsigned,
 327
 328   KEY name_title_timestamp (ar_namespace,ar_title,ar_timestamp)
 329
 330 ) TYPE=InnoDB;
 331
 332 --
 333 -- Track links within the wiki that do exist.
 334 -- These rows must be removed when the target page is
 335 -- deleted, and replaced with brokenlinks entries.
 336 -- They must also be updated if a target page is renamed.
 337 --
 338 CREATE TABLE /*$wgDBprefix*/links (
 339   -- Key to the page_id of the page containing the link.
 340   l_from int(8) unsigned NOT NULL default '0',
 341
 342   -- Key to the page_id of the link target.
 343   -- An unfortunate consequence of this is that rename
 344   -- operations require changing the links entries for
 345   -- all links to the moved page.
 346   l_to int(8) unsigned NOT NULL default '0',
 347
 348   UNIQUE KEY l_from(l_from,l_to),
 349   KEY (l_to)
 350
 351 ) TYPE=InnoDB;
 352
 353 --
 354 -- Track links to pages that don't yet exist.
 355 -- These rows must be removed when the target page
 356 -- is created, and replaced with links table entries.
 357 --
 358 CREATE TABLE /*$wgDBprefix*/brokenlinks (
 359   -- Key to the page_id of the page containing the link.
 360   bl_from int(8) unsigned NOT NULL default '0',
 361
 362   -- Text of the target page title ("namesapce:title").
 363   -- Unfortunately this doesn't split the namespace index
 364   -- key and therefore can't easily be joined to anything.
 365   bl_to varchar(255) binary NOT NULL default '',
 366   UNIQUE KEY bl_from(bl_from,bl_to),
 367   KEY (bl_to)
 368
 369 ) TYPE=InnoDB;
 370
 371 --
 372 -- Track links to images *used inline*
 373 -- We don't distinguish live from broken links here, so
 374 -- they do not need to be changed on upload/removal.
 375 --
 376 CREATE TABLE /*$wgDBprefix*/imagelinks (
 377   -- Key to page_id of the page containing the image / media link.
 378   il_from int(8) unsigned NOT NULL default '0',
 379
 380   -- Filename of target image.
 381   -- This is also the page_title of the file's description page;
 382   -- all such pages are in namespace 6 (NS_IMAGE).
 383   il_to varchar(255) binary NOT NULL default '',
 384
 385   UNIQUE KEY il_from(il_from,il_to),
 386   KEY (il_to)
 387
 388 ) TYPE=InnoDB;
 389
 390 --
 391 -- Track category inclusions *used inline*
 392 -- This tracks a single level of category membership
 393 -- (folksonomic tagging, really).
 394 --
 395 CREATE TABLE /*$wgDBprefix*/categorylinks (
 396   -- Key to page_id of the page defined as a category member.
 397   cl_from int(8) unsigned NOT NULL default '0',
 398
 399   -- Name of the category.
 400   -- This is also the page_title of the category's description page;
 401   -- all such pages are in namespace 14 (NS_CATEGORY).
 402   cl_to varchar(255) binary NOT NULL default '',
 403
 404   -- The title of the linking page, or an optional override
 405   -- to determine sort order. Sorting is by binary order, which
 406   -- isn't always ideal, but collations seem to be an exciting
 407   -- and dangerous new world in MySQL...
 408   cl_sortkey varchar(255) binary NOT NULL default '',
 409
 410   -- This isn't really used at present. Provided for an optional
 411   -- sorting method by approximate addition time.
 412   cl_timestamp timestamp NOT NULL,
 413
 414   UNIQUE KEY cl_from(cl_from,cl_to),
 415
 416   -- This key is trouble. It's incomplete, AND it's too big
 417   -- when collation is set to UTF-8. Bleeeacch!
 418   KEY cl_sortkey(cl_to,cl_sortkey(128)),
 419
 420   -- Not really used?
 421   KEY cl_timestamp(cl_to,cl_timestamp)
 422
 423 ) TYPE=InnoDB;
 424
 425 --
 426 -- Stores (possibly gzipped) serialized objects with
 427 -- cache arrays to reduce database load slurping up
 428 -- from links and brokenlinks.
 429 --
 430 CREATE TABLE /*$wgDBprefix*/linkscc (
 431   lcc_pageid INT UNSIGNED NOT NULL UNIQUE KEY,
 432   lcc_cacheobj MEDIUMBLOB NOT NULL
 433
 434 ) TYPE=InnoDB;
 435
 436 --
 437 -- Contains a single row with some aggregate info
 438 -- on the state of the site.
 439 --
 440 CREATE TABLE /*$wgDBprefix*/site_stats (
 441   -- The single row should contain 1 here.
 442   ss_row_id int(8) unsigned NOT NULL,
 443
 444   -- Total number of page views, if hit counters are enabled.
 445   ss_total_views bigint(20) unsigned default '0',
 446
 447   -- Total number of edits performed.
 448   ss_total_edits bigint(20) unsigned default '0',
 449
 450   -- An approximate count of pages matching the following criteria:
 451   -- * in namespace 0
 452   -- * not a redirect
 453   -- * contains the text '[['
 454   -- See isCountable() in includes/Article.php
 455   ss_good_articles bigint(20) unsigned default '0',
 456
 457   UNIQUE KEY ss_row_id (ss_row_id)
 458
 459 ) TYPE=InnoDB;
 460
 461 --
 462 -- Stores an ID for every time any article is visited;
 463 -- depending on $wgHitcounterUpdateFreq, it is
 464 -- periodically cleared and the cur_counter column
 465 -- in the cur table updated for the all articles
 466 -- that have been visited.)
 467 --
 468 CREATE TABLE /*$wgDBprefix*/hitcounter (
 469   hc_id INTEGER UNSIGNED NOT NULL
 470 ) TYPE=HEAP MAX_ROWS=25000;
 471
 472
 473 --
 474 -- The internet is full of jerks, alas. Sometimes it's handy
 475 -- to block a vandal or troll account.
 476 --
 477 CREATE TABLE /*$wgDBprefix*/ipblocks (
 478   -- Primary key, introduced for privacy.
 479   ipb_id int(8) NOT NULL auto_increment,
 480
 481   -- Blocked IP address in dotted-quad form or user name.
 482   ipb_address varchar(40) binary NOT NULL default '',
 483
 484   -- Blocked user ID or 0 for IP blocks.
 485   ipb_user int(8) unsigned NOT NULL default '0',
 486
 487   -- User ID who made the block.
 488   ipb_by int(8) unsigned NOT NULL default '0',
 489
 490   -- Text comment made by blocker.
 491   ipb_reason tinyblob NOT NULL default '',
 492
 493   -- Creation (or refresh) date in standard YMDHMS form.
 494   -- IP blocks expire automatically.
 495   ipb_timestamp char(14) binary NOT NULL default '',
 496
 497   -- Indicates that the IP address was banned because a banned
 498   -- user accessed a page through it. If this is 1, ipb_address
 499   -- will be hidden, and the block identified by block ID number.
 500   ipb_auto tinyint(1) NOT NULL default '0',
 501
 502   -- Time at which the block will expire.
 503   ipb_expiry char(14) binary NOT NULL default '',
 504
 505   PRIMARY KEY ipb_id (ipb_id),
 506   INDEX ipb_address (ipb_address),
 507   INDEX ipb_user (ipb_user)
 508
 509 ) TYPE=InnoDB;
 510
 511
 512 --
 513 -- Uploaded images and other files.
 514 --
 515 CREATE TABLE /*$wgDBprefix*/image (
 516   -- Filename.
 517   -- This is also the title of the associated description page,
 518   -- which will be in namespace 6 (NS_IMAGE).
 519   img_name varchar(255) binary NOT NULL default '',
 520
 521   -- File size in bytes.
 522   img_size int(8) unsigned NOT NULL default '0',
 523
 524   -- For images, size in pixels.
 525   img_width int(5)  NOT NULL default '0',
 526   img_height int(5)  NOT NULL default '0',
 527
 528   -- Extracted EXIF metadata stored as a serialized PHP array.
 529   img_metadata mediumblob NOT NULL,
 530
 531   -- For images, bits per pixel if known.
 532   img_bits int(3)  NOT NULL default '0',
 533
 534   -- Media type as defined by the MEDIATYPE_xxx constants
 535   img_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
 536
 537   -- major part of a MIME media type as defined by IANA
 538   -- see http://www.iana.org/assignments/media-types/
 539   img_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
 540
 541   -- minor part of a MIME media type as defined by IANA
 542   -- the minor parts are not required to adher to any standard
 543   -- but should be consistent throughout the database
 544   -- see http://www.iana.org/assignments/media-types/
 545   img_minor_mime varchar(32) NOT NULL default "unknown",
 546
 547   -- Description field as entered by the uploader.
 548   -- This is displayed in image upload history and logs.
 549   img_description tinyblob NOT NULL default '',
 550
 551   -- user_id and user_name of uploader.
 552   img_user int(5) unsigned NOT NULL default '0',
 553   img_user_text varchar(255) binary NOT NULL default '',
 554
 555   -- Time of the upload.
 556   img_timestamp char(14) binary NOT NULL default '',
 557
 558   PRIMARY KEY img_name (img_name),
 559
 560   -- Used by Special:Imagelist for sort-by-size
 561   INDEX img_size (img_size),
 562
 563   -- Used by Special:Newimages and Special:Imagelist
 564   INDEX img_timestamp (img_timestamp)
 565
 566 ) TYPE=InnoDB;
 567
 568 --
 569 -- Previous revisions of uploaded files.
 570 -- Awkwardly, image rows have to be moved into
 571 -- this table at re-upload time.
 572 --
 573 CREATE TABLE /*$wgDBprefix*/oldimage (
 574   -- Base filename: key to image.img_name
 575   oi_name varchar(255) binary NOT NULL default '',
 576
 577   -- Filename of the archived file.
 578   -- This is generally a timestamp and '!' prepended to the base name.
 579   oi_archive_name varchar(255) binary NOT NULL default '',
 580
 581   -- Other fields as in image...
 582   oi_size int(8) unsigned NOT NULL default 0,
 583   oi_width int(5) NOT NULL default 0,
 584   oi_height int(5) NOT NULL default 0,
 585   oi_bits int(3) NOT NULL default 0,
 586   oi_description tinyblob NOT NULL default '',
 587   oi_user int(5) unsigned NOT NULL default '0',
 588   oi_user_text varchar(255) binary NOT NULL default '',
 589   oi_timestamp char(14) binary NOT NULL default '',
 590
 591   INDEX oi_name (oi_name(10))
 592
 593 ) TYPE=InnoDB;
 594
 595
 596 --
 597 -- Primarily a summary table for Special:Recentchanges,
 598 -- this table contains some additional info on edits from
 599 -- the last few days.
 600 --
 601 CREATE TABLE /*$wgDBprefix*/recentchanges (
 602   rc_id int(8) NOT NULL auto_increment,
 603   rc_timestamp varchar(14) binary NOT NULL default '',
 604   rc_cur_time varchar(14) binary NOT NULL default '',
 605
 606   -- As in revision
 607   rc_user int(10) unsigned NOT NULL default '0',
 608   rc_user_text varchar(255) binary NOT NULL default '',
 609
 610   -- When pages are renamed, their RC entries do _not_ change.
 611   rc_namespace int NOT NULL default '0',
 612   rc_title varchar(255) binary NOT NULL default '',
 613
 614   -- as in revision...
 615   rc_comment varchar(255) binary NOT NULL default '',
 616   rc_minor tinyint(3) unsigned NOT NULL default '0',
 617
 618   -- Edits by user accounts with the 'bot' rights key are
 619   -- marked with a 1 here, and will be hidden from the
 620   -- default view.
 621   rc_bot tinyint(3) unsigned NOT NULL default '0',
 622
 623   rc_new tinyint(3) unsigned NOT NULL default '0',
 624
 625   -- Key to page_id (was cur_id prior to 1.5).
 626   -- This will keep links working after moves while
 627   -- retaining the at-the-time name in the changes list.
 628   rc_cur_id int(10) unsigned NOT NULL default '0',
 629
 630   -- rev_id of the given revision
 631   rc_this_oldid int(10) unsigned NOT NULL default '0',
 632
 633   -- rev_id of the prior revision, for generating diff links.
 634   rc_last_oldid int(10) unsigned NOT NULL default '0',
 635
 636   -- These may no longer be used, with the new move log.
 637   rc_type tinyint(3) unsigned NOT NULL default '0',
 638   rc_moved_to_ns tinyint(3) unsigned NOT NULL default '0',
 639   rc_moved_to_title varchar(255) binary NOT NULL default '',
 640
 641   -- If the Recent Changes Patrol option is enabled,
 642   -- users may mark edits as having been reviewed to
 643   -- remove a warning flag on the RC list.
 644   -- A value of 1 indicates the page has been reviewed.
 645   rc_patrolled tinyint(3) unsigned NOT NULL default '0',
 646
 647   -- Recorded IP address the edit was made from, if the
 648   -- $wgPutIPinRC option is enabled.
 649   rc_ip char(15) NOT NULL default '',
 650
 651   PRIMARY KEY rc_id (rc_id),
 652   INDEX rc_timestamp (rc_timestamp),
 653   INDEX rc_namespace_title (rc_namespace, rc_title),
 654   INDEX rc_cur_id (rc_cur_id),
 655   INDEX new_name_timestamp(rc_new,rc_namespace,rc_timestamp),
 656   INDEX rc_ip (rc_ip)
 657
 658 ) TYPE=InnoDB;
 659
 660 CREATE TABLE /*$wgDBprefix*/watchlist (
 661   -- Key to user_id
 662   wl_user int(5) unsigned NOT NULL,
 663
 664   -- Key to page_namespace/page_title
 665   -- Note that users may watch patches which do not exist yet,
 666   -- or existed in the past but have been deleted.
 667   wl_namespace int NOT NULL default '0',
 668   wl_title varchar(255) binary NOT NULL default '',
 669
 670   -- Timestamp when user was last sent a notification e-mail;
 671   -- cleared when the user visits the page.
 672   -- FIXME: add proper null support etc
 673   wl_notificationtimestamp varchar(14) binary NOT NULL default '0',
 674
 675   UNIQUE KEY (wl_user, wl_namespace, wl_title),
 676   KEY namespace_title (wl_namespace,wl_title)
 677
 678 ) TYPE=InnoDB;
 679
 680
 681 --
 682 -- Used by texvc math-rendering extension to keep track
 683 -- of previously-rendered items.
 684 --
 685 CREATE TABLE /*$wgDBprefix*/math (
 686   -- Binary MD5 hash of the latex fragment, used as an identifier key.
 687   math_inputhash varchar(16) NOT NULL,
 688
 689   -- Not sure what this is, exactly...
 690   math_outputhash varchar(16) NOT NULL,
 691
 692   -- texvc reports how well it thinks the HTML conversion worked;
 693   -- if it's a low level the PNG rendering may be preferred.
 694   math_html_conservativeness tinyint(1) NOT NULL,
 695
 696   -- HTML output from texvc, if any
 697   math_html text,
 698
 699   -- MathML output from texvc, if any
 700   math_mathml text,
 701
 702   UNIQUE KEY math_inputhash (math_inputhash)
 703
 704 ) TYPE=InnoDB;
 705
 706 --
 707 -- When using the default MySQL search backend, page titles
 708 -- and text are munged to strip markup, do Unicode case folding,
 709 -- and prepare the result for MySQL's fulltext index.
 710 --
 711 -- This table must be MyISAM; InnoDB does not support the needed
 712 -- fulltext index.
 713 --
 714 CREATE TABLE /*$wgDBprefix*/searchindex (
 715   -- Key to page_id
 716   si_page int(8) unsigned NOT NULL,
 717
 718   -- Munged version of title
 719   si_title varchar(255) NOT NULL default '',
 720
 721   -- Munged version of body text
 722   si_text mediumtext NOT NULL default '',
 723
 724   UNIQUE KEY (si_page),
 725   FULLTEXT si_title (si_title),
 726   FULLTEXT si_text (si_text)
 727
 728 ) TYPE=MyISAM;
 729
 730 --
 731 -- Recognized interwiki link prefixes
 732 --
 733 CREATE TABLE /*$wgDBprefix*/interwiki (
 734   -- The interwiki prefix, (e.g. "Meatball", or the language prefix "de")
 735   iw_prefix char(32) NOT NULL,
 736
 737   -- The URL of the wiki, with "$1" as a placeholder for an article name.
 738   -- Any spaces in the name will be transformed to underscores before
 739   -- insertion.
 740   iw_url char(127) NOT NULL,
 741
 742   -- A boolean value indicating whether the wiki is in this project
 743   -- (used, for example, to detect redirect loops)
 744   iw_local BOOL NOT NULL,
 745
 746   UNIQUE KEY iw_prefix (iw_prefix)
 747
 748 ) TYPE=InnoDB;
 749
 750 --
 751 -- Used for caching expensive grouped queries
 752 --
 753 CREATE TABLE /*$wgDBprefix*/querycache (
 754   -- A key name, generally the base name of of the special page.
 755   qc_type char(32) NOT NULL,
 756
 757   -- Some sort of stored value. Sizes, counts...
 758   qc_value int(5) unsigned NOT NULL default '0',
 759
 760   -- Target namespace+title
 761   qc_namespace int NOT NULL default '0',
 762   qc_title char(255) binary NOT NULL default '',
 763
 764   KEY (qc_type,qc_value)
 765
 766 ) TYPE=InnoDB;
 767
 768 --
 769 -- For a few generic cache operations if not using Memcached
 770 --
 771 CREATE TABLE /*$wgDBprefix*/objectcache (
 772   keyname char(255) binary not null default '',
 773   value mediumblob,
 774   exptime datetime,
 775   unique key (keyname),
 776   key (exptime)
 777
 778 ) TYPE=InnoDB;
 779
 780 -- For article validation
 781 CREATE TABLE /*$wgDBprefix*/validate (
 782   `val_user` int(11) NOT NULL default '0',
 783   `val_page` int(11) unsigned NOT NULL default '0',
 784   `val_revision` int(11) unsigned NOT NULL default '0',
 785   `val_type` int(11) unsigned NOT NULL default '0',
 786   `val_value` int(11) default '0',
 787   `val_comment` varchar(255) NOT NULL default '',
 788   KEY `val_user` (`val_user`,`val_revision`)
 789 ) TYPE=InnoDB;
 790
 791
 792 CREATE TABLE /*$wgDBprefix*/logging (
 793   -- Symbolic keys for the general log type and the action type
 794   -- within the log. The output format will be controlled by the
 795   -- action field, but only the type controls categorization.
 796   log_type char(10) NOT NULL default '',
 797   log_action char(10) NOT NULL default '',
 798
 799   -- Timestamp. Duh.
 800   log_timestamp char(14) NOT NULL default '19700101000000',
 801
 802   -- The user who performed this action; key to user_id
 803   log_user int unsigned NOT NULL default 0,
 804
 805   -- Key to the page affected. Where a user is the target,
 806   -- this will point to the user page.
 807   log_namespace int NOT NULL default 0,
 808   log_title varchar(255) binary NOT NULL default '',
 809
 810   -- Freeform text. Interpreted as edit history comments.
 811   log_comment varchar(255) NOT NULL default '',
 812
 813   -- LF separated list of miscellaneous parameters
 814   log_params blob NOT NULL default '',
 815
 816   KEY type_time (log_type, log_timestamp),
 817   KEY user_time (log_user, log_timestamp),
 818   KEY page_time (log_namespace, log_title, log_timestamp)
 819
 820 ) TYPE=InnoDB;
 821
 822
 823
 824
 825
 826 -- Hold group name and description
 827 CREATE TABLE /*$wgDBprefix*/groups (
 828   gr_id int(5) unsigned NOT NULL auto_increment,
 829   gr_name varchar(50) NOT NULL default '',
 830   gr_description varchar(255) NOT NULL default '',
 831   gr_rights tinyblob,
 832   PRIMARY KEY  (gr_id)
 833
 834 ) TYPE=InnoDB;
 835
 836 -- Relation table between user and groups
 837 CREATE TABLE /*$wgDBprefix*/user_groups (
 838         ug_user int(5) unsigned NOT NULL default '0',
 839         ug_group int(5) unsigned NOT NULL default '0',
 840         PRIMARY KEY  (ug_user,ug_group)
 841
 842 ) TYPE=InnoDB;