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