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. See the User::newFromName() for
  58   -- the specific tests that usernames have to pass.
  59   user_name varchar(255) binary NOT NULL default '',
  60
  61   -- Optional 'real name' to be displayed in credit listings
  62   user_real_name varchar(255) binary NOT NULL default '',
  63
  64   -- Password hashes, normally hashed like so:
  65   -- MD5(CONCAT(user_id,'-',MD5(plaintext_password))), see
  66   -- wfEncryptPassword() in GlobalFunctions.php
  67   user_password tinyblob NOT NULL default '',
  68
  69   -- When using 'mail me a new password', a random
  70   -- password is generated and the hash stored here.
  71   -- The previous password is left in place until
  72   -- someone actually logs in with the new password,
  73   -- at which point the hash is moved to user_password
  74   -- and the old password is invalidated.
  75   user_newpassword tinyblob NOT NULL default '',
  76
  77   -- Note: email should be restricted, not public info.
  78   -- Same with passwords.
  79   user_email tinytext NOT NULL default '',
  80
  81   -- Newline-separated list of name=value defining the user
  82   -- preferences
  83   user_options blob NOT NULL default '',
  84
  85   -- This is a timestamp which is updated when a user
  86   -- logs in, logs out, changes preferences, or performs
  87   -- some other action requiring HTML cache invalidation
  88   -- to ensure that the UI is updated.
  89   user_touched char(14) binary NOT NULL default '',
  90
  91   -- A pseudorandomly generated value that is stored in
  92   -- a cookie when the "remember password" feature is
  93   -- used (previously, a hash of the password was used, but
  94   -- this was vulnerable to cookie-stealing attacks)
  95   user_token char(32) binary NOT NULL default '',
  96
  97   -- Initially NULL; when a user's e-mail address has been
  98   -- validated by returning with a mailed token, this is
  99   -- set to the current timestamp.
 100   user_email_authenticated CHAR(14) BINARY,
 101
 102   -- Randomly generated token created when the e-mail address
 103   -- is set and a confirmation test mail sent.
 104   user_email_token CHAR(32) BINARY,
 105
 106   -- Expiration date for the user_email_token
 107   user_email_token_expires CHAR(14) BINARY,
 108
 109   -- Timestamp of account registration.
 110   -- Accounts predating this schema addition may contain NULL.
 111   user_registration CHAR(14) BINARY,
 112
 113   PRIMARY KEY user_id (user_id),
 114   UNIQUE INDEX user_name (user_name),
 115   INDEX (user_email_token)
 116
 117 ) TYPE=InnoDB;
 118
 119 --
 120 -- User permissions have been broken out to a separate table;
 121 -- this allows sites with a shared user table to have different
 122 -- permissions assigned to a user in each project.
 123 --
 124 -- This table replaces the old user_rights field which used a
 125 -- comma-separated blob.
 126 --
 127 CREATE TABLE /*$wgDBprefix*/user_groups (
 128   -- Key to user_id
 129   ug_user int(5) unsigned NOT NULL default '0',
 130
 131   -- Group names are short symbolic string keys.
 132   -- The set of group names is open-ended, though in practice
 133   -- only some predefined ones are likely to be used.
 134   --
 135   -- At runtime $wgGroupPermissions will associate group keys
 136   -- with particular permissions. A user will have the combined
 137   -- permissions of any group they're explicitly in, plus
 138   -- the implicit '*' and 'user' groups.
 139   ug_group char(16) NOT NULL default '',
 140
 141   PRIMARY KEY (ug_user,ug_group),
 142   KEY (ug_group)
 143 ) TYPE=InnoDB;
 144
 145 -- Stores notifications of user talk page changes, for the display
 146 -- of the "you have new messages" box
 147 CREATE TABLE /*$wgDBprefix*/user_newtalk (
 148   -- Key to user.user_id
 149   user_id int(5) NOT NULL default '0',
 150   -- If the user is an anonymous user hir IP address is stored here
 151   -- since the user_id of 0 is ambiguous
 152   user_ip varchar(40) NOT NULL default '',
 153   INDEX user_id (user_id),
 154   INDEX user_ip (user_ip)
 155 );
 156
 157
 158 --
 159 -- Core of the wiki: each page has an entry here which identifies
 160 -- it by title and contains some essential metadata.
 161 --
 162 CREATE TABLE /*$wgDBprefix*/page (
 163   -- Unique identifier number. The page_id will be preserved across
 164   -- edits and rename operations, but not deletions and recreations.
 165   page_id int(8) unsigned NOT NULL auto_increment,
 166
 167   -- A page name is broken into a namespace and a title.
 168   -- The namespace keys are UI-language-independent constants,
 169   -- defined in includes/Defines.php
 170   page_namespace int NOT NULL,
 171
 172   -- The rest of the title, as text.
 173   -- Spaces are transformed into underscores in title storage.
 174   page_title varchar(255) binary NOT NULL,
 175
 176   -- Comma-separated set of permission keys indicating who
 177   -- can move or edit the page.
 178   page_restrictions tinyblob NOT NULL default '',
 179
 180   -- Number of times this page has been viewed.
 181   page_counter bigint(20) unsigned NOT NULL default '0',
 182
 183   -- 1 indicates the article is a redirect.
 184   page_is_redirect tinyint(1) unsigned NOT NULL default '0',
 185
 186   -- 1 indicates this is a new entry, with only one edit.
 187   -- Not all pages with one edit are new pages.
 188   page_is_new tinyint(1) unsigned NOT NULL default '0',
 189
 190   -- Random value between 0 and 1, used for Special:Randompage
 191   page_random real unsigned NOT NULL,
 192
 193   -- This timestamp is updated whenever the page changes in
 194   -- a way requiring it to be re-rendered, invalidating caches.
 195   -- Aside from editing this includes permission changes,
 196   -- creation or deletion of linked pages, and alteration
 197   -- of contained templates.
 198   page_touched char(14) binary NOT NULL default '',
 199
 200   -- Handy key to revision.rev_id of the current revision.
 201   -- This may be 0 during page creation, but that shouldn't
 202   -- happen outside of a transaction... hopefully.
 203   page_latest int(8) unsigned NOT NULL,
 204
 205   -- Uncompressed length in bytes of the page's current source text.
 206   page_len int(8) unsigned NOT NULL,
 207
 208   PRIMARY KEY page_id (page_id),
 209   UNIQUE INDEX name_title (page_namespace,page_title),
 210
 211   -- Special-purpose indexes
 212   INDEX (page_random),
 213   INDEX (page_len)
 214
 215 ) TYPE=InnoDB;
 216
 217 --
 218 -- Every edit of a page creates also a revision row.
 219 -- This stores metadata about the revision, and a reference
 220 -- to the text storage backend.
 221 --
 222 CREATE TABLE /*$wgDBprefix*/revision (
 223   rev_id int(8) unsigned NOT NULL auto_increment,
 224
 225   -- Key to page_id. This should _never_ be invalid.
 226   rev_page int(8) unsigned NOT NULL,
 227
 228   -- Key to text.old_id, where the actual bulk text is stored.
 229   -- It's possible for multiple revisions to use the same text,
 230   -- for instance revisions where only metadata is altered
 231   -- or a rollback to a previous version.
 232   rev_text_id int(8) unsigned NOT NULL,
 233
 234   -- Text comment summarizing the change.
 235   -- This text is shown in the history and other changes lists,
 236   -- rendered in a subset of wiki markup by Linker::formatComment()
 237   rev_comment tinyblob NOT NULL default '',
 238
 239   -- Key to user.user_id of the user who made this edit.
 240   -- Stores 0 for anonymous edits and for some mass imports.
 241   rev_user int(5) unsigned NOT NULL default '0',
 242
 243   -- Text username or IP address of the editor.
 244   rev_user_text varchar(255) binary NOT NULL default '',
 245
 246   -- Timestamp
 247   rev_timestamp char(14) binary NOT NULL default '',
 248
 249   -- Records whether the user marked the 'minor edit' checkbox.
 250   -- Many automated edits are marked as minor.
 251   rev_minor_edit tinyint(1) unsigned NOT NULL default '0',
 252
 253   -- Not yet used; reserved for future changes to the deletion system.
 254   rev_deleted tinyint(1) unsigned NOT NULL default '0',
 255
 256   PRIMARY KEY rev_page_id (rev_page, rev_id),
 257   UNIQUE INDEX rev_id (rev_id),
 258   INDEX rev_timestamp (rev_timestamp),
 259   INDEX page_timestamp (rev_page,rev_timestamp),
 260   INDEX user_timestamp (rev_user,rev_timestamp),
 261   INDEX usertext_timestamp (rev_user_text,rev_timestamp)
 262
 263 ) TYPE=InnoDB;
 264
 265
 266 --
 267 -- Holds text of individual page revisions.
 268 --
 269 -- Field names are a holdover from the 'old' revisions table in
 270 -- MediaWiki 1.4 and earlier: an upgrade will transform that
 271 -- table into the 'text' table to minimize unnecessary churning
 272 -- and downtime. If upgrading, the other fields will be left unused.
 273 --
 274 CREATE TABLE /*$wgDBprefix*/text (
 275   -- Unique text storage key number.
 276   -- Note that the 'oldid' parameter used in URLs does *not*
 277   -- refer to this number anymore, but to rev_id.
 278   --
 279   -- revision.rev_text_id is a key to this column
 280   old_id int(8) unsigned NOT NULL auto_increment,
 281
 282   -- Depending on the contents of the old_flags field, the text
 283   -- may be convenient plain text, or it may be funkily encoded.
 284   old_text mediumblob NOT NULL default '',
 285
 286   -- Comma-separated list of flags:
 287   -- gzip: text is compressed with PHP's gzdeflate() function.
 288   -- utf8: text was stored as UTF-8.
 289   --       If $wgLegacyEncoding option is on, rows *without* this flag
 290   --       will be converted to UTF-8 transparently at load time.
 291   -- object: text field contained a serialized PHP object.
 292   --         The object either contains multiple versions compressed
 293   --         together to achieve a better compression ratio, or it refers
 294   --         to another row where the text can be found.
 295   old_flags tinyblob NOT NULL default '',
 296
 297   PRIMARY KEY old_id (old_id)
 298
 299 ) TYPE=InnoDB;
 300
 301 --
 302 -- Holding area for deleted articles, which may be viewed
 303 -- or restored by admins through the Special:Undelete interface.
 304 -- The fields generally correspond to the page, revision, and text
 305 -- fields, with several caveats.
 306 --
 307 CREATE TABLE /*$wgDBprefix*/archive (
 308   ar_namespace int NOT NULL default '0',
 309   ar_title varchar(255) binary NOT NULL default '',
 310
 311   -- Newly deleted pages will not store text in this table,
 312   -- but will reference the separately existing text rows.
 313   -- This field is retained for backwards compatibility,
 314   -- so old archived pages will remain accessible after
 315   -- upgrading from 1.4 to 1.5.
 316   -- Text may be gzipped or otherwise funky.
 317   ar_text mediumblob NOT NULL default '',
 318
 319   -- Basic revision stuff...
 320   ar_comment tinyblob NOT NULL default '',
 321   ar_user int(5) unsigned NOT NULL default '0',
 322   ar_user_text varchar(255) binary NOT NULL,
 323   ar_timestamp char(14) binary NOT NULL default '',
 324   ar_minor_edit tinyint(1) NOT NULL default '0',
 325
 326   -- See ar_text note.
 327   ar_flags tinyblob NOT NULL default '',
 328
 329   -- When revisions are deleted, their unique rev_id is stored
 330   -- here so it can be retained after undeletion. This is necessary
 331   -- to retain permalinks to given revisions after accidental delete
 332   -- cycles or messy operations like history merges.
 333   --
 334   -- Old entries from 1.4 will be NULL here, and a new rev_id will
 335   -- be created on undeletion for those revisions.
 336   ar_rev_id int(8) unsigned,
 337
 338   -- For newly deleted revisions, this is the text.old_id key to the
 339   -- actual stored text. To avoid breaking the block-compression scheme
 340   -- and otherwise making storage changes harder, the actual text is
 341   -- *not* deleted from the text table, merely hidden by removal of the
 342   -- page and revision entries.
 343   --
 344   -- Old entries deleted under 1.2-1.4 will have NULL here, and their
 345   -- ar_text and ar_flags fields will be used to create a new text
 346   -- row upon undeletion.
 347   ar_text_id int(8) unsigned,
 348
 349   KEY name_title_timestamp (ar_namespace,ar_title,ar_timestamp)
 350
 351 ) TYPE=InnoDB;
 352
 353
 354 --
 355 -- Track page-to-page hyperlinks within the wiki.
 356 --
 357 CREATE TABLE /*$wgDBprefix*/pagelinks (
 358   -- Key to the page_id of the page containing the link.
 359   pl_from int(8) unsigned NOT NULL default '0',
 360
 361   -- Key to page_namespace/page_title of the target page.
 362   -- The target page may or may not exist, and due to renames
 363   -- and deletions may refer to different page records as time
 364   -- goes by.
 365   pl_namespace int NOT NULL default '0',
 366   pl_title varchar(255) binary NOT NULL default '',
 367
 368   UNIQUE KEY pl_from(pl_from,pl_namespace,pl_title),
 369   KEY (pl_namespace,pl_title)
 370
 371 ) TYPE=InnoDB;
 372
 373
 374 --
 375 -- Track template inclusions.
 376 --
 377 CREATE TABLE /*$wgDBprefix*/templatelinks (
 378   -- Key to the page_id of the page containing the link.
 379   tl_from int(8) unsigned NOT NULL default '0',
 380
 381   -- Key to page_namespace/page_title of the target page.
 382   -- The target page may or may not exist, and due to renames
 383   -- and deletions may refer to different page records as time
 384   -- goes by.
 385   tl_namespace int NOT NULL default '0',
 386   tl_title varchar(255) binary NOT NULL default '',
 387
 388   UNIQUE KEY tl_from(tl_from,tl_namespace,tl_title),
 389   KEY (tl_namespace,tl_title)
 390
 391 ) TYPE=InnoDB;
 392
 393 --
 394 -- Track links to images *used inline*
 395 -- We don't distinguish live from broken links here, so
 396 -- they do not need to be changed on upload/removal.
 397 --
 398 CREATE TABLE /*$wgDBprefix*/imagelinks (
 399   -- Key to page_id of the page containing the image / media link.
 400   il_from int(8) unsigned NOT NULL default '0',
 401
 402   -- Filename of target image.
 403   -- This is also the page_title of the file's description page;
 404   -- all such pages are in namespace 6 (NS_IMAGE).
 405   il_to varchar(255) binary NOT NULL default '',
 406
 407   UNIQUE KEY il_from(il_from,il_to),
 408   KEY (il_to)
 409
 410 ) TYPE=InnoDB;
 411
 412 --
 413 -- Track category inclusions *used inline*
 414 -- This tracks a single level of category membership
 415 -- (folksonomic tagging, really).
 416 --
 417 CREATE TABLE /*$wgDBprefix*/categorylinks (
 418   -- Key to page_id of the page defined as a category member.
 419   cl_from int(8) unsigned NOT NULL default '0',
 420
 421   -- Name of the category.
 422   -- This is also the page_title of the category's description page;
 423   -- all such pages are in namespace 14 (NS_CATEGORY).
 424   cl_to varchar(255) binary NOT NULL default '',
 425
 426   -- The title of the linking page, or an optional override
 427   -- to determine sort order. Sorting is by binary order, which
 428   -- isn't always ideal, but collations seem to be an exciting
 429   -- and dangerous new world in MySQL... The sortkey is updated
 430   -- if no override exists and cl_from is renamed.
 431   --
 432   -- For MySQL 4.1+ with charset set to utf8, the sort key *index*
 433   -- needs cut to be smaller than 1024 bytes (at 3 bytes per char).
 434   -- To sort properly on the shorter key, this field needs to be
 435   -- the same shortness.
 436   cl_sortkey varchar(86) binary NOT NULL default '',
 437
 438   -- This isn't really used at present. Provided for an optional
 439   -- sorting method by approximate addition time.
 440   cl_timestamp timestamp NOT NULL,
 441
 442   UNIQUE KEY cl_from(cl_from,cl_to),
 443
 444   -- We always sort within a given category...
 445   KEY cl_sortkey(cl_to,cl_sortkey),
 446
 447   -- Not really used?
 448   KEY cl_timestamp(cl_to,cl_timestamp)
 449
 450 ) TYPE=InnoDB;
 451
 452 --
 453 -- Track links to external URLs
 454 --
 455 CREATE TABLE /*$wgDBprefix*/externallinks (
 456   -- page_id of the referring page
 457   el_from int(8) unsigned NOT NULL default '0',
 458
 459   -- The URL
 460   el_to blob NOT NULL default '',
 461
 462   -- In the case of HTTP URLs, this is the URL with any username or password
 463   -- removed, and with the labels in the hostname reversed and converted to
 464   -- lower case. An extra dot is added to allow for matching of either
 465   -- example.com or *.example.com in a single scan.
 466   -- Example:
 467   --      http://user:password@sub.example.com/page.html
 468   --   becomes
 469   --      http://com.example.sub./page.html
 470   -- which allows for fast searching for all pages under example.com with the
 471   -- clause:
 472   --      WHERE el_index LIKE 'http://com.example.%'
 473   el_index blob NOT NULL default '',
 474
 475   KEY (el_from, el_to(40)),
 476   KEY (el_to(60), el_from),
 477   KEY (el_index(60))
 478 ) TYPE=InnoDB;
 479
 480 --
 481 -- Track interlanguage links
 482 --
 483 CREATE TABLE /*$wgDBprefix*/langlinks (
 484   -- page_id of the referring page
 485   ll_from int(8) unsigned NOT NULL default '0',
 486
 487   -- Language code of the target
 488   ll_lang varchar(10) binary NOT NULL default '',
 489
 490   -- Title of the target, including namespace
 491   ll_title varchar(255) binary NOT NULL default '',
 492
 493   UNIQUE KEY (ll_from, ll_lang),
 494   KEY (ll_lang, ll_title)
 495 ) ENGINE=InnoDB;
 496
 497 --
 498 -- Contains a single row with some aggregate info
 499 -- on the state of the site.
 500 --
 501 CREATE TABLE /*$wgDBprefix*/site_stats (
 502   -- The single row should contain 1 here.
 503   ss_row_id int(8) unsigned NOT NULL,
 504
 505   -- Total number of page views, if hit counters are enabled.
 506   ss_total_views bigint(20) unsigned default '0',
 507
 508   -- Total number of edits performed.
 509   ss_total_edits bigint(20) unsigned default '0',
 510
 511   -- An approximate count of pages matching the following criteria:
 512   -- * in namespace 0
 513   -- * not a redirect
 514   -- * contains the text '[['
 515   -- See Article::isCountable() in includes/Article.php
 516   ss_good_articles bigint(20) unsigned default '0',
 517
 518   -- Total pages, theoretically equal to SELECT COUNT(*) FROM page; except faster
 519   ss_total_pages bigint(20) default '-1',
 520
 521   -- Number of users, theoretically equal to SELECT COUNT(*) FROM user;
 522   ss_users bigint(20) default '-1',
 523
 524   -- Deprecated, no longer updated as of 1.5
 525   ss_admins int(10) default '-1',
 526
 527   -- Number of images, equivalent to SELECT COUNT(*) FROM image
 528   ss_images int(10) default '0',
 529
 530   UNIQUE KEY ss_row_id (ss_row_id)
 531
 532 ) TYPE=InnoDB;
 533
 534 --
 535 -- Stores an ID for every time any article is visited;
 536 -- depending on $wgHitcounterUpdateFreq, it is
 537 -- periodically cleared and the page_counter column
 538 -- in the page table updated for the all articles
 539 -- that have been visited.)
 540 --
 541 CREATE TABLE /*$wgDBprefix*/hitcounter (
 542   hc_id INTEGER UNSIGNED NOT NULL
 543 ) TYPE=HEAP MAX_ROWS=25000;
 544
 545
 546 --
 547 -- The internet is full of jerks, alas. Sometimes it's handy
 548 -- to block a vandal or troll account.
 549 --
 550 CREATE TABLE /*$wgDBprefix*/ipblocks (
 551   -- Primary key, introduced for privacy.
 552   ipb_id int(8) NOT NULL auto_increment,
 553
 554   -- Blocked IP address in dotted-quad form or user name.
 555   ipb_address varchar(40) binary NOT NULL default '',
 556
 557   -- Blocked user ID or 0 for IP blocks.
 558   ipb_user int(8) unsigned NOT NULL default '0',
 559
 560   -- User ID who made the block.
 561   ipb_by int(8) unsigned NOT NULL default '0',
 562
 563   -- Text comment made by blocker.
 564   ipb_reason tinyblob NOT NULL default '',
 565
 566   -- Creation (or refresh) date in standard YMDHMS form.
 567   -- IP blocks expire automatically.
 568   ipb_timestamp char(14) binary NOT NULL default '',
 569
 570   -- Indicates that the IP address was banned because a banned
 571   -- user accessed a page through it. If this is 1, ipb_address
 572   -- will be hidden, and the block identified by block ID number.
 573   ipb_auto tinyint(1) NOT NULL default '0',
 574
 575   -- Time at which the block will expire.
 576   ipb_expiry char(14) binary NOT NULL default '',
 577
 578   -- Start and end of an address range, in hexadecimal
 579   -- Size chosen to allow IPv6
 580   ipb_range_start varchar(32) NOT NULL default '',
 581   ipb_range_end varchar(32) NOT NULL default '',
 582
 583   PRIMARY KEY ipb_id (ipb_id),
 584   INDEX ipb_address (ipb_address),
 585   INDEX ipb_user (ipb_user),
 586   INDEX ipb_range (ipb_range_start(8), ipb_range_end(8))
 587
 588 ) TYPE=InnoDB;
 589
 590
 591 --
 592 -- Uploaded images and other files.
 593 --
 594 CREATE TABLE /*$wgDBprefix*/image (
 595   -- Filename.
 596   -- This is also the title of the associated description page,
 597   -- which will be in namespace 6 (NS_IMAGE).
 598   img_name varchar(255) binary NOT NULL default '',
 599
 600   -- File size in bytes.
 601   img_size int(8) unsigned NOT NULL default '0',
 602
 603   -- For images, size in pixels.
 604   img_width int(5)  NOT NULL default '0',
 605   img_height int(5)  NOT NULL default '0',
 606
 607   -- Extracted EXIF metadata stored as a serialized PHP array.
 608   img_metadata mediumblob NOT NULL,
 609
 610   -- For images, bits per pixel if known.
 611   img_bits int(3)  NOT NULL default '0',
 612
 613   -- Media type as defined by the MEDIATYPE_xxx constants
 614   img_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
 615
 616   -- major part of a MIME media type as defined by IANA
 617   -- see http://www.iana.org/assignments/media-types/
 618   img_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart") NOT NULL default "unknown",
 619
 620   -- minor part of a MIME media type as defined by IANA
 621   -- the minor parts are not required to adher to any standard
 622   -- but should be consistent throughout the database
 623   -- see http://www.iana.org/assignments/media-types/
 624   img_minor_mime varchar(32) NOT NULL default "unknown",
 625
 626   -- Description field as entered by the uploader.
 627   -- This is displayed in image upload history and logs.
 628   img_description tinyblob NOT NULL default '',
 629
 630   -- user_id and user_name of uploader.
 631   img_user int(5) unsigned NOT NULL default '0',
 632   img_user_text varchar(255) binary NOT NULL default '',
 633
 634   -- Time of the upload.
 635   img_timestamp char(14) binary NOT NULL default '',
 636
 637   PRIMARY KEY img_name (img_name),
 638
 639   -- Used by Special:Imagelist for sort-by-size
 640   INDEX img_size (img_size),
 641
 642   -- Used by Special:Newimages and Special:Imagelist
 643   INDEX img_timestamp (img_timestamp)
 644
 645 ) TYPE=InnoDB;
 646
 647 --
 648 -- Previous revisions of uploaded files.
 649 -- Awkwardly, image rows have to be moved into
 650 -- this table at re-upload time.
 651 --
 652 CREATE TABLE /*$wgDBprefix*/oldimage (
 653   -- Base filename: key to image.img_name
 654   oi_name varchar(255) binary NOT NULL default '',
 655
 656   -- Filename of the archived file.
 657   -- This is generally a timestamp and '!' prepended to the base name.
 658   oi_archive_name varchar(255) binary NOT NULL default '',
 659
 660   -- Other fields as in image...
 661   oi_size int(8) unsigned NOT NULL default 0,
 662   oi_width int(5) NOT NULL default 0,
 663   oi_height int(5) NOT NULL default 0,
 664   oi_bits int(3) NOT NULL default 0,
 665   oi_description tinyblob NOT NULL default '',
 666   oi_user int(5) unsigned NOT NULL default '0',
 667   oi_user_text varchar(255) binary NOT NULL default '',
 668   oi_timestamp char(14) binary NOT NULL default '',
 669
 670   INDEX oi_name (oi_name(10))
 671
 672 ) TYPE=InnoDB;
 673
 674
 675 --
 676 -- Primarily a summary table for Special:Recentchanges,
 677 -- this table contains some additional info on edits from
 678 -- the last few days, see Article::editUpdates()
 679 --
 680 CREATE TABLE /*$wgDBprefix*/recentchanges (
 681   rc_id int(8) NOT NULL auto_increment,
 682   rc_timestamp varchar(14) binary NOT NULL default '',
 683   rc_cur_time varchar(14) binary NOT NULL default '',
 684
 685   -- As in revision
 686   rc_user int(10) unsigned NOT NULL default '0',
 687   rc_user_text varchar(255) binary NOT NULL default '',
 688
 689   -- When pages are renamed, their RC entries do _not_ change.
 690   rc_namespace int NOT NULL default '0',
 691   rc_title varchar(255) binary NOT NULL default '',
 692
 693   -- as in revision...
 694   rc_comment varchar(255) binary NOT NULL default '',
 695   rc_minor tinyint(3) unsigned NOT NULL default '0',
 696
 697   -- Edits by user accounts with the 'bot' rights key are
 698   -- marked with a 1 here, and will be hidden from the
 699   -- default view.
 700   rc_bot tinyint(3) unsigned NOT NULL default '0',
 701
 702   rc_new tinyint(3) unsigned NOT NULL default '0',
 703
 704   -- Key to page_id (was cur_id prior to 1.5).
 705   -- This will keep links working after moves while
 706   -- retaining the at-the-time name in the changes list.
 707   rc_cur_id int(10) unsigned NOT NULL default '0',
 708
 709   -- rev_id of the given revision
 710   rc_this_oldid int(10) unsigned NOT NULL default '0',
 711
 712   -- rev_id of the prior revision, for generating diff links.
 713   rc_last_oldid int(10) unsigned NOT NULL default '0',
 714
 715   -- These may no longer be used, with the new move log.
 716   rc_type tinyint(3) unsigned NOT NULL default '0',
 717   rc_moved_to_ns tinyint(3) unsigned NOT NULL default '0',
 718   rc_moved_to_title varchar(255) binary NOT NULL default '',
 719
 720   -- If the Recent Changes Patrol option is enabled,
 721   -- users may mark edits as having been reviewed to
 722   -- remove a warning flag on the RC list.
 723   -- A value of 1 indicates the page has been reviewed.
 724   rc_patrolled tinyint(3) unsigned NOT NULL default '0',
 725
 726   -- Recorded IP address the edit was made from, if the
 727   -- $wgPutIPinRC option is enabled.
 728   rc_ip char(15) NOT NULL default '',
 729
 730   PRIMARY KEY rc_id (rc_id),
 731   INDEX rc_timestamp (rc_timestamp),
 732   INDEX rc_namespace_title (rc_namespace, rc_title),
 733   INDEX rc_cur_id (rc_cur_id),
 734   INDEX new_name_timestamp(rc_new,rc_namespace,rc_timestamp),
 735   INDEX rc_ip (rc_ip)
 736
 737 ) TYPE=InnoDB;
 738
 739 CREATE TABLE /*$wgDBprefix*/watchlist (
 740   -- Key to user.user_id
 741   wl_user int(5) unsigned NOT NULL,
 742
 743   -- Key to page_namespace/page_title
 744   -- Note that users may watch pages which do not exist yet,
 745   -- or existed in the past but have been deleted.
 746   wl_namespace int NOT NULL default '0',
 747   wl_title varchar(255) binary NOT NULL default '',
 748
 749   -- Timestamp when user was last sent a notification e-mail;
 750   -- cleared when the user visits the page.
 751   wl_notificationtimestamp varchar(14) binary,
 752
 753   UNIQUE KEY (wl_user, wl_namespace, wl_title),
 754   KEY namespace_title (wl_namespace,wl_title)
 755
 756 ) TYPE=InnoDB;
 757
 758
 759 --
 760 -- Used by the math module to keep track
 761 -- of previously-rendered items.
 762 --
 763 CREATE TABLE /*$wgDBprefix*/math (
 764   -- Binary MD5 hash of the latex fragment, used as an identifier key.
 765   math_inputhash varchar(16) NOT NULL,
 766
 767   -- Not sure what this is, exactly...
 768   math_outputhash varchar(16) NOT NULL,
 769
 770   -- texvc reports how well it thinks the HTML conversion worked;
 771   -- if it's a low level the PNG rendering may be preferred.
 772   math_html_conservativeness tinyint(1) NOT NULL,
 773
 774   -- HTML output from texvc, if any
 775   math_html text,
 776
 777   -- MathML output from texvc, if any
 778   math_mathml text,
 779
 780   UNIQUE KEY math_inputhash (math_inputhash)
 781
 782 ) TYPE=InnoDB;
 783
 784 --
 785 -- When using the default MySQL search backend, page titles
 786 -- and text are munged to strip markup, do Unicode case folding,
 787 -- and prepare the result for MySQL's fulltext index.
 788 --
 789 -- This table must be MyISAM; InnoDB does not support the needed
 790 -- fulltext index.
 791 --
 792 CREATE TABLE /*$wgDBprefix*/searchindex (
 793   -- Key to page_id
 794   si_page int(8) unsigned NOT NULL,
 795
 796   -- Munged version of title
 797   si_title varchar(255) NOT NULL default '',
 798
 799   -- Munged version of body text
 800   si_text mediumtext NOT NULL default '',
 801
 802   UNIQUE KEY (si_page),
 803   FULLTEXT si_title (si_title),
 804   FULLTEXT si_text (si_text)
 805
 806 ) TYPE=MyISAM;
 807
 808 --
 809 -- Recognized interwiki link prefixes
 810 --
 811 CREATE TABLE /*$wgDBprefix*/interwiki (
 812   -- The interwiki prefix, (e.g. "Meatball", or the language prefix "de")
 813   iw_prefix char(32) NOT NULL,
 814
 815   -- The URL of the wiki, with "$1" as a placeholder for an article name.
 816   -- Any spaces in the name will be transformed to underscores before
 817   -- insertion.
 818   iw_url char(127) NOT NULL,
 819
 820   -- A boolean value indicating whether the wiki is in this project
 821   -- (used, for example, to detect redirect loops)
 822   iw_local BOOL NOT NULL,
 823
 824   -- Boolean value indicating whether interwiki transclusions are allowed.
 825   iw_trans TINYINT(1) NOT NULL DEFAULT 0,
 826
 827   UNIQUE KEY iw_prefix (iw_prefix)
 828
 829 ) TYPE=InnoDB;
 830
 831 --
 832 -- Used for caching expensive grouped queries
 833 --
 834 CREATE TABLE /*$wgDBprefix*/querycache (
 835   -- A key name, generally the base name of of the special page.
 836   qc_type char(32) NOT NULL,
 837
 838   -- Some sort of stored value. Sizes, counts...
 839   qc_value int(5) unsigned NOT NULL default '0',
 840
 841   -- Target namespace+title
 842   qc_namespace int NOT NULL default '0',
 843   qc_title char(255) binary NOT NULL default '',
 844
 845   KEY (qc_type,qc_value)
 846
 847 ) TYPE=InnoDB;
 848
 849 --
 850 -- For a few generic cache operations if not using Memcached
 851 --
 852 CREATE TABLE /*$wgDBprefix*/objectcache (
 853   keyname char(255) binary not null default '',
 854   value mediumblob,
 855   exptime datetime,
 856   unique key (keyname),
 857   key (exptime)
 858
 859 ) TYPE=InnoDB;
 860
 861 --
 862 -- Cache of interwiki transclusion
 863 --
 864 CREATE TABLE /*$wgDBprefix*/transcache (
 865         tc_url          VARCHAR(255) NOT NULL,
 866         tc_contents     TEXT,
 867         tc_time         INT NOT NULL,
 868         UNIQUE INDEX tc_url_idx(tc_url)
 869 ) TYPE=InnoDB;
 870
 871 -- For article validation
 872 CREATE TABLE /*$wgDBprefix*/validate (
 873   val_user int(11) NOT NULL default '0',
 874   val_page int(11) unsigned NOT NULL default '0',
 875   val_revision int(11) unsigned NOT NULL default '0',
 876   val_type int(11) unsigned NOT NULL default '0',
 877   val_value int(11) default '0',
 878   val_comment varchar(255) NOT NULL default '',
 879   val_ip varchar(20) NOT NULL default '',
 880   KEY val_user (val_user,val_revision)
 881 ) TYPE=InnoDB;
 882
 883
 884 CREATE TABLE /*$wgDBprefix*/logging (
 885   -- Symbolic keys for the general log type and the action type
 886   -- within the log. The output format will be controlled by the
 887   -- action field, but only the type controls categorization.
 888   log_type char(10) NOT NULL default '',
 889   log_action char(10) NOT NULL default '',
 890
 891   -- Timestamp. Duh.
 892   log_timestamp char(14) NOT NULL default '19700101000000',
 893
 894   -- The user who performed this action; key to user_id
 895   log_user int unsigned NOT NULL default 0,
 896
 897   -- Key to the page affected. Where a user is the target,
 898   -- this will point to the user page.
 899   log_namespace int NOT NULL default 0,
 900   log_title varchar(255) binary NOT NULL default '',
 901
 902   -- Freeform text. Interpreted as edit history comments.
 903   log_comment varchar(255) NOT NULL default '',
 904
 905   -- LF separated list of miscellaneous parameters
 906   log_params blob NOT NULL default '',
 907
 908   KEY type_time (log_type, log_timestamp),
 909   KEY user_time (log_user, log_timestamp),
 910   KEY page_time (log_namespace, log_title, log_timestamp),
 911   KEY times (log_timestamp)
 912
 913 ) TYPE=InnoDB;
 914
 915 CREATE TABLE /*$wgDBprefix*/trackbacks (
 916         tb_id integer AUTO_INCREMENT PRIMARY KEY,
 917         tb_page integer REFERENCES page(page_id) ON DELETE CASCADE,
 918         tb_title varchar(255) NOT NULL,
 919         tb_url  varchar(255) NOT NULL,
 920         tb_ex text,
 921         tb_name varchar(255),
 922
 923         INDEX (tb_page)
 924 ) TYPE=InnoDB;
 925
 926
 927 -- Jobs performed by parallel apache threads or a command-line daemon
 928 CREATE TABLE /*$wgDBprefix*/job (
 929   job_id int(9) unsigned NOT NULL auto_increment,
 930
 931   -- Command name, currently only refreshLinks is defined
 932   job_cmd varchar(255) NOT NULL default '',
 933
 934   -- Namespace and title to act on
 935   -- Should be 0 and '' if the command does not operate on a title
 936   job_namespace int NOT NULL,
 937   job_title varchar(255) binary NOT NULL,
 938
 939   -- Any other parameters to the command
 940   -- Presently unused, format undefined
 941   job_params blob NOT NULL default '',
 942
 943   PRIMARY KEY job_id (job_id),
 944   KEY (job_cmd, job_namespace, job_title)
 945 ) TYPE=InnoDB;
 946
 947
 948 -- Details of updates to cached special pages
 949 CREATE TABLE /*$wgDBprefix*/querycache_info (
 950
 951         -- Special page name
 952         -- Corresponds to a qc_type value
 953         qci_type varchar(32) NOT NULL default '',
 954
 955         -- Timestamp of last update
 956         qci_timestamp char(14) NOT NULL default '19700101000000',
 957
 958         UNIQUE KEY ( qci_type )
 959
 960 ) TYPE=InnoDB;