付録A パラメータ

FUJITSU Enterprise Postgresのpostgresql.confファイルに設定するパラメータについて説明します。postgresql.confファイルは、データ格納先に配置されています。

注意

パスを指定する場合は、以下に注意してください。

パスの区切り文字は\\を指定する。
パスに空白を含む場合は""で囲む。

core_directory（文字列）
コアファイルを出力するディレクトリを指定します。本パラメータを指定しない場合は、データ格納先のディレクトリを指定したものとみなされます。本パラメータは、インスタンス起動時にパラメータ指定することでのみ設定できます。インスタンス起動中に動的変更することはできません。
core_contents（文字列）
コアファイルに含める内容を指定します。
- full：サーバプロセスのメモリの内容をすべてコアファイルに出力します。
- none：コアファイルを出力しません。
- minimum：サーバプロセスのうち、共有メモリ以外の内容をコアファイルに出力します。コアファイルのサイズは小さくなります。ただし、場合によってはコアファイルが出力された原因の調査に必要な情報が十分に得られないことがあります。
本パラメータを指定しない場合は、“minimum”を指定したものとみなされます。本パラメータは、インスタンス起動時にパラメータ指定することでのみ設定できます。インスタンス起動中に動的変更することはできません。
keystore_location（文字列）
キーストアのファイルを格納するディレクトリを指定します。他のデータベースクラスタとは異なる場所を指定してください。本パラメータは、インスタンス起動時にパラメータ指定することでのみ設定できます。インスタンス起動中に動的変更することはできません。
tablespace_encryption_algorithm（文字列）
作成するテーブル空間の暗号化アルゴリズムを指定します。有効な値は AES128、 AES256、または none です。noneを指定した場合、暗号化は行いません。デフォルト値は none です。暗号化を行う場合、AES256の指定を推奨します。スーパーユーザーのみこの設定を変更できます。
backup_destination（文字列）
pgx_dmpallコマンドがバックアップデータを格納するディレクトリを絶対パスで指定します。他のデータベースクラスタとは異なる場所を指定してください。本パラメータは、インスタンス起動時にパラメータ指定することでのみ設定できます。インスタンス起動中に動的変更することはできません。
このディレクトリは、バックアップするデータ格納先のディレクトリ、テーブル空間ディレクトリ、およびトランザクションログ格納先のディレクトリの外に配置してください。このディレクトリの内容はデータベースシステムが管理するため、利用者は任意のファイルを格納しないように注意してください。
search_path（文字列）
Oracleデータベース互換のSUBSTR関数を利用する場合は、“search_path”パラメータに、“oracle”および“pg_catalog”を設定してください。“oracle”は、“pg_catalog”よりも前に指定する必要があります。
例
```
search_path = '"$user", public, oracle, pg_catalog'
```
参考
- search_pathは、スキーマ検索パスの優先順位を指定する機能です。Oracleデータベース版のSUBSTR関数はoracleスキーマに定義されます。
- search_pathについては、“PostgreSQL Documentation”の“Server Administration”の“Statement Behavior”を参照してください。
track_waits(文字列)
pgx_stat_lwlockおよびpgx_stat_latchに対し、統計情報の収集を有効にします。
- on：統計情報の収集を有効にします。
- off：統計情報の収集を無効にします。
本パラメータを指定しない場合は、“on”を指定したものとみなされます。
スーパーユーザーのみ、この設定を変更できます。
track_sql (文字列)
pgx_stat_sqlに対し、統計情報の収集を有効にします。
- on：統計情報の収集を有効にします。
- off：統計情報の収集を無効にします。
本パラメータを指定しない場合は、“on”を指定したものとみなされます。
スーパーユーザーのみ、この設定を変更できます。

インメモリ機能に関するパラメータ

