ソフトウェアエンジニアリング

マイグレーション（スキーマ変更）スクリプトを生成するRailsのスクリプト generate migrationを実行します。

まず、テーブル名termsをglossary_termsに変更するマイグレーションを作成します。Redmine専用スクリプトは用意されていないので、Redmine基点ディレクトリでRails汎用スクリプトで雛形を生成し、プラグインディレクトリへ移動・ファイル名変更します。

D:\work\redmine> 
bundle exec rails generate migration rename_glossary_terms_from_terms
      invoke  active_record
      create    db/migrate/20191019234944_rename_glossary_terms_from_terms.rb

D:\work\redmine> move db\migrate\20191019234944_rename_glossary_terms_from_terms.rb plugins\redmine_glossary\db\migrate\004_rename_glossary_terms_from_terms.rb

プラグインのdb\migrateディレクトリに、ファイル名先頭を日時から連番となるよう変更して移動します。
生成されたマイグレーションファイルの雛形は次です。

class RenameGlossaryTermsFromTerms < ActiveRecord::Migration[5.2]
  def change
  end
end

def changeの中に、マイグレーションメソッド（今回はrename_table）を実行するコードを記述します。

   def change
+    rename_table :terms, :glossary_terms
   end

changeメソッドで定義した変更はロールバックに対応することができます。

ついでに、カラムtech_en, name_cn, name_frを削除するマイグレーションを追記します。

   def change
+    remove_column :terms, :tech_en, :string
+    remove_column :terms, :name_cn, :string
+    remove_column :terms, :name_fr, :string
     rename_table :terms, :glossary_terms
   end

テーブル名変更とカラム削除とでマイグレーションファイルを分けるかどうか悩みましたが、あまり多数のマイグレーションファイルがあるのも煩雑なので、ここでは1つのマイグレーションファイルにまとめています。

マイグレーションの実行は次です。

D:\work\redmine> bundle exec rails redmine:plugins:migrate
== 4 RenameGlossaryTermsFromTerms: migrating ==================================
-- remove_column(:terms, :tech_en, :string)
   -> 0.0218s
-- remove_column(:terms, :name_cn, :string)
   -> 0.0116s
-- remove_column(:terms, :name_fr, :string)
   -> 0.0103s
-- rename_table(:terms, :glossary_terms)
   -> 0.0140s
== 4 RenameGlossaryTermsFromTerms: migrated (0.0606s) =========================

D:\work\redmine> 

マイグレーションの変更を戻す（ロールバック）確認をします。

D:\work\redmine> bundle exec rails redmine:plugins:migrate NAME=redmine_glossary VERSION=3
== 4 RenameGlossaryTermsFromTerms: reverting ==================================
-- rename_table(:glossary_terms, :terms)
   -> 0.0157s
-- add_column(:terms, :name_fr, :string)
   -> 0.0037s
-- add_column(:terms, :name_cn, :string)
   -> 0.0039s
-- add_column(:terms, :tech_en, :string)
   -> 0.0035s
== 4 RenameGlossaryTermsFromTerms: reverted (0.0488s) =========================
D:\work\redmine> 

マイグレーションファイル004の変更を戻す、すなわちマイグレーションファイル003までを適用したスキーマに戻すので、VERSION=3を指定します。

スキーマ変更は既存の再構築プロジェクト(#75)でも実現できる見込みがあるので、そちらで実施する。
そこで親チケットを変更した。

Redmine Glossaryプラグイン再構築 フェーズ21で本作業を実施した。
よって、本チケットはクローズする。