postgresql.conf-13.j2

# {{ ansible_managed }}
# -----------------------------
# 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:  kB = kilobytes        Time units:  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 = '{{ postgresql_data_directory }}'		# use data in another directory
					# (change requires restart)
hba_file = '{{ postgresql_hba_file }}'	# host-based authentication file
					# (change requires restart)
ident_file = '{{ postgresql_ident_file }}'	# ident configuration file
					# (change requires restart)

# If external_pid_file is not explicitly set, no extra PID file is written.
external_pid_file = '{{ postgresql_external_pid_file }}'			# write an extra PID file
					# (change requires restart)


#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------

# - Connection Settings -

listen_addresses = '{{ postgresql_listen_addresses | join(',') }}'		# what IP address(es) to listen on;
					# comma-separated list of addresses;
					# defaults to 'localhost'; use '*' for all
					# (change requires restart)
port = {{ postgresql_port }}				# (change requires restart)
max_connections = {{ postgresql_max_connections }}			# (change requires restart)
superuser_reserved_connections = {{ postgresql_superuser_reserved_connections }}	# (change requires restart)
unix_socket_directories = '{{ postgresql_unix_socket_directories | join(',') }}'	# comma-separated list of directories
					# (change requires restart)
unix_socket_group = '{{ postgresql_unix_socket_group }}'			# (change requires restart)
unix_socket_permissions = {{ postgresql_unix_socket_permissions }}		# begin with 0 to use octal notation
					# (change requires restart)
bonjour = {{ 'on' if postgresql_bonjour else 'off' }}				# advertise server via Bonjour
					# (change requires restart)
bonjour_name = '{{ postgresql_bonjour_name }}'			# defaults to the computer name
					# (change requires restart)

# - TCP settings -
# see "man tcp" for details

tcp_keepalives_idle = {{ postgresql_tcp_keepalives_idle }}		# TCP_KEEPIDLE, in seconds;
					# 0 selects the system default
tcp_keepalives_interval = {{ postgresql_tcp_keepalives_interval }}		# TCP_KEEPINTVL, in seconds;
					# 0 selects the system default
tcp_keepalives_count = {{ postgresql_tcp_keepalives_count }}		# TCP_KEEPCNT;
					# 0 selects the system default
tcp_user_timeout = {{ postgresql_tcp_user_timeout }}                   # TCP_USER_TIMEOUT, in milliseconds;
                                        # 0 selects the system default

# - Authentication -

authentication_timeout = {{ postgresql_authentication_timeout }}		# 1s-600s
password_encryption = {{ postgresql_password_encryption }}     # md5 or scram-sha-256
db_user_namespace = {{ 'on' if postgresql_db_user_namespace else 'off' }}

# GSSAPI using Kerberos

krb_server_keyfile = '{{ postgresql_krb_server_keyfile }}'
krb_caseins_users = {{ 'on' if postgresql_krb_caseins_users else 'off' }}

# - SSL -

ssl = {{ 'on' if postgresql_ssl else 'off' }}
ssl_ca_file = '{{ postgresql_ssl_ca_file }}'
ssl_cert_file = '{{ postgresql_ssl_cert_file }}'
ssl_crl_file = '{{ postgresql_ssl_crl_file }}'
ssl_key_file = '{{ postgresql_ssl_key_file }}'
ssl_ciphers = '{{ postgresql_ssl_ciphers | join(':') }}' # allowed SSL ciphers
ssl_prefer_server_ciphers = {{ 'on' if postgresql_ssl_prefer_server_ciphers else 'off' }}
ssl_ecdh_curve = '{{ postgresql_ssl_ecdh_curve }}'
ssl_min_protocol_version = '{{ postgresql_ssl_min_protocol_version }}'
ssl_max_protocol_version = '{{ postgresql_ssl_max_protocol_version }}'
ssl_dh_params_file = '{{ postgresql_ssl_dh_params_file }}'
ssl_passphrase_command = '{{ postgresql_ssl_passphrase_command }}'
ssl_passphrase_command_supports_reload = {{ 'on' if postgresql_ssl_passphrase_command_supports_reload else 'off' }}


#------------------------------------------------------------------------------
# RESOURCE USAGE (except WAL)
#------------------------------------------------------------------------------

# - Memory -

shared_buffers = {{ postgresql_shared_buffers }}			# min 128kB
					# (change requires restart)
huge_pages = {{ postgresql_huge_pages }}			# on, off, or try
					# (change requires restart)
