Manual:Schema changes/ja

このページは開発作業の一部としてデータベースのレイアウトを変更する必要がある人々のために、MediaWiki コアとその拡張機能のためのスキーマ変更パッチを構築する方法を説明するヘルプ ページです.

用語集

 * スキーマ - MediaWiki の現在のデータベース レイアウト.
 * スキーマの変更 - スキーマ移行のアトミックな部分で、コミットによって追加されるもの. 例えば、「テーブル foo を追加」、「テーブル baz からカラム bar を削除」などです.
 * データベース管理システム (DBMS) - MediaWiki のデータベースを扱う基盤技術. MediaWiki コアでサポートされているものは以下の通りです: MySQL、SQLite、PostgreSQL.  拡張機能を使用するとより多くなる可能性があります.
 * データ定義言語 (DDL) - スキーマやスキーマ変更を定義する構文 (DBMS によって異なる場合がある). 例: 「ALTER TABLE」「DROP COLUMN」.  「.sql」ファイルとして保存されます.
 * データベース抽象レイヤー (DBAL) - DBMS に依存しないデータベース スキーマおよびスキーマ変更定義と実際の DDL との間の橋渡し.

概要
各スキーマの変更では、2 つの部分を処理する必要があります. 第一に、新しいインストレーションは古いスキーマではなく新しいスキーマを持つ必要があり、第二に、古いインストレーションは新しいスキーマにアップグレードできる必要があります. 最初のパートでは、スキーマ DDL ファイル (tables.sql という名前で保存) を修正し、2 番目のパートでは、「ALTER TABLE」パッチを提供し、それをアップデーターのロジックに配線します.

DBMS ごとに 1 つずつある専用 DDL を、1 つの抽象スキーマに移行している真っ最中です. テーブルによっては、複数の生の SQL ファイルを変更したり、1 つの json ファイルのみを変更し、メンテナンス スクリプトを使用して SQL ファイルを生成することがあります.



手動 (廃止予定)
2020年まで使用されるこの方式では、スキーマを変更する際に:


 * 1) 2 か所にある tables.sql を変更 (MySQL は maintenance/tables.sql、PostgreSQL は maintenance/postgres/tables.sql)
 * 2) MySQL の現行インストレーションのアップグレード パスとして、スキーマ変更 DDL ファイルを作成し、maintenance/archives/ に配置します
 * 3) * 他の種類の DBMS でそのパッチが動作しない場合は、専用のパッチを作成する必要があります. 例えば、SQLite には ALTER TABLE がありません. つまり、一時テーブルを作成してデータをコピーし、古いテーブルを削除して、新しいテーブルの名前を古い名前に変更する必要があるのです.  例
 * 4) これらの DDL ファイル (ステップ 2 より) を MysqlUpdater, SqliteUpdater, PostgresUpdater に配線します

例

 * カラムの削除 - 以前は 3 つではなく 5 つの DBMS をサポートしていたことにご注意ください
 * インデックスの変更
 * テーブルの新規作成



自動的な生成
MediaWiki コアのすべてのテーブルの抽象スキーマは「maintenance/tables.json」にあります. この抽象化では、Doctrine DBAL ライブラリを使用して DDL ファイルを生成しています.


 * 1) tables.json 構造を変更します.
 * 2) メンテナンス スクリプトを実行し、3 つの DDL ファイルを生成します:
 * 3) 抽象スキーマ変更の .json ファイル (下記を参照) を作成し、maintenance/abstractSchemaChanges/ ディレクトリに配置します
 * 4) メンテナンス スクリプトを使用してスキーマ パッチを構築します. 例:
 * 5) MysqlUpdater, SqliteUpdater, PostgresUpdater に追加します
 * 6) パッチを作成する際には、変更点と自動生成された DDL ファイルを git でチェックアウトすることを忘れないでください.



パッチの例

 * logging テーブルの 4 つのインデックス名を変更



注記

 * Doctrine DBAL の既定値は  です.  null 可能 (nullable) にしたい場合は、  で明示的に指定します.
 * Doctrine DBAL のカラム型の一覧はこちらにあります: https://github.com/doctrine/dbal/blob/3.3.x/src/Types/Types.php
 * Since MediaWiki 1.38, Doctrine DBAL types which are not listed in the following table are unavailable.



抽象スキーマの変更
スキーマの変更については、テーブルの抽象スキーマの変更前と変更後のスナップショットを json ファイルで作成します (1 テーブルにつき 1 つのスキーマ変更でお願いします). その後、同様の方法でメンテナンス スクリプトを実行すると、2 つのテーブル間の差分を取り、スキーマ変更用の DDL ファイルを自動生成します.



抽象スキーマの変更の例
2 つのテーブルは、「actor_user」の型が「integer」から「bigint」に変更されている点を除いて同じです. 変更自体を抽象化するのではなく差分を取る理由は、SQLite はほとんどの場合 ALTER TABLE を持っておらず、つまり DBAL は一時テーブルを使ってスキーマ変更 DDL ファイルを構築するためにスキーマを知る必要があるからです.

Best practices in choosing the data type

 * For timestamps, use mwtimestamp datatype (T42626).
 * Instead of VARCHAR or CHAR, use VARBINARY or BINARY (otherwise you have to deal with encodings in databases)
 * Unless you actually need the negative value, use UNSIGNED for any type of integer value to double its capacity.
 * Using ENUM is highly discouraged (T119173).