Merge "mediawiki.requestIdleCallback: Re-enable use of native requestIdleCallback"
[lhc/web/wiklou.git] / 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 -- This is a shared schema file used for both MySQL and SQLite installs.
6 --
7 -- For more documentation on the database schema, see
8 -- https://www.mediawiki.org/wiki/Manual:Database_layout
9 --
10 -- General notes:
11 --
12 -- If possible, create tables as InnoDB to benefit from the
13 -- superior resiliency against crashes and ability to read
14 -- during writes (and write during reads!)
15 --
16 -- Only the 'searchindex' table requires MyISAM due to the
17 -- requirement for fulltext index support, which is missing
18 -- from InnoDB.
19 --
20 --
21 -- The MySQL table backend for MediaWiki currently uses
22 -- 14-character BINARY or VARBINARY fields to store timestamps.
23 -- The format is YYYYMMDDHHMMSS, which is derived from the
24 -- text format of MySQL's TIMESTAMP fields.
25 --
26 -- Historically TIMESTAMP fields were used, but abandoned
27 -- in early 2002 after a lot of trouble with the fields
28 -- auto-updating.
29 --
30 -- The Postgres backend uses TIMESTAMPTZ fields for timestamps,
31 -- and we will migrate the MySQL definitions at some point as
32 -- well.
33 --
34 --
35 -- The /*_*/ comments in this and other files are
36 -- replaced with the defined table prefix by the installer
37 -- and updater scripts. If you are installing or running
38 -- updates manually, you will need to manually insert the
39 -- table prefix if any when running these scripts.
40 --
41
42
43 --
44 -- The user table contains basic account information,
45 -- authentication keys, etc.
46 --
47 -- Some multi-wiki sites may share a single central user table
48 -- between separate wikis using the $wgSharedDB setting.
49 --
50 -- Note that when a external authentication plugin is used,
51 -- user table entries still need to be created to store
52 -- preferences and to key tracking information in the other
53 -- tables.
54 --
55 CREATE TABLE /*_*/user (
56 user_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
57
58 -- Usernames must be unique, must not be in the form of
59 -- an IP address. _Shouldn't_ allow slashes or case
60 -- conflicts. Spaces are allowed, and are _not_ converted
61 -- to underscores like titles. See the User::newFromName() for
62 -- the specific tests that usernames have to pass.
63 user_name varchar(255) binary NOT NULL default '',
64
65 -- Optional 'real name' to be displayed in credit listings
66 user_real_name varchar(255) binary NOT NULL default '',
67
68 -- Password hashes, see User::crypt() and User::comparePasswords()
69 -- in User.php for the algorithm
70 user_password tinyblob NOT NULL,
71
72 -- When using 'mail me a new password', a random
73 -- password is generated and the hash stored here.
74 -- The previous password is left in place until
75 -- someone actually logs in with the new password,
76 -- at which point the hash is moved to user_password
77 -- and the old password is invalidated.
78 user_newpassword tinyblob NOT NULL,
79
80 -- Timestamp of the last time when a new password was
81 -- sent, for throttling and expiring purposes
82 -- Emailed passwords will expire $wgNewPasswordExpiry
83 -- (a week) after being set. If user_newpass_time is NULL
84 -- (eg. created by mail) it doesn't expire.
85 user_newpass_time binary(14),
86
87 -- Note: email should be restricted, not public info.
88 -- Same with passwords.
89 user_email tinytext NOT NULL,
90
91 -- If the browser sends an If-Modified-Since header, a 304 response is
92 -- suppressed if the value in this field for the current user is later than
93 -- the value in the IMS header. That is, this field is an invalidation timestamp
94 -- for the browser cache of logged-in users. Among other things, it is used
95 -- to prevent pages generated for a previously logged in user from being
96 -- displayed after a session expiry followed by a fresh login.
97 user_touched binary(14) NOT NULL default '',
98
99 -- A pseudorandomly generated value that is stored in
100 -- a cookie when the "remember password" feature is
101 -- used (previously, a hash of the password was used, but
102 -- this was vulnerable to cookie-stealing attacks)
103 user_token binary(32) NOT NULL default '',
104
105 -- Initially NULL; when a user's e-mail address has been
106 -- validated by returning with a mailed token, this is
107 -- set to the current timestamp.
108 user_email_authenticated binary(14),
109
110 -- Randomly generated token created when the e-mail address
111 -- is set and a confirmation test mail sent.
112 user_email_token binary(32),
113
114 -- Expiration date for the user_email_token
115 user_email_token_expires binary(14),
116
117 -- Timestamp of account registration.
118 -- Accounts predating this schema addition may contain NULL.
119 user_registration binary(14),
120
121 -- Count of edits and edit-like actions.
122 --
123 -- *NOT* intended to be an accurate copy of COUNT(*) WHERE rev_user=user_id
124 -- May contain NULL for old accounts if batch-update scripts haven't been
125 -- run, as well as listing deleted edits and other myriad ways it could be
126 -- out of sync.
127 --
128 -- Meant primarily for heuristic checks to give an impression of whether
129 -- the account has been used much.
130 --
131 user_editcount int,
132
133 -- Expiration date for user password.
134 user_password_expires varbinary(14) DEFAULT NULL
135
136 ) /*$wgDBTableOptions*/;
137
138 CREATE UNIQUE INDEX /*i*/user_name ON /*_*/user (user_name);
139 CREATE INDEX /*i*/user_email_token ON /*_*/user (user_email_token);
140 CREATE INDEX /*i*/user_email ON /*_*/user (user_email(50));
141
142
143 --
144 -- User permissions have been broken out to a separate table;
145 -- this allows sites with a shared user table to have different
146 -- permissions assigned to a user in each project.
147 --
148 -- This table replaces the old user_rights field which used a
149 -- comma-separated blob.
150 --
151 CREATE TABLE /*_*/user_groups (
152 -- Key to user_id
153 ug_user int unsigned NOT NULL default 0,
154
155 -- Group names are short symbolic string keys.
156 -- The set of group names is open-ended, though in practice
157 -- only some predefined ones are likely to be used.
158 --
159 -- At runtime $wgGroupPermissions will associate group keys
160 -- with particular permissions. A user will have the combined
161 -- permissions of any group they're explicitly in, plus
162 -- the implicit '*' and 'user' groups.
163 ug_group varbinary(255) NOT NULL default '',
164
165 -- Time at which the user group membership will expire. Set to
166 -- NULL for a non-expiring (infinite) membership.
167 ug_expiry varbinary(14) NULL default NULL,
168
169 PRIMARY KEY (ug_user, ug_group)
170 ) /*$wgDBTableOptions*/;
171
172 CREATE INDEX /*i*/ug_group ON /*_*/user_groups (ug_group);
173 CREATE INDEX /*i*/ug_expiry ON /*_*/user_groups (ug_expiry);
174
175 -- Stores the groups the user has once belonged to.
176 -- The user may still belong to these groups (check user_groups).
177 -- Users are not autopromoted to groups from which they were removed.
178 CREATE TABLE /*_*/user_former_groups (
179 -- Key to user_id
180 ufg_user int unsigned NOT NULL default 0,
181 ufg_group varbinary(255) NOT NULL default ''
182 ) /*$wgDBTableOptions*/;
183
184 CREATE UNIQUE INDEX /*i*/ufg_user_group ON /*_*/user_former_groups (ufg_user,ufg_group);
185
186 --
187 -- Stores notifications of user talk page changes, for the display
188 -- of the "you have new messages" box
189 --
190 CREATE TABLE /*_*/user_newtalk (
191 -- Key to user.user_id
192 user_id int unsigned NOT NULL default 0,
193 -- If the user is an anonymous user their IP address is stored here
194 -- since the user_id of 0 is ambiguous
195 user_ip varbinary(40) NOT NULL default '',
196 -- The highest timestamp of revisions of the talk page viewed
197 -- by this user
198 user_last_timestamp varbinary(14) NULL default NULL
199 ) /*$wgDBTableOptions*/;
200
201 -- Indexes renamed for SQLite in 1.14
202 CREATE INDEX /*i*/un_user_id ON /*_*/user_newtalk (user_id);
203 CREATE INDEX /*i*/un_user_ip ON /*_*/user_newtalk (user_ip);
204
205
206 --
207 -- User preferences and perhaps other fun stuff. :)
208 -- Replaces the old user.user_options blob, with a couple nice properties:
209 --
210 -- 1) We only store non-default settings, so changes to the defauls
211 -- are now reflected for everybody, not just new accounts.
212 -- 2) We can more easily do bulk lookups, statistics, or modifications of
213 -- saved options since it's a sane table structure.
214 --
215 CREATE TABLE /*_*/user_properties (
216 -- Foreign key to user.user_id
217 up_user int NOT NULL,
218
219 -- Name of the option being saved. This is indexed for bulk lookup.
220 up_property varbinary(255) NOT NULL,
221
222 -- Property value as a string.
223 up_value blob
224 ) /*$wgDBTableOptions*/;
225
226 CREATE UNIQUE INDEX /*i*/user_properties_user_property ON /*_*/user_properties (up_user,up_property);
227 CREATE INDEX /*i*/user_properties_property ON /*_*/user_properties (up_property);
228
229 --
230 -- This table contains a user's bot passwords: passwords that allow access to
231 -- the account via the API with limited rights.
232 --
233 CREATE TABLE /*_*/bot_passwords (
234 -- User ID obtained from CentralIdLookup.
235 bp_user int NOT NULL,
236
237 -- Application identifier
238 bp_app_id varbinary(32) NOT NULL,
239
240 -- Password hashes, like user.user_password
241 bp_password tinyblob NOT NULL,
242
243 -- Like user.user_token
244 bp_token binary(32) NOT NULL default '',
245
246 -- JSON blob for MWRestrictions
247 bp_restrictions blob NOT NULL,
248
249 -- Grants allowed to the account when authenticated with this bot-password
250 bp_grants blob NOT NULL,
251
252 PRIMARY KEY ( bp_user, bp_app_id )
253 ) /*$wgDBTableOptions*/;
254
255 --
256 -- Core of the wiki: each page has an entry here which identifies
257 -- it by title and contains some essential metadata.
258 --
259 CREATE TABLE /*_*/page (
260 -- Unique identifier number. The page_id will be preserved across
261 -- edits and rename operations, but not deletions and recreations.
262 page_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
263
264 -- A page name is broken into a namespace and a title.
265 -- The namespace keys are UI-language-independent constants,
266 -- defined in includes/Defines.php
267 page_namespace int NOT NULL,
268
269 -- The rest of the title, as text.
270 -- Spaces are transformed into underscores in title storage.
271 page_title varchar(255) binary NOT NULL,
272
273 -- Comma-separated set of permission keys indicating who
274 -- can move or edit the page.
275 page_restrictions tinyblob NOT NULL,
276
277 -- 1 indicates the article is a redirect.
278 page_is_redirect tinyint unsigned NOT NULL default 0,
279
280 -- 1 indicates this is a new entry, with only one edit.
281 -- Not all pages with one edit are new pages.
282 page_is_new tinyint unsigned NOT NULL default 0,
283
284 -- Random value between 0 and 1, used for Special:Randompage
285 page_random real unsigned NOT NULL,
286
287 -- This timestamp is updated whenever the page changes in
288 -- a way requiring it to be re-rendered, invalidating caches.
289 -- Aside from editing this includes permission changes,
290 -- creation or deletion of linked pages, and alteration
291 -- of contained templates.
292 page_touched binary(14) NOT NULL default '',
293
294 -- This timestamp is updated whenever a page is re-parsed and
295 -- it has all the link tracking tables updated for it. This is
296 -- useful for de-duplicating expensive backlink update jobs.
297 page_links_updated varbinary(14) NULL default NULL,
298
299 -- Handy key to revision.rev_id of the current revision.
300 -- This may be 0 during page creation, but that shouldn't
301 -- happen outside of a transaction... hopefully.
302 page_latest int unsigned NOT NULL,
303
304 -- Uncompressed length in bytes of the page's current source text.
305 page_len int unsigned NOT NULL,
306
307 -- content model, see CONTENT_MODEL_XXX constants
308 page_content_model varbinary(32) DEFAULT NULL,
309
310 -- Page content language
311 page_lang varbinary(35) DEFAULT NULL
312 ) /*$wgDBTableOptions*/;
313
314 CREATE UNIQUE INDEX /*i*/name_title ON /*_*/page (page_namespace,page_title);
315 CREATE INDEX /*i*/page_random ON /*_*/page (page_random);
316 CREATE INDEX /*i*/page_len ON /*_*/page (page_len);
317 CREATE INDEX /*i*/page_redirect_namespace_len ON /*_*/page (page_is_redirect, page_namespace, page_len);
318
319 --
320 -- Every edit of a page creates also a revision row.
321 -- This stores metadata about the revision, and a reference
322 -- to the text storage backend.
323 --
324 CREATE TABLE /*_*/revision (
325 -- Unique ID to identify each revision
326 rev_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
327
328 -- Key to page_id. This should _never_ be invalid.
329 rev_page int unsigned NOT NULL,
330
331 -- Key to text.old_id, where the actual bulk text is stored.
332 -- It's possible for multiple revisions to use the same text,
333 -- for instance revisions where only metadata is altered
334 -- or a rollback to a previous version.
335 rev_text_id int unsigned NOT NULL,
336
337 -- Text comment summarizing the change.
338 -- This text is shown in the history and other changes lists,
339 -- rendered in a subset of wiki markup by Linker::formatComment()
340 rev_comment varbinary(767) NOT NULL,
341
342 -- Key to user.user_id of the user who made this edit.
343 -- Stores 0 for anonymous edits and for some mass imports.
344 rev_user int unsigned NOT NULL default 0,
345
346 -- Text username or IP address of the editor.
347 rev_user_text varchar(255) binary NOT NULL default '',
348
349 -- Timestamp of when revision was created
350 rev_timestamp binary(14) NOT NULL default '',
351
352 -- Records whether the user marked the 'minor edit' checkbox.
353 -- Many automated edits are marked as minor.
354 rev_minor_edit tinyint unsigned NOT NULL default 0,
355
356 -- Restrictions on who can access this revision
357 rev_deleted tinyint unsigned NOT NULL default 0,
358
359 -- Length of this revision in bytes
360 rev_len int unsigned,
361
362 -- Key to revision.rev_id
363 -- This field is used to add support for a tree structure (The Adjacency List Model)
364 rev_parent_id int unsigned default NULL,
365
366 -- SHA-1 text content hash in base-36
367 rev_sha1 varbinary(32) NOT NULL default '',
368
369 -- content model, see CONTENT_MODEL_XXX constants
370 rev_content_model varbinary(32) DEFAULT NULL,
371
372 -- content format, see CONTENT_FORMAT_XXX constants
373 rev_content_format varbinary(64) DEFAULT NULL
374
375 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=1024;
376 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
377
378 CREATE INDEX /*i*/rev_page_id ON /*_*/revision (rev_page, rev_id);
379 CREATE INDEX /*i*/rev_timestamp ON /*_*/revision (rev_timestamp);
380 CREATE INDEX /*i*/page_timestamp ON /*_*/revision (rev_page,rev_timestamp);
381 CREATE INDEX /*i*/user_timestamp ON /*_*/revision (rev_user,rev_timestamp);
382 CREATE INDEX /*i*/usertext_timestamp ON /*_*/revision (rev_user_text,rev_timestamp);
383 CREATE INDEX /*i*/page_user_timestamp ON /*_*/revision (rev_page,rev_user,rev_timestamp);
384
385 --
386 -- Holds text of individual page revisions.
387 --
388 -- Field names are a holdover from the 'old' revisions table in
389 -- MediaWiki 1.4 and earlier: an upgrade will transform that
390 -- table into the 'text' table to minimize unnecessary churning
391 -- and downtime. If upgrading, the other fields will be left unused.
392 --
393 CREATE TABLE /*_*/text (
394 -- Unique text storage key number.
395 -- Note that the 'oldid' parameter used in URLs does *not*
396 -- refer to this number anymore, but to rev_id.
397 --
398 -- revision.rev_text_id is a key to this column
399 old_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
400
401 -- Depending on the contents of the old_flags field, the text
402 -- may be convenient plain text, or it may be funkily encoded.
403 old_text mediumblob NOT NULL,
404
405 -- Comma-separated list of flags:
406 -- gzip: text is compressed with PHP's gzdeflate() function.
407 -- utf-8: text was stored as UTF-8.
408 -- If $wgLegacyEncoding option is on, rows *without* this flag
409 -- will be converted to UTF-8 transparently at load time. Note
410 -- that due to a bug in a maintenance script, this flag may
411 -- have been stored as 'utf8' in some cases (T18841).
412 -- object: text field contained a serialized PHP object.
413 -- The object either contains multiple versions compressed
414 -- together to achieve a better compression ratio, or it refers
415 -- to another row where the text can be found.
416 -- external: text was stored in an external location specified by old_text.
417 -- Any additional flags apply to the data stored at that URL, not
418 -- the URL itself. The 'object' flag is *not* set for URLs of the
419 -- form 'DB://cluster/id/itemid', because the external storage
420 -- system itself decompresses these.
421 old_flags tinyblob NOT NULL
422 ) /*$wgDBTableOptions*/ MAX_ROWS=10000000 AVG_ROW_LENGTH=10240;
423 -- In case tables are created as MyISAM, use row hints for MySQL <5.0 to avoid 4GB limit
424
425
426 --
427 -- Holding area for deleted articles, which may be viewed
428 -- or restored by admins through the Special:Undelete interface.
429 -- The fields generally correspond to the page, revision, and text
430 -- fields, with several caveats.
431 --
432 CREATE TABLE /*_*/archive (
433 -- Primary key
434 ar_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
435 ar_namespace int NOT NULL default 0,
436 ar_title varchar(255) binary NOT NULL default '',
437
438 -- Newly deleted pages will not store text in this table,
439 -- but will reference the separately existing text rows.
440 -- This field is retained for backwards compatibility,
441 -- so old archived pages will remain accessible after
442 -- upgrading from 1.4 to 1.5.
443 -- Text may be gzipped or otherwise funky.
444 ar_text mediumblob NOT NULL,
445
446 -- Basic revision stuff...
447 ar_comment varbinary(767) NOT NULL,
448 ar_user int unsigned NOT NULL default 0,
449 ar_user_text varchar(255) binary NOT NULL,
450 ar_timestamp binary(14) NOT NULL default '',
451 ar_minor_edit tinyint NOT NULL default 0,
452
453 -- See ar_text note.
454 ar_flags tinyblob NOT NULL,
455
456 -- When revisions are deleted, their unique rev_id is stored
457 -- here so it can be retained after undeletion. This is necessary
458 -- to retain permalinks to given revisions after accidental delete
459 -- cycles or messy operations like history merges.
460 --
461 -- Old entries from 1.4 will be NULL here, and a new rev_id will
462 -- be created on undeletion for those revisions.
463 ar_rev_id int unsigned,
464
465 -- For newly deleted revisions, this is the text.old_id key to the
466 -- actual stored text. To avoid breaking the block-compression scheme
467 -- and otherwise making storage changes harder, the actual text is
468 -- *not* deleted from the text table, merely hidden by removal of the
469 -- page and revision entries.
470 --
471 -- Old entries deleted under 1.2-1.4 will have NULL here, and their
472 -- ar_text and ar_flags fields will be used to create a new text
473 -- row upon undeletion.
474 ar_text_id int unsigned,
475
476 -- rev_deleted for archives
477 ar_deleted tinyint unsigned NOT NULL default 0,
478
479 -- Length of this revision in bytes
480 ar_len int unsigned,
481
482 -- Reference to page_id. Useful for sysadmin fixing of large pages
483 -- merged together in the archives, or for cleanly restoring a page
484 -- at its original ID number if possible.
485 --
486 -- Will be NULL for pages deleted prior to 1.11.
487 ar_page_id int unsigned,
488
489 -- Original previous revision
490 ar_parent_id int unsigned default NULL,
491
492 -- SHA-1 text content hash in base-36
493 ar_sha1 varbinary(32) NOT NULL default '',
494
495 -- content model, see CONTENT_MODEL_XXX constants
496 ar_content_model varbinary(32) DEFAULT NULL,
497
498 -- content format, see CONTENT_FORMAT_XXX constants
499 ar_content_format varbinary(64) DEFAULT NULL
500 ) /*$wgDBTableOptions*/;
501
502 CREATE INDEX /*i*/name_title_timestamp ON /*_*/archive (ar_namespace,ar_title,ar_timestamp);
503 CREATE INDEX /*i*/ar_usertext_timestamp ON /*_*/archive (ar_user_text,ar_timestamp);
504 CREATE INDEX /*i*/ar_revid ON /*_*/archive (ar_rev_id);
505
506
507 --
508 -- Track page-to-page hyperlinks within the wiki.
509 --
510 CREATE TABLE /*_*/pagelinks (
511 -- Key to the page_id of the page containing the link.
512 pl_from int unsigned NOT NULL default 0,
513 -- Namespace for this page
514 pl_from_namespace int NOT NULL default 0,
515
516 -- Key to page_namespace/page_title of the target page.
517 -- The target page may or may not exist, and due to renames
518 -- and deletions may refer to different page records as time
519 -- goes by.
520 pl_namespace int NOT NULL default 0,
521 pl_title varchar(255) binary NOT NULL default ''
522 ) /*$wgDBTableOptions*/;
523
524 CREATE UNIQUE INDEX /*i*/pl_from ON /*_*/pagelinks (pl_from,pl_namespace,pl_title);
525 CREATE INDEX /*i*/pl_namespace ON /*_*/pagelinks (pl_namespace,pl_title,pl_from);
526 CREATE INDEX /*i*/pl_backlinks_namespace ON /*_*/pagelinks (pl_from_namespace,pl_namespace,pl_title,pl_from);
527
528
529 --
530 -- Track template inclusions.
531 --
532 CREATE TABLE /*_*/templatelinks (
533 -- Key to the page_id of the page containing the link.
534 tl_from int unsigned NOT NULL default 0,
535 -- Namespace for this page
536 tl_from_namespace int NOT NULL default 0,
537
538 -- Key to page_namespace/page_title of the target page.
539 -- The target page may or may not exist, and due to renames
540 -- and deletions may refer to different page records as time
541 -- goes by.
542 tl_namespace int NOT NULL default 0,
543 tl_title varchar(255) binary NOT NULL default ''
544 ) /*$wgDBTableOptions*/;
545
546 CREATE UNIQUE INDEX /*i*/tl_from ON /*_*/templatelinks (tl_from,tl_namespace,tl_title);
547 CREATE INDEX /*i*/tl_namespace ON /*_*/templatelinks (tl_namespace,tl_title,tl_from);
548 CREATE INDEX /*i*/tl_backlinks_namespace ON /*_*/templatelinks (tl_from_namespace,tl_namespace,tl_title,tl_from);
549
550
551 --
552 -- Track links to images *used inline*
553 -- We don't distinguish live from broken links here, so
554 -- they do not need to be changed on upload/removal.
555 --
556 CREATE TABLE /*_*/imagelinks (
557 -- Key to page_id of the page containing the image / media link.
558 il_from int unsigned NOT NULL default 0,
559 -- Namespace for this page
560 il_from_namespace int NOT NULL default 0,
561
562 -- Filename of target image.
563 -- This is also the page_title of the file's description page;
564 -- all such pages are in namespace 6 (NS_FILE).
565 il_to varchar(255) binary NOT NULL default ''
566 ) /*$wgDBTableOptions*/;
567
568 CREATE UNIQUE INDEX /*i*/il_from ON /*_*/imagelinks (il_from,il_to);
569 CREATE INDEX /*i*/il_to ON /*_*/imagelinks (il_to,il_from);
570 CREATE INDEX /*i*/il_backlinks_namespace ON /*_*/imagelinks (il_from_namespace,il_to,il_from);
571
572
573 --
574 -- Track category inclusions *used inline*
575 -- This tracks a single level of category membership
576 --
577 CREATE TABLE /*_*/categorylinks (
578 -- Key to page_id of the page defined as a category member.
579 cl_from int unsigned NOT NULL default 0,
580
581 -- Name of the category.
582 -- This is also the page_title of the category's description page;
583 -- all such pages are in namespace 14 (NS_CATEGORY).
584 cl_to varchar(255) binary NOT NULL default '',
585
586 -- A binary string obtained by applying a sortkey generation algorithm
587 -- (Collation::getSortKey()) to page_title, or cl_sortkey_prefix . "\n"
588 -- . page_title if cl_sortkey_prefix is nonempty.
589 cl_sortkey varbinary(230) NOT NULL default '',
590
591 -- A prefix for the raw sortkey manually specified by the user, either via
592 -- [[Category:Foo|prefix]] or {{defaultsort:prefix}}. If nonempty, it's
593 -- concatenated with a line break followed by the page title before the sortkey
594 -- conversion algorithm is run. We store this so that we can update
595 -- collations without reparsing all pages.
596 -- Note: If you change the length of this field, you also need to change
597 -- code in LinksUpdate.php. See T27254.
598 cl_sortkey_prefix varchar(255) binary NOT NULL default '',
599
600 -- This isn't really used at present. Provided for an optional
601 -- sorting method by approximate addition time.
602 cl_timestamp timestamp NOT NULL,
603
604 -- Stores $wgCategoryCollation at the time cl_sortkey was generated. This
605 -- can be used to install new collation versions, tracking which rows are not
606 -- yet updated. '' means no collation, this is a legacy row that needs to be
607 -- updated by updateCollation.php. In the future, it might be possible to
608 -- specify different collations per category.
609 cl_collation varbinary(32) NOT NULL default '',
610
611 -- Stores whether cl_from is a category, file, or other page, so we can
612 -- paginate the three categories separately. This never has to be updated
613 -- after the page is created, since none of these page types can be moved to
614 -- any other.
615 cl_type ENUM('page', 'subcat', 'file') NOT NULL default 'page'
616 ) /*$wgDBTableOptions*/;
617
618 CREATE UNIQUE INDEX /*i*/cl_from ON /*_*/categorylinks (cl_from,cl_to);
619
620 -- We always sort within a given category, and within a given type. FIXME:
621 -- Formerly this index didn't cover cl_type (since that didn't exist), so old
622 -- callers won't be using an index: fix this?
623 CREATE INDEX /*i*/cl_sortkey ON /*_*/categorylinks (cl_to,cl_type,cl_sortkey,cl_from);
624
625 -- Used by the API (and some extensions)
626 CREATE INDEX /*i*/cl_timestamp ON /*_*/categorylinks (cl_to,cl_timestamp);
627
628 -- Used when updating collation (e.g. updateCollation.php)
629 CREATE INDEX /*i*/cl_collation_ext ON /*_*/categorylinks (cl_collation, cl_to, cl_type, cl_from);
630
631 --
632 -- Track all existing categories. Something is a category if 1) it has an entry
633 -- somewhere in categorylinks, or 2) it has a description page. Categories
634 -- might not have corresponding pages, so they need to be tracked separately.
635 --
636 CREATE TABLE /*_*/category (
637 -- Primary key
638 cat_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
639
640 -- Name of the category, in the same form as page_title (with underscores).
641 -- If there is a category page corresponding to this category, by definition,
642 -- it has this name (in the Category namespace).
643 cat_title varchar(255) binary NOT NULL,
644
645 -- The numbers of member pages (including categories and media), subcatego-
646 -- ries, and Image: namespace members, respectively. These are signed to
647 -- make underflow more obvious. We make the first number include the second
648 -- two for better sorting: subtracting for display is easy, adding for order-
649 -- ing is not.
650 cat_pages int signed NOT NULL default 0,
651 cat_subcats int signed NOT NULL default 0,
652 cat_files int signed NOT NULL default 0
653 ) /*$wgDBTableOptions*/;
654
655 CREATE UNIQUE INDEX /*i*/cat_title ON /*_*/category (cat_title);
656
657 -- For Special:Mostlinkedcategories
658 CREATE INDEX /*i*/cat_pages ON /*_*/category (cat_pages);
659
660
661 --
662 -- Track links to external URLs
663 --
664 CREATE TABLE /*_*/externallinks (
665 -- Primary key
666 el_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
667
668 -- page_id of the referring page
669 el_from int unsigned NOT NULL default 0,
670
671 -- The URL
672 el_to blob NOT NULL,
673
674 -- In the case of HTTP URLs, this is the URL with any username or password
675 -- removed, and with the labels in the hostname reversed and converted to
676 -- lower case. An extra dot is added to allow for matching of either
677 -- example.com or *.example.com in a single scan.
678 -- Example:
679 -- http://user:password@sub.example.com/page.html
680 -- becomes
681 -- http://com.example.sub./page.html
682 -- which allows for fast searching for all pages under example.com with the
683 -- clause:
684 -- WHERE el_index LIKE 'http://com.example.%'
685 el_index blob NOT NULL,
686
687 -- This is el_index truncated to 60 bytes to allow for sortable queries that
688 -- aren't supported by a partial index.
689 -- @todo Drop the default once this is deployed everywhere and code is populating it.
690 el_index_60 varbinary(60) NOT NULL default ''
691 ) /*$wgDBTableOptions*/;
692
693 CREATE INDEX /*i*/el_from ON /*_*/externallinks (el_from, el_to(40));
694 CREATE INDEX /*i*/el_to ON /*_*/externallinks (el_to(60), el_from);
695 CREATE INDEX /*i*/el_index ON /*_*/externallinks (el_index(60));
696 CREATE INDEX /*i*/el_index_60 ON /*_*/externallinks (el_index_60, el_id);
697 CREATE INDEX /*i*/el_from_index_60 ON /*_*/externallinks (el_from, el_index_60, el_id);
698
699 --
700 -- Track interlanguage links
701 --
702 CREATE TABLE /*_*/langlinks (
703 -- page_id of the referring page
704 ll_from int unsigned NOT NULL default 0,
705
706 -- Language code of the target
707 ll_lang varbinary(20) NOT NULL default '',
708
709 -- Title of the target, including namespace
710 ll_title varchar(255) binary NOT NULL default ''
711 ) /*$wgDBTableOptions*/;
712
713 CREATE UNIQUE INDEX /*i*/ll_from ON /*_*/langlinks (ll_from, ll_lang);
714 CREATE INDEX /*i*/ll_lang ON /*_*/langlinks (ll_lang, ll_title);
715
716
717 --
718 -- Track inline interwiki links
719 --
720 CREATE TABLE /*_*/iwlinks (
721 -- page_id of the referring page
722 iwl_from int unsigned NOT NULL default 0,
723
724 -- Interwiki prefix code of the target
725 iwl_prefix varbinary(20) NOT NULL default '',
726
727 -- Title of the target, including namespace
728 iwl_title varchar(255) binary NOT NULL default ''
729 ) /*$wgDBTableOptions*/;
730
731 CREATE UNIQUE INDEX /*i*/iwl_from ON /*_*/iwlinks (iwl_from, iwl_prefix, iwl_title);
732 CREATE INDEX /*i*/iwl_prefix_title_from ON /*_*/iwlinks (iwl_prefix, iwl_title, iwl_from);
733 CREATE INDEX /*i*/iwl_prefix_from_title ON /*_*/iwlinks (iwl_prefix, iwl_from, iwl_title);
734
735
736 --
737 -- Contains a single row with some aggregate info
738 -- on the state of the site.
739 --
740 CREATE TABLE /*_*/site_stats (
741 -- The single row should contain 1 here.
742 ss_row_id int unsigned NOT NULL,
743
744 -- Total number of edits performed.
745 ss_total_edits bigint unsigned default 0,
746
747 -- An approximate count of pages matching the following criteria:
748 -- * in namespace 0
749 -- * not a redirect
750 -- * contains the text '[['
751 -- See Article::isCountable() in includes/Article.php
752 ss_good_articles bigint unsigned default 0,
753
754 -- Total pages, theoretically equal to SELECT COUNT(*) FROM page; except faster
755 ss_total_pages bigint default '-1',
756
757 -- Number of users, theoretically equal to SELECT COUNT(*) FROM user;
758 ss_users bigint default '-1',
759
760 -- Number of users that still edit
761 ss_active_users bigint default '-1',
762
763 -- Number of images, equivalent to SELECT COUNT(*) FROM image
764 ss_images int default 0
765 ) /*$wgDBTableOptions*/;
766
767 -- Pointless index to assuage developer superstitions
768 CREATE UNIQUE INDEX /*i*/ss_row_id ON /*_*/site_stats (ss_row_id);
769
770 --
771 -- The internet is full of jerks, alas. Sometimes it's handy
772 -- to block a vandal or troll account.
773 --
774 CREATE TABLE /*_*/ipblocks (
775 -- Primary key, introduced for privacy.
776 ipb_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
777
778 -- Blocked IP address in dotted-quad form or user name.
779 ipb_address tinyblob NOT NULL,
780
781 -- Blocked user ID or 0 for IP blocks.
782 ipb_user int unsigned NOT NULL default 0,
783
784 -- User ID who made the block.
785 ipb_by int unsigned NOT NULL default 0,
786
787 -- User name of blocker
788 ipb_by_text varchar(255) binary NOT NULL default '',
789
790 -- Text comment made by blocker.
791 ipb_reason varbinary(767) NOT NULL,
792
793 -- Creation (or refresh) date in standard YMDHMS form.
794 -- IP blocks expire automatically.
795 ipb_timestamp binary(14) NOT NULL default '',
796
797 -- Indicates that the IP address was banned because a banned
798 -- user accessed a page through it. If this is 1, ipb_address
799 -- will be hidden, and the block identified by block ID number.
800 ipb_auto bool NOT NULL default 0,
801
802 -- If set to 1, block applies only to logged-out users
803 ipb_anon_only bool NOT NULL default 0,
804
805 -- Block prevents account creation from matching IP addresses
806 ipb_create_account bool NOT NULL default 1,
807
808 -- Block triggers autoblocks
809 ipb_enable_autoblock bool NOT NULL default '1',
810
811 -- Time at which the block will expire.
812 -- May be "infinity"
813 ipb_expiry varbinary(14) NOT NULL default '',
814
815 -- Start and end of an address range, in hexadecimal
816 -- Size chosen to allow IPv6
817 -- FIXME: these fields were originally blank for single-IP blocks,
818 -- but now they are populated. No migration was ever done. They
819 -- should be fixed to be blank again for such blocks (T51504).
820 ipb_range_start tinyblob NOT NULL,
821 ipb_range_end tinyblob NOT NULL,
822
823 -- Flag for entries hidden from users and Sysops
824 ipb_deleted bool NOT NULL default 0,
825
826 -- Block prevents user from accessing Special:Emailuser
827 ipb_block_email bool NOT NULL default 0,
828
829 -- Block allows user to edit their own talk page
830 ipb_allow_usertalk bool NOT NULL default 0,
831
832 -- ID of the block that caused this block to exist
833 -- Autoblocks set this to the original block
834 -- so that the original block being deleted also
835 -- deletes the autoblocks
836 ipb_parent_block_id int default NULL
837
838 ) /*$wgDBTableOptions*/;
839
840 -- Unique index to support "user already blocked" messages
841 -- Any new options which prevent collisions should be included
842 CREATE UNIQUE INDEX /*i*/ipb_address ON /*_*/ipblocks (ipb_address(255), ipb_user, ipb_auto, ipb_anon_only);
843
844 CREATE INDEX /*i*/ipb_user ON /*_*/ipblocks (ipb_user);
845 CREATE INDEX /*i*/ipb_range ON /*_*/ipblocks (ipb_range_start(8), ipb_range_end(8));
846 CREATE INDEX /*i*/ipb_timestamp ON /*_*/ipblocks (ipb_timestamp);
847 CREATE INDEX /*i*/ipb_expiry ON /*_*/ipblocks (ipb_expiry);
848 CREATE INDEX /*i*/ipb_parent_block_id ON /*_*/ipblocks (ipb_parent_block_id);
849
850
851 --
852 -- Uploaded images and other files.
853 --
854 CREATE TABLE /*_*/image (
855 -- Filename.
856 -- This is also the title of the associated description page,
857 -- which will be in namespace 6 (NS_FILE).
858 img_name varchar(255) binary NOT NULL default '' PRIMARY KEY,
859
860 -- File size in bytes.
861 img_size int unsigned NOT NULL default 0,
862
863 -- For images, size in pixels.
864 img_width int NOT NULL default 0,
865 img_height int NOT NULL default 0,
866
867 -- Extracted Exif metadata stored as a serialized PHP array.
868 img_metadata mediumblob NOT NULL,
869
870 -- For images, bits per pixel if known.
871 img_bits int NOT NULL default 0,
872
873 -- Media type as defined by the MEDIATYPE_xxx constants
874 img_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
875
876 -- major part of a MIME media type as defined by IANA
877 -- see https://www.iana.org/assignments/media-types/
878 -- for "chemical" cf. http://dx.doi.org/10.1021/ci9803233 by the ACS
879 img_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart", "chemical") NOT NULL default "unknown",
880
881 -- minor part of a MIME media type as defined by IANA
882 -- the minor parts are not required to adher to any standard
883 -- but should be consistent throughout the database
884 -- see https://www.iana.org/assignments/media-types/
885 img_minor_mime varbinary(100) NOT NULL default "unknown",
886
887 -- Description field as entered by the uploader.
888 -- This is displayed in image upload history and logs.
889 img_description varbinary(767) NOT NULL,
890
891 -- user_id and user_name of uploader.
892 img_user int unsigned NOT NULL default 0,
893 img_user_text varchar(255) binary NOT NULL,
894
895 -- Time of the upload.
896 img_timestamp varbinary(14) NOT NULL default '',
897
898 -- SHA-1 content hash in base-36
899 img_sha1 varbinary(32) NOT NULL default ''
900 ) /*$wgDBTableOptions*/;
901
902 CREATE INDEX /*i*/img_usertext_timestamp ON /*_*/image (img_user_text,img_timestamp);
903 -- Used by Special:ListFiles for sort-by-size
904 CREATE INDEX /*i*/img_size ON /*_*/image (img_size);
905 -- Used by Special:Newimages and Special:ListFiles
906 CREATE INDEX /*i*/img_timestamp ON /*_*/image (img_timestamp);
907 -- Used in API and duplicate search
908 CREATE INDEX /*i*/img_sha1 ON /*_*/image (img_sha1(10));
909 -- Used to get media of one type
910 CREATE INDEX /*i*/img_media_mime ON /*_*/image (img_media_type,img_major_mime,img_minor_mime);
911
912
913 --
914 -- Previous revisions of uploaded files.
915 -- Awkwardly, image rows have to be moved into
916 -- this table at re-upload time.
917 --
918 CREATE TABLE /*_*/oldimage (
919 -- Base filename: key to image.img_name
920 oi_name varchar(255) binary NOT NULL default '',
921
922 -- Filename of the archived file.
923 -- This is generally a timestamp and '!' prepended to the base name.
924 oi_archive_name varchar(255) binary NOT NULL default '',
925
926 -- Other fields as in image...
927 oi_size int unsigned NOT NULL default 0,
928 oi_width int NOT NULL default 0,
929 oi_height int NOT NULL default 0,
930 oi_bits int NOT NULL default 0,
931 oi_description varbinary(767) NOT NULL,
932 oi_user int unsigned NOT NULL default 0,
933 oi_user_text varchar(255) binary NOT NULL,
934 oi_timestamp binary(14) NOT NULL default '',
935
936 oi_metadata mediumblob NOT NULL,
937 oi_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
938 oi_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart", "chemical") NOT NULL default "unknown",
939 oi_minor_mime varbinary(100) NOT NULL default "unknown",
940 oi_deleted tinyint unsigned NOT NULL default 0,
941 oi_sha1 varbinary(32) NOT NULL default ''
942 ) /*$wgDBTableOptions*/;
943
944 CREATE INDEX /*i*/oi_usertext_timestamp ON /*_*/oldimage (oi_user_text,oi_timestamp);
945 CREATE INDEX /*i*/oi_name_timestamp ON /*_*/oldimage (oi_name,oi_timestamp);
946 -- oi_archive_name truncated to 14 to avoid key length overflow
947 CREATE INDEX /*i*/oi_name_archive_name ON /*_*/oldimage (oi_name,oi_archive_name(14));
948 CREATE INDEX /*i*/oi_sha1 ON /*_*/oldimage (oi_sha1(10));
949
950
951 --
952 -- Record of deleted file data
953 --
954 CREATE TABLE /*_*/filearchive (
955 -- Unique row id
956 fa_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
957
958 -- Original base filename; key to image.img_name, page.page_title, etc
959 fa_name varchar(255) binary NOT NULL default '',
960
961 -- Filename of archived file, if an old revision
962 fa_archive_name varchar(255) binary default '',
963
964 -- Which storage bin (directory tree or object store) the file data
965 -- is stored in. Should be 'deleted' for files that have been deleted;
966 -- any other bin is not yet in use.
967 fa_storage_group varbinary(16),
968
969 -- SHA-1 of the file contents plus extension, used as a key for storage.
970 -- eg 8f8a562add37052a1848ff7771a2c515db94baa9.jpg
971 --
972 -- If NULL, the file was missing at deletion time or has been purged
973 -- from the archival storage.
974 fa_storage_key varbinary(64) default '',
975
976 -- Deletion information, if this file is deleted.
977 fa_deleted_user int,
978 fa_deleted_timestamp binary(14) default '',
979 fa_deleted_reason varbinary(767) default '',
980
981 -- Duped fields from image
982 fa_size int unsigned default 0,
983 fa_width int default 0,
984 fa_height int default 0,
985 fa_metadata mediumblob,
986 fa_bits int default 0,
987 fa_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
988 fa_major_mime ENUM("unknown", "application", "audio", "image", "text", "video", "message", "model", "multipart", "chemical") default "unknown",
989 fa_minor_mime varbinary(100) default "unknown",
990 fa_description varbinary(767),
991 fa_user int unsigned default 0,
992 fa_user_text varchar(255) binary,
993 fa_timestamp binary(14) default '',
994
995 -- Visibility of deleted revisions, bitfield
996 fa_deleted tinyint unsigned NOT NULL default 0,
997
998 -- sha1 hash of file content
999 fa_sha1 varbinary(32) NOT NULL default ''
1000 ) /*$wgDBTableOptions*/;
1001
1002 -- pick out by image name
1003 CREATE INDEX /*i*/fa_name ON /*_*/filearchive (fa_name, fa_timestamp);
1004 -- pick out dupe files
1005 CREATE INDEX /*i*/fa_storage_group ON /*_*/filearchive (fa_storage_group, fa_storage_key);
1006 -- sort by deletion time
1007 CREATE INDEX /*i*/fa_deleted_timestamp ON /*_*/filearchive (fa_deleted_timestamp);
1008 -- sort by uploader
1009 CREATE INDEX /*i*/fa_user_timestamp ON /*_*/filearchive (fa_user_text,fa_timestamp);
1010 -- find file by sha1, 10 bytes will be enough for hashes to be indexed
1011 CREATE INDEX /*i*/fa_sha1 ON /*_*/filearchive (fa_sha1(10));
1012
1013
1014 --
1015 -- Store information about newly uploaded files before they're
1016 -- moved into the actual filestore
1017 --
1018 CREATE TABLE /*_*/uploadstash (
1019 us_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1020
1021 -- the user who uploaded the file.
1022 us_user int unsigned NOT NULL,
1023
1024 -- file key. this is how applications actually search for the file.
1025 -- this might go away, or become the primary key.
1026 us_key varchar(255) NOT NULL,
1027
1028 -- the original path
1029 us_orig_path varchar(255) NOT NULL,
1030
1031 -- the temporary path at which the file is actually stored
1032 us_path varchar(255) NOT NULL,
1033
1034 -- which type of upload the file came from (sometimes)
1035 us_source_type varchar(50),
1036
1037 -- the date/time on which the file was added
1038 us_timestamp varbinary(14) NOT NULL,
1039
1040 us_status varchar(50) NOT NULL,
1041
1042 -- chunk counter starts at 0, current offset is stored in us_size
1043 us_chunk_inx int unsigned NULL,
1044
1045 -- Serialized file properties from FSFile::getProps()
1046 us_props blob,
1047
1048 -- file size in bytes
1049 us_size int unsigned NOT NULL,
1050 -- this hash comes from FSFile::getSha1Base36(), and is 31 characters
1051 us_sha1 varchar(31) NOT NULL,
1052 us_mime varchar(255),
1053 -- Media type as defined by the MEDIATYPE_xxx constants, should duplicate definition in the image table
1054 us_media_type ENUM("UNKNOWN", "BITMAP", "DRAWING", "AUDIO", "VIDEO", "MULTIMEDIA", "OFFICE", "TEXT", "EXECUTABLE", "ARCHIVE") default NULL,
1055 -- image-specific properties
1056 us_image_width int unsigned,
1057 us_image_height int unsigned,
1058 us_image_bits smallint unsigned
1059
1060 ) /*$wgDBTableOptions*/;
1061
1062 -- sometimes there's a delete for all of a user's stuff.
1063 CREATE INDEX /*i*/us_user ON /*_*/uploadstash (us_user);
1064 -- pick out files by key, enforce key uniqueness
1065 CREATE UNIQUE INDEX /*i*/us_key ON /*_*/uploadstash (us_key);
1066 -- the abandoned upload cleanup script needs this
1067 CREATE INDEX /*i*/us_timestamp ON /*_*/uploadstash (us_timestamp);
1068
1069
1070 --
1071 -- Primarily a summary table for Special:Recentchanges,
1072 -- this table contains some additional info on edits from
1073 -- the last few days, see Article::editUpdates()
1074 --
1075 CREATE TABLE /*_*/recentchanges (
1076 rc_id int NOT NULL PRIMARY KEY AUTO_INCREMENT,
1077 rc_timestamp varbinary(14) NOT NULL default '',
1078
1079 -- As in revision
1080 rc_user int unsigned NOT NULL default 0,
1081 rc_user_text varchar(255) binary NOT NULL,
1082
1083 -- When pages are renamed, their RC entries do _not_ change.
1084 rc_namespace int NOT NULL default 0,
1085 rc_title varchar(255) binary NOT NULL default '',
1086
1087 -- as in revision...
1088 rc_comment varbinary(767) NOT NULL default '',
1089 rc_minor tinyint unsigned NOT NULL default 0,
1090
1091 -- Edits by user accounts with the 'bot' rights key are
1092 -- marked with a 1 here, and will be hidden from the
1093 -- default view.
1094 rc_bot tinyint unsigned NOT NULL default 0,
1095
1096 -- Set if this change corresponds to a page creation
1097 rc_new tinyint unsigned NOT NULL default 0,
1098
1099 -- Key to page_id (was cur_id prior to 1.5).
1100 -- This will keep links working after moves while
1101 -- retaining the at-the-time name in the changes list.
1102 rc_cur_id int unsigned NOT NULL default 0,
1103
1104 -- rev_id of the given revision
1105 rc_this_oldid int unsigned NOT NULL default 0,
1106
1107 -- rev_id of the prior revision, for generating diff links.
1108 rc_last_oldid int unsigned NOT NULL default 0,
1109
1110 -- The type of change entry (RC_EDIT,RC_NEW,RC_LOG,RC_EXTERNAL)
1111 rc_type tinyint unsigned NOT NULL default 0,
1112
1113 -- The source of the change entry (replaces rc_type)
1114 -- default of '' is temporary, needed for initial migration
1115 rc_source varchar(16) binary not null default '',
1116
1117 -- If the Recent Changes Patrol option is enabled,
1118 -- users may mark edits as having been reviewed to
1119 -- remove a warning flag on the RC list.
1120 -- A value of 1 indicates the page has been reviewed.
1121 rc_patrolled tinyint unsigned NOT NULL default 0,
1122
1123 -- Recorded IP address the edit was made from, if the
1124 -- $wgPutIPinRC option is enabled.
1125 rc_ip varbinary(40) NOT NULL default '',
1126
1127 -- Text length in characters before
1128 -- and after the edit
1129 rc_old_len int,
1130 rc_new_len int,
1131
1132 -- Visibility of recent changes items, bitfield
1133 rc_deleted tinyint unsigned NOT NULL default 0,
1134
1135 -- Value corresponding to log_id, specific log entries
1136 rc_logid int unsigned NOT NULL default 0,
1137 -- Store log type info here, or null
1138 rc_log_type varbinary(255) NULL default NULL,
1139 -- Store log action or null
1140 rc_log_action varbinary(255) NULL default NULL,
1141 -- Log params
1142 rc_params blob NULL
1143 ) /*$wgDBTableOptions*/;
1144
1145 CREATE INDEX /*i*/rc_timestamp ON /*_*/recentchanges (rc_timestamp);
1146 CREATE INDEX /*i*/rc_namespace_title ON /*_*/recentchanges (rc_namespace, rc_title);
1147 CREATE INDEX /*i*/rc_cur_id ON /*_*/recentchanges (rc_cur_id);
1148 CREATE INDEX /*i*/new_name_timestamp ON /*_*/recentchanges (rc_new,rc_namespace,rc_timestamp);
1149 CREATE INDEX /*i*/rc_ip ON /*_*/recentchanges (rc_ip);
1150 CREATE INDEX /*i*/rc_ns_usertext ON /*_*/recentchanges (rc_namespace, rc_user_text);
1151 CREATE INDEX /*i*/rc_user_text ON /*_*/recentchanges (rc_user_text, rc_timestamp);
1152 CREATE INDEX /*i*/rc_name_type_patrolled_timestamp ON /*_*/recentchanges (rc_namespace, rc_type, rc_patrolled, rc_timestamp);
1153
1154
1155 CREATE TABLE /*_*/watchlist (
1156 wl_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1157 -- Key to user.user_id
1158 wl_user int unsigned NOT NULL,
1159
1160 -- Key to page_namespace/page_title
1161 -- Note that users may watch pages which do not exist yet,
1162 -- or existed in the past but have been deleted.
1163 wl_namespace int NOT NULL default 0,
1164 wl_title varchar(255) binary NOT NULL default '',
1165
1166 -- Timestamp used to send notification e-mails and show "updated since last visit" markers on
1167 -- history and recent changes / watchlist. Set to NULL when the user visits the latest revision
1168 -- of the page, which means that they should be sent an e-mail on the next change.
1169 wl_notificationtimestamp varbinary(14)
1170
1171 ) /*$wgDBTableOptions*/;
1172
1173 CREATE UNIQUE INDEX /*i*/wl_user ON /*_*/watchlist (wl_user, wl_namespace, wl_title);
1174 CREATE INDEX /*i*/namespace_title ON /*_*/watchlist (wl_namespace, wl_title);
1175 CREATE INDEX /*i*/wl_user_notificationtimestamp ON /*_*/watchlist (wl_user, wl_notificationtimestamp);
1176
1177
1178 --
1179 -- When using the default MySQL search backend, page titles
1180 -- and text are munged to strip markup, do Unicode case folding,
1181 -- and prepare the result for MySQL's fulltext index.
1182 --
1183 -- This table must be MyISAM; InnoDB does not support the needed
1184 -- fulltext index.
1185 --
1186 CREATE TABLE /*_*/searchindex (
1187 -- Key to page_id
1188 si_page int unsigned NOT NULL,
1189
1190 -- Munged version of title
1191 si_title varchar(255) NOT NULL default '',
1192
1193 -- Munged version of body text
1194 si_text mediumtext NOT NULL
1195 ) ENGINE=MyISAM DEFAULT CHARSET=utf8;
1196
1197 CREATE UNIQUE INDEX /*i*/si_page ON /*_*/searchindex (si_page);
1198 CREATE FULLTEXT INDEX /*i*/si_title ON /*_*/searchindex (si_title);
1199 CREATE FULLTEXT INDEX /*i*/si_text ON /*_*/searchindex (si_text);
1200
1201
1202 --
1203 -- Recognized interwiki link prefixes
1204 --
1205 CREATE TABLE /*_*/interwiki (
1206 -- The interwiki prefix, (e.g. "Meatball", or the language prefix "de")
1207 iw_prefix varchar(32) NOT NULL,
1208
1209 -- The URL of the wiki, with "$1" as a placeholder for an article name.
1210 -- Any spaces in the name will be transformed to underscores before
1211 -- insertion.
1212 iw_url blob NOT NULL,
1213
1214 -- The URL of the file api.php
1215 iw_api blob NOT NULL,
1216
1217 -- The name of the database (for a connection to be established with wfGetLB( 'wikiid' ))
1218 iw_wikiid varchar(64) NOT NULL,
1219
1220 -- A boolean value indicating whether the wiki is in this project
1221 -- (used, for example, to detect redirect loops)
1222 iw_local bool NOT NULL,
1223
1224 -- Boolean value indicating whether interwiki transclusions are allowed.
1225 iw_trans tinyint NOT NULL default 0
1226 ) /*$wgDBTableOptions*/;
1227
1228 CREATE UNIQUE INDEX /*i*/iw_prefix ON /*_*/interwiki (iw_prefix);
1229
1230
1231 --
1232 -- Used for caching expensive grouped queries
1233 --
1234 CREATE TABLE /*_*/querycache (
1235 -- A key name, generally the base name of of the special page.
1236 qc_type varbinary(32) NOT NULL,
1237
1238 -- Some sort of stored value. Sizes, counts...
1239 qc_value int unsigned NOT NULL default 0,
1240
1241 -- Target namespace+title
1242 qc_namespace int NOT NULL default 0,
1243 qc_title varchar(255) binary NOT NULL default ''
1244 ) /*$wgDBTableOptions*/;
1245
1246 CREATE INDEX /*i*/qc_type ON /*_*/querycache (qc_type,qc_value);
1247
1248
1249 --
1250 -- For a few generic cache operations if not using Memcached
1251 --
1252 CREATE TABLE /*_*/objectcache (
1253 keyname varbinary(255) NOT NULL default '' PRIMARY KEY,
1254 value mediumblob,
1255 exptime datetime
1256 ) /*$wgDBTableOptions*/;
1257 CREATE INDEX /*i*/exptime ON /*_*/objectcache (exptime);
1258
1259
1260 --
1261 -- Cache of interwiki transclusion
1262 --
1263 CREATE TABLE /*_*/transcache (
1264 tc_url varbinary(255) NOT NULL,
1265 tc_contents text,
1266 tc_time binary(14) NOT NULL
1267 ) /*$wgDBTableOptions*/;
1268
1269 CREATE UNIQUE INDEX /*i*/tc_url_idx ON /*_*/transcache (tc_url);
1270
1271
1272 CREATE TABLE /*_*/logging (
1273 -- Log ID, for referring to this specific log entry, probably for deletion and such.
1274 log_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1275
1276 -- Symbolic keys for the general log type and the action type
1277 -- within the log. The output format will be controlled by the
1278 -- action field, but only the type controls categorization.
1279 log_type varbinary(32) NOT NULL default '',
1280 log_action varbinary(32) NOT NULL default '',
1281
1282 -- Timestamp. Duh.
1283 log_timestamp binary(14) NOT NULL default '19700101000000',
1284
1285 -- The user who performed this action; key to user_id
1286 log_user int unsigned NOT NULL default 0,
1287
1288 -- Name of the user who performed this action
1289 log_user_text varchar(255) binary NOT NULL default '',
1290
1291 -- Key to the page affected. Where a user is the target,
1292 -- this will point to the user page.
1293 log_namespace int NOT NULL default 0,
1294 log_title varchar(255) binary NOT NULL default '',
1295 log_page int unsigned NULL,
1296
1297 -- Freeform text. Interpreted as edit history comments.
1298 log_comment varbinary(767) NOT NULL default '',
1299
1300 -- miscellaneous parameters:
1301 -- LF separated list (old system) or serialized PHP array (new system)
1302 log_params blob NOT NULL,
1303
1304 -- rev_deleted for logs
1305 log_deleted tinyint unsigned NOT NULL default 0
1306 ) /*$wgDBTableOptions*/;
1307
1308 CREATE INDEX /*i*/type_time ON /*_*/logging (log_type, log_timestamp);
1309 CREATE INDEX /*i*/user_time ON /*_*/logging (log_user, log_timestamp);
1310 CREATE INDEX /*i*/page_time ON /*_*/logging (log_namespace, log_title, log_timestamp);
1311 CREATE INDEX /*i*/times ON /*_*/logging (log_timestamp);
1312 CREATE INDEX /*i*/log_user_type_time ON /*_*/logging (log_user, log_type, log_timestamp);
1313 CREATE INDEX /*i*/log_page_id_time ON /*_*/logging (log_page,log_timestamp);
1314 CREATE INDEX /*i*/type_action ON /*_*/logging (log_type, log_action, log_timestamp);
1315 CREATE INDEX /*i*/log_user_text_type_time ON /*_*/logging (log_user_text, log_type, log_timestamp);
1316 CREATE INDEX /*i*/log_user_text_time ON /*_*/logging (log_user_text, log_timestamp);
1317
1318
1319 CREATE TABLE /*_*/log_search (
1320 -- The type of ID (rev ID, log ID, rev timestamp, username)
1321 ls_field varbinary(32) NOT NULL,
1322 -- The value of the ID
1323 ls_value varchar(255) NOT NULL,
1324 -- Key to log_id
1325 ls_log_id int unsigned NOT NULL default 0
1326 ) /*$wgDBTableOptions*/;
1327 CREATE UNIQUE INDEX /*i*/ls_field_val ON /*_*/log_search (ls_field,ls_value,ls_log_id);
1328 CREATE INDEX /*i*/ls_log_id ON /*_*/log_search (ls_log_id);
1329
1330
1331 -- Jobs performed by parallel apache threads or a command-line daemon
1332 CREATE TABLE /*_*/job (
1333 job_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1334
1335 -- Command name
1336 -- Limited to 60 to prevent key length overflow
1337 job_cmd varbinary(60) NOT NULL default '',
1338
1339 -- Namespace and title to act on
1340 -- Should be 0 and '' if the command does not operate on a title
1341 job_namespace int NOT NULL,
1342 job_title varchar(255) binary NOT NULL,
1343
1344 -- Timestamp of when the job was inserted
1345 -- NULL for jobs added before addition of the timestamp
1346 job_timestamp varbinary(14) NULL default NULL,
1347
1348 -- Any other parameters to the command
1349 -- Stored as a PHP serialized array, or an empty string if there are no parameters
1350 job_params blob NOT NULL,
1351
1352 -- Random, non-unique, number used for job acquisition (for lock concurrency)
1353 job_random integer unsigned NOT NULL default 0,
1354
1355 -- The number of times this job has been locked
1356 job_attempts integer unsigned NOT NULL default 0,
1357
1358 -- Field that conveys process locks on rows via process UUIDs
1359 job_token varbinary(32) NOT NULL default '',
1360
1361 -- Timestamp when the job was locked
1362 job_token_timestamp varbinary(14) NULL default NULL,
1363
1364 -- Base 36 SHA1 of the job parameters relevant to detecting duplicates
1365 job_sha1 varbinary(32) NOT NULL default ''
1366 ) /*$wgDBTableOptions*/;
1367
1368 CREATE INDEX /*i*/job_sha1 ON /*_*/job (job_sha1);
1369 CREATE INDEX /*i*/job_cmd_token ON /*_*/job (job_cmd,job_token,job_random);
1370 CREATE INDEX /*i*/job_cmd_token_id ON /*_*/job (job_cmd,job_token,job_id);
1371 CREATE INDEX /*i*/job_cmd ON /*_*/job (job_cmd, job_namespace, job_title, job_params(128));
1372 CREATE INDEX /*i*/job_timestamp ON /*_*/job (job_timestamp);
1373
1374
1375 -- Details of updates to cached special pages
1376 CREATE TABLE /*_*/querycache_info (
1377 -- Special page name
1378 -- Corresponds to a qc_type value
1379 qci_type varbinary(32) NOT NULL default '',
1380
1381 -- Timestamp of last update
1382 qci_timestamp binary(14) NOT NULL default '19700101000000'
1383 ) /*$wgDBTableOptions*/;
1384
1385 CREATE UNIQUE INDEX /*i*/qci_type ON /*_*/querycache_info (qci_type);
1386
1387
1388 -- For each redirect, this table contains exactly one row defining its target
1389 CREATE TABLE /*_*/redirect (
1390 -- Key to the page_id of the redirect page
1391 rd_from int unsigned NOT NULL default 0 PRIMARY KEY,
1392
1393 -- Key to page_namespace/page_title of the target page.
1394 -- The target page may or may not exist, and due to renames
1395 -- and deletions may refer to different page records as time
1396 -- goes by.
1397 rd_namespace int NOT NULL default 0,
1398 rd_title varchar(255) binary NOT NULL default '',
1399 rd_interwiki varchar(32) default NULL,
1400 rd_fragment varchar(255) binary default NULL
1401 ) /*$wgDBTableOptions*/;
1402
1403 CREATE INDEX /*i*/rd_ns_title ON /*_*/redirect (rd_namespace,rd_title,rd_from);
1404
1405
1406 -- Used for caching expensive grouped queries that need two links (for example double-redirects)
1407 CREATE TABLE /*_*/querycachetwo (
1408 -- A key name, generally the base name of of the special page.
1409 qcc_type varbinary(32) NOT NULL,
1410
1411 -- Some sort of stored value. Sizes, counts...
1412 qcc_value int unsigned NOT NULL default 0,
1413
1414 -- Target namespace+title
1415 qcc_namespace int NOT NULL default 0,
1416 qcc_title varchar(255) binary NOT NULL default '',
1417
1418 -- Target namespace+title2
1419 qcc_namespacetwo int NOT NULL default 0,
1420 qcc_titletwo varchar(255) binary NOT NULL default ''
1421 ) /*$wgDBTableOptions*/;
1422
1423 CREATE INDEX /*i*/qcc_type ON /*_*/querycachetwo (qcc_type,qcc_value);
1424 CREATE INDEX /*i*/qcc_title ON /*_*/querycachetwo (qcc_type,qcc_namespace,qcc_title);
1425 CREATE INDEX /*i*/qcc_titletwo ON /*_*/querycachetwo (qcc_type,qcc_namespacetwo,qcc_titletwo);
1426
1427
1428 -- Used for storing page restrictions (i.e. protection levels)
1429 CREATE TABLE /*_*/page_restrictions (
1430 -- Field for an ID for this restrictions row (sort-key for Special:ProtectedPages)
1431 pr_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1432 -- Page to apply restrictions to (Foreign Key to page).
1433 pr_page int NOT NULL,
1434 -- The protection type (edit, move, etc)
1435 pr_type varbinary(60) NOT NULL,
1436 -- The protection level (Sysop, autoconfirmed, etc)
1437 pr_level varbinary(60) NOT NULL,
1438 -- Whether or not to cascade the protection down to pages transcluded.
1439 pr_cascade tinyint NOT NULL,
1440 -- Field for future support of per-user restriction.
1441 pr_user int NULL,
1442 -- Field for time-limited protection.
1443 pr_expiry varbinary(14) NULL
1444 ) /*$wgDBTableOptions*/;
1445
1446 CREATE UNIQUE INDEX /*i*/pr_pagetype ON /*_*/page_restrictions (pr_page,pr_type);
1447 CREATE INDEX /*i*/pr_typelevel ON /*_*/page_restrictions (pr_type,pr_level);
1448 CREATE INDEX /*i*/pr_level ON /*_*/page_restrictions (pr_level);
1449 CREATE INDEX /*i*/pr_cascade ON /*_*/page_restrictions (pr_cascade);
1450
1451
1452 -- Protected titles - nonexistent pages that have been protected
1453 CREATE TABLE /*_*/protected_titles (
1454 pt_namespace int NOT NULL,
1455 pt_title varchar(255) binary NOT NULL,
1456 pt_user int unsigned NOT NULL,
1457 pt_reason varbinary(767),
1458 pt_timestamp binary(14) NOT NULL,
1459 pt_expiry varbinary(14) NOT NULL default '',
1460 pt_create_perm varbinary(60) NOT NULL
1461 ) /*$wgDBTableOptions*/;
1462
1463 CREATE UNIQUE INDEX /*i*/pt_namespace_title ON /*_*/protected_titles (pt_namespace,pt_title);
1464 CREATE INDEX /*i*/pt_timestamp ON /*_*/protected_titles (pt_timestamp);
1465
1466
1467 -- Name/value pairs indexed by page_id
1468 CREATE TABLE /*_*/page_props (
1469 pp_page int NOT NULL,
1470 pp_propname varbinary(60) NOT NULL,
1471 pp_value blob NOT NULL,
1472 pp_sortkey float DEFAULT NULL
1473 ) /*$wgDBTableOptions*/;
1474
1475 CREATE UNIQUE INDEX /*i*/pp_page_propname ON /*_*/page_props (pp_page,pp_propname);
1476 CREATE UNIQUE INDEX /*i*/pp_propname_page ON /*_*/page_props (pp_propname,pp_page);
1477 CREATE UNIQUE INDEX /*i*/pp_propname_sortkey_page ON /*_*/page_props (pp_propname,pp_sortkey,pp_page);
1478
1479 -- A table to log updates, one text key row per update.
1480 CREATE TABLE /*_*/updatelog (
1481 ul_key varchar(255) NOT NULL PRIMARY KEY,
1482 ul_value blob
1483 ) /*$wgDBTableOptions*/;
1484
1485
1486 -- A table to track tags for revisions, logs and recent changes.
1487 CREATE TABLE /*_*/change_tag (
1488 ct_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1489 -- RCID for the change
1490 ct_rc_id int NULL,
1491 -- LOGID for the change
1492 ct_log_id int NULL,
1493 -- REVID for the change
1494 ct_rev_id int NULL,
1495 -- Tag applied
1496 ct_tag varchar(255) NOT NULL,
1497 -- Parameters for the tag, presently unused
1498 ct_params blob NULL
1499 ) /*$wgDBTableOptions*/;
1500
1501 CREATE UNIQUE INDEX /*i*/change_tag_rc_tag ON /*_*/change_tag (ct_rc_id,ct_tag);
1502 CREATE UNIQUE INDEX /*i*/change_tag_log_tag ON /*_*/change_tag (ct_log_id,ct_tag);
1503 CREATE UNIQUE INDEX /*i*/change_tag_rev_tag ON /*_*/change_tag (ct_rev_id,ct_tag);
1504 -- Covering index, so we can pull all the info only out of the index.
1505 CREATE INDEX /*i*/change_tag_tag_id ON /*_*/change_tag (ct_tag,ct_rc_id,ct_rev_id,ct_log_id);
1506
1507
1508 -- Rollup table to pull a LIST of tags simply without ugly GROUP_CONCAT
1509 -- that only works on MySQL 4.1+
1510 CREATE TABLE /*_*/tag_summary (
1511 ts_id int unsigned NOT NULL PRIMARY KEY AUTO_INCREMENT,
1512 -- RCID for the change
1513 ts_rc_id int NULL,
1514 -- LOGID for the change
1515 ts_log_id int NULL,
1516 -- REVID for the change
1517 ts_rev_id int NULL,
1518 -- Comma-separated list of tags
1519 ts_tags blob NOT NULL
1520 ) /*$wgDBTableOptions*/;
1521
1522 CREATE UNIQUE INDEX /*i*/tag_summary_rc_id ON /*_*/tag_summary (ts_rc_id);
1523 CREATE UNIQUE INDEX /*i*/tag_summary_log_id ON /*_*/tag_summary (ts_log_id);
1524 CREATE UNIQUE INDEX /*i*/tag_summary_rev_id ON /*_*/tag_summary (ts_rev_id);
1525
1526
1527 CREATE TABLE /*_*/valid_tag (
1528 vt_tag varchar(255) NOT NULL PRIMARY KEY
1529 ) /*$wgDBTableOptions*/;
1530
1531 -- Table for storing localisation data
1532 CREATE TABLE /*_*/l10n_cache (
1533 -- Language code
1534 lc_lang varbinary(32) NOT NULL,
1535 -- Cache key
1536 lc_key varchar(255) NOT NULL,
1537 -- Value
1538 lc_value mediumblob NOT NULL
1539 ) /*$wgDBTableOptions*/;
1540 CREATE INDEX /*i*/lc_lang_key ON /*_*/l10n_cache (lc_lang, lc_key);
1541
1542 -- Table caching which local files a module depends on that aren't
1543 -- registered directly, used for fast retrieval of file dependency.
1544 -- Currently only used for tracking images that CSS depends on
1545 CREATE TABLE /*_*/module_deps (
1546 -- Module name
1547 md_module varbinary(255) NOT NULL,
1548 -- Module context vary (includes skin and language; called "md_skin" for legacy reasons)
1549 md_skin varbinary(32) NOT NULL,
1550 -- JSON blob with file dependencies
1551 md_deps mediumblob NOT NULL
1552 ) /*$wgDBTableOptions*/;
1553 CREATE UNIQUE INDEX /*i*/md_module_skin ON /*_*/module_deps (md_module, md_skin);
1554
1555 -- Holds all the sites known to the wiki.
1556 CREATE TABLE /*_*/sites (
1557 -- Numeric id of the site
1558 site_id INT UNSIGNED NOT NULL PRIMARY KEY AUTO_INCREMENT,
1559
1560 -- Global identifier for the site, ie 'enwiktionary'
1561 site_global_key varbinary(32) NOT NULL,
1562
1563 -- Type of the site, ie 'mediawiki'
1564 site_type varbinary(32) NOT NULL,
1565
1566 -- Group of the site, ie 'wikipedia'
1567 site_group varbinary(32) NOT NULL,
1568
1569 -- Source of the site data, ie 'local', 'wikidata', 'my-magical-repo'
1570 site_source varbinary(32) NOT NULL,
1571
1572 -- Language code of the sites primary language.
1573 site_language varbinary(32) NOT NULL,
1574
1575 -- Protocol of the site, ie 'http://', 'irc://', '//'
1576 -- This field is an index for lookups and is build from type specific data in site_data.
1577 site_protocol varbinary(32) NOT NULL,
1578
1579 -- Domain of the site in reverse order, ie 'org.mediawiki.www.'
1580 -- This field is an index for lookups and is build from type specific data in site_data.
1581 site_domain VARCHAR(255) NOT NULL,
1582
1583 -- Type dependent site data.
1584 site_data BLOB NOT NULL,
1585
1586 -- If site.tld/path/key:pageTitle should forward users to the page on
1587 -- the actual site, where "key" is the local identifier.
1588 site_forward bool NOT NULL,
1589
1590 -- Type dependent site config.
1591 -- For instance if template transclusion should be allowed if it's a MediaWiki.
1592 site_config BLOB NOT NULL
1593 ) /*$wgDBTableOptions*/;
1594
1595 CREATE UNIQUE INDEX /*i*/sites_global_key ON /*_*/sites (site_global_key);
1596 CREATE INDEX /*i*/sites_type ON /*_*/sites (site_type);
1597 CREATE INDEX /*i*/sites_group ON /*_*/sites (site_group);
1598 CREATE INDEX /*i*/sites_source ON /*_*/sites (site_source);
1599 CREATE INDEX /*i*/sites_language ON /*_*/sites (site_language);
1600 CREATE INDEX /*i*/sites_protocol ON /*_*/sites (site_protocol);
1601 CREATE INDEX /*i*/sites_domain ON /*_*/sites (site_domain);
1602 CREATE INDEX /*i*/sites_forward ON /*_*/sites (site_forward);
1603
1604 -- Links local site identifiers to their corresponding site.
1605 CREATE TABLE /*_*/site_identifiers (
1606 -- Key on site.site_id
1607 si_site INT UNSIGNED NOT NULL,
1608
1609 -- local key type, ie 'interwiki' or 'langlink'
1610 si_type varbinary(32) NOT NULL,
1611
1612 -- local key value, ie 'en' or 'wiktionary'
1613 si_key varbinary(32) NOT NULL
1614 ) /*$wgDBTableOptions*/;
1615
1616 CREATE UNIQUE INDEX /*i*/site_ids_type ON /*_*/site_identifiers (si_type, si_key);
1617 CREATE INDEX /*i*/site_ids_site ON /*_*/site_identifiers (si_site);
1618 CREATE INDEX /*i*/site_ids_key ON /*_*/site_identifiers (si_key);
1619
1620 -- vim: sw=2 sts=2 et