temp_buffers = {{ postgresql_temp_buffers }}			# min 800kB
max_prepared_transactions = {{ postgresql_max_prepared_transactions }}		# 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.
work_mem = {{ postgresql_work_mem }}				# min 64kB
hash_mem_multiplier = {{ postgresql_hash_mem_multiplier }}              # 1-1000.0 multiplier on hash table work_mem
maintenance_work_mem = {{ postgresql_maintenance_work_mem }}		# min 1MB
autovacuum_work_mem = {{ postgresql_autovacuum_work_mem }}		# min 1MB, or -1 to use maintenance_work_mem
logical_decoding_work_mem = {{ postgresql_logical_decoding_work_mem }}       # min 64kB
max_stack_depth = {{ postgresql_max_stack_depth }}			# min 100kB
shared_memory_type = {{ postgresql_shared_memory_type }}              # the default is the first option
                                        # supported by the operating system:
                                        #   mmap
                                        #   sysv
                                        #   windows
                                        # (change requires restart)
dynamic_shared_memory_type = {{ postgresql_dynamic_shared_memory_type }}	# the default is the first option
					# supported by the operating system:
					#   posix
					#   sysv
					#   windows
					#   mmap
					# (change requires restart)

# - Disk -

temp_file_limit = {{ postgresql_temp_file_limit }}			# limits per-process temp file space
					# in kilobytes, or -1 for no limit

# - Kernel Resources -

max_files_per_process = {{ postgresql_max_files_per_process }}		# min 64
					# (change requires restart)

# - Cost-Based Vacuum Delay -

vacuum_cost_delay = {{ postgresql_vacuum_cost_delay }}			# 0-100 milliseconds (0 disables)
vacuum_cost_page_hit = {{ postgresql_vacuum_cost_page_hit }}		# 0-10000 credits
vacuum_cost_page_miss = {{ postgresql_vacuum_cost_page_miss }}		# 0-10000 credits
vacuum_cost_page_dirty = {{ postgresql_vacuum_cost_page_dirty }}		# 0-10000 credits
vacuum_cost_limit = {{ postgresql_vacuum_cost_limit }}		# 1-10000 credits

# - Background Writer -

bgwriter_delay = {{ postgresql_bgwriter_delay }}			# 10-10000ms between rounds
bgwriter_lru_maxpages = {{ postgresql_bgwriter_lru_maxpages }}		# max buffers written/round, 0 disables
bgwriter_lru_multiplier = {{ postgresql_bgwriter_lru_multiplier }}		# 0-10.0 multiplier on buffers scanned/round
bgwriter_flush_after = {{ postgresql_bgwriter_flush_after }}		# measured in pages, 0 disables

# - Asynchronous Behavior -

effective_io_concurrency = {{ postgresql_effective_io_concurrency }}		# 1-1000; 0 disables prefetching
maintenance_io_concurrency = {{ postgresql_maintenance_io_concurrency }}        # 1-1000; 0 disables prefetching
max_worker_processes = {{ postgresql_max_worker_processes }}		# (change requires restart)
max_parallel_maintenance_workers = {{ postgresql_max_parallel_maintenance_workers }}	# taken from max_parallel_workers
max_parallel_workers_per_gather = {{ postgresql_max_parallel_workers_per_gather }}	# taken from max_parallel_workers
parallel_leader_participation = {{ 'on' if postgresql_parallel_leader_participation else 'off' }}
max_parallel_workers = {{ postgresql_max_parallel_workers }}		# maximum number of max_worker_processes that
					# can be used in parallel operations
old_snapshot_threshold = {{ postgresql_old_snapshot_threshold }}		# 1min-60d; -1 disables; 0 is immediate
					# (change requires restart)
backend_flush_after = {{ postgresql_backend_flush_after }}		# measured in pages, 0 disables


#------------------------------------------------------------------------------
# WRITE-AHEAD LOG
#------------------------------------------------------------------------------

# - Settings -

wal_level = {{ postgresql_wal_level }}			# minimal, replica, or logical
					# (change requires restart)
fsync = {{ 'on' if postgresql_fsync else 'off' }}				# flush data to disk for crash safety
					# (turning this off can cause
					# unrecoverable data corruption)
synchronous_commit = {{ postgresql_synchronous_commit }}		# synchronization level;
					# off, local, remote_write, remote_apply, or on
wal_sync_method = {{ postgresql_wal_sync_method }}		# the default is the first option
					# supported by the operating system:
					#   open_datasync
					#   fdatasync (default on Linux)
					#   fsync
					#   fsync_writethrough
					#   open_sync
full_page_writes = {{ 'on' if postgresql_full_page_writes else 'off' }}			# recover from partial page writes
wal_compression = {{ 'on' if postgresql_wal_compression else 'off' }}			# enable compression of full-page writes
wal_log_hints = {{ 'on' if postgresql_wal_log_hints else 'off' }}			# also do full page writes of non-critical updates
					# (change requires restart)