reserve_buffer_ratio (数値)
ステーブルバッファテーブルに使用する共有メモリの割合をパーセンテージで指定します。
- 最小値：0
- 最大値：80
本パラメータを指定しない場合は、0を指定したものとみなされます。
vci.cost_threshold (数値)
VCIを利用した実行計画を選択する最も低いコストです。VCIを利用しない最良の実行計画のコスト値がこの値より低い場合には、そのVCIを利用しない実行計画を選択します。
- 最小値：0
- 最大値：4バイト符号付き整数の最大値
範囲外の値が指定された場合は、18000が設定されます。
本パラメータを指定しない場合は、18000を指定したものとみなされます。
vci.control_max_workers (数値)
VCIを管理するバックグラウンドワーカー数を指定します。インスタンス全体のワーカ数はmax_worker_processesにより制限されるため、max_worker_processesにここで設定した値を足してください。
- 最小値：1
- 最大値：8388607
範囲外の値が指定された場合は、8が設定されます。
本パラメータを指定しない場合は、8を指定したものとみなされます。
vci.enable (文字列)
VCIの有効、または無効を指定します。
- on：VCIを有効にします。
- off：VCIを無効にします。
本パラメータを指定しない場合は、“on”を指定したものとみなされます。
vci.log_query (文字列)
vci.max_local_rosで指定したメモリが不足したことでVCI利用ができなかった場合の、ログ出力の有効、または無効を指定します。
- on：ログ出力を有効にします。
- off：ログ出力を無効にします。
本パラメータを指定しない場合は、“off”を指定したものとみなされます。
vci.maintenance_work_mem (数値)
CREATE INDEXなどのVCIのメンテナンス時に使用するメモリの最大サイズを指定します。
- 最小値：1MB
- 最大値：4バイト符号付き整数の最大値 / 1024
範囲外の値が指定された場合は、256MBが設定されます。
本パラメータを指定しない場合は、256MBを指定したものとみなされます。
vci.max_local_ros (数値)
VCI検索時に使用するメモリの最大サイズを指定します。
- 最小値：64MB
- 最大値：4バイト符号付き整数の最大値
範囲外の値が指定された場合は、64MBが設定されます。
本パラメータを指定しない場合は、64MBを指定したものとみなされます。
参考
4バイト符号付き整数の最大値は、OSにより異なります。使用するOSの定義に従ってください。
vci.max_parallel_degree (数値)
並列検索で使用するバックグラウンドワーカーの最大数を指定します。インスタンス全体のワーカ数はmax_worker_processesにより制限されるため、max_worker_processesにここで設定した値を足してください。
並列検索で使用するバックグラウンドワーカーの最大数は、-8388607～8388607の範囲で指定可能です。
- 1以上の整数：指定した並列度で検索処理を実施します。
- 0：並列検索処理を停止します。
- 負数：環境から取得した最大CPU数から指定値を引いた並列度で、検索処理を実施します。
範囲外の値が指定された場合は、0が設定されます。
本パラメータを指定しない場合は、0を指定したものとみなされます。
vci.shared_work_mem (数値)
VCI並列検索時に使用するメモリの最大サイズを指定します。
- 最小値：32MB
- 最大値：4バイト符号付き整数の最大値
範囲外の値が指定された場合は、1GBが設定されます。
本パラメータを指定しない場合は、1GBを指定したものとみなされます。
vci.smc_directory (文字列)
VCI検索時に動的共有メモリとして一時ファイルを作成するディレクトリ名を指定します。
本パラメータを指定しない場合は、データ格納ディレクトリのサブディレクトリ(データ格納ディレクトリ\\base\\pgsql_tmp)を指定したものとみなされます。

Global Meta Cache機能に関するパラメータ

pgx_global_metacache (数値)
GMC領域のメモリサイズを指定します。
次の計算式で算出された値を指定してください。
算出された値よりも小さい値を指定しても動作しますが、メタキャッシュがGMC領域に入りきらなくなるかもしれません。
その場合にはシステムが不要だと思ったメタキャッシュを破棄しますが、再度そのメタキャッシュが必要な場合にはメタキャッシュを展開する必要があるので、十分な性能を発揮できなくなります。
10MBよりも小さい値で、かつ、機能を無効にする0以外の値ではGlobal Meta Cache機能が動作できないためにデータベースの起動が失敗します。
0を設定するとGlobal Meta Cache機能は無効になります。デフォルトは0です。
この設定を変更するときはデータベースの再起動が必要です。
```
GMC領域のメモリサイズ
  = Max(10MB, 
    （全ユーザーテーブル個数 × 0.4 KB
       + 全ユーザーインデックス個数 × 0.3 KB
       + 全ユーザーカラム数 × 0.8 KB）× 1.5（※）)

  ※安全係数（1.5）
  テーブル定義変更やシステムカタログの行が変更された場合に、一時的に変更前のGMCと変更後のGMCが共有メモリ上に存在する場合を考慮した値です。
```
track_gmc (文字列)
pgx_stat_gmcに対し、統計情報の収集を有効にします。
- on：統計情報の収集を有効にします。
- off：統計情報の収集を無効にします。
本パラメータを指定しない場合は、“on”を指定したものとみなされます。
スーパーユーザーのみ、この設定を変更できます。

参照

上記以外のpostgresql.confのパラメータについては、“PostgreSQL Documentation”の“Server Administration”の“Server Configuration”を参照してください。