> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 移行

CData Sync はデフォルトでアプリケーションデータを格納するために組み込みのDerby データベースを使用します。このデータベースをMicrosoft SQL Server、MySQL、PostgreSQL などの外部データベースに移行できます。

外部データベースへの移行により、パフォーマンス、スケーラビリティ、およびエンタープライズデータベース標準との整合性が向上します。Sync は、環境を検証してターゲットデータベースにスキーマとデータをコピーする**アプリケーションデータベース移行**ツールをUI で提供しています。

移行には、アプリケーションスキーマとデータ（ジョブ、タスク、スケジュール、監査、リクエスト、履歴（システム制限の範囲内）を含む）が含まれます。データベースオブジェクトはSync のスキーマロジックを使用して作成され、データタイプはターゲットデータベースに基づいてマッピングされます。

データベース移行ツールは、次のシナリオで使用できます：

* デフォルトのDerby データベースから本番環境での使用のために外部データベースへの移行
* 既存のデータベースプラットフォームへの統一化
* 外部アプリケーションデータベースを必要とする環境または設定の準備

外部データベースへの移行後、元のDerby データベースは保持され、必要に応じてフォールバックとして使用できます。

> [!NOTE]
>
> Sync は自動的に新しいデータベースに切り替えません。詳細については、[新しいデータベースへの切り替え](#新しいデータベースへの切り替え)を参照してください。

## 前提条件

移行を開始する前に、環境が以下の要件を満たしていることを確認してください。移行プロセスはアプリケーションデータベースへの排他的アクセスが必要であり、これらの条件が満たされていない場合は実行がブロックされます。

* Sync への管理者アクセス権がある。
* ターゲットデータベースにアクセス可能で、スキーマ、テーブル、インデックスを作成する権限がある。
* すべてのジョブが停止されており、変更データキャプチャ（CDC）エンジンが実行されていない。
* 1つのノードのみが実行されている。移行を開始する前に、他のすべてのノードを停止する。

## データベースの移行

アプリケーションデータベースを移行するには：

1. Sync を開き、Sync ウィンドウの右上にある歯車アイコンをクリックして**システム設定**ページに移動します。

2. **移行**タブで、**アプリケーションデータベース移行**セクションを見つけます。

3. **アプリケーションデータベースを移行**をクリックします。以下に示すように、セーフモードを有効にするよう求められる場合があります：

   ![Safe mode prompt](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Migrating-the-Application-Database_migrating-the-database_1.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=37cd50da97cf8a0651ed98d24a35132d)

   ダイアログで**セーフモードに入る**をクリックすると、Sync はバックグラウンドプロセスを無効にし、すべてのスレッドが停止するまで待機します。Sync がセーフモードになると、確認メッセージとともに別のダイアログが表示されます。

   ![Safe mode confirmation](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Migrating-the-Application-Database_migrating-the-database_2.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=eede92be03070bee2625769107384028)

4. **データベースを選択**をクリックして、選択ダイアログを開きます。

5. **データベースを選択**タブで、データベースを選択します。

   ![Select Database tab](https://mintcdn.com/cdata-sync/kdVWT2jSQXwgtx6Q/26.4/images/Migrating-the-Application-Database_migrating-the-database_3.png?fit=max\&auto=format\&n=kdVWT2jSQXwgtx6Q\&q=85\&s=2f77430e62e08bbf30b74787d2b511e6)

6. 選択したサーバーの接続詳細を入力します。（各データベースによって接続詳細が若干異なることに注意してください。）

7. **接続テスト**をクリックします。接続テストが成功した場合は**次へ**をクリックします。接続テストが失敗した場合は、接続詳細を確認し、エラーを修正してから再試行します。

8. **移行**タブで**移行を開始**をクリックしてプロセスを開始します。移行が開始される前に、Sync はジョブやCDC エンジンが実行されていないこと、システムがセーフモードであることなど、すべての前提条件が満たされているかどうかを検証します。

   > [!NOTE]
   >
   > 検証が失敗した場合、Sync は続行する前に問題を解決する必要があることを示すメッセージを表示します。

   移行が完了するまで待ちます。移行の進行状況がUI に表示されます。

9. 移行が完了した後に提供される暗号化された接続文字列をコピーします。この接続文字列は、新しいデータベースへの切り替え方法を説明する次のセクションで使用する必要があります。

> [!NOTE]
>
> 移行が失敗した場合、Sync は変更をロールバックして元のDerby データベースを保持します。

## 新しいデータベースへの切り替え

移行が完了したら、次の手順で新しいデータベースに切り替えます：

1. sync.properties ファイルを開き、次のプロパティを設定します：

   ```
   cdata.app.db=<YourEncryptedConnectionString>
   ```

   > [!NOTE]
   >
   > 接続文字列などの暗号化された値についての詳細は、[サーバーの設定](https://docs.sync.cdata.com/26.4/ja/getting-started/installation-and-configuration/configuring-the-server.md#機密設定値の暗号化)を参照してください。
2. ファイルを保存して Sync を再起動します。

再起動後、Sync は外部データベースを使用します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.