wal_init_zero = {{ 'on' if postgresql_wal_init_zero else 'off' }}                     # zero-fill new WAL files
wal_recycle = {{ 'on' if postgresql_wal_recycle else 'off' }}                       # recycle WAL files
wal_buffers = {{ postgresql_wal_buffers }}			# min 32kB, -1 sets based on shared_buffers
					# (change requires restart)
wal_writer_delay = {{ postgresql_wal_writer_delay }}		# 1-10000 milliseconds
wal_writer_flush_after = {{ postgresql_wal_writer_flush_after }}		# measured in pages, 0 disables
wal_skip_threshold = {{ postgresql_wal_skip_threshold }}

commit_delay = {{ postgresql_commit_delay }}			# range 0-100000, in microseconds
commit_siblings = {{ postgresql_commit_siblings }}			# range 1-1000

# - Checkpoints -

checkpoint_timeout = {{ postgresql_checkpoint_timeout }}		# range 30s-1d
max_wal_size = {{ postgresql_max_wal_size }}
min_wal_size = {{ postgresql_min_wal_size }}
checkpoint_completion_target = {{ postgresql_checkpoint_completion_target }}	# checkpoint target duration, 0.0 - 1.0
checkpoint_flush_after = {{ postgresql_checkpoint_flush_after }}		# measured in pages, 0 disables
checkpoint_warning = {{ postgresql_checkpoint_warning }}		# 0 disables

# - Archiving -

archive_mode = {{ 'on' if ( postgresql_archive_mode | bool == true or postgresql_archive_mode == 'on' ) else ( 'always' if postgresql_archive_mode == 'always' else 'off' ) }}		# enables archiving; off, on, or always
				# (change requires restart)
archive_command = '{{ postgresql_archive_command }}'		# command to use to archive a logfile segment
				# 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 = {{ postgresql_archive_timeout }}		# force a logfile segment switch after this
				# number of seconds; 0 disables

# - Archive Recovery -

# These are only used in recovery mode.

restore_command = '{{ postgresql_restore_command }}'           # command to use to restore an archived logfile segment
                                # placeholders: %p = path of file to restore
                                #               %f = file name only
                                # e.g. 'cp /mnt/server/archivedir/%f %p'
                                # (change requires restart)
archive_cleanup_command = '{{ postgresql_archive_cleanup_command }}'   # command to execute at every restartpoint
recovery_end_command = '{{ postgresql_recovery_end_command }}'      # command to execute at completion of recovery

# - Recovery Target -

# Set these only when performing a targeted recovery.

recovery_target = '{{ postgresql_recovery_target }}'           # 'immediate' to end recovery as soon as a
                                # consistent state is reached
                                # (change requires restart)
recovery_target_name = '{{ postgresql_recovery_target_name }}'      # the named restore point to which recovery will proceed
                                # (change requires restart)
recovery_target_time = '{{ postgresql_recovery_target_time }}'      # the time stamp up to which recovery will proceed
                                # (change requires restart)
recovery_target_xid = '{{ postgresql_recovery_target_xid }}'       # the transaction ID up to which recovery will proceed
                                # (change requires restart)
recovery_target_lsn = '{{ postgresql_recovery_target_lsn }}'       # the WAL LSN up to which recovery will proceed
                                # (change requires restart)
recovery_target_inclusive = {{ 'on' if postgresql_recovery_target_inclusive else 'off' }} # Specifies whether to stop:
                                # just after the specified recovery target (on)
                                # just before the recovery target (off)
                                # (change requires restart)
recovery_target_timeline = '{{ postgresql_recovery_target_timeline }}'    # 'current', 'latest', or timeline ID
                                # (change requires restart)
recovery_target_action = '{{ postgresql_recovery_target_action }}'       # 'pause', 'promote', 'shutdown'
                                # (change requires restart)


#------------------------------------------------------------------------------
# REPLICATION
#------------------------------------------------------------------------------

# - Sending Servers -

# Set these on the master and on any standby that will send replication data.

max_wal_senders = {{ postgresql_max_wal_senders }}		# max number of walsender processes
				# (change requires restart)
wal_keep_size = {{ postgresql_wal_keep_size }}              # in megabytes; 0 disables
max_slot_wal_keep_size = {{ postgresql_max_slot_wal_keep_size }}    # in megabytes; -1 disables
wal_sender_timeout = {{ postgresql_wal_sender_timeout }}	# in milliseconds; 0 disables

max_replication_slots = {{ postgresql_max_replication_slots }}	# max number of replication slots
				# (change requires restart)
track_commit_timestamp = {{ 'on' if postgresql_track_commit_timestamp else 'off' }}	# collect timestamp of transaction commit
				# (change requires restart)

# - Master Server -

# These settings are ignored on a standby server.

