Manual:Revision table/fr

La table revision contient les métadonnées de chaque modification apportée aux pages du wiki. Chacune des modifications de page crée une ligne de version, qui contient des informations telles que l'utilisateur ayant modifié, l'heure à laquelle la modification a été faite, et une référence vers le nouveau texte wiki de la table.

Notez qu'une ligne concerne partiellement l'opération de modification et le résultat de cette opération, c'est à dire le nouveau texte wiki. Elle ne donne pas de référence directe à l'ancien texte wiki.

Importer la dernière version d'une page d'un autre wiki génère deux entrées dans la table revision, l'une avec la date et le texte wiki de la version importée, et l'autre avec la date de l'import. Le texte wiki de cette dernière (qui devient celui de la page actuelle) est - lorsqu'une page avec le même nom existe déjà - celui de la page la plus récente des deux.

La table revision est très similaire à la table. La table revision est utilisée pour les pages du listing de l'historique et celui des. La table est utilisée pour les, les , les , et, dans le cas de création de page, pour la.

Différences :


 * la table recentchanges enregistre aussi les événements du journal tels que les déplacements de pages et les suppressions.
 * les éléments de la table recentchanges sont purgés périodiquement; ceux de la table revision restent en permanence, sauf si la page est supprimée ou que le propriétaire du site exécute le script de maintenance.
 * comme dit précédemment, l'import de la révision d'une page n'ajoute pas simplement une entrée à la table revision avec la date de l'import, mais aussi une autre avec la date d'origine.

Les versions supprimées sont déplacées vers la table.

La table des versions et la table text ont été introduites dans pour remplacer la table.

rev_id
Ce champ comporte la clé primaire de chaque révision. est une clé étrangère pour ce champ. Les rev_id nombre sont protégés contre la supression/restauration depuis les débuts de la table dans MediaWiki 1.5, lorsque rev_id et text_id ont remplacé l'ancien cur_id.

rev_page
Ce champ comporte une référence vers la à laquelle cette révision appartient. Le numéro dans ce champ est égal au champ de la page nommée. Ceci ne doit jamais être non valide; si c'est le cas, cette révision n'apparaîtra pas dans la page de l'historique. Si pointe sur une revision avec un rev_page non valide, cela provoquera l'erreur "La révision numéro 0 de la page nommée 'Foo' n'existe pas".

rev_text_id
Ceci est une clé étrangère pour dans la table. (la table text est l'endroit où est stocké l'ensemble du texte actuel). Il est possible que des révisions aient le même texte. C'est le cas des révisions pour lesquelles seulement les métadonnées ont été modifiées, ou celles pour lesquelles un a été effectué sur une précédente version.

S'il existe des rangées dans la table avec  = rev_id, ce champ doit être ignoré (et peut être à 0) en faveur des données correspondantes des positions et des tables de contenu.

rev_comment
Ce champ contient un résumé des modifications de l'éditeur (commentaire du contributeur sur la révision). Ce texte est affiché dans l'historique et les contributions. (La contient une copie utilisée pour les, les , les , et dans le cas des créations de page, pour la .) Il est rendu dans un sous-ensemble épuré de balises wiki.

des tables revision_comment_temp et doit être utilisé à la place !

rev_comment_id
Ce champ comprend une référence vers la ligne où se trouvent les commentaires de l'éditeur.

rev_user
Ceci est égal au de l'utilisateur qui a fait cette modification. La valeur de ce champ est de 0 pour les utilisateurs anonymes, les scripts d'initialisation, et pour certaines importations de masse.

Notez, il y a des bogues : T112384.

rev_user_text
Ce champ contient le texte du de l'éditeur, ou l'adresse IP de l'éditeur si la révision a été faite par un utilisatuer non enregistré.

Dans les révisions importées de UseModWiki ou les incarnations plus anciennes du logiciel de la phase II, ce champ peut contenir une adresse IP dont le dernier octet est grisé (par exemple  qui devient 24.150.61.xxx; voir bug 3631). Certaines modifications importées de UseModWiki peuvent contenir un nom d'hôte de recherche DNS inversée comme   or.

rev_timestamp
Contient le de l'édition.

rev_minor_edit
Enregistre le fait que l'utilisateur a coché l'élément 'édition mineure'. Si la valeur de ce champ est 1, alors la modification a été déclarée 'mineure'; sinon il est à 0. Beaucoup de modifications automatiques sont marquées comme mineures.

