Dumps
These docs are for maintainers of the various dumps. Information for users of the dumps can be found at Meta-wiki's m:Data dumps page. Information for developers can be found on mediawiki.org.
Daily checks
Dumps maintainers should watch or check a few things every day:
- email to the ops-dumps mail alias (get on it! SRE/Clinic_Duty#Mail_aliases)
- xmldatadumps-l mailing list
- Phabricator Dumps-Generation workboard
- https://dumps.wikimedia.org/ (mentions the current run, unless idle)
- icinga for dumps hosts: snapshots, [1]
Dumps types
We produce several types of dumps. For information about deployment of updates, architecture of the dumps, and troubleshooting each dump type, check the appropriate entry below.
- xml/sql dumps which contain revision metadata and content for public Wikimedia projects, along with contents of select sql tables
- adds/changes dumps which contain a daily xml dump of new pages or pages with new revisions since the previous run, for public Wikimedia projects
- Wikidata entity dumps which contain dumps of 'entities' (Qxxx) in various formats, and a dump of lexemes, run once a week.
- category dumps which contain weekly full and daily incremental category lists for public Wikimedia projects, in rdf format
- other miscellaneous dumps including content translation dumps, cirrus search dumps, and global block information.
Other datasets are also provided for download, such as page view counts; these datasets are managed by other folks and are not documented here.
Service
Hardware
- Dumps snapshot hosts that run scripts to generate the dumps
- Dumps datastores where the snapshot hosts write intermediate and final dump output files, which are later published to our web servers
- Dumps servers that provide the dumps to the public, to our mirrors, and via nfs to Wikimedia Cloud Services and stats host users
Adding new dumps
If you are interested in adding a new dumpset, please check the guidelines (still in draft form).
If you are working with wikibase dumps of some sort, you might want to look at a code walkthrough; see Dumps/Wikibase dumps overview.
Testing changes to the dumps or new scripts
See Dumps/Testing for more about this.
Mirrors
If you are adding a mirror, see Dumps Mirror setup.