synchronous_standby_names = '{% if postgresql_synchronous_standby_names != [] %}{% if postgresql_synchronous_standby_choose_sync != "" and postgresql_synchronous_standby_num_sync != "" %}{{ postgresql_synchronous_standby_choose_sync }} {% endif %}{% if postgresql_synchronous_standby_num_sync != "" %}{{ postgresql_synchronous_standby_num_sync }} ({% endif %}"{{ postgresql_synchronous_standby_names | join('\",\"') }}"{% if postgresql_synchronous_standby_num_sync != "" %}){% endif %}{% endif %}'	# 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
vacuum_defer_cleanup_age = {{ postgresql_vacuum_defer_cleanup_age }}	# number of xacts by which cleanup is delayed

# - Standby Servers -

# These settings are ignored on a master server.

primary_conninfo = '{{ postgresql_primary_conninfo }}'                  # connection string to sending server
                                        # (change requires restart)
primary_slot_name = '{{ postgresql_primary_slot_name }}'                 # replication slot on sending server
                                        # (change requires restart)
promote_trigger_file = '{{ postgresql_promote_trigger_file }}'              # file name whose presence ends recovery
hot_standby = {{ 'on' if postgresql_hot_standby else 'off' }}			# "off" disallows queries during recovery
					# (change requires restart)
max_standby_archive_delay = {{ postgresql_max_standby_archive_delay }}	# max delay before canceling queries
					# when reading WAL from archive;
					# -1 allows indefinite delay
max_standby_streaming_delay = {{ postgresql_max_standby_streaming_delay }}	# max delay before canceling queries
					# when reading streaming WAL;
					# -1 allows indefinite delay
wal_receiver_create_temp_slot = {{ postgresql_wal_receiver_create_temp_slot }}     # create temp slot if primary_slot_name
                                        # is not set

wal_receiver_status_interval = {{ postgresql_wal_receiver_status_interval }}	# send replies at least this often
					# 0 disables
hot_standby_feedback = {{ 'on' if postgresql_hot_standby_feedback else 'off' }}		# send info from standby to prevent
					# query conflicts
wal_receiver_timeout = {{ postgresql_wal_receiver_timeout }}		# time that receiver waits for
					# communication from master
					# in milliseconds; 0 disables
wal_retrieve_retry_interval = {{ postgresql_wal_retrieve_retry_interval }}	# time to wait before retrying to
					# retrieve WAL after a failed attempt
recovery_min_apply_delay = {{ postgresql_recovery_min_apply_delay }}           # minimum delay for applying changes during recovery

# - Subscribers -

# These settings are ignored on a publisher.

max_logical_replication_workers = {{ postgresql_max_logical_replication_workers }}	# taken from max_worker_processes
					# (change requires restart)
max_sync_workers_per_subscription = {{ postgresql_max_sync_workers_per_subscription }}	# taken from max_logical_replication_workers


#------------------------------------------------------------------------------
# QUERY TUNING
#------------------------------------------------------------------------------

# - Planner Method Configuration -

enable_bitmapscan = {{ 'on' if postgresql_enable_bitmapscan else 'off' }}
enable_hashagg = {{ 'on' if postgresql_enable_hashagg else 'off' }}
enable_hashjoin = {{ 'on' if postgresql_enable_hashjoin else 'off' }}
enable_indexscan = {{ 'on' if postgresql_enable_indexscan else 'off' }}
enable_indexonlyscan = {{ 'on' if postgresql_enable_indexonlyscan else 'off' }}
enable_material = {{ 'on' if postgresql_enable_material else 'off' }}
enable_mergejoin = {{ 'on' if postgresql_enable_mergejoin else 'off' }}
enable_nestloop = {{ 'on' if postgresql_enable_nestloop else 'off'  }}
enable_parallel_append = {{ 'on' if postgresql_enable_parallel_append else 'off' }}
enable_seqscan = {{ 'on' if postgresql_enable_seqscan else 'off' }}
enable_sort = {{ 'on' if postgresql_enable_sort else 'off' }}
enable_incremental_sort = {{ 'on' if postgresql_enable_incremental_sort else 'off' }}
enable_tidscan = {{ 'on' if postgresql_enable_tidscan else 'off' }}
enable_partitionwise_join = {{ 'on' if postgresql_enable_partitionwise_join else 'off' }}
enable_partitionwise_aggregate = {{ 'on' if postgresql_enable_partitionwise_aggregate else 'off' }}
enable_parallel_hash = {{ 'on' if postgresql_enable_parallel_hash else 'off' }}
enable_partition_pruning = {{ 'on' if postgresql_enable_partition_pruning else 'off' }}

# - Planner Cost Constants -