rev_deleted
Ce champ est réservé pour le système. C'est un champ de bits qui peut prendre les valeurs suivantes : DELETED_TEXT = 1; DELETED_COMMENT = 2; DELETED_USER = 4; and DELETED_RESTRICTED = 8. Donc si par exemple rien n'a été supprimé de cette version, alors la valeur est 0; si à la fois le commentaire et l'utilisateur ont été supprimés, la valeur est 6.

rev_len
Ce champ contient la longueur de l'article après la révision, en octets. Utilisé dans les pages de l'historique. Correspond à.

rev_parent_id
Le rev_id de la version précédente de la page. Correspond à.

For edits which are new page creations, rev_parent_id = 0.

Utilisation
Ce champ est utilisé pour ajouter la prise en charge d'une structure arborescente. Ce champ est par exemple utilisé pour calculer la différence de taille d'une certaine révision et la révision précédente dans la vue de la page historique. Si l'ID d'un parent pointe vers une révision qui est associée à une page différente, MediaWiki continue d'utiliser la révision parente comme base de comparaison pour le calcul de la différence de taille. If a revision is deleted from the database, and another revision's parent ID still points to it, then MediaWiki will behave the same as if there were no parent revision; i.e. it will assume the previous size was 0.

Versions transférées
When revisions are imported from another wiki, the imported revisions' parent ID tree structure from the source wiki is retained (this is implemented by each revision's, other than the tail revision, having a XML element that is used to populate rev_parent_id), and the destination wiki's revisions' parent IDs are not updated. Likewise, when page histories are merged, the parent IDs of the revisions from the source and destination pages are not updated. peut être utilisé pour populer rev_parent_id en se basant sur l'heure de la révision et son ID. In the case of an edit conflict, the revision ID of the edit that is saved first (causing the conflict) will be used as the parent ID of the edit that is saved second (after resolving the conflict).

rev_sha1
Ce champ est utilisé pour ajouter le contenu texte du hachage du SHA-1 en base 36 (généré par by ).

rev_content_model
Modèle de contentu, voir les constantes CONTENT_MODEL_XXX dans. Ces ID seront exposés dans l'API et les vidages XML. Extensions that define their own content model IDs should take care to avoid conflicts. Using the extension name as a prefix is recommended, for example 'myextension-somecontent'. Les valeurs possibles sont par exemple : 'wikitext', 'javascript', 'css', 'text', and 'json'

If rows in the slots table with slot_revision_id = rev_id this field should be ignored (and may be NULL) in favor of the corresponding data from the slots and content tables.

rev_content_format
Format du contenu, voir les constantes CONTENT_FORMAT_XXX dans. Ceux-ci doivent être des types de MIME, et seront présentés dans l'API et les vidages XML. Les extensions sont libres d'utiliser les formats ci-dessous, ou de définir les leurs propres. It is recommended to stick with the conventions for MIME types. Les valeurs possibles sont par exemple : 'text/x-wiki', 'text/javascript', 'text/css', 'text/plain', 'text/html', 'application/vnd.php.serialized', 'application/json', 'application/xml'

If rows in the slots table with slot_revision_id = rev_id exist, this field should be ignored (and may be NULL).

Résumé du schéma
DESCRIBE revision; ++-+--+-+++ ++-+--+-+++ ++-+--+-+++
 * Field             | Type                | Null | Key | Default        | Extra          |
 * rev_id            | int(10) unsigned    | NO   | PRI | NULL           | auto_increment |
 * rev_page          | int(10) unsigned    | NO   | MUL | NULL           |                |
 * rev_text_id       | int(10) unsigned    | NO   |     | 0              |                |
 * rev_comment       | varbinary(767)      | NO   |     |                |                |
 * rev_user          | int(10) unsigned    | NO   | MUL | 0              |                |
 * rev_user_text     | varbinary(255)      | NO   | MUL |                |                |
 * rev_timestamp     | binary(14)          | NO   | MUL |                |                |
 * rev_minor_edit    | tinyint(3) unsigned | NO   |     | 0              |                |
 * rev_deleted       | tinyint(3) unsigned | NO   |     | 0              |                |
 * rev_len           | int(10) unsigned    | YES  |     | NULL           |                |
 * rev_parent_id     | int(10) unsigned    | YES  |     | NULL           |                |
 * rev_sha1          | varbinary(32)       | NO   |     |                |                |
 * rev_content_model | varbinary(32)       | YES  |     | NULL           |                |
 * rev_content_format | varbinary(64)      | YES  |     | NULL           |                |

