すべてのプロダクト
Search

このプロダクト

    PolarDB:パラメーター

    ドキュメントセンター

    PolarDB:パラメーター

    最終更新日:Jan 07, 2026

    このトピックでは、列ストアインデックスのパラメーターとデータの型について説明します。

    設定パラメーター

    パラメーター

    有効な値

    デフォルト値

    説明

    polar_csi.enable_query

    on|off

    off

    クエリ文で列ストアインデックスを使用できるかどうかを指定します。有効な値：

    • off (デフォルト)：クエリ文は列ストアインデックスを使用できません。

    • on：クエリ文は列ストアインデックスを使用できます。

    polar_csi.cost_threshold

    1 to 1000000000

    50000

    クエリコストがこのしきい値より小さい場合、クエリ文は高速化のために列ストアインデックスを使用しません。実際のビジネスワークロードに基づいて値を調整してください。

    • この値が高すぎると、時間のかかる SQL 文が列ストアインデックスを使用できなくなり、クエリが遅くなります。

    • この値が低すぎると、単純な SQL 文が列ストアインデックスを使用するようになり、システムの同時実行性が低下します。

    説明

    • SQL 文のコストを照会および分析するには、EXPLAIN または EXPLAIN ANALYZE を使用します。

    • PostgreSQL 14：マイナーエンジンバージョン 2.0.14.13.28.0 以降では、デフォルト値が 50000 に変更されました。以前のデフォルト値は 1000 でした。

    • PostgreSQL 16：マイナーエンジンバージョン 2.0.16.10.12.0 以降では、デフォルト値が 50000 に変更されました。以前のデフォルト値は 1000 でした。

    polar_csi.exec_parallel

    1 to 512

    2

    列ストアインデックスの並列度。これは、単一の SQL 文が使用できる CPU リソースの量です。一般的に、並列度が高いほどパフォーマンスが向上します。

    実際の値はクラスターのリソース仕様に依存します。クラスターの仕様に基づいてこのパラメーターを調整してください。値はコンピュートノードの CPU コア数を超えないようにする必要があります。

    polar_csi.memory_limit

    1 to 1048576

    4096

    列ストアインデックスが使用できるメモリ量。単位：MB。

    メモリのしきい値が大きいほど、インデックス作成が高速になります。クラスターの仕様に基づいてこのパラメーターを調整してください。値はクラスターメモリの 25% を超えないようにする必要があります。超えた場合、メモリ不足 (OOM) エラーが発生する可能性があります。

    説明

    • PostgreSQL 14：マイナーエンジンバージョン 2.0.14.19.40.0 以降では、デフォルト値が 4096 に変更されました。以前のデフォルト値は 1024 でした。

    • PostgreSQL 16：マイナーエンジンバージョン 2.0.16.10.12.0 以降では、デフォルト値が 4096 に変更されました。以前のデフォルト値は 1024 でした。

    polar_csi.flush_count

    2048 to 20480000

    204800

    インデックス作成時にバッチでコミットする行数。

    行数を増やすと作成効率が向上しますが、より多くのメモリを消費します。

    polar_csi.update_interval

    0 to 3600

    1

    リアルタイムの行と列のデータを定期的に更新する間隔。単位：秒。

    更新間隔を長くすると、同じタイプの小さなトランザクションをマージできます。これにより、トランザクション数が多い場合のデータ更新効率が向上します。

    説明

    • PostgreSQL 14：このパラメーターは、列ストアインデックスのリアルタイム性能を向上させるために、マイナーエンジンバージョン 2.0.14.13.28.0 以降で追加されました。

    • PostgreSQL 16：このパラメーターは、列ストアインデックスのリアルタイム性能を向上させるために、マイナーエンジンバージョン 2.0.16.10.12.0 以降で追加されました。

    polar_csi.update_batch_count

    1024 to 4294967295

    100000

    一括更新での行数のしきい値。

    更新トランザクションの最大行数。このしきい値を大きくすると、データ更新の効率が向上します。

    説明

    • PostgreSQL 14：このパラメーターは、列ストアインデックスのリアルタイム性能を向上させるために、マイナーエンジンバージョン 2.0.14.13.28.0 以降で追加されました。

    • PostgreSQL 16：このパラメーターは、列ストアインデックスのリアルタイム性能を向上させるために、マイナーエンジンバージョン 2.0.16.10.12.0 以降で追加されました。

    polar_csi.forward_replay_wait

    on|off

    off

    列ストアインデックスデータのクエリ整合性レベル。有効な値：

    • off：結果整合性。列ストアインデックスのデータは、ローストアのデータより遅れる可能性があります。

    • on：強整合性。クエリは、実行される前に列ストアデータが最新バージョンにリプレイされるのを待ちます。書き込み負荷が高い場合、このパラメーターを有効にすると待機時間が長くなる可能性があります。

    polar_csi.forward_replay_wait_lsn_diff

    0～INT_MAX

    0

    ローストアと列ストア間で許容される LSN サイズでの同期遅延。遅延がこのしきい値を超えると、列ストアエンジンは使用されなくなります。単位：BYTE。

    説明

    • このパラメーターは、polar_csi.forward_replay_wait が有効な場合にのみ効果があります。

    • このパラメーターは、以下のバージョンにのみ適用されます：

      • PostgreSQL 14：マイナーエンジンバージョン 2.0.14.19.40.0 以降。

      • PostgreSQL 16：マイナーエンジンバージョン 2.0.16.10.12.0 以降。

      • PostgreSQL 15 および PostgreSQL 17：適用範囲と同じです。

    polar_csi.sync_addcolumn

    on|off

    off

    Add Column 操作を列ストアインデックスに同期するかどうかを指定します。

    説明

    このパラメーターは、以下のバージョンにのみ適用されます：

    • PostgreSQL 14：マイナーエンジンバージョン 2.0.14.19.40.0 以降。

    • PostgreSQL 16：マイナーエンジンバージョン 2.0.16.10.12.0 以降。

    • PostgreSQL 15 および PostgreSQL 17：適用範囲と同じです。

    データの型

    カテゴリ

    データの型

    基本データの型

    BOOLEAN、ARRAY、BIT、UUID

    文字列型とバイナリ型

    BPCHAR、CHAR、VARCHAR、TEXT、NAME、BYTEA

    日付/時刻型

    DATE、TIME、TIMESTAMP、TIMESTAMPTZ、INTERVAL

    数値型

    BIGINT、DECIMAL、DOUBLE PRECISION、FLOAT4、FLOAT8、INTEGER、NUMERIC、REAL、SERIAL、SHORT、SMALLINT

    複合型

    JSON、JSONB、ENUM、BITSTRING、VARCHAR[]、TEXT[]

    説明

    • PostgreSQL 14：マイナーエンジンバージョン 2.0.14.19.40.0 以降で、BITSTRING、VARCHAR[]、TEXT[] データ型が追加されました。

    • PostgreSQL 16：マイナーエンジンバージョン 2.0.16.10.12.0 以降で、BITSTRING、VARCHAR[]、TEXT[] データ型が追加されました。