seq_page_cost = {{ postgresql_seq_page_cost }}			# measured on an arbitrary scale
random_page_cost = {{ postgresql_random_page_cost }}			# same scale as above
cpu_tuple_cost = {{ postgresql_cpu_tuple_cost }}			# same scale as above
cpu_index_tuple_cost = {{ postgresql_cpu_index_tuple_cost }}		# same scale as above
cpu_operator_cost = {{ postgresql_cpu_operator_cost }}		# same scale as above
parallel_tuple_cost = {{ postgresql_parallel_tuple_cost }}		# same scale as above
parallel_setup_cost = {{ postgresql_parallel_setup_cost }}	# same scale as above

jit_above_cost = {{ postgresql_jit_above_cost }}		# perform JIT compilation if available
					# and query more expensive than this;
					# -1 disables
jit_inline_above_cost = {{ postgresql_jit_inline_above_cost }}		# inline small functions if query is
					# more expensive than this; -1 disables
jit_optimize_above_cost = {{ postgresql_jit_optimize_above_cost }}	# use expensive JIT optimizations if
					# query is more expensive than this;
					# -1 disables

min_parallel_table_scan_size = {{ postgresql_min_parallel_table_scan_size }}
min_parallel_index_scan_size = {{ postgresql_min_parallel_index_scan_size }}
effective_cache_size = {{ postgresql_effective_cache_size }}

# - Genetic Query Optimizer -

geqo = {{ 'on' if postgresql_geqo else 'off' }}
geqo_threshold = {{ postgresql_geqo_threshold }}
geqo_effort = {{ postgresql_geqo_effort }}			# range 1-10
geqo_pool_size = {{ postgresql_geqo_pool_size }}			# selects default based on effort
geqo_generations = {{ postgresql_geqo_generations }}			# selects default based on effort
geqo_selection_bias = {{ postgresql_geqo_selection_bias }}		# range 1.5-2.0
geqo_seed = {{ postgresql_geqo_seed }}			# range 0.0-1.0

# - Other Planner Options -

default_statistics_target = {{ postgresql_default_statistics_target }}	# range 1-10000
constraint_exclusion = {{ postgresql_constraint_exclusion }}	# on, off, or partition
cursor_tuple_fraction = {{ postgresql_cursor_tuple_fraction }}		# range 0.0-1.0
from_collapse_limit = {{ postgresql_from_collapse_limit }}
join_collapse_limit = {{ postgresql_join_collapse_limit }}		# 1 disables collapsing of explicit
					# JOIN clauses
force_parallel_mode = {{ 'on' if ( postgresql_force_parallel_mode | bool == true or postgresql_force_parallel_mode == 'on' ) else ( 'regress' if postgresql_force_parallel_mode == 'regress' else 'off' ) }}
jit = {{ 'on' if postgresql_jit else 'off' }}				# allow JIT compilation
plan_cache_mode = {{ postgresql_plan_cache_mode }}                 # auto, force_generic_plan or
                                        # force_custom_plan


#------------------------------------------------------------------------------
# REPORTING AND LOGGING
#------------------------------------------------------------------------------

# - Where to Log -

log_destination = '{{ postgresql_log_destination }}'		# Valid values are combinations of
					# stderr, csvlog, syslog, and eventlog,
					# depending on platform.  csvlog
					# requires logging_collector to be on.

# This is used when logging to stderr:
logging_collector = {{ 'on' if postgresql_logging_collector else 'off' }}			# Enable capturing of stderr and csvlog
					# into log files. Required to be on for
					# csvlogs.
					# (change requires restart)

# These are only used if logging_collector is on:
log_directory = '{{ postgresql_log_directory }}'			# directory where log files are written,
					# can be absolute or relative to PGDATA
log_filename = '{{ postgresql_log_filename }}'	# log file name pattern,
					# can include strftime() escapes
log_file_mode = {{ postgresql_log_file_mode }}			# creation mode for log files,
					# begin with 0 to use octal notation