DESCRIBE revision; ++-+--+-+++ ++-+--+-+++ ++-+--+-+++
 * Field             | Type                | Null | Key | Default        | Extra          |
 * rev_id            | int(10) unsigned    | NO   | PRI | NULL           | auto_increment |
 * rev_page          | int(10) unsigned    | NO   | MUL | NULL           |                |
 * rev_text_id       | int(10) unsigned    | NO   |     | NULL           |                |
 * rev_comment       | varbinary(767)      | NO   |     |                |                |
 * rev_user          | int(10) unsigned    | NO   | MUL | 0              |                |
 * rev_user_text     | varbinary(255)      | NO   | MUL |                |                |
 * rev_timestamp     | binary(14)          | NO   | MUL |                |                |
 * rev_minor_edit    | tinyint(3) unsigned | NO   |     | 0              |                |
 * rev_deleted       | tinyint(3) unsigned | NO   |     | 0              |                |
 * rev_len           | int(10) unsigned    | YES  |     | NULL           |                |
 * rev_parent_id     | int(10) unsigned    | YES  |     | NULL           |                |
 * rev_sha1          | varbinary(32)       | NO   |     |                |                |
 * rev_content_model | varbinary(32)       | YES  |     | NULL           |                |
 * rev_content_format | varbinary(64)      | YES  |     | NULL           |                |

DESCRIBE revision; ++-+--+-+++ ++-+--+-+++ ++-+--+-+++
 * Field             | Type                | Null | Key | Default        | Extra          |
 * rev_id            | int(10) unsigned    | NO   | PRI | NULL           | auto_increment |
 * rev_page          | int(10) unsigned    | NO   | MUL | NULL           |                |
 * rev_text_id       | int(10) unsigned    | NO   |     | NULL           |                |
 * rev_comment       | varbinary(767)      | NO   |     | NULL           |                |
 * rev_user          | int(10) unsigned    | NO   | MUL | 0              |                |
 * rev_user_text     | varbinary(255)      | NO   | MUL |                |                |
 * rev_timestamp     | binary(14)          | NO   | MUL |                |                |
 * rev_minor_edit    | tinyint(3) unsigned | NO   |     | 0              |                |
 * rev_deleted       | tinyint(3) unsigned | NO   |     | 0              |                |
 * rev_len           | int(10) unsigned    | YES  |     | NULL           |                |
 * rev_parent_id     | int(10) unsigned    | YES  |     | NULL           |                |
 * rev_sha1          | varbinary(32)       | NO   |     |                |                |
 * rev_content_model | varbinary(32)       | YES  |     | NULL           |                |
 * rev_content_format | varbinary(64)      | YES  |     | NULL           |                |

DESCRIBE revision; ++-+--+-+-++ ++-+--+-+-++ ++-+--+-+-++
 * Field             | Type                | Null | Key | Default | Extra          |
 * rev_id            | int(10) unsigned    | NO   | PRI | NULL    | AUTO_INCREMENT |
 * rev_page          | int(10) unsigned    | NO   | PRI | NULL    |                |
 * rev_text_id       | int(10) unsigned    | NO   |     | NULL    |                |
 * rev_comment       | tinyblob            | NO   |     | NULL    |                |
 * rev_user          | int(10) unsigned    | NO   | MUL | 0       |                |
 * rev_user_text     | varchar(255) binary | NO   | MUL | NULL    |                |
 * rev_timestamp     | binary(14)          | NO   | MUL | NULL    |                |
 * rev_minor_edit    | tinyint(3) unsigned | NO   |     | 0       |                |
 * rev_deleted       | tinyint(3) unsigned | NO   |     | 0       |                |
 * rev_len           | int(10) unsigned    | YES  |     | NULL    |                |
 * rev_parent_id     | int(10) unsigned    | YES  |     | NULL    |                |
 * rev_sha1          | varbinary(32)       | NO   |     | NULL    |                |
 * rev_content_model | varbinary(32)       | YES  |     | NULL    |                |
 * rev_content_format | varbinary(64)      | YES  |     | NULL    |                |

