BellaDatiアプリケーションとPostgreSQLデータベースを接続するための手順を説明します。
データベースエンジンPostgreSQL 12の使用を推奨します。このデータベースエンジンは現在サポートされています。
PostgreSQL 12は、BellaDati 2.10リリースからサポートされています。
On this page:
PostgreSQLのデータベース作成と設定
TCPソケットでデータベースにアクセスできるようにpg_hba.confファイルを設定します。以下はその例です。
host belladati_db belladati_dbuser 0.0.0.0/0 md5
BellaDatiが接続するデータベースユーザー(例:belladati_dbuser)を作成します。このデータベースユーザー名は、以降のステップでBellaDatiのこのデータベースへの接続を設定するために使用されますので、覚えておいてください。データベースへのアクセスを制御するpg_hba.confファイルの設定も忘れずに行ってください。
$ createuser -SDRP belladati_dbuser
Unicode照合順序で(例えばbelladati_db)データ・ウェアハウスとしてBellaDatiが使用するためのデータベースを作成します。
CREATE DATABASE belladati_db WITH ENCODING 'UNICODE' TEMPLATE template0;
または以下のコマンドライン:
$ createdb -E UNICODE -O belladati_dbuser belladati_db -T template0
- ユーザーがデータベースに接続する権限を持って、データベース内のテーブルに作成する及び書き込めることを確認してください
PostgreSQL 10 以降では、ステップ 4 は省略可能です。
データベースがplpgsql言語を持っているかどうかを確認してください。ない場合は、このコマンドを使用して定義できます。
CREATE LANGUAGE plpgsql
または以下にコマンド行から
$ createlang -U belladati_dbuser plpgsql belladati_db
pg_hba.confファイル構成のPostgreSQLデフォルトを使用するときは、TCPソケット経由で接続することによりこのコマンドを実行する必要があります。createlang -h 127.0.0.1 -U
belladati_dbuser plpgsql belladati_db
データベース名を覚えておいてください。以降のデータベースへのBellaDatiの接続を設定するために使用されます。
PostgreSQL構成
私たちは次のように$POSTGRES_HOME/data/postgresql.confにPostgreSQL構成の変更を行うことを強くお勧めします。この例では、4GBのメモリを備えた単一のサーバー上でBellaDatiアプリケーションとデータベースを実行する時にパラメータを指定します。 2GB以上(-Xmxパラメータを使用)は、Java上で動作しているBellaDatiアプリケーション・サーバー用に指定します。残りは、オペレーティングシステム及びデータベース・サーバに利用可能であるべきです。
この構成は、実際の使用状況のニーズに応じて変更されることがあります。
次の例では、単一サーバーインストールの最小限の構成を示します。
名前 | 値 | 説明 | 備考 |
---|---|---|---|
max_connections | 50 | 同時接続の最大数を設定すること | |
shared_buffers | 512MB | サーバにより使用した共有メモリバッファの数を設定すること | min 1/4 RAM, 1/2 RAM recommended |
temp_buffers | 2MB | 各セッションが使用した一時バッファの最大数を設定すること。 | セッションごと |
work_mem | 16MB | クエリーワークスペースのために使用される最大メモリを設定すること。 | 16MB以上、RAM128推奨 |
maintenance_work_mem | 64MB | 保守作業のために使用される最大メモリを設定すること。 | 64MB以上、RAM32以上推奨 |
max_stack_depth | 2MB | 単位の最大スタックの深さを設定すること。 | |
wal_buffers | 512kB | WAL向けの共有したメモリにディスクページバッファの数を設定すること。 | |
effective_cache_size | 1024MB | ディスクキャッシュのサイズに関するプランナの推測を設定すること。 | RAM / 2を推奨 |
log_statement | none | ログしたステートメントタイプを設定すること。 | |
autovacuum | on | 自動バキュームサブプロセスを起動すること。 | |
autovacuum_analyze_scale_factor | 0.05 | タプル挿入、更新数、またはreltuplesの一部として分析する前に削除すること。 | |
autovacuum_analyze_threshold | 10 | タプル挿入、更新の最小数、または分析の前に削除される事。 | |
autovacuum_freeze_max_age | 200000000 | トランザクションIDの周回を防ぐためにテーブルを自動バキュームする年齢です。 | |
autovacuum_max_workers | 5 | 同時に実行されている自動バキュームワーカー・プロセスの最大数を設定すること。 | |
autovacuum_multixact_freeze_max_age | 400000000 | 周回を防ぐためにテーブルを自動バキュームするMultixact 年齢です。 | |
autovacuum_naptime | 15s | 自動バキューム実行の間にスリープ時間です | |
autovacuum_vacuum_cost_delay | 10ms | 自動バキューム用ミリ秒に延長バキュームコストです。 | |
autovacuum_vacuum_cost_limit | 1000 | 自動バキュームのため、昼寝前に使用可能なバキュームコストです | |
autovacuum_vacuum_scale_factor | 0.1 | reltuplesの一部として真空の前に削除するまたはタプル更新数です。 | |
autovacuum_vacuum_threshold | 25 | 真空の前に削除するまたはタプル更新の最小回数 |
代わりのpg_dumpコマンドを使用して、archive_modeパラメータをオフに設定することをお勧めします。
バックアップと復元
PostgreSQLのダンプ・コマンドを使用することでBellaDatiデータベースをバックアップできます:
pg_dump -U user -F c -v -f "path_to_dump/dump.backup" belladati_db
バックアップを復元するには、pg_restoreのコマンドを使用します
pg_restore -v -c -O -d belladati_db -U user path_to_dump/dump.backup
次のステップ
Installing BellaDati on Linux - continue Installing BellaDati on Linux, step "check that default ports"
以下の説明したように、アプリケーションサーバー上でBellaDati WARの設定を続行します。