Manual:Database layout
- 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 |
The SQL code that creates the MySQL/MariaDB core tables for any MediaWiki version is in the sql/tables.json source file, which is then transformed into platform-specific SQL files, like sql/mysql/tables-generated.sql for MySQL.
Prior to MediaWiki 1.35, the SQL code that created the core tables for any MediaWiki version—with extensive comments—was in the maintenance/tables.sql source file. 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.
In MediaWiki 1.44, the schema files were moved to a new top-level sql directory.
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 | 1.42 | 1.43 | master |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
actor | |||||||||||||||||||||||||||||||||||||||||||
archive | |||||||||||||||||||||||||||||||||||||||||||
block | |||||||||||||||||||||||||||||||||||||||||||
block_ | |||||||||||||||||||||||||||||||||||||||||||
blobs | |||||||||||||||||||||||||||||||||||||||||||
bot_ | |||||||||||||||||||||||||||||||||||||||||||
broken | |||||||||||||||||||||||||||||||||||||||||||
category | |||||||||||||||||||||||||||||||||||||||||||
category | |||||||||||||||||||||||||||||||||||||||||||
change_ | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | master |
change_ | |||||||||||||||||||||||||||||||||||||||||||
comment | |||||||||||||||||||||||||||||||||||||||||||
content | |||||||||||||||||||||||||||||||||||||||||||
content_ | |||||||||||||||||||||||||||||||||||||||||||
cur | |||||||||||||||||||||||||||||||||||||||||||
external | |||||||||||||||||||||||||||||||||||||||||||
external_ | |||||||||||||||||||||||||||||||||||||||||||
file | |||||||||||||||||||||||||||||||||||||||||||
hit | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | master |
image | |||||||||||||||||||||||||||||||||||||||||||
image_ | |||||||||||||||||||||||||||||||||||||||||||
interwiki | |||||||||||||||||||||||||||||||||||||||||||
ip_changes | |||||||||||||||||||||||||||||||||||||||||||
ipblocks | |||||||||||||||||||||||||||||||||||||||||||
ipblocks_ | |||||||||||||||||||||||||||||||||||||||||||
ipblocks_ | |||||||||||||||||||||||||||||||||||||||||||
iwlinks | |||||||||||||||||||||||||||||||||||||||||||
job | |||||||||||||||||||||||||||||||||||||||||||
l10n_ | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | master |
langlinks | |||||||||||||||||||||||||||||||||||||||||||
links | |||||||||||||||||||||||||||||||||||||||||||
linkscc | |||||||||||||||||||||||||||||||||||||||||||
linktarget | |||||||||||||||||||||||||||||||||||||||||||
logging | |||||||||||||||||||||||||||||||||||||||||||
log_ | |||||||||||||||||||||||||||||||||||||||||||
math | |||||||||||||||||||||||||||||||||||||||||||
module_ | |||||||||||||||||||||||||||||||||||||||||||
msg_ | |||||||||||||||||||||||||||||||||||||||||||
msg_ | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | master |
object | |||||||||||||||||||||||||||||||||||||||||||
old | |||||||||||||||||||||||||||||||||||||||||||
oldimage | |||||||||||||||||||||||||||||||||||||||||||
page | |||||||||||||||||||||||||||||||||||||||||||
pagelinks | |||||||||||||||||||||||||||||||||||||||||||
page_ | |||||||||||||||||||||||||||||||||||||||||||
page_ | |||||||||||||||||||||||||||||||||||||||||||
profiling | |||||||||||||||||||||||||||||||||||||||||||
protected_ | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | master |
querycachetwo | |||||||||||||||||||||||||||||||||||||||||||
querycache_ | |||||||||||||||||||||||||||||||||||||||||||
recentchanges | |||||||||||||||||||||||||||||||||||||||||||
redirect | |||||||||||||||||||||||||||||||||||||||||||
revision | |||||||||||||||||||||||||||||||||||||||||||
revision_ | |||||||||||||||||||||||||||||||||||||||||||
revision_ | |||||||||||||||||||||||||||||||||||||||||||
searchindex | |||||||||||||||||||||||||||||||||||||||||||
sites | |||||||||||||||||||||||||||||||||||||||||||
site_ | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | master |
site_ | |||||||||||||||||||||||||||||||||||||||||||
slots | |||||||||||||||||||||||||||||||||||||||||||
slot_ | |||||||||||||||||||||||||||||||||||||||||||
tag_ | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | master |
user | |||||||||||||||||||||||||||||||||||||||||||
user_ | |||||||||||||||||||||||||||||||||||||||||||
user_ | |||||||||||||||||||||||||||||||||||||||||||
user_ | |||||||||||||||||||||||||||||||||||||||||||
user_ | |||||||||||||||||||||||||||||||||||||||||||
user_ | |||||||||||||||||||||||||||||||||||||||||||
user_ | |||||||||||||||||||||||||||||||||||||||||||
valid_ | |||||||||||||||||||||||||||||||||||||||||||
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 | 1.42 | 1.43 | 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 | 1.42 | 1.43 | master |
Database management systems
In MediaWiki master, tables.sql has been migrated to sql/tables.json, and documenting comments should be found there instead of the resultant SQL files.
See the latest MariaDB/MySQL-compatible versions from Git: sql/mysql/tables-generated.sql.
If using SQLite , the file sql/sqlite/tables-generated.sql should be viewed instead.
If using PostgreSQL , the files sql/postgres/tables.sql and sql/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
- Manual:Database access
- Proposed Database Schema Changes
- Database field prefixes
- w:Wikipedia:Database queries
- Developer hub
- Records of edits in the database
- Research on MediaWiki DB schema evolution
- Diagram instructions, documents how to update the diagram