- デフォルトのDerby データベースから本番環境での使用のために外部データベースへの移行
- 既存のデータベースプラットフォームへの統一化
- 外部アプリケーションデータベースを必要とする環境または設定の準備
は自動的に新しいデータベースに切り替えません。詳細については、新しいデータベースへの切り替えを参照してください。
前提条件
移行を開始する前に、環境が以下の要件を満たしていることを確認してください。移行プロセスはアプリケーションデータベースへの排他的アクセスが必要であり、これらの条件が満たされていない場合は実行がブロックされます。- への管理者アクセス権がある。
- ターゲットデータベースにアクセス可能で、スキーマ、テーブル、インデックスを作成する権限がある。
- すべてのジョブが停止されており、変更データキャプチャ（CDC）エンジンが実行されていない。
- 1つのノードのみが実行されている。移行を開始する前に、他のすべてのノードを停止する。
データベースの移行
アプリケーションデータベースを移行するには：- を開き、 ウィンドウの右上にある歯車アイコンをクリックして設定ページに移動します。
- 移行タブで、アプリケーションデータベース移行セクションを見つけます。
-
アプリケーションデータベースを移行をクリックします。以下に示すように、セーフモードを有効にするよう求められる場合があります：
- データベースを選択をクリックして、選択ダイアログボックスを開きます。
-
データベースを選択タブで、データベースを選択します。
- 選択したサーバーの接続詳細を入力します。（各データベースによって接続詳細が若干異なることに注意してください。）
- 接続テストをクリックします。接続テストが成功した場合は次へをクリックします。接続テストが失敗した場合は、接続詳細を確認し、エラーを修正してから再試行します。
-
移行タブで移行を開始をクリックしてプロセスを開始します。移行が開始される前に、 はジョブやCDC エンジンが実行されていないこと、システムがセーフモードであることなど、すべての前提条件が満たされているかどうかを検証します。
移行が完了するまで待ちます。移行の進行状況がUI に表示されます。検証が失敗した場合、 は続行する前に問題を解決する必要があることを示すメッセージを表示します。
- 移行が完了した後に提供される暗号化された接続文字列をコピーします。この接続文字列は、新しいデータベースへの切り替え方法を説明する次のセクションで使用する必要があります。
移行が失敗した場合、 は変更をロールバックして元のDerby データベースを保持します。
新しいデータベースへの切り替え
移行が完了したら、次の手順で新しいデータベースに切り替えます：-
sync.properties ファイルを開き、次のプロパティを設定します：
接続文字列などの暗号化された値についての詳細は、サーバーの設定を参照してください。
- ファイルを保存して を再起動します。
高可用性またはクラスタ環境でのデータベースの切り替え
が高可用性（HA）またはクラスタ環境にデプロイされている場合は、移行前に1つを除くすべてのノードを停止する必要があります。移行が完了したら、次のようにすべてのノードを更新する必要があります：- 各ノードのsync.properties ファイルを開きます。
-
cdata.app.dbプロパティを移行中に生成された暗号化された接続文字列に設定します。 - 各ノードで を再起動します。