From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Actor migration and the translation is 16% complete.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎polski • ‎हिन्दी • ‎日本語

Historically, MediaWiki has stored references to users (such as the author of a revision or an image) as an [<id>, <name>] pair, with [0, <IP address>] for anonymous edits. Esto era un desperdicio en espacio de almacenamiento, causaba problemas de rendimiento en las wikis con muchas revisiones, y dificultaba renombrar a los usuarios o introducir nuevos tipos de autores (como los T133452). En MediaWiki 1.31 se introduce el concepto de "actores" (alguien que realiza un acción, como editar o registrar un evento; actualmente esta usuario puede estar registrado o ser anónimo). Adicionalmente, un proceso de migración hacia un nuevo modelo para la base de datos,en donde los campos como revision.rev_user y revision.rev_user_text son remplazados con revision.rev_actor. Due to the huge size of the English Wikipedia revision table, which must be fully migrated before the changes can be cleaned up, the migration is being done gradually, over several MediaWiki releases. It is expected to finish in MediaWiki 1.34.

The migration will create an actor table record for every distinct *_user / *_user_text pair, and replace those pairs with a reference to the actor row ID. The following columns are being migrated:

Table Old columns New column
revision rev_user, rev_user_text rev_actor
archive ar_user, ar_user_text ar_actor
ipblocks ipb_by, ipb_by_text ipb_by_actor
image img_user, img_user_text img_actor
oldimage oi_user, oi_user_text oi_actor
filearchive fa_user, fa_user_text fa_actor
recentchanges rc_user, rc_user_text rc_actor
logging log_user, log_user_text log_actor

To avoid doing a costly ALTER TABLE on the extremely huge revision tables of large Wikipedia wikis, rev_user and rev_user_text are initially copied to the revision_actor_temp table and from there back to revision. The revision_actor_temp table will be dropped afterwards.

If you are a wiki owner, you probably don't need to do anything, the migration will happen automatically when you run update.php. If you want to control when the migration happens, see $wgActorTableSchemaMigrationStage and the migrateActors.php maintenance script.

If you are an extension developer, and your extension does direct DB access to some of the affected fields, you'll need to update your queries (and ideally use the getQueryInfo() methods, such as Revision::getQueryInfo(), instead of manually constructing your query). During the migration period, you can also use the ActorMigration class to get schema/field information that respects any $wgActorTableSchemaMigrationStage settings.

If you are a tool developer using Toolforge , there might be performance implications, even if you don't use any of the affected fields directly. See wikitech:News/Actor storage changes on the Wiki Replicas for additional information.