diff --git a/.env.sample b/.env.sample index bf8e2d0..594ca5a 100644 --- a/.env.sample +++ b/.env.sample @@ -5,7 +5,7 @@ FLAVOUR=social APP_VERSION=latest # choose what extra services you want to run -COMPOSE_FILE="compose.yml:compose.meilisearch.yml" +COMPOSE_FILE="compose.yml:postgres/compose.postgres.tune.yml:compose.meilisearch.yml" APP_VERSION_FLAVOUR=${APP_VERSION}-${FLAVOUR} # Different flavours/forks or architectures may require different builds of bonfire: @@ -46,8 +46,8 @@ MAIL_BACKEND=none # max file upload size - default is 20 meg UPLOAD_LIMIT=20000000 -# in megabytes -DB_MEMORY_LIMIT=1000 +# upper limit for how much RAM you want the DB to use, in megabytes +# DB_MEMORY_LIMIT=1000 # how much info to include in logs (from less to more: emergency, alert, critical, error, warning, notice, info, debug) LOG_LEVEL=info diff --git a/postgres/bash-envsubst.sh b/postgres/bash-envsubst.sh new file mode 100644 index 0000000..270febd --- /dev/null +++ b/postgres/bash-envsubst.sh @@ -0,0 +1,21 @@ +#!/usr/bin/env bash +# Pure bash implementation of envsubst for environments where it's not available +# This provides a fallback when the native envsubst command (from gettext package) is missing + +# Function: envsubst +# Reads from stdin and replaces ${VAR_NAME} patterns with environment variable values +# Usage: envsubst < template_file > output_file +envsubst() { + local line + while IFS= read -r line; do + # Replace all ${VAR} patterns in the line + # This regex finds ${...} patterns and replaces them with the variable value + while [[ "$line" =~ \$\{([^}]+)\} ]]; do + local var_name="${BASH_REMATCH[1]}" + local var_value="${!var_name:-}" + # Replace the first occurrence + line="${line/\$\{${var_name}\}/${var_value}}" + done + echo "$line" + done +} diff --git a/postgres/compose.postgres.tune.yml b/postgres/compose.postgres.tune.yml new file mode 100644 index 0000000..4c61775 --- /dev/null +++ b/postgres/compose.postgres.tune.yml @@ -0,0 +1,51 @@ +--- +version: "3.8" + +services: + + db: + environment: + - AVAILABLE_RAM_MB=${DB_MEMORY_LIMIT} + - PG_DB_TYPE + - PG_STORAGE_TYPE + # - POSTGRES_START_CMD= + # - postgres + # -c max_connections=200 + # -c shared_buffers=${DB_MEMORY_LIMIT}MB + # # -c shared_preload_libraries='pg_stat_statements' + # # -c statement_timeout=1800000 + # # -c pg_stat_statements.track=all + # shm_size: ${DB_MEMORY_LIMIT} # unsupported by docker swarm + tmpfs: + - /tmp:size=${DB_MEMORY_LIMIT}M + entrypoint: ["/postgres-entrypoint.sh"] + #entrypoint: ['tail', '-f', '/dev/null'] # can replace entrypoint when the Postgres DB is corrupted and won't start + configs: + - source: postgres_entrypoint + target: /postgres-entrypoint.sh + mode: 0555 + - source: postgres_tune + target: /postgres-tune.sh + mode: 0555 + - source: postgres_conf_tmpl + target: /postgres.conf.tmpl + mode: 0444 + - source: bash_envsubst + target: /bash-envsubst.sh + mode: 0444 + + +configs: + postgres_entrypoint: + name: ${STACK_NAME}_postgres_entrypoint_${POSTGRES_ENTRYPOINT_VERSION:-v6} + file: postgres/postgres-entrypoint.sh + postgres_tune: + name: ${STACK_NAME}_postgres_tune_${POSTGRES_TUNE_VERSION:-v1} + file: postgres/postgres-tune.sh + postgres_conf_tmpl: + name: ${STACK_NAME}_postgres_conf_tmpl_${POSTGRES_CONF_TMPL_VERSION:-v2} + file: postgres/postgres.conf.tmpl + bash_envsubst: + name: ${STACK_NAME}_bash_envsubst_${BASH_ENVSUBST_VERSION:-v1} + file: postgres/bash-envsubst.sh + diff --git a/postgres/postgres-entrypoint.sh b/postgres/postgres-entrypoint.sh new file mode 100755 index 0000000..9b22b2c --- /dev/null +++ b/postgres/postgres-entrypoint.sh @@ -0,0 +1,61 @@ +#!/usr/bin/env bash +set -euo pipefail + +# Get the directory where this script is located +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" + +# Normalize SCRIPT_DIR to avoid double slashes when it's root +[[ "$SCRIPT_DIR" == "/" ]] && SCRIPT_DIR="" + +# Configuration via environment variables +POSTGRES_CONF_PATH="${POSTGRES_CONF_PATH:-/var/lib/postgresql/data/postgresql.auto.conf}" +POSTGRES_START_CMD="${POSTGRES_START_CMD:-docker-entrypoint.sh postgres}" + +# Check if envsubst is available, if not, load our bash implementation +if ! command -v envsubst &> /dev/null; then + echo "PostgreSQL: envsubst not found, using pure bash fallback..." + source "${SCRIPT_DIR}/bash-envsubst.sh" +fi + +echo "PostgreSQL: Generating optimized configuration..." + +# Generate and evaluate the ENV vars (only sets values that aren't already set) +eval "$(bash "${SCRIPT_DIR}/postgres-tune.sh")" + +echo "PostgreSQL: Configuration values:" +echo " Profile: ${PG_DB_TYPE:-oltp}" +echo " Max Connections: ${PG_MAX_CONNECTIONS}" +echo " Shared Buffers: ${PG_SHARED_BUFFERS_MB}MB" +echo " Effective Cache: ${PG_EFFECTIVE_CACHE_SIZE_MB}MB" +echo " Work Mem: ${PG_WORK_MEM_KB}kB" +echo " Max Workers: ${PG_MAX_WORKER_PROCESSES}" + +# Filter out comments and blank lines for cleaner output +config=$(envsubst < "${SCRIPT_DIR}/postgres.conf.tmpl" | grep -v '^\s*#' | grep -v '^\s*$') + +# Get the directory for the config file +CONF_DIR="$(dirname "${POSTGRES_CONF_PATH}")" + +echo "==========================================" +echo "$config" +echo "==========================================" + +# Check if we can write to the config location +if mkdir -p "${CONF_DIR}" 2>/dev/null; then + # Write the processed config + echo "$config" > "${POSTGRES_CONF_PATH}" + echo "PostgreSQL: Configuration generated at ${POSTGRES_CONF_PATH}" + + # Check if we should start postgres + if [[ -n "${POSTGRES_START_CMD}" && "${POSTGRES_START_CMD}" != "none" ]]; then + # Start PostgreSQL - postgresql.auto.conf is automatically loaded from data dir + exec ${POSTGRES_START_CMD} + else + echo "PostgreSQL: Skipping startup (POSTGRES_START_CMD is '${POSTGRES_START_CMD}')" + exit 0 + fi +else + echo "WARNING: Cannot write to ${CONF_DIR}" + echo "To use this config, save it to a file and start postgres with: postgres -c config_file=/path/to/postgresql.conf" + exit 1 +fi diff --git a/postgres/postgres-tune.sh b/postgres/postgres-tune.sh new file mode 100755 index 0000000..8aaef39 --- /dev/null +++ b/postgres/postgres-tune.sh @@ -0,0 +1,431 @@ +#!/usr/bin/env bash +set -euo pipefail + +# PostgreSQL Configuration Tuner +# Based on PGTune algorithm (https://pgtune.leopard.in.ua) +# Detects system resources and calculates optimal settings +# Outputs ENV vars that can be sourced before running envsubst + +# Constants +readonly KB=1024 +readonly MB=$((1024 * KB)) +readonly GB=$((1024 * MB)) +readonly TB=$((1024 * GB)) + +# Database types +readonly DB_TYPE_WEB="web" +readonly DB_TYPE_OLTP="oltp" +readonly DB_TYPE_DW="dw" +readonly DB_TYPE_DESKTOP="desktop" +readonly DB_TYPE_MIXED="mixed" + +# Storage types +readonly STORAGE_SSD="ssd" +readonly STORAGE_HDD="hdd" +readonly STORAGE_SAN="san" + +# Auto-detect or use environment variables +PG_DB_TYPE="${PG_DB_TYPE:-${DB_TYPE:-oltp}}" +PG_STORAGE_TYPE="${PG_STORAGE_TYPE:-${DISK_STORAGE_TYPE:-ssd}}" +PG_DB_VERSION="${PG_DB_VERSION:-17}" + +# System resources detection +detect_total_memory_kb() { + if [[ -n "${AVAILABLE_RAM_GB:-}" ]]; then + echo $((AVAILABLE_RAM_GB * GB / KB)) + elif [[ -n "${AVAILABLE_RAM_MB:-}" ]]; then + echo $((AVAILABLE_RAM_MB * MB / KB)) + elif [[ -f /proc/meminfo ]]; then + # Linux + awk '/MemTotal/ {print int($2)}' /proc/meminfo + elif command -v sysctl &> /dev/null; then + # macOS/BSD + local mem_bytes + mem_bytes=$(sysctl -n hw.memsize 2>/dev/null || sysctl -n hw.physmem 2>/dev/null) + echo $((mem_bytes / KB)) + else + # Fallback: assume 4GB + echo $((4 * GB / KB)) + fi +} + +detect_cpu_count() { + if [[ -n "${NUM_CPU:-}" ]]; then + echo "$NUM_CPU" + elif command -v nproc &> /dev/null; then + nproc + elif [[ -f /proc/cpuinfo ]]; then + grep -c ^processor /proc/cpuinfo + elif command -v sysctl &> /dev/null; then + sysctl -n hw.ncpu 2>/dev/null || echo "2" + else + echo "2" + fi +} + +# Get system resources +TOTAL_MEMORY_KB=$(detect_total_memory_kb) +CPU_COUNT=$(detect_cpu_count) + +# Helper functions +to_mb() { + echo $(($1 / KB)) +} + +to_gb() { + echo $(($1 / MB)) +} + + +# Print detected/configured values to stderr so they don't interfere with the export output +{ + echo "==========================================" + echo "PostgreSQL Configuration Detection" + echo "==========================================" + echo "System Resources:" + echo " Total Memory: $(to_mb $TOTAL_MEMORY_KB) MB ($(to_gb $TOTAL_MEMORY_KB) GB)" + echo " CPU Cores: ${CPU_COUNT}" + echo "" + echo "Configuration:" + echo " Database Type: ${PG_DB_TYPE}" + echo " Storage Type: ${PG_STORAGE_TYPE}" + echo " PostgreSQL Version: ${PG_DB_VERSION}" + echo "==========================================" + echo "" +} >&2 + + +# Calculate max_connections +calc_max_connections() { + if [[ -n "${PG_MAX_CONNECTIONS:-}" ]]; then + echo "$PG_MAX_CONNECTIONS" + return + fi + + case "$PG_DB_TYPE" in + "$DB_TYPE_WEB") echo 200 ;; + "$DB_TYPE_OLTP") echo 300 ;; + "$DB_TYPE_DW") echo 40 ;; + "$DB_TYPE_DESKTOP") echo 20 ;; + "$DB_TYPE_MIXED") echo 100 ;; + *) echo 100 ;; + esac +} + +# Calculate shared_buffers +calc_shared_buffers() { + if [[ -n "${PG_SHARED_BUFFERS_MB:-}" ]]; then + echo $((PG_SHARED_BUFFERS_MB * MB / KB)) + return + fi + + local shared_buffers_kb + case "$PG_DB_TYPE" in + "$DB_TYPE_WEB"|"$DB_TYPE_OLTP"|"$DB_TYPE_DW"|"$DB_TYPE_MIXED") + shared_buffers_kb=$((TOTAL_MEMORY_KB / 4)) + ;; + "$DB_TYPE_DESKTOP") + shared_buffers_kb=$((TOTAL_MEMORY_KB / 16)) + ;; + *) + shared_buffers_kb=$((TOTAL_MEMORY_KB / 4)) + ;; + esac + + echo "$shared_buffers_kb" +} + +# Calculate effective_cache_size +calc_effective_cache_size() { + if [[ -n "${PG_EFFECTIVE_CACHE_SIZE_MB:-}" ]]; then + echo $((PG_EFFECTIVE_CACHE_SIZE_MB * MB / KB)) + return + fi + + case "$PG_DB_TYPE" in + "$DB_TYPE_WEB"|"$DB_TYPE_OLTP"|"$DB_TYPE_DW"|"$DB_TYPE_MIXED") + echo $((TOTAL_MEMORY_KB * 3 / 4)) + ;; + "$DB_TYPE_DESKTOP") + echo $((TOTAL_MEMORY_KB / 4)) + ;; + *) + echo $((TOTAL_MEMORY_KB * 3 / 4)) + ;; + esac +} + +# Calculate maintenance_work_mem +calc_maintenance_work_mem() { + if [[ -n "${PG_MAINTENANCE_WORK_MEM_MB:-}" ]]; then + echo $((PG_MAINTENANCE_WORK_MEM_MB * MB / KB)) + return + fi + + local maint_mem_kb + case "$PG_DB_TYPE" in + "$DB_TYPE_DW") + maint_mem_kb=$((TOTAL_MEMORY_KB / 8)) + ;; + *) + maint_mem_kb=$((TOTAL_MEMORY_KB / 16)) + ;; + esac + + # Cap at 2GB + local max_maint_mem=$((2 * GB / KB)) + if [[ $maint_mem_kb -gt $max_maint_mem ]]; then + maint_mem_kb=$max_maint_mem + fi + + echo "$maint_mem_kb" +} + +# Calculate checkpoint settings +calc_checkpoint_settings() { + local min_wal_kb max_wal_kb + + if [[ -n "${PG_MIN_WAL_SIZE_MB:-}" ]]; then + min_wal_kb=$((PG_MIN_WAL_SIZE_MB * MB / KB)) + else + case "$PG_DB_TYPE" in + "$DB_TYPE_WEB"|"$DB_TYPE_MIXED") min_wal_kb=$((1024 * MB / KB)) ;; + "$DB_TYPE_OLTP") min_wal_kb=$((2048 * MB / KB)) ;; + "$DB_TYPE_DW") min_wal_kb=$((4096 * MB / KB)) ;; + "$DB_TYPE_DESKTOP") min_wal_kb=$((100 * MB / KB)) ;; + *) min_wal_kb=$((1024 * MB / KB)) ;; + esac + fi + + if [[ -n "${PG_MAX_WAL_SIZE_MB:-}" ]]; then + max_wal_kb=$((PG_MAX_WAL_SIZE_MB * MB / KB)) + else + case "$PG_DB_TYPE" in + "$DB_TYPE_WEB"|"$DB_TYPE_MIXED") max_wal_kb=$((4096 * MB / KB)) ;; + "$DB_TYPE_OLTP") max_wal_kb=$((8192 * MB / KB)) ;; + "$DB_TYPE_DW") max_wal_kb=$((16384 * MB / KB)) ;; + "$DB_TYPE_DESKTOP") max_wal_kb=$((2048 * MB / KB)) ;; + *) max_wal_kb=$((4096 * MB / KB)) ;; + esac + fi + + echo "$min_wal_kb $max_wal_kb" +} + +# Calculate wal_buffers +calc_wal_buffers() { + if [[ -n "${PG_WAL_BUFFERS_MB:-}" ]]; then + echo $((PG_WAL_BUFFERS_MB * MB / KB)) + return + fi + + local shared_buffers_kb=$1 + local wal_buffers_kb=$((shared_buffers_kb * 3 / 100)) + + local max_wal_buffer=$((16 * MB / KB)) + if [[ $wal_buffers_kb -gt $max_wal_buffer ]]; then + wal_buffers_kb=$max_wal_buffer + fi + + # Round up to 16MB if close + local near_max=$((14 * MB / KB)) + if [[ $wal_buffers_kb -gt $near_max && $wal_buffers_kb -lt $max_wal_buffer ]]; then + wal_buffers_kb=$max_wal_buffer + fi + + # Minimum 32KB + if [[ $wal_buffers_kb -lt 32 ]]; then + wal_buffers_kb=32 + fi + + echo "$wal_buffers_kb" +} + +# Calculate default_statistics_target +calc_default_statistics_target() { + if [[ -n "${PG_DEFAULT_STATISTICS_TARGET:-}" ]]; then + echo "$PG_DEFAULT_STATISTICS_TARGET" + return + fi + + case "$PG_DB_TYPE" in + "$DB_TYPE_DW") echo 500 ;; + *) echo 100 ;; + esac +} + +# Calculate random_page_cost +calc_random_page_cost() { + if [[ -n "${PG_RANDOM_PAGE_COST:-}" ]]; then + echo "$PG_RANDOM_PAGE_COST" + return + fi + + case "$PG_STORAGE_TYPE" in + "$STORAGE_HDD") echo "4" ;; + "$STORAGE_SSD"|"$STORAGE_SAN") echo "1.1" ;; + *) echo "1.1" ;; + esac +} + +# Calculate effective_io_concurrency +calc_effective_io_concurrency() { + if [[ -n "${PG_EFFECTIVE_IO_CONCURRENCY:-}" ]]; then + echo "$PG_EFFECTIVE_IO_CONCURRENCY" + return + fi + + case "$PG_STORAGE_TYPE" in + "$STORAGE_HDD") echo 2 ;; + "$STORAGE_SSD") echo 200 ;; + "$STORAGE_SAN") echo 300 ;; + *) echo 200 ;; + esac +} + +# Calculate parallel workers settings +calc_parallel_settings() { + if [[ $CPU_COUNT -lt 4 ]]; then + echo "" + return + fi + + local workers_per_gather=$((CPU_COUNT / 2)) + local max_parallel_workers=${PG_MAX_PARALLEL_WORKERS:-$CPU_COUNT} + local max_worker_processes=${PG_MAX_WORKER_PROCESSES:-$CPU_COUNT} + + # Cap at 4 for non-DW workloads + if [[ "$PG_DB_TYPE" != "$DB_TYPE_DW" && $workers_per_gather -gt 4 ]]; then + workers_per_gather=4 + fi + + local parallel_maint_workers=$((CPU_COUNT / 2)) + if [[ $parallel_maint_workers -gt 4 ]]; then + parallel_maint_workers=4 + fi + local max_parallel_maintenance_workers=${PG_MAX_PARALLEL_MAINTENANCE_WORKERS:-$parallel_maint_workers} + + local max_parallel_workers_per_gather=${PG_MAX_PARALLEL_WORKERS_PER_GATHER:-$workers_per_gather} + + echo "max_worker_processes = $max_worker_processes" + echo "max_parallel_workers_per_gather = $max_parallel_workers_per_gather" + echo "max_parallel_workers = $max_parallel_workers" + echo "max_parallel_maintenance_workers = $max_parallel_maintenance_workers" +} + +# Calculate work_mem +calc_work_mem() { + if [[ -n "${PG_WORK_MEM_KB:-}" ]]; then + echo "$PG_WORK_MEM_KB" + return + fi + + local shared_buffers_kb=$1 + local max_connections=$2 + local max_worker_processes=${PG_MAX_WORKER_PROCESSES:-8} + + local work_mem_kb=$(( (TOTAL_MEMORY_KB - shared_buffers_kb) / ((max_connections + max_worker_processes) * 3) )) + + case "$PG_DB_TYPE" in + "$DB_TYPE_DW"|"$DB_TYPE_MIXED"|"$DB_TYPE_DESKTOP") + work_mem_kb=$((work_mem_kb / 2)) + ;; + esac + + # Minimum 64KB + if [[ $work_mem_kb -lt 64 ]]; then + work_mem_kb=64 + fi + + echo "$work_mem_kb" +} + +# Calculate huge_pages +calc_huge_pages() { + if [[ -n "${PG_HUGE_PAGES:-}" ]]; then + echo "$PG_HUGE_PAGES" + return + fi + + # Enable for systems with >= 32GB RAM + if [[ $TOTAL_MEMORY_KB -ge $((32 * GB / KB)) ]]; then + echo "try" + else + echo "off" + fi +} + +# Calculate checkpoint_completion_target +calc_checkpoint_completion_target() { + echo "${PG_CHECKPOINT_COMPLETION_TARGET:-0.9}" +} + +# Main generation function - output as ENV vars +generate_env_vars() { + local max_connections shared_buffers_kb effective_cache_kb maint_work_mem_kb + local min_wal_kb max_wal_kb wal_buffers_kb work_mem_kb + local default_stats_target random_page_cost effective_io_concurrency + local huge_pages checkpoint_target + + max_connections=$(calc_max_connections) + shared_buffers_kb=$(calc_shared_buffers) + effective_cache_kb=$(calc_effective_cache_size) + maint_work_mem_kb=$(calc_maintenance_work_mem) + read -r min_wal_kb max_wal_kb <<< "$(calc_checkpoint_settings)" + wal_buffers_kb=$(calc_wal_buffers "$shared_buffers_kb") + default_stats_target=$(calc_default_statistics_target) + random_page_cost=$(calc_random_page_cost) + effective_io_concurrency=$(calc_effective_io_concurrency) + work_mem_kb=$(calc_work_mem "$shared_buffers_kb" "$max_connections") + huge_pages=$(calc_huge_pages) + checkpoint_target=$(calc_checkpoint_completion_target) + + # Calculate parallel settings as individual values + local max_worker_processes max_parallel_workers_per_gather max_parallel_workers max_parallel_maintenance_workers + if [[ $CPU_COUNT -ge 4 ]]; then + local workers_per_gather=$((CPU_COUNT / 2)) + if [[ "$PG_DB_TYPE" != "$DB_TYPE_DW" && $workers_per_gather -gt 4 ]]; then + workers_per_gather=4 + fi + + local parallel_maint_workers=$((CPU_COUNT / 2)) + if [[ $parallel_maint_workers -gt 4 ]]; then + parallel_maint_workers=4 + fi + + max_worker_processes=${PG_MAX_WORKER_PROCESSES:-$CPU_COUNT} + max_parallel_workers_per_gather=${PG_MAX_PARALLEL_WORKERS_PER_GATHER:-$workers_per_gather} + max_parallel_workers=${PG_MAX_PARALLEL_WORKERS:-$CPU_COUNT} + max_parallel_maintenance_workers=${PG_MAX_PARALLEL_MAINTENANCE_WORKERS:-$parallel_maint_workers} + else + max_worker_processes=${PG_MAX_WORKER_PROCESSES:-8} + max_parallel_workers_per_gather=${PG_MAX_PARALLEL_WORKERS_PER_GATHER:-2} + max_parallel_workers=${PG_MAX_PARALLEL_WORKERS:-8} + max_parallel_maintenance_workers=${PG_MAX_PARALLEL_MAINTENANCE_WORKERS:-2} + fi + + # Output ENV vars (only if not already set) + cat << EOF +# PostgreSQL configuration calculated for: $PG_DB_TYPE workload, ${CPU_COUNT} CPUs, $(to_mb $TOTAL_MEMORY_KB)MB RAM, $PG_STORAGE_TYPE storage +export PG_MAX_CONNECTIONS=\${PG_MAX_CONNECTIONS:-$max_connections} +export PG_SHARED_BUFFERS_MB=\${PG_SHARED_BUFFERS_MB:-$(to_mb "$shared_buffers_kb")} +export PG_EFFECTIVE_CACHE_SIZE_MB=\${PG_EFFECTIVE_CACHE_SIZE_MB:-$(to_mb "$effective_cache_kb")} +export PG_MAINTENANCE_WORK_MEM_MB=\${PG_MAINTENANCE_WORK_MEM_MB:-$(to_mb "$maint_work_mem_kb")} +export PG_WORK_MEM_KB=\${PG_WORK_MEM_KB:-$work_mem_kb} +export PG_HUGE_PAGES=\${PG_HUGE_PAGES:-$huge_pages} +export PG_WAL_BUFFERS_MB=\${PG_WAL_BUFFERS_MB:-$(to_mb "$wal_buffers_kb")} +export PG_MIN_WAL_SIZE_MB=\${PG_MIN_WAL_SIZE_MB:-$(to_mb "$min_wal_kb")} +export PG_MAX_WAL_SIZE_MB=\${PG_MAX_WAL_SIZE_MB:-$(to_mb "$max_wal_kb")} +export PG_CHECKPOINT_COMPLETION_TARGET=\${PG_CHECKPOINT_COMPLETION_TARGET:-$checkpoint_target} +export PG_DEFAULT_STATISTICS_TARGET=\${PG_DEFAULT_STATISTICS_TARGET:-$default_stats_target} +export PG_RANDOM_PAGE_COST=\${PG_RANDOM_PAGE_COST:-$random_page_cost} +export PG_EFFECTIVE_IO_CONCURRENCY=\${PG_EFFECTIVE_IO_CONCURRENCY:-$effective_io_concurrency} +export PG_MAX_WORKER_PROCESSES=\${PG_MAX_WORKER_PROCESSES:-$max_worker_processes} +export PG_MAX_PARALLEL_WORKERS_PER_GATHER=\${PG_MAX_PARALLEL_WORKERS_PER_GATHER:-$max_parallel_workers_per_gather} +export PG_MAX_PARALLEL_WORKERS=\${PG_MAX_PARALLEL_WORKERS:-$max_parallel_workers} +export PG_MAX_PARALLEL_MAINTENANCE_WORKERS=\${PG_MAX_PARALLEL_MAINTENANCE_WORKERS:-$max_parallel_maintenance_workers} +EOF +} + +# Run generation +generate_env_vars diff --git a/postgres/postgres.conf.tmpl b/postgres/postgres.conf.tmpl new file mode 100644 index 0000000..a470884 --- /dev/null +++ b/postgres/postgres.conf.tmpl @@ -0,0 +1,819 @@ +# ----------------------------- +# PostgreSQL configuration file +# ----------------------------- +# +# This file consists of lines of the form: +# +# name = value +# +# (The "=" is optional.) Whitespace may be used. Comments are introduced with +# "#" anywhere on a line. The complete list of parameter names and allowed +# values can be found in the PostgreSQL documentation. +# +# The commented-out settings shown in this file represent the default values. +# Re-commenting a setting is NOT sufficient to revert it to the default value; +# you need to reload the server. +# +# This file is read on server startup and when the server receives a SIGHUP +# signal. If you edit the file on a running system, you have to SIGHUP the +# server for the changes to take effect, run "pg_ctl reload", or execute +# "SELECT pg_reload_conf()". Some parameters, which are marked below, +# require a server shutdown and restart to take effect. +# +# Any parameter can also be given as a command-line option to the server, e.g., +# "postgres -c log_connections=on". Some parameters can be changed at run time +# with the "SET" SQL command. +# +# Memory units: B = bytes Time units: us = microseconds +# kB = kilobytes ms = milliseconds +# MB = megabytes s = seconds +# GB = gigabytes min = minutes +# TB = terabytes h = hours +# d = days + + +#------------------------------------------------------------------------------ +# FILE LOCATIONS +#------------------------------------------------------------------------------ + +# The default values of these variables are driven from the -D command-line +# option or PGDATA environment variable, represented here as ConfigDir. + +#data_directory = 'ConfigDir' # use data in another directory + # (change requires restart) +#hba_file = 'ConfigDir/pg_hba.conf' # host-based authentication file + # (change requires restart) +#ident_file = 'ConfigDir/pg_ident.conf' # ident configuration file + # (change requires restart) + +# If external_pid_file is not explicitly set, no extra PID file is written. +#external_pid_file = '' # write an extra PID file + # (change requires restart) + + +#------------------------------------------------------------------------------ +# CONNECTIONS AND AUTHENTICATION +#------------------------------------------------------------------------------ + +# - Connection Settings - + +listen_addresses = '*' # comma-separated list of addresses; defaults to 'localhost'; use '*' for all + +max_connections = ${PG_MAX_CONNECTIONS} + +#port = 5432 # (change requires restart) +#reserved_connections = 0 # (change requires restart) +#superuser_reserved_connections = 3 # (change requires restart) +#unix_socket_directories = '/tmp' # comma-separated list of directories + # (change requires restart) +#unix_socket_group = '' # (change requires restart) +#unix_socket_permissions = 0777 # begin with 0 to use octal notation + # (change requires restart) +#bonjour = off # advertise server via Bonjour + # (change requires restart) +#bonjour_name = '' # defaults to the computer name + # (change requires restart) + +# - TCP settings - +# see "man tcp" for details + +#tcp_keepalives_idle = 0 # TCP_KEEPIDLE, in seconds; + # 0 selects the system default +#tcp_keepalives_interval = 0 # TCP_KEEPINTVL, in seconds; + # 0 selects the system default +#tcp_keepalives_count = 0 # TCP_KEEPCNT; + # 0 selects the system default +#tcp_user_timeout = 0 # TCP_USER_TIMEOUT, in milliseconds; + # 0 selects the system default + +#client_connection_check_interval = 0 # time between checks for client + # disconnection while running queries; + # 0 for never + +# - Authentication - + +#authentication_timeout = 1min # 1s-600s +#password_encryption = scram-sha-256 # scram-sha-256 or md5 +#scram_iterations = 4096 +#db_user_namespace = off + +# GSSAPI using Kerberos +#krb_server_keyfile = 'FILE:${sysconfdir}/krb5.keytab' +#krb_caseins_users = off +#gss_accept_delegation = off + +# - SSL - + +#ssl = off +#ssl_ca_file = '' +#ssl_cert_file = 'server.crt' +#ssl_crl_file = '' +#ssl_crl_dir = '' +#ssl_key_file = 'server.key' +#ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL' # allowed SSL ciphers +#ssl_prefer_server_ciphers = on +#ssl_ecdh_curve = 'prime256v1' +#ssl_min_protocol_version = 'TLSv1.2' +#ssl_max_protocol_version = '' +#ssl_dh_params_file = '' +#ssl_passphrase_command = '' +#ssl_passphrase_command_supports_reload = off + + +#------------------------------------------------------------------------------ +# RESOURCE USAGE (except WAL) +#------------------------------------------------------------------------------ + +# - Memory - + +shared_buffers = ${PG_SHARED_BUFFERS_MB}MB # min 128kB +huge_pages = ${PG_HUGE_PAGES} # on, off, or try +work_mem = ${PG_WORK_MEM_KB}kB # min 64kB +maintenance_work_mem = ${PG_MAINTENANCE_WORK_MEM_MB}MB # min 1MB + +#huge_page_size = 0 # zero for system default +#temp_buffers = 8MB # min 800kB +#max_prepared_transactions = 0 # zero disables the feature + # (change requires restart) +# Caution: it is not advisable to set max_prepared_transactions nonzero unless +# you actively intend to use prepared transactions. +#hash_mem_multiplier = 2.0 # 1-1000.0 multiplier on hash table work_mem +#maintenance_work_mem = 64MB # min 1MB +#autovacuum_work_mem = -1 # min 1MB, or -1 to use maintenance_work_mem +#logical_decoding_work_mem = 64MB # min 64kB +#max_stack_depth = 2MB # min 100kB +#shared_memory_type = mmap # the default is the first option + # supported by the operating system: + # mmap + # sysv + # windows + # (change requires restart) +#dynamic_shared_memory_type = posix # the default is usually the first option + # supported by the operating system: + # posix + # sysv + # windows + # mmap + # (change requires restart) +#min_dynamic_shared_memory = 0MB # (change requires restart) +#vacuum_buffer_usage_limit = 256kB # size of vacuum and analyze buffer access strategy ring; + # 0 to disable vacuum buffer access strategy; + # range 128kB to 16GB + +# - Disk - + +#temp_file_limit = -1 # limits per-process temp file space + # in kilobytes, or -1 for no limit + +# - Kernel Resources - + +#max_files_per_process = 1000 # min 64 + # (change requires restart) + +# - Cost-Based Vacuum Delay - + +#vacuum_cost_delay = 0 # 0-100 milliseconds (0 disables) +#vacuum_cost_page_hit = 1 # 0-10000 credits +#vacuum_cost_page_miss = 2 # 0-10000 credits +#vacuum_cost_page_dirty = 20 # 0-10000 credits +#vacuum_cost_limit = 200 # 1-10000 credits + +# - Background Writer - + +#bgwriter_delay = 200ms # 10-10000ms between rounds +#bgwriter_lru_maxpages = 100 # max buffers written/round, 0 disables +#bgwriter_lru_multiplier = 2.0 # 0-10.0 multiplier on buffers scanned/round +#bgwriter_flush_after = 0 # measured in pages, 0 disables + +# - Asynchronous Behavior - +#backend_flush_after = 0 # measured in pages, 0 disables +effective_io_concurrency = ${PG_EFFECTIVE_IO_CONCURRENCY} # 1-1000; 0 disables prefetching +max_worker_processes = ${PG_MAX_WORKER_PROCESSES} +max_parallel_workers_per_gather = ${PG_MAX_PARALLEL_WORKERS_PER_GATHER} # limited by max_parallel_workers +max_parallel_maintenance_workers = ${PG_MAX_PARALLEL_MAINTENANCE_WORKERS} # limited by max_parallel_workers +max_parallel_workers = ${PG_MAX_PARALLEL_WORKERS} # number of max_worker_processes that can be used in parallel operations + +#maintenance_io_concurrency = 10 # 1-1000; 0 disables prefetching +#parallel_leader_participation = on +#old_snapshot_threshold = -1 # 1min-60d; -1 disables; 0 is immediate + # (change requires restart) + + +#------------------------------------------------------------------------------ +# WRITE-AHEAD LOG +#------------------------------------------------------------------------------ + +# - Settings - + +wal_buffers = ${PG_WAL_BUFFERS_MB}MB # min 32kB, -1 sets based on shared_buffers + +#wal_level = replica # minimal, replica, or logical + # (change requires restart) +#fsync = on # flush data to disk for crash safety + # (turning this off can cause + # unrecoverable data corruption) +#synchronous_commit = on # synchronization level; + # off, local, remote_write, remote_apply, or on +#wal_sync_method = fsync # the default is the first option + # supported by the operating system: + # open_datasync + # fdatasync (default on Linux and FreeBSD) + # fsync + # fsync_writethrough + # open_sync +#full_page_writes = on # recover from partial page writes +#wal_log_hints = off # also do full page writes of non-critical updates + # (change requires restart) +#wal_compression = off # enables compression of full-page writes; + # off, pglz, lz4, zstd, or on +#wal_init_zero = on # zero-fill new WAL files +#wal_recycle = on # recycle WAL files +#wal_writer_delay = 200ms # 1-10000 milliseconds +#wal_writer_flush_after = 1MB # measured in pages, 0 disables +#wal_skip_threshold = 2MB + +#commit_delay = 0 # range 0-100000, in microseconds +#commit_siblings = 5 # range 1-1000 + +# - Checkpoints - + +#checkpoint_timeout = 5min # range 30s-1d +checkpoint_completion_target = ${PG_CHECKPOINT_COMPLETION_TARGET} # checkpoint target duration, 0.0 - 1.0 +#checkpoint_flush_after = 0 # measured in pages, 0 disables +#checkpoint_warning = 30s # 0 disables +max_wal_size = ${PG_MAX_WAL_SIZE_MB}MB +min_wal_size = ${PG_MIN_WAL_SIZE_MB}MB + +# - Prefetching during recovery - + +#recovery_prefetch = try # prefetch pages referenced in the WAL? +#wal_decode_buffer_size = 512kB # lookahead window used for prefetching + # (change requires restart) + +# - Archiving - + +#archive_mode = off # enables archiving; off, on, or always + # (change requires restart) +#archive_library = '' # library to use to archive a WAL file + # (empty string indicates archive_command should + # be used) +#archive_command = '' # command to use to archive a WAL file + # placeholders: %p = path of file to archive + # %f = file name only + # e.g. 'test ! -f /mnt/server/archivedir/%f && cp %p /mnt/server/archivedir/%f' +#archive_timeout = 0 # force a WAL file switch after this + # number of seconds; 0 disables + +# - Archive Recovery - + +# These are only used in recovery mode. + +#restore_command = '' # command to use to restore an archived WAL file + # placeholders: %p = path of file to restore + # %f = file name only + # e.g. 'cp /mnt/server/archivedir/%f %p' +#archive_cleanup_command = '' # command to execute at every restartpoint +#recovery_end_command = '' # command to execute at completion of recovery + +# - Recovery Target - + +# Set these only when performing a targeted recovery. + +#recovery_target = '' # 'immediate' to end recovery as soon as a + # consistent state is reached + # (change requires restart) +#recovery_target_name = '' # the named restore point to which recovery will proceed + # (change requires restart) +#recovery_target_time = '' # the time stamp up to which recovery will proceed + # (change requires restart) +#recovery_target_xid = '' # the transaction ID up to which recovery will proceed + # (change requires restart) +#recovery_target_lsn = '' # the WAL LSN up to which recovery will proceed + # (change requires restart) +#recovery_target_inclusive = on # Specifies whether to stop: + # just after the specified recovery target (on) + # just before the recovery target (off) + # (change requires restart) +#recovery_target_timeline = 'latest' # 'current', 'latest', or timeline ID + # (change requires restart) +#recovery_target_action = 'pause' # 'pause', 'promote', 'shutdown' + # (change requires restart) + + +#------------------------------------------------------------------------------ +# REPLICATION +#------------------------------------------------------------------------------ + +# - Sending Servers - + +# Set these on the primary and on any standby that will send replication data. + +#max_wal_senders = 10 # max number of walsender processes + # (change requires restart) +#max_replication_slots = 10 # max number of replication slots + # (change requires restart) +#wal_keep_size = 0 # in megabytes; 0 disables +#max_slot_wal_keep_size = -1 # in megabytes; -1 disables +#wal_sender_timeout = 60s # in milliseconds; 0 disables +#track_commit_timestamp = off # collect timestamp of transaction commit + # (change requires restart) + +# - Primary Server - + +# These settings are ignored on a standby server. + +#synchronous_standby_names = '' # standby servers that provide sync rep + # method to choose sync standbys, number of sync standbys, + # and comma-separated list of application_name + # from standby(s); '*' = all + +# - Standby Servers - + +# These settings are ignored on a primary server. + +#primary_conninfo = '' # connection string to sending server +#primary_slot_name = '' # replication slot on sending server +#hot_standby = on # "off" disallows queries during recovery + # (change requires restart) +#max_standby_archive_delay = 30s # max delay before canceling queries + # when reading WAL from archive; + # -1 allows indefinite delay +#max_standby_streaming_delay = 30s # max delay before canceling queries + # when reading streaming WAL; + # -1 allows indefinite delay +#wal_receiver_create_temp_slot = off # create temp slot if primary_slot_name + # is not set +#wal_receiver_status_interval = 10s # send replies at least this often + # 0 disables +#hot_standby_feedback = off # send info from standby to prevent + # query conflicts +#wal_receiver_timeout = 60s # time that receiver waits for + # communication from primary + # in milliseconds; 0 disables +#wal_retrieve_retry_interval = 5s # time to wait before retrying to + # retrieve WAL after a failed attempt +#recovery_min_apply_delay = 0 # minimum delay for applying changes during recovery + +# - Subscribers - + +# These settings are ignored on a publisher. + +#max_logical_replication_workers = 4 # taken from max_worker_processes + # (change requires restart) +#max_sync_workers_per_subscription = 2 # taken from max_logical_replication_workers +#max_parallel_apply_workers_per_subscription = 2 # taken from max_logical_replication_workers + + +#------------------------------------------------------------------------------ +# QUERY TUNING +#------------------------------------------------------------------------------ + +# - Planner Method Configuration - + +#enable_async_append = on +#enable_bitmapscan = on +#enable_gathermerge = on +#enable_hashagg = on +#enable_hashjoin = on +#enable_incremental_sort = on +#enable_indexscan = on +#enable_indexonlyscan = on +#enable_material = on +#enable_memoize = on +#enable_mergejoin = on +#enable_nestloop = on +#enable_parallel_append = on +#enable_parallel_hash = on +#enable_partition_pruning = on +#enable_partitionwise_join = off +#enable_partitionwise_aggregate = off +#enable_presorted_aggregate = on +#enable_seqscan = on +#enable_sort = on +#enable_tidscan = on + +# - Planner Cost Constants - + +#seq_page_cost = 1.0 # measured on an arbitrary scale +random_page_cost = ${PG_RANDOM_PAGE_COST} # same scale as above +#cpu_tuple_cost = 0.01 # same scale as above +#cpu_index_tuple_cost = 0.005 # same scale as above +#cpu_operator_cost = 0.0025 # same scale as above +#parallel_setup_cost = 1000.0 # same scale as above +#parallel_tuple_cost = 0.1 # same scale as above +#min_parallel_table_scan_size = 8MB +#min_parallel_index_scan_size = 512kB +effective_cache_size = ${PG_EFFECTIVE_CACHE_SIZE_MB}MB + +#jit_above_cost = 100000 # perform JIT compilation if available + # and query more expensive than this; + # -1 disables +#jit_inline_above_cost = 500000 # inline small functions if query is + # more expensive than this; -1 disables +#jit_optimize_above_cost = 500000 # use expensive JIT optimizations if + # query is more expensive than this; + # -1 disables + +# - Genetic Query Optimizer - + +#geqo = on +#geqo_threshold = 12 +#geqo_effort = 5 # range 1-10 +#geqo_pool_size = 0 # selects default based on effort +#geqo_generations = 0 # selects default based on effort +#geqo_selection_bias = 2.0 # range 1.5-2.0 +#geqo_seed = 0.0 # range 0.0-1.0 + +# - Other Planner Options - + +default_statistics_target = ${PG_DEFAULT_STATISTICS_TARGET} # range 1-10000 +#constraint_exclusion = partition # on, off, or partition +#cursor_tuple_fraction = 0.1 # range 0.0-1.0 +#from_collapse_limit = 8 +#jit = on # allow JIT compilation +#join_collapse_limit = 8 # 1 disables collapsing of explicit + # JOIN clauses +#plan_cache_mode = auto # auto, force_generic_plan or + # force_custom_plan +#recursive_worktable_factor = 10.0 # range 0.001-1000000 + + +#------------------------------------------------------------------------------ +# REPORTING AND LOGGING +#------------------------------------------------------------------------------ + +# - Where to Log - + +#log_destination = 'stderr' # Valid values are combinations of + # stderr, csvlog, jsonlog, syslog, and + # eventlog, depending on platform. + # csvlog and jsonlog require + # logging_collector to be on. + +# This is used when logging to stderr: +#logging_collector = off # Enable capturing of stderr, jsonlog, + # and csvlog into log files. Required + # to be on for csvlogs and jsonlogs. + # (change requires restart) + +# These are only used if logging_collector is on: +#log_directory = 'log' # directory where log files are written, + # can be absolute or relative to PGDATA +#log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log' # log file name pattern, + # can include strftime() escapes +#log_file_mode = 0600 # creation mode for log files, + # begin with 0 to use octal notation +#log_rotation_age = 1d # Automatic rotation of logfiles will + # happen after that time. 0 disables. +#log_rotation_size = 10MB # Automatic rotation of logfiles will + # happen after that much log output. + # 0 disables. +#log_truncate_on_rotation = off # If on, an existing log file with the + # same name as the new log file will be + # truncated rather than appended to. + # But such truncation only occurs on + # time-driven rotation, not on restarts + # or size-driven rotation. Default is + # off, meaning append to existing files + # in all cases. + +# These are relevant when logging to syslog: +#syslog_facility = 'LOCAL0' +#syslog_ident = 'postgres' +#syslog_sequence_numbers = on +#syslog_split_messages = on + +# This is only relevant when logging to eventlog (Windows): +# (change requires restart) +#event_source = 'PostgreSQL' + +# - When to Log - + +#log_min_messages = warning # values in order of decreasing detail: + # debug5 + # debug4 + # debug3 + # debug2 + # debug1 + # info + # notice + # warning + # error + # log + # fatal + # panic + +#log_min_error_statement = error # values in order of decreasing detail: + # debug5 + # debug4 + # debug3 + # debug2 + # debug1 + # info + # notice + # warning + # error + # log + # fatal + # panic (effectively off) + +#log_min_duration_statement = -1 # -1 is disabled, 0 logs all statements + # and their durations, > 0 logs only + # statements running at least this number + # of milliseconds + +#log_min_duration_sample = -1 # -1 is disabled, 0 logs a sample of statements + # and their durations, > 0 logs only a sample of + # statements running at least this number + # of milliseconds; + # sample fraction is determined by log_statement_sample_rate + +#log_statement_sample_rate = 1.0 # fraction of logged statements exceeding + # log_min_duration_sample to be logged; + # 1.0 logs all such statements, 0.0 never logs + + +#log_transaction_sample_rate = 0.0 # fraction of transactions whose statements + # are logged regardless of their duration; 1.0 logs all + # statements from all transactions, 0.0 never logs + +#log_startup_progress_interval = 10s # Time between progress updates for + # long-running startup operations. + # 0 disables the feature, > 0 indicates + # the interval in milliseconds. + +# - What to Log - + +#debug_print_parse = off +#debug_print_rewritten = off +#debug_print_plan = off +#debug_pretty_print = on +#log_autovacuum_min_duration = 10min # log autovacuum activity; + # -1 disables, 0 logs all actions and + # their durations, > 0 logs only + # actions running at least this number + # of milliseconds. +#log_checkpoints = on +#log_connections = off +#log_disconnections = off +#log_duration = off +#log_error_verbosity = default # terse, default, or verbose messages +#log_hostname = off +#log_line_prefix = '%m [%p] ' # special values: + # %a = application name + # %u = user name + # %d = database name + # %r = remote host and port + # %h = remote host + # %b = backend type + # %p = process ID + # %P = process ID of parallel group leader + # %t = timestamp without milliseconds + # %m = timestamp with milliseconds + # %n = timestamp with milliseconds (as a Unix epoch) + # %Q = query ID (0 if none or not computed) + # %i = command tag + # %e = SQL state + # %c = session ID + # %l = session line number + # %s = session start timestamp + # %v = virtual transaction ID + # %x = transaction ID (0 if none) + # %q = stop here in non-session + # processes + # %% = '%' + # e.g. '<%u%%%d> ' +#log_lock_waits = off # log lock waits >= deadlock_timeout +#log_recovery_conflict_waits = off # log standby recovery conflict waits + # >= deadlock_timeout +#log_parameter_max_length = -1 # when logging statements, limit logged + # bind-parameter values to N bytes; + # -1 means print in full, 0 disables +#log_parameter_max_length_on_error = 0 # when logging an error, limit logged + # bind-parameter values to N bytes; + # -1 means print in full, 0 disables +#log_statement = 'none' # none, ddl, mod, all +#log_replication_commands = off +#log_temp_files = -1 # log temporary files equal or larger + # than the specified size in kilobytes; + # -1 disables, 0 logs all temp files +#log_timezone = 'GMT' + +# - Process Title - + +#cluster_name = '' # added to process titles if nonempty + # (change requires restart) +#update_process_title = on + + +#------------------------------------------------------------------------------ +# STATISTICS +#------------------------------------------------------------------------------ + +# - Cumulative Query and Index Statistics - + +#track_activities = on +#track_activity_query_size = 1024 # (change requires restart) +#track_counts = on +#track_io_timing = off +#track_wal_io_timing = off +#track_functions = none # none, pl, all +#stats_fetch_consistency = cache # cache, none, snapshot + + +# - Monitoring - + +#compute_query_id = auto +#log_statement_stats = off +#log_parser_stats = off +#log_planner_stats = off +#log_executor_stats = off + + +#------------------------------------------------------------------------------ +# AUTOVACUUM +#------------------------------------------------------------------------------ + +#autovacuum = on # Enable autovacuum subprocess? 'on' + # requires track_counts to also be on. +#autovacuum_max_workers = 3 # max number of autovacuum subprocesses + # (change requires restart) +#autovacuum_naptime = 1min # time between autovacuum runs +#autovacuum_vacuum_threshold = 50 # min number of row updates before + # vacuum +#autovacuum_vacuum_insert_threshold = 1000 # min number of row inserts + # before vacuum; -1 disables insert + # vacuums +#autovacuum_analyze_threshold = 50 # min number of row updates before + # analyze +#autovacuum_vacuum_scale_factor = 0.2 # fraction of table size before vacuum +#autovacuum_vacuum_insert_scale_factor = 0.2 # fraction of inserts over table + # size before insert vacuum +#autovacuum_analyze_scale_factor = 0.1 # fraction of table size before analyze +#autovacuum_freeze_max_age = 200000000 # maximum XID age before forced vacuum + # (change requires restart) +#autovacuum_multixact_freeze_max_age = 400000000 # maximum multixact age + # before forced vacuum + # (change requires restart) +#autovacuum_vacuum_cost_delay = 2ms # default vacuum cost delay for + # autovacuum, in milliseconds; + # -1 means use vacuum_cost_delay +#autovacuum_vacuum_cost_limit = -1 # default vacuum cost limit for + # autovacuum, -1 means use + # vacuum_cost_limit + + +#------------------------------------------------------------------------------ +# CLIENT CONNECTION DEFAULTS +#------------------------------------------------------------------------------ + +# - Statement Behavior - + +#client_min_messages = notice # values in order of decreasing detail: + # debug5 + # debug4 + # debug3 + # debug2 + # debug1 + # log + # notice + # warning + # error +#search_path = '"$user", public' # schema names +#row_security = on +#default_table_access_method = 'heap' +#default_tablespace = '' # a tablespace name, '' uses the default +#default_toast_compression = 'pglz' # 'pglz' or 'lz4' +#temp_tablespaces = '' # a list of tablespace names, '' uses + # only default tablespace +#check_function_bodies = on +#default_transaction_isolation = 'read committed' +#default_transaction_read_only = off +#default_transaction_deferrable = off +#session_replication_role = 'origin' +#statement_timeout = 0 # in milliseconds, 0 is disabled +#lock_timeout = 0 # in milliseconds, 0 is disabled +#idle_in_transaction_session_timeout = 0 # in milliseconds, 0 is disabled +#idle_session_timeout = 0 # in milliseconds, 0 is disabled +#vacuum_freeze_table_age = 150000000 +#vacuum_freeze_min_age = 50000000 +#vacuum_failsafe_age = 1600000000 +#vacuum_multixact_freeze_table_age = 150000000 +#vacuum_multixact_freeze_min_age = 5000000 +#vacuum_multixact_failsafe_age = 1600000000 +#bytea_output = 'hex' # hex, escape +#xmlbinary = 'base64' +#xmloption = 'content' +#gin_pending_list_limit = 4MB +#createrole_self_grant = '' # set and/or inherit + +# - Locale and Formatting - + +#datestyle = 'iso, mdy' +#intervalstyle = 'postgres' +#timezone = 'GMT' +#timezone_abbreviations = 'Default' # Select the set of available time zone + # abbreviations. Currently, there are + # Default + # Australia (historical usage) + # India + # You can create your own file in + # share/timezonesets/. +#extra_float_digits = 1 # min -15, max 3; any value >0 actually + # selects precise output mode +#client_encoding = sql_ascii # actually, defaults to database + # encoding + +# These settings are initialized by initdb, but they can be changed. +#lc_messages = '' # locale for system error message + # strings +#lc_monetary = 'C' # locale for monetary formatting +#lc_numeric = 'C' # locale for number formatting +#lc_time = 'C' # locale for time formatting + +#icu_validation_level = warning # report ICU locale validation + # errors at the given level + +# default configuration for text search +#default_text_search_config = 'pg_catalog.simple' + +# - Shared Library Preloading - + +#local_preload_libraries = '' +#session_preload_libraries = '' +#shared_preload_libraries = '' # (change requires restart) +#jit_provider = 'llvmjit' # JIT library to use + +# - Other Defaults - + +#dynamic_library_path = '$libdir' +#extension_destdir = '' # prepend path when loading extensions + # and shared objects (added by Debian) +#gin_fuzzy_search_limit = 0 + + +#------------------------------------------------------------------------------ +# LOCK MANAGEMENT +#------------------------------------------------------------------------------ + +#deadlock_timeout = 1s +#max_locks_per_transaction = 64 # min 10 + # (change requires restart) +#max_pred_locks_per_transaction = 64 # min 10 + # (change requires restart) +#max_pred_locks_per_relation = -2 # negative values mean + # (max_pred_locks_per_transaction + # / -max_pred_locks_per_relation) - 1 +#max_pred_locks_per_page = 2 # min 0 + + +#------------------------------------------------------------------------------ +# VERSION AND PLATFORM COMPATIBILITY +#------------------------------------------------------------------------------ + +# - Previous PostgreSQL Versions - + +#array_nulls = on +#backslash_quote = safe_encoding # on, off, or safe_encoding +#escape_string_warning = on +#lo_compat_privileges = off +#quote_all_identifiers = off +#standard_conforming_strings = on +#synchronize_seqscans = on + +# - Other Platforms and Clients - + +#transform_null_equals = off + + +#------------------------------------------------------------------------------ +# ERROR HANDLING +#------------------------------------------------------------------------------ + +#exit_on_error = off # terminate session on any error? +#restart_after_crash = on # reinitialize after backend crash? +#data_sync_retry = off # retry or panic on failure to fsync + # data? + # (change requires restart) +#recovery_init_sync_method = fsync # fsync, syncfs (Linux 5.8+) + + +#------------------------------------------------------------------------------ +# CONFIG FILE INCLUDES +#------------------------------------------------------------------------------ + +# These options allow settings to be loaded from files other than the +# default postgresql.conf. Note that these are directives, not variable +# assignments, so they can usefully be given more than once. + +#include_dir = '...' # include files ending in '.conf' from + # a directory, e.g., 'conf.d' +#include_if_exists = '...' # include file only if it exists +#include = '...' # include file + + +#------------------------------------------------------------------------------ +# CUSTOMIZED OPTIONS +#------------------------------------------------------------------------------ + +# Add settings for extensions here