DESCRIBE revision; ++-+--+-+-++ ++-+--+-+-++ ++-+--+-+-++
 * Field         | Type                | Null | Key | Default | Extra          |
 * rev_id        | int(10) unsigned    | NO   | PRI | NULL    | AUTO_INCREMENT |
 * rev_page      | int(10) unsigned    | NO   | PRI | NULL    |                |
 * rev_text_id   | int(10) unsigned    | NO   |     | NULL    |                |
 * rev_comment   | tinyblob            | NO   |     | NULL    |                |
 * rev_user      | int(10) unsigned    | NO   | MUL | 0       |                |
 * rev_user_text | varchar(255) binary | NO   | MUL | NULL    |                |
 * rev_timestamp | binary(14)          | NO   | MUL | NULL    |                |
 * rev_minor_edit | tinyint(3) unsigned | NO  |     | 0       |                |
 * rev_deleted   | tinyint(3) unsigned | NO   |     | 0       |                |
 * rev_len       | int(10) unsigned    | YES  |     | NULL    |                |
 * rev_parent_id | int(10) unsigned    | YES  |     | NULL    |                |
 * rev_sha1      | varbinary(32)       | NO   |     | NULL    |                |

DESCRIBE revision; ++-+--+-+-++ ++-+--+-+-++ ++-+--+-+-++
 * Field         | Type                | Null | Key | Default | Extra          |
 * rev_id        | int(10) unsigned    | NO   | PRI | NULL    | AUTO_INCREMENT |
 * rev_page      | int(10) unsigned    | NO   | PRI | NULL    |                |
 * rev_text_id   | int(10) unsigned    | NO   |     | NULL    |                |
 * rev_comment   | tinyblob            | NO   |     | NULL    |                |
 * rev_user      | int(10) unsigned    | NO   | MUL | 0       |                |
 * rev_user_text | varchar(255) binary | NO   | MUL | NULL    |                |
 * rev_timestamp | binary(14)          | NO   | MUL | NULL    |                |
 * rev_minor_edit | tinyint(3) unsigned | NO  |     | 0       |                |
 * rev_deleted   | tinyint(3) unsigned | NO   |     | 0       |                |
 * rev_len       | int(10) unsigned    | YES  |     | NULL    |                |
 * rev_parent_id | int(10) unsigned    | YES  |     | NULL    |                |

DESCRIBE revision; ++-+--+-+-++ ++-+--+-+-++ ++-+--+-+-++
 * Field         | Type                | Null | Key | Default | Extra          |
 * rev_id        | int(8) unsigned     | NO   | PRI | NULL    | AUTO_INCREMENT |
 * rev_page      | int(8) unsigned     | NO   | PRI | NULL    |                |
 * rev_text_id   | int(8) unsigned     | NO   |     | NULL    |                |
 * rev_comment   | tinyblob            | NO   |     | NULL    |                |
 * rev_user      | int(5) unsigned     | NO   | MUL | 0       |                |
 * rev_user_text | varchar(255) binary | NO   | MUL | NULL    |                |
 * rev_timestamp | char(14) binary     | NO   | MUL | NULL    |                |
 * rev_minor_edit | tinyint(1) unsigned | NO  |     | 0       |                |
 * rev_deleted   | tinyint(1) unsigned | NO   |     | 0       |                |

Les index
SHOW INDEX IN revision; <pre style="width: 170%"> +--++-+--+---+---+-+--++--++-+---+ +--++-+--+---+---+-+--++--++-+---+ +--++-+--+---+---+-+--++--++-+---+
 * Table   | Non_unique | Key_name            | Seq_in_index | Column_name   | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment |
 * revision |         0 | PRIMARY             |            1 | rev_id        | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         0 | rev_page_id         |            1 | rev_page      | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         0 | rev_page_id         |            2 | rev_id        | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | rev_timestamp       |            1 | rev_timestamp | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | page_timestamp      |            1 | rev_page      | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | page_timestamp      |            2 | rev_timestamp | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | user_timestamp      |            1 | rev_user      | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | user_timestamp      |            2 | rev_timestamp | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | usertext_timestamp  |            1 | rev_user_text | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | usertext_timestamp  |            2 | rev_timestamp | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | page_user_timestamp |            1 | rev_page      | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | page_user_timestamp |            2 | rev_user      | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |
 * revision |         1 | page_user_timestamp |            3 | rev_timestamp | A         |           1 |     NULL | NULL   |      | BTREE      |         |               |