Manual:Database layout

From mediawiki.org
Schema redirects here; for information about the Schema: namespace, see Extension:EventLogging , and for the structure of extension.json, see Manual:Extension.json/Schema .


Manual:Contents MediaWiki database layout database_layout table
Database schema diagram of MediaWiki
Database schema diagram of MediaWiki

Prior to MediaWiki 1.35, the SQL code that creates the MySQL/MariaDB core tables for any MediaWiki version—with extensive comments—is in the maintenance/tables.sql source file.

Since MediaWiki 1.35, the appropriate file is in the maintenance/tables.json source file, which is then transformed into maintenance/tables-generated.sql. Up to MediaWiki 1.37 maintenance/tables.sql continued to be partially in use as some tables hadn't been migrated to maintenance/tables.json yet.

The most important tables are probably:

Version history

The following table depicts the range of MediaWiki versions over which each table has existed in the schema. Red rows indicate tables that are no longer used by the core nor added by the installer as of a particular version. They might however still be used by extensions. Note, table headings are repeated every 10 rows for clarity.

1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
 actor
archive
 block
 block_target
 blobs 
 bot_passwords
brokenlinks 
 category
 categorylinks
 change_tag
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
 change_tag_def
 comment
 content
 content_models
cur 
 externallinks
 external_user 
 filearchive
 hitcounter 
image
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
imagelinks
 image_comment_temp 
interwiki
 ip_changes
ipblocks
 ipblocks_old 
 ipblocks_restrictions
 iwlinks
 job
 l10n_cache
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
 langlinks
links 
linkscc 
 linktarget
 logging
 log_search
math 
 module_deps
 msg_resource 
 msg_resource_links 
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
 objectcache
old 
oldimage
 page
 pagelinks
 page_props
 page_restrictions
 profiling 
 protected_titles
 querycache
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
 querycachetwo
 querycache_info
recentchanges
 redirect
 revision
 revision_actor_temp 
 revision_comment_temp 
searchindex
 sites
 site_identifiers
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
site_stats
 slots
 slot_roles
 tag_summary 
 templatelinks
 text
 trackbacks 
 transcache 
 updatelog
 uploadstash
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
user
 user_autocreate_serial
 user_former_groups
 user_groups
user_newtalk
 user_properties
 user_rights 
 valid_tag 
 validate 
watchlist
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master
 watchlist_expiry
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24 1.25 1.26 1.27 1.28 1.29 1.30 1.31 1.32 1.33 1.34 1.35 1.36 1.37 1.38 1.39 1.40 1.41 master

Database management systems

In MediaWiki master, tables.sql is currently being migrated to maintenance/tables.json, and documenting comments should be found there instead of the resultant SQL files.

See the latest MariaDB/MySQL-compatible versions from Git: maintenance/tables.sql, maintenance/tables-generated.sql.

If using SQLite , the file maintenance/sqlite/tables-generated.sql and the unmigrated MySQL tables in maintenance/tables.sql should be viewed instead.

If using PostgreSQL , the files maintenance/postgres/tables.sql and maintenance/postgres/tables-generated.sql should be viewed instead.

If using Microsoft SQL Server, see maintenance/mssql/tables.sql. (removed in 1.34)

If using Oracle, see maintenance/oracle/tables.sql. (removed in 1.34)

See also

Diagrams