log_truncate_on_rotation = {{ 'on' if postgresql_log_truncate_on_rotation else '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.
log_rotation_age = {{ postgresql_log_rotation_age }}			# Automatic rotation of logfiles will
					# happen after that time.  0 disables.
log_rotation_size = {{ postgresql_log_rotation_size }}			# Automatic rotation of logfiles will
					# happen after that much log output.
					# 0 disables.

# These are relevant when logging to syslog:
syslog_facility = '{{ postgresql_syslog_facility }}'
syslog_ident = '{{ postgresql_syslog_ident }}'
syslog_sequence_numbers = {{ 'on' if postgresql_syslog_sequence_numbers else 'off' }}
syslog_split_messages = {{ 'on' if postgresql_syslog_split_messages else 'off' }}

# This is only relevant when logging to eventlog (win32):
# (change requires restart)
event_source = '{{ postgresql_event_source }}'

# - When to Log -

log_min_messages = {{ postgresql_log_min_messages }}		# values in order of decreasing detail:
					#   debug5
					#   debug4
					#   debug3
					#   debug2
					#   debug1
					#   info
					#   notice
					#   warning
					#   error
					#   log
					#   fatal
					#   panic

log_min_error_statement = {{ postgresql_log_min_error_statement }}	# values in order of decreasing detail:
					#   debug5
					#   debug4
					#   debug3
					#   debug2
					#   debug1
					#   info
					#   notice
					#   warning
					#   error
					#   log
					#   fatal
					#   panic (effectively off)

log_min_duration_statement = {{ postgresql_log_min_duration_statement }}	# -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 = {{ postgresql_log_min_duration_sample }}            # -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 = {{ postgresql_log_statement_sample_rate }}         # 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 = {{ postgresql_log_transaction_sample_rate }}      # Fraction of transactions whose statements
                                        # are logged regardless of their duration. 1.0 logs all
                                        # statements from all transactions, 0.0 never logs.

# - What to Log -

debug_print_parse = {{ 'on' if postgresql_debug_print_parse else 'off' }}
debug_print_rewritten = {{ 'on' if postgresql_debug_print_rewritten else 'off' }}
debug_print_plan = {{ 'on' if postgresql_debug_print_plan else 'off' }}
debug_pretty_print = {{ 'on' if postgresql_debug_pretty_print else 'off' }}
log_checkpoints = {{ 'on' if postgresql_log_checkpoints else 'off' }}
log_connections = {{ 'on' if postgresql_log_connections else 'off' }}
log_disconnections = {{ 'on' if postgresql_log_disconnections else 'off' }}
log_duration = {{ 'on' if postgresql_log_duration else 'off' }}
log_error_verbosity = {{ postgresql_log_error_verbosity }}		# terse, default, or verbose messages
log_hostname = {{ 'on' if postgresql_log_hostname else 'off' }}
log_line_prefix = '{{ postgresql_log_line_prefix }}'			# special values:
					#   %a = application name
					#   %u = user name
					#   %d = database name
					#   %r = remote host and port
					#   %h = remote host
					#   %p = process ID
					#   %t = timestamp without milliseconds
					#   %m = timestamp with milliseconds
					#   %n = timestamp with milliseconds (as a Unix epoch)
					#   %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 = {{ 'on' if postgresql_log_lock_waits else 'off' }}			# log lock waits >= deadlock_timeout
log_parameter_max_length = {{ postgresql_log_parameter_max_length }}           # when logging statements, limit logged
                                        # bind-parameter values to N bytes;
                                        # -1 means print in full, 0 disables
log_parameter_max_length_on_error = {{ postgresql_log_parameter_max_length_on_error }}   # when logging an error, limit logged
                                        # bind-parameter values to N bytes;
                                        # -1 means print in full, 0 disables
log_statement = '{{ postgresql_log_statement }}'			# none, ddl, mod, all
log_replication_commands = {{ 'on' if postgresql_log_replication_commands else 'off' }}
log_temp_files = {{ postgresql_log_temp_files }}			# log temporary files equal or larger
					# than the specified size in kilobytes;
					# -1 disables, 0 logs all temp files
log_timezone = '{{ postgresql_log_timezone }}'

#------------------------------------------------------------------------------
# PROCESS TITLE
#------------------------------------------------------------------------------

cluster_name = '{{ postgresql_cluster_name }}'			# added to process titles if nonempty
					# (change requires restart)
update_process_title = {{ 'on' if postgresql_update_process_title else 'off' }}


#------------------------------------------------------------------------------
# STATISTICS
#------------------------------------------------------------------------------

# - Query and Index Statistics Collector -

track_activities = {{ 'on' if postgresql_track_activities else 'off' }}
track_counts = {{ 'on' if postgresql_track_counts else 'off' }}
track_io_timing = {{ 'on' if postgresql_track_io_timing else 'off' }}
track_functions = {{ postgresql_track_functions }}			# none, pl, all
track_activity_query_size = {{ postgresql_track_activity_query_size }}	# (change requires restart)
stats_temp_directory = '{{ postgresql_stats_temp_directory }}'


# - Monitoring -

log_parser_stats = {{ 'on' if postgresql_log_parser_stats else 'off' }}
log_planner_stats = {{ 'on' if postgresql_log_planner_stats else 'off' }}
log_executor_stats = {{ 'on' if postgresql_log_executor_stats else 'off' }}
log_statement_stats = {{ 'on' if postgresql_log_statement_stats else 'off' }}


#------------------------------------------------------------------------------
# AUTOVACUUM
#------------------------------------------------------------------------------

autovacuum = {{ 'on' if postgresql_autovacuum else 'off' }}			# Enable autovacuum subprocess?  'on'
					# requires track_counts to also be on.
log_autovacuum_min_duration = {{ postgresql_log_autovacuum_min_duration }}	# -1 disables, 0 logs all actions and
					# their durations, > 0 logs only
					# actions running at least this number
					# of milliseconds.
autovacuum_max_workers = {{ postgresql_autovacuum_max_workers }}		# max number of autovacuum subprocesses
					# (change requires restart)
autovacuum_naptime = {{ postgresql_autovacuum_naptime }}		# time between autovacuum runs
autovacuum_vacuum_threshold = {{ postgresql_autovacuum_vacuum_threshold }}	# min number of row updates before
					# vacuum
autovacuum_vacuum_insert_threshold = {{ postgresql_autovacuum_vacuum_insert_threshold }}      # min number of row inserts
                                        # before vacuum; -1 disables insert
                                        # vacuums
autovacuum_analyze_threshold = {{ postgresql_autovacuum_analyze_threshold }}	# min number of row updates before
					# analyze
autovacuum_vacuum_scale_factor = {{ postgresql_autovacuum_vacuum_scale_factor }}	# fraction of table size before vacuum
autovacuum_vacuum_insert_scale_factor = {{ postgresql_autovacuum_vacuum_insert_scale_factor }}    # fraction of inserts over table
                                        # size before insert vacuum
autovacuum_analyze_scale_factor = {{ postgresql_autovacuum_analyze_scale_factor }}	# fraction of table size before analyze
autovacuum_freeze_max_age = {{ postgresql_autovacuum_freeze_max_age }}	# maximum XID age before forced vacuum
					# (change requires restart)
autovacuum_multixact_freeze_max_age = {{ postgresql_autovacuum_multixact_freeze_max_age }}	# maximum multixact age
					# before forced vacuum
					# (change requires restart)
autovacuum_vacuum_cost_delay = {{ postgresql_autovacuum_vacuum_cost_delay }}	# default vacuum cost delay for
					# autovacuum, in milliseconds;
					# -1 means use vacuum_cost_delay
autovacuum_vacuum_cost_limit = {{ postgresql_autovacuum_vacuum_cost_limit }}	# default vacuum cost limit for
					# autovacuum, -1 means use
					# vacuum_cost_limit


#------------------------------------------------------------------------------
# CLIENT CONNECTION DEFAULTS
#------------------------------------------------------------------------------

# - Statement Behavior -

client_min_messages = {{ postgresql_client_min_messages }}		# values in order of decreasing detail:
					#   debug5
					#   debug4
					#   debug3
					#   debug2
					#   debug1
					#   log
					#   notice
					#   warning
					#   error
search_path = '{{ postgresql_search_path | join(',') }}'	# schema names
row_security = {{ 'on' if postgresql_row_security else 'off' }}
default_tablespace = '{{ postgresql_default_tablespace }}'		# a tablespace name, '' uses the default
temp_tablespaces = '{{ postgresql_temp_tablespaces | join(',') }}'			# a list of tablespace names, '' uses
					# only default tablespace
default_table_access_method = '{{ postgresql_default_table_access_method }}'
check_function_bodies = {{ 'on' if postgresql_check_function_bodies else 'off' }}
default_transaction_isolation = '{{ postgresql_default_transaction_isolation }}'
default_transaction_read_only = {{ 'on' if postgresql_default_transaction_read_only else 'off' }}
default_transaction_deferrable = {{ 'on' if postgresql_default_transaction_deferrable else 'off' }}
session_replication_role = '{{ postgresql_session_replication_role }}'
statement_timeout = {{ postgresql_statement_timeout }}			# in milliseconds, 0 is disabled
lock_timeout = {{ postgresql_lock_timeout }}			# in milliseconds, 0 is disabled
idle_in_transaction_session_timeout = {{ postgresql_idle_in_transaction_session_timeout }}	# in milliseconds, 0 is disabled
vacuum_freeze_min_age = {{ postgresql_vacuum_freeze_min_age }}
vacuum_freeze_table_age = {{ postgresql_vacuum_freeze_table_age }}
vacuum_multixact_freeze_min_age = {{ postgresql_vacuum_multixact_freeze_min_age }}
vacuum_multixact_freeze_table_age = {{ postgresql_vacuum_multixact_freeze_table_age }}
vacuum_cleanup_index_scale_factor = {{ postgresql_vacuum_cleanup_index_scale_factor }}	# fraction of total number of tuples
						# before index cleanup, 0 always performs
						# index cleanup
bytea_output = '{{ postgresql_bytea_output }}'			# hex, escape
xmlbinary = '{{ postgresql_xmlbinary }}'
xmloption = '{{ postgresql_xmloption }}'
gin_fuzzy_search_limit = {{ postgresql_gin_fuzzy_search_limit }}
gin_pending_list_limit = {{ postgresql_gin_pending_list_limit }}

# - Locale and Formatting -

datestyle = '{{ postgresql_datestyle | join(',') }}'
intervalstyle = '{{ postgresql_intervalstyle }}'
timezone = '{{ postgresql_timezone }}'
timezone_abbreviations = '{{ postgresql_timezone_abbreviations }}'     # 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 = {{ postgresql_extra_float_digits }}			# min -15, max 3; any value >0 actually
                                        # selects precise output mode
{% if not postgresql_client_encoding %}
#client_encoding = sql_ascii		# actually, defaults to database
{% else %}
client_encoding = {{ postgresql_client_encoding }}		# actually, defaults to database
{% endif %}
					# encoding

# These settings are initialized by initdb, but they can be changed.
lc_messages = '{{ postgresql_lc_messages }}'			# locale for system error message
					# strings
lc_monetary = '{{ postgresql_lc_monetary }}'			# locale for monetary formatting
lc_numeric = '{{ postgresql_lc_numeric }}'			# locale for number formatting
lc_time = '{{ postgresql_lc_time }}'				# locale for time formatting

# default configuration for text search
default_text_search_config = '{{ postgresql_default_text_search_config }}'

# - Shared Library Preloading -

shared_preload_libraries = '{{ postgresql_shared_preload_libraries | join(',') }}'	# (change requires restart)
local_preload_libraries = '{{ postgresql_local_preload_libraries | join(',') }}'
session_preload_libraries = '{{ postgresql_session_preload_libraries | join(',') }}'
jit_provider = '{{ postgresql_jit_provider }}'		# JIT library to use

# - Other Defaults -

dynamic_library_path = '{{ postgresql_dynamic_library_path }}'


#------------------------------------------------------------------------------
# LOCK MANAGEMENT
#------------------------------------------------------------------------------

deadlock_timeout = {{ postgresql_deadlock_timeout }}
max_locks_per_transaction = {{ postgresql_max_locks_per_transaction }}		# min 10
					# (change requires restart)
max_pred_locks_per_transaction = {{ postgresql_max_pred_locks_per_transaction }}	# min 10
					# (change requires restart)
max_pred_locks_per_relation = {{ postgresql_max_pred_locks_per_relation }}	# negative values mean
					# (max_pred_locks_per_transaction
					#  / -max_pred_locks_per_relation) - 1
max_pred_locks_per_page = {{ postgresql_max_pred_locks_per_page }}            # min 0


#------------------------------------------------------------------------------
# VERSION AND PLATFORM COMPATIBILITY
#------------------------------------------------------------------------------

# - Previous PostgreSQL Versions -

array_nulls = {{ 'on' if postgresql_array_nulls else 'off' }}
backslash_quote = {{ postgresql_backslash_quote }}	# on, off, or safe_encoding
escape_string_warning = {{ 'on' if postgresql_escape_string_warning else 'off' }}
lo_compat_privileges = {{ 'on' if postgresql_lo_compat_privileges else 'off' }}
operator_precedence_warning = {{ 'on' if postgresql_operator_precedence_warning else 'off' }}
quote_all_identifiers = {{ 'on' if postgresql_quote_all_identifiers else 'off' }}
standard_conforming_strings = {{ 'on' if postgresql_standard_conforming_strings else 'off' }}
synchronize_seqscans = {{ 'on' if postgresql_synchronize_seqscans else 'off' }}

# - Other Platforms and Clients -

transform_null_equals = {{ 'on' if postgresql_transform_null_equals else 'off' }}


#------------------------------------------------------------------------------
# ERROR HANDLING
#------------------------------------------------------------------------------

exit_on_error = {{ 'on' if postgresql_exit_on_error else 'off' }}			# terminate session on any error?
restart_after_crash = {{ 'on' if postgresql_restart_after_crash else 'off' }}		# reinitialize after backend crash?
data_sync_retry = {{ 'on' if postgresql_data_sync_retry else 'off' }}			# retry or panic on failure to fsync
                                        # data?
                                        # (change requires restart)


#------------------------------------------------------------------------------
# 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 = '{{ postgresql_include_dir }}'                    # include files ending in '.conf' from
                                        # a directory, e.g., 'conf.d'
{{ '#' if not postgresql_include_if_exists | bool else '' }}include_if_exists = '{{ postgresql_include_if_exists }}'	# include file only if it exists
{{ '#' if not postgresql_include | bool else '' }}include = '{{ postgresql_include }}'		# include file


#------------------------------------------------------------------------------
# CUSTOMIZED OPTIONS
#------------------------------------------------------------------------------

# Add settings for extensions here