Database Configuration

データベース構成画面では、組み込みの HyperSQL サーバーを使用してデータベースを作成および構成したり、サポートされている外部のデータベースに接続したりできます。データベースのバックアップを作成および復元したり、既存のバックアップを別のタイプのデータベースに移行したりすることもできます。たとえば、HyperSQL のデータベースをバックアップし、Oracle または MySQL のデータベースとして再作成できます。あるいは、データベースの現在の状態をキャプチャし、後でロールバックに使用できます。サポート対象のデータベース バージョンおよび要件については「システム要件」を参照してください。

データベース設定画面を開くには、管理メニュー (歯車のアイコン) から [データベース設定] を選択します。

「CTP のインストールと実行」も参照してください。

データベース設定の構成

既存のデータベースへの接続

このプロセスは、現在の CTP を既存の CTP データベースに接続します。

1. [データベース設定] をクリックし、表示されたウィンドウで [既存の CTP データベースに接続] を選択します。
   
2. [次へ] をクリックし、データベースの種類を選択します。HyperSQL、MariaDB、MySQL、Oracle、または PostgreSQL。
   
   

3. データベースの URL とユーザー認証情報を入力します。

4. [接続のテスト] をクリックして情報が正しいことを確認します。
5. [保存して接続] をクリックし、データベースに接続します。

新規データベースの作成

このプロセスにより、新しい空の CTP データベースが作成されます。バックアップから新しい CTP データベースを作成する方法については、「バックアップからのデータベースの作成」を参照してください。

1. [データベース設定] をクリックし、表示されたウィンドウで [新規 CTP データベース、ユーザー、スキーマの作成] を選択します。
   
2. [次へ] をクリックし、データベースの種類を選択します。HyperSQL、MariaDB、MySQL、Oracle、または PostgreSQL。
   
   
3. データベースの URL とルート認証情報を入力します。
4. [接続のテスト] をクリックして情報が正しいことを確認します。
   

   MySQL データベースの場合、root ユーザーに GRANT OPTION 権限が必要です。

5. [次へ] をクリックします。
   
   

6. 新しいユーザーと認証情報を入力し、[データベースの作成] をクリックします。

既存のデータベースに対する CTP スキーマの作成

このプロセスでは、既存のユーザー認証情報を使用して既存のデータベースの CTP スキーマを作成します。バックアップから CTP スキーマを作成する方法については、「バックアップからのデータベースの作成」を参照してください。

1. [データベース設定] をクリックし、表示されたウィンドウで [CTP データベース スキーマの作成] を選択します。
   
2. [次へ] をクリックし、データベースの種類を選択します。HyperSQL、MariaDB、MySQL、Oracle、または PostgreSQL。
   
   
3. データベースの URL とユーザー認証情報を入力します。
4. [接続のテスト] をクリックして情報が正しいことを確認します。
5. [スキーマの作成] をクリックします。

データベースのバックアップ

データベースのバックアップの作成

CTP データベースをバックアップするには、[データベース構成] ページで [データベースのバックアップ] をクリックします。次に実行される処理は、データベースの種類によって異なります。

• データベースが HyperSQL、MariaDB、または MySQL の場合、バックアップはすぐに開始されます。

• データベースが Oracle の場合、データ テーブルスペース (表領域) を指定するダイアログが表示されます。テーブルスペースの名前を入力し、[バックアップの作成] をクリックすると、バックアップが開始されます。

• データベースが PostgreSQL の場合、スキーマを指定するダイアログが表示されます。スキーマの名前を入力し、[バックアップの作成] をクリックすると、バックアップが開始されます。

バックアップが完了したら、[ダウンロード] をクリックしてデバイスにダウンロードできます。

大きなファイルがあるデータベースのバックアップ (MySQL のみ)

MySQL データベースを使用していて、バックアップが失敗した場合、次の操作を行って、MySQL のサイズ制限値を大きくしてみてください。

1. MySQL の my.cnf/my.ini ファイルを探します。MySQL 8 の場合、https://dev.mysql.com/doc/refman/8.0/en/option-files.html を参照してください。その他のバージョンの場合、http://dev.mysql.com/doc/index.html から適切なマニュアルを参照してください。
2. ファイルを編集し、次のようにパラメーターを設定します。
3. MySQL サービスを再開します。 

[mysqld]

• innodb = ON
• innodb_log_file_size = 5242880000 // This must be set to be 10x the largest content being loaded for the public marketplace.
• max_allowed_packet = 1G
• innodb_file_per_table = 1
• innodb_file_format = Barracuda 

[mysql]

• max_allowed_packet = 1G 

[client]

• max_allowed_packet = 1G

バックアップからのデータベースの作成

バックアップから新しいデータベースを作成できます。このプロセスでは、新しいデータベースが作成され、バックアップされたデータベースのデータが入力されます。既存のデータベースを上書きしないでください。同じバージョンの CTP のデータベース バックアップを使用してください。異なるバージョンの CTP のバックアップを使用して新しいデータベースを作成しないでください。

1. [データベースの復元] をクリックします。
2. 以下のオプションのいずれかを選択し、説明に従ってデータベースとユーザー情報を入力します。
   • 新しい CTP データベース、ユーザー、およびスキーマの作成
     1. データベースの種類を選択します。HyperSQL、MariaDB、MySQL、Oracle、または PostgreSQL。
     2. データベースの URL とルート認証情報を入力します。
     3. [接続のテスト] をクリックして情報が正しいことを確認します。
        
     4. [次へ] をクリックします。
     5. 新しいユーザーと認証情報を入力し、[次へ] をクリックします。
   • CTP データベース スキーマの作成
     1. データベースの種類を選択します。HyperSQL、MariaDB、MySQL、Oracle、または PostgreSQL。
     2. データベースの URL とユーザー認証情報を入力します。
     3. [接続のテスト] をクリックして情報が正しいことを確認します。
     4. [次へ] をクリックします。
3. [参照] をクリックしてバックアップ ファイルを選択します。バックアップのアップロードが完了したら、[データベースの復元] をクリックします。

指定された場所に新しいデータベースが作成され、バックアップ ファイルに保存されたデータが入力されます。

データベースの移行

データベースの種類を別の種類（たとえば、HyperSQL から PostgreSQL）に移行できます。これは、基本的な 2 つの手順で行います。

1. 既存のデータベースのバックアップを作成します。「データベースのバックアップの作成」を参照してください。
2. バックアップを新しいデータベースの種類に復元します。「バックアップからのデータベースの作成」を参照してください。

この操作は、CTP の同じバージョン内でのみ実行してください。前述の HyperSQL から PostgreSQL への移行の例に倣い、HyperSQL データベースのバックアップは、PostgreSQL データベースと同じバージョンの CTP で作成する必要があります。以前のバージョンの CTP で HyperSQL データベースをバックアップし、その後 CTP をアップグレードして、そのバックアップを使用して PostgreSQL データベースを作成しようとすると、エラーが発生する可能性があります。

注意

• CTP には、MariaDB、MySQL、Oracle、または PostgreSQL 用の JDBC ドライバー ライブラリは付属していません。詳細については、インストール ガイドの「JDBC ドライバーに関する注意」を参照してください。