Doc: improve a couple of comments in postgresql.conf.sample.
[pgsql.git] / src / backend / utils / misc / postgresql.conf.sample
blob770118ad5e37c06ca8feb74338dba6eb154019db
1 # -----------------------------
2 # PostgreSQL configuration file
3 # -----------------------------
5 # This file consists of lines of the form:
7 #   name = value
9 # (The "=" is optional.)  Whitespace may be used.  Comments are introduced with
10 # "#" anywhere on a line.  The complete list of parameter names and allowed
11 # values can be found in the PostgreSQL documentation.
13 # The commented-out settings shown in this file represent the default values.
14 # Re-commenting a setting is NOT sufficient to revert it to the default value;
15 # you need to reload the server.
17 # This file is read on server startup and when the server receives a SIGHUP
18 # signal.  If you edit the file on a running system, you have to SIGHUP the
19 # server for the changes to take effect, run "pg_ctl reload", or execute
20 # "SELECT pg_reload_conf()".  Some parameters, which are marked below,
21 # require a server shutdown and restart to take effect.
23 # Any parameter can also be given as a command-line option to the server, e.g.,
24 # "postgres -c log_connections=on".  Some parameters can be changed at run time
25 # with the "SET" SQL command.
27 # Memory units:  B  = bytes            Time units:  us  = microseconds
28 #                kB = kilobytes                     ms  = milliseconds
29 #                MB = megabytes                     s   = seconds
30 #                GB = gigabytes                     min = minutes
31 #                TB = terabytes                     h   = hours
32 #                                                   d   = days
35 #------------------------------------------------------------------------------
36 # FILE LOCATIONS
37 #------------------------------------------------------------------------------
39 # The default values of these variables are driven from the -D command-line
40 # option or PGDATA environment variable, represented here as ConfigDir.
42 #data_directory = 'ConfigDir'           # use data in another directory
43                                         # (change requires restart)
44 #hba_file = 'ConfigDir/pg_hba.conf'     # host-based authentication file
45                                         # (change requires restart)
46 #ident_file = 'ConfigDir/pg_ident.conf' # ident configuration file
47                                         # (change requires restart)
49 # If external_pid_file is not explicitly set, no extra PID file is written.
50 #external_pid_file = ''                 # write an extra PID file
51                                         # (change requires restart)
54 #------------------------------------------------------------------------------
55 # CONNECTIONS AND AUTHENTICATION
56 #------------------------------------------------------------------------------
58 # - Connection Settings -
60 #listen_addresses = 'localhost'         # what IP address(es) to listen on;
61                                         # comma-separated list of addresses;
62                                         # defaults to 'localhost'; use '*' for all
63                                         # (change requires restart)
64 #port = 5432                            # (change requires restart)
65 #max_connections = 100                  # (change requires restart)
66 #reserved_connections = 0               # (change requires restart)
67 #superuser_reserved_connections = 3     # (change requires restart)
68 #unix_socket_directories = '/tmp'       # comma-separated list of directories
69                                         # (change requires restart)
70 #unix_socket_group = ''                 # (change requires restart)
71 #unix_socket_permissions = 0777         # begin with 0 to use octal notation
72                                         # (change requires restart)
73 #bonjour = off                          # advertise server via Bonjour
74                                         # (change requires restart)
75 #bonjour_name = ''                      # defaults to the computer name
76                                         # (change requires restart)
78 # - TCP settings -
79 # see "man tcp" for details
81 #tcp_keepalives_idle = 0                # TCP_KEEPIDLE, in seconds;
82                                         # 0 selects the system default
83 #tcp_keepalives_interval = 0            # TCP_KEEPINTVL, in seconds;
84                                         # 0 selects the system default
85 #tcp_keepalives_count = 0               # TCP_KEEPCNT;
86                                         # 0 selects the system default
87 #tcp_user_timeout = 0                   # TCP_USER_TIMEOUT, in milliseconds;
88                                         # 0 selects the system default
90 #client_connection_check_interval = 0   # time between checks for client
91                                         # disconnection while running queries;
92                                         # 0 for never
94 # - Authentication -
96 #authentication_timeout = 1min          # 1s-600s
97 #password_encryption = scram-sha-256    # scram-sha-256 or md5
98 #scram_iterations = 4096
100 # GSSAPI using Kerberos
101 #krb_server_keyfile = 'FILE:${sysconfdir}/krb5.keytab'
102 #krb_caseins_users = off
103 #gss_accept_delegation = off
105 # - SSL -
107 #ssl = off
108 #ssl_ca_file = ''
109 #ssl_cert_file = 'server.crt'
110 #ssl_crl_file = ''
111 #ssl_crl_dir = ''
112 #ssl_key_file = 'server.key'
113 #ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'       # allowed SSL ciphers
114 #ssl_prefer_server_ciphers = on
115 #ssl_ecdh_curve = 'prime256v1'
116 #ssl_min_protocol_version = 'TLSv1.2'
117 #ssl_max_protocol_version = ''
118 #ssl_dh_params_file = ''
119 #ssl_passphrase_command = ''
120 #ssl_passphrase_command_supports_reload = off
123 #------------------------------------------------------------------------------
124 # RESOURCE USAGE (except WAL)
125 #------------------------------------------------------------------------------
127 # - Memory -
129 #shared_buffers = 128MB                 # min 128kB
130                                         # (change requires restart)
131 #huge_pages = try                       # on, off, or try
132                                         # (change requires restart)
133 #huge_page_size = 0                     # zero for system default
134                                         # (change requires restart)
135 #temp_buffers = 8MB                     # min 800kB
136 #max_prepared_transactions = 0          # zero disables the feature
137                                         # (change requires restart)
138 # Caution: it is not advisable to set max_prepared_transactions nonzero unless
139 # you actively intend to use prepared transactions.
140 #work_mem = 4MB                         # min 64kB
141 #hash_mem_multiplier = 2.0              # 1-1000.0 multiplier on hash table work_mem
142 #maintenance_work_mem = 64MB            # min 1MB
143 #autovacuum_work_mem = -1               # min 1MB, or -1 to use maintenance_work_mem
144 #logical_decoding_work_mem = 64MB       # min 64kB
145 #max_stack_depth = 2MB                  # min 100kB
146 #shared_memory_type = mmap              # the default is the first option
147                                         # supported by the operating system:
148                                         #   mmap
149                                         #   sysv
150                                         #   windows
151                                         # (change requires restart)
152 #dynamic_shared_memory_type = posix     # the default is usually the first option
153                                         # supported by the operating system:
154                                         #   posix
155                                         #   sysv
156                                         #   windows
157                                         #   mmap
158                                         # (change requires restart)
159 #min_dynamic_shared_memory = 0MB        # (change requires restart)
160 #vacuum_buffer_usage_limit = 256kB      # size of vacuum and analyze buffer access strategy ring;
161                                         # 0 to disable vacuum buffer access strategy;
162                                         # range 128kB to 16GB
164 # - Disk -
166 #temp_file_limit = -1                   # limits per-process temp file space
167                                         # in kilobytes, or -1 for no limit
169 #max_notify_queue_pages = 1048576       # limits the number of SLRU pages allocated
170                                                                         # for NOTIFY / LISTEN queue
172 # - Kernel Resources -
174 #max_files_per_process = 1000           # min 64
175                                         # (change requires restart)
177 # - Cost-Based Vacuum Delay -
179 #vacuum_cost_delay = 0                  # 0-100 milliseconds (0 disables)
180 #vacuum_cost_page_hit = 1               # 0-10000 credits
181 #vacuum_cost_page_miss = 2              # 0-10000 credits
182 #vacuum_cost_page_dirty = 20            # 0-10000 credits
183 #vacuum_cost_limit = 200                # 1-10000 credits
185 # - Background Writer -
187 #bgwriter_delay = 200ms                 # 10-10000ms between rounds
188 #bgwriter_lru_maxpages = 100            # max buffers written/round, 0 disables
189 #bgwriter_lru_multiplier = 2.0          # 0-10.0 multiplier on buffers scanned/round
190 #bgwriter_flush_after = 0               # measured in pages, 0 disables
192 # - Asynchronous Behavior -
194 #backend_flush_after = 0                # measured in pages, 0 disables
195 #effective_io_concurrency = 1           # 1-1000; 0 disables prefetching
196 #maintenance_io_concurrency = 10        # 1-1000; 0 disables prefetching
197 #max_worker_processes = 8               # (change requires restart)
198 #max_parallel_workers_per_gather = 2    # limited by max_parallel_workers
199 #max_parallel_maintenance_workers = 2   # limited by max_parallel_workers
200 #max_parallel_workers = 8               # number of max_worker_processes that
201                                         # can be used in parallel operations
202 #parallel_leader_participation = on
205 #------------------------------------------------------------------------------
206 # WRITE-AHEAD LOG
207 #------------------------------------------------------------------------------
209 # - Settings -
211 #wal_level = replica                    # minimal, replica, or logical
212                                         # (change requires restart)
213 #fsync = on                             # flush data to disk for crash safety
214                                         # (turning this off can cause
215                                         # unrecoverable data corruption)
216 #synchronous_commit = on                # synchronization level;
217                                         # off, local, remote_write, remote_apply, or on
218 #wal_sync_method = fsync                # the default is the first option
219                                         # supported by the operating system:
220                                         #   open_datasync
221                                         #   fdatasync (default on Linux and FreeBSD)
222                                         #   fsync
223                                         #   fsync_writethrough
224                                         #   open_sync
225 #full_page_writes = on                  # recover from partial page writes
226 #wal_log_hints = off                    # also do full page writes of non-critical updates
227                                         # (change requires restart)
228 #wal_compression = off                  # enables compression of full-page writes;
229                                         # off, pglz, lz4, zstd, or on
230 #wal_init_zero = on                     # zero-fill new WAL files
231 #wal_recycle = on                       # recycle WAL files
232 #wal_buffers = -1                       # min 32kB, -1 sets based on shared_buffers
233                                         # (change requires restart)
234 #wal_writer_delay = 200ms               # 1-10000 milliseconds
235 #wal_writer_flush_after = 1MB           # measured in pages, 0 disables
236 #wal_skip_threshold = 2MB
238 #commit_delay = 0                       # range 0-100000, in microseconds
239 #commit_siblings = 5                    # range 1-1000
241 # - Checkpoints -
243 #checkpoint_timeout = 5min              # range 30s-1d
244 #checkpoint_completion_target = 0.9     # checkpoint target duration, 0.0 - 1.0
245 #checkpoint_flush_after = 0             # measured in pages, 0 disables
246 #checkpoint_warning = 30s               # 0 disables
247 #max_wal_size = 1GB
248 #min_wal_size = 80MB
250 # - Prefetching during recovery -
252 #recovery_prefetch = try        # prefetch pages referenced in the WAL?
253 #wal_decode_buffer_size = 512kB # lookahead window used for prefetching
254                                 # (change requires restart)
256 # - Archiving -
258 #archive_mode = off             # enables archiving; off, on, or always
259                                 # (change requires restart)
260 #archive_library = ''           # library to use to archive a WAL file
261                                 # (empty string indicates archive_command should
262                                 # be used)
263 #archive_command = ''           # command to use to archive a WAL file
264                                 # placeholders: %p = path of file to archive
265                                 #               %f = file name only
266                                 # e.g. 'test ! -f /mnt/server/archivedir/%f && cp %p /mnt/server/archivedir/%f'
267 #archive_timeout = 0            # force a WAL file switch after this
268                                 # number of seconds; 0 disables
270 # - Archive Recovery -
272 # These are only used in recovery mode.
274 #restore_command = ''           # command to use to restore an archived WAL file
275                                 # placeholders: %p = path of file to restore
276                                 #               %f = file name only
277                                 # e.g. 'cp /mnt/server/archivedir/%f %p'
278 #archive_cleanup_command = ''   # command to execute at every restartpoint
279 #recovery_end_command = ''      # command to execute at completion of recovery
281 # - Recovery Target -
283 # Set these only when performing a targeted recovery.
285 #recovery_target = ''           # 'immediate' to end recovery as soon as a
286                                 # consistent state is reached
287                                 # (change requires restart)
288 #recovery_target_name = ''      # the named restore point to which recovery will proceed
289                                 # (change requires restart)
290 #recovery_target_time = ''      # the time stamp up to which recovery will proceed
291                                 # (change requires restart)
292 #recovery_target_xid = ''       # the transaction ID up to which recovery will proceed
293                                 # (change requires restart)
294 #recovery_target_lsn = ''       # the WAL LSN up to which recovery will proceed
295                                 # (change requires restart)
296 #recovery_target_inclusive = on # Specifies whether to stop:
297                                 # just after the specified recovery target (on)
298                                 # just before the recovery target (off)
299                                 # (change requires restart)
300 #recovery_target_timeline = 'latest'    # 'current', 'latest', or timeline ID
301                                         # (change requires restart)
302 #recovery_target_action = 'pause'       # 'pause', 'promote', 'shutdown'
303                                         # (change requires restart)
305 # - WAL Summarization -
307 #summarize_wal = off                     # run WAL summarizer process?
308 #wal_summary_keep_time = '10d' # when to remove old summary files, 0 = never
311 #------------------------------------------------------------------------------
312 # REPLICATION
313 #------------------------------------------------------------------------------
315 # - Sending Servers -
317 # Set these on the primary and on any standby that will send replication data.
319 #max_wal_senders = 10           # max number of walsender processes
320                                 # (change requires restart)
321 #max_replication_slots = 10     # max number of replication slots
322                                 # (change requires restart)
323 #wal_keep_size = 0              # in megabytes; 0 disables
324 #max_slot_wal_keep_size = -1    # in megabytes; -1 disables
325 #wal_sender_timeout = 60s       # in milliseconds; 0 disables
326 #track_commit_timestamp = off   # collect timestamp of transaction commit
327                                 # (change requires restart)
329 # - Primary Server -
331 # These settings are ignored on a standby server.
333 #synchronous_standby_names = '' # standby servers that provide sync rep
334                                 # method to choose sync standbys, number of sync standbys,
335                                 # and comma-separated list of application_name
336                                 # from standby(s); '*' = all
338 # - Standby Servers -
340 # These settings are ignored on a primary server.
342 #primary_conninfo = ''                  # connection string to sending server
343 #primary_slot_name = ''                 # replication slot on sending server
344 #hot_standby = on                       # "off" disallows queries during recovery
345                                         # (change requires restart)
346 #max_standby_archive_delay = 30s        # max delay before canceling queries
347                                         # when reading WAL from archive;
348                                         # -1 allows indefinite delay
349 #max_standby_streaming_delay = 30s      # max delay before canceling queries
350                                         # when reading streaming WAL;
351                                         # -1 allows indefinite delay
352 #wal_receiver_create_temp_slot = off    # create temp slot if primary_slot_name
353                                         # is not set
354 #wal_receiver_status_interval = 10s     # send replies at least this often
355                                         # 0 disables
356 #hot_standby_feedback = off             # send info from standby to prevent
357                                         # query conflicts
358 #wal_receiver_timeout = 60s             # time that receiver waits for
359                                         # communication from primary
360                                         # in milliseconds; 0 disables
361 #wal_retrieve_retry_interval = 5s       # time to wait before retrying to
362                                         # retrieve WAL after a failed attempt
363 #recovery_min_apply_delay = 0           # minimum delay for applying changes during recovery
365 # - Subscribers -
367 # These settings are ignored on a publisher.
369 #max_logical_replication_workers = 4    # taken from max_worker_processes
370                                         # (change requires restart)
371 #max_sync_workers_per_subscription = 2  # taken from max_logical_replication_workers
372 #max_parallel_apply_workers_per_subscription = 2        # taken from max_logical_replication_workers
375 #------------------------------------------------------------------------------
376 # QUERY TUNING
377 #------------------------------------------------------------------------------
379 # - Planner Method Configuration -
381 #enable_async_append = on
382 #enable_bitmapscan = on
383 #enable_gathermerge = on
384 #enable_hashagg = on
385 #enable_hashjoin = on
386 #enable_incremental_sort = on
387 #enable_indexscan = on
388 #enable_indexonlyscan = on
389 #enable_material = on
390 #enable_memoize = on
391 #enable_mergejoin = on
392 #enable_nestloop = on
393 #enable_parallel_append = on
394 #enable_parallel_hash = on
395 #enable_partition_pruning = on
396 #enable_partitionwise_join = off
397 #enable_partitionwise_aggregate = off
398 #enable_presorted_aggregate = on
399 #enable_seqscan = on
400 #enable_sort = on
401 #enable_tidscan = on
402 #enable_group_by_reordering = on
404 # - Planner Cost Constants -
406 #seq_page_cost = 1.0                    # measured on an arbitrary scale
407 #random_page_cost = 4.0                 # same scale as above
408 #cpu_tuple_cost = 0.01                  # same scale as above
409 #cpu_index_tuple_cost = 0.005           # same scale as above
410 #cpu_operator_cost = 0.0025             # same scale as above
411 #parallel_setup_cost = 1000.0           # same scale as above
412 #parallel_tuple_cost = 0.1              # same scale as above
413 #min_parallel_table_scan_size = 8MB
414 #min_parallel_index_scan_size = 512kB
415 #effective_cache_size = 4GB
417 #jit_above_cost = 100000                # perform JIT compilation if available
418                                         # and query more expensive than this;
419                                         # -1 disables
420 #jit_inline_above_cost = 500000         # inline small functions if query is
421                                         # more expensive than this; -1 disables
422 #jit_optimize_above_cost = 500000       # use expensive JIT optimizations if
423                                         # query is more expensive than this;
424                                         # -1 disables
426 # - Genetic Query Optimizer -
428 #geqo = on
429 #geqo_threshold = 12
430 #geqo_effort = 5                        # range 1-10
431 #geqo_pool_size = 0                     # selects default based on effort
432 #geqo_generations = 0                   # selects default based on effort
433 #geqo_selection_bias = 2.0              # range 1.5-2.0
434 #geqo_seed = 0.0                        # range 0.0-1.0
436 # - Other Planner Options -
438 #default_statistics_target = 100        # range 1-10000
439 #constraint_exclusion = partition       # on, off, or partition
440 #cursor_tuple_fraction = 0.1            # range 0.0-1.0
441 #from_collapse_limit = 8
442 #jit = on                               # allow JIT compilation
443 #join_collapse_limit = 8                # 1 disables collapsing of explicit
444                                         # JOIN clauses
445 #plan_cache_mode = auto                 # auto, force_generic_plan or
446                                         # force_custom_plan
447 #recursive_worktable_factor = 10.0      # range 0.001-1000000
450 #------------------------------------------------------------------------------
451 # REPORTING AND LOGGING
452 #------------------------------------------------------------------------------
454 # - Where to Log -
456 #log_destination = 'stderr'             # Valid values are combinations of
457                                         # stderr, csvlog, jsonlog, syslog, and
458                                         # eventlog, depending on platform.
459                                         # csvlog and jsonlog require
460                                         # logging_collector to be on.
462 # This is used when logging to stderr:
463 #logging_collector = off                # Enable capturing of stderr, jsonlog,
464                                         # and csvlog into log files. Required
465                                         # to be on for csvlogs and jsonlogs.
466                                         # (change requires restart)
468 # These are only used if logging_collector is on:
469 #log_directory = 'log'                  # directory where log files are written,
470                                         # can be absolute or relative to PGDATA
471 #log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'        # log file name pattern,
472                                                         # can include strftime() escapes
473 #log_file_mode = 0600                   # creation mode for log files,
474                                         # begin with 0 to use octal notation
475 #log_rotation_age = 1d                  # Automatic rotation of logfiles will
476                                         # happen after that time.  0 disables.
477 #log_rotation_size = 10MB               # Automatic rotation of logfiles will
478                                         # happen after that much log output.
479                                         # 0 disables.
480 #log_truncate_on_rotation = off         # If on, an existing log file with the
481                                         # same name as the new log file will be
482                                         # truncated rather than appended to.
483                                         # But such truncation only occurs on
484                                         # time-driven rotation, not on restarts
485                                         # or size-driven rotation.  Default is
486                                         # off, meaning append to existing files
487                                         # in all cases.
489 # These are relevant when logging to syslog:
490 #syslog_facility = 'LOCAL0'
491 #syslog_ident = 'postgres'
492 #syslog_sequence_numbers = on
493 #syslog_split_messages = on
495 # This is only relevant when logging to eventlog (Windows):
496 # (change requires restart)
497 #event_source = 'PostgreSQL'
499 # - When to Log -
501 #log_min_messages = warning             # values in order of decreasing detail:
502                                         #   debug5
503                                         #   debug4
504                                         #   debug3
505                                         #   debug2
506                                         #   debug1
507                                         #   info
508                                         #   notice
509                                         #   warning
510                                         #   error
511                                         #   log
512                                         #   fatal
513                                         #   panic
515 #log_min_error_statement = error        # values in order of decreasing detail:
516                                         #   debug5
517                                         #   debug4
518                                         #   debug3
519                                         #   debug2
520                                         #   debug1
521                                         #   info
522                                         #   notice
523                                         #   warning
524                                         #   error
525                                         #   log
526                                         #   fatal
527                                         #   panic (effectively off)
529 #log_min_duration_statement = -1        # -1 is disabled, 0 logs all statements
530                                         # and their durations, > 0 logs only
531                                         # statements running at least this number
532                                         # of milliseconds
534 #log_min_duration_sample = -1           # -1 is disabled, 0 logs a sample of statements
535                                         # and their durations, > 0 logs only a sample of
536                                         # statements running at least this number
537                                         # of milliseconds;
538                                         # sample fraction is determined by log_statement_sample_rate
540 #log_statement_sample_rate = 1.0        # fraction of logged statements exceeding
541                                         # log_min_duration_sample to be logged;
542                                         # 1.0 logs all such statements, 0.0 never logs
545 #log_transaction_sample_rate = 0.0      # fraction of transactions whose statements
546                                         # are logged regardless of their duration; 1.0 logs all
547                                         # statements from all transactions, 0.0 never logs
549 #log_startup_progress_interval = 10s    # Time between progress updates for
550                                         # long-running startup operations.
551                                         # 0 disables the feature, > 0 indicates
552                                         # the interval in milliseconds.
554 # - What to Log -
556 #debug_print_parse = off
557 #debug_print_rewritten = off
558 #debug_print_plan = off
559 #debug_pretty_print = on
560 #log_autovacuum_min_duration = 10min    # log autovacuum activity;
561                                         # -1 disables, 0 logs all actions and
562                                         # their durations, > 0 logs only
563                                         # actions running at least this number
564                                         # of milliseconds.
565 #log_checkpoints = on
566 #log_connections = off
567 #log_disconnections = off
568 #log_duration = off
569 #log_error_verbosity = default          # terse, default, or verbose messages
570 #log_hostname = off
571 #log_line_prefix = '%m [%p] '           # special values:
572                                         #   %a = application name
573                                         #   %u = user name
574                                         #   %d = database name
575                                         #   %r = remote host and port
576                                         #   %h = remote host
577                                         #   %b = backend type
578                                         #   %p = process ID
579                                         #   %P = process ID of parallel group leader
580                                         #   %t = timestamp without milliseconds
581                                         #   %m = timestamp with milliseconds
582                                         #   %n = timestamp with milliseconds (as a Unix epoch)
583                                         #   %Q = query ID (0 if none or not computed)
584                                         #   %i = command tag
585                                         #   %e = SQL state
586                                         #   %c = session ID
587                                         #   %l = session line number
588                                         #   %s = session start timestamp
589                                         #   %v = virtual transaction ID
590                                         #   %x = transaction ID (0 if none)
591                                         #   %q = stop here in non-session
592                                         #        processes
593                                         #   %% = '%'
594                                         # e.g. '<%u%%%d> '
595 #log_lock_waits = off                   # log lock waits >= deadlock_timeout
596 #log_recovery_conflict_waits = off      # log standby recovery conflict waits
597                                         # >= deadlock_timeout
598 #log_parameter_max_length = -1          # when logging statements, limit logged
599                                         # bind-parameter values to N bytes;
600                                         # -1 means print in full, 0 disables
601 #log_parameter_max_length_on_error = 0  # when logging an error, limit logged
602                                         # bind-parameter values to N bytes;
603                                         # -1 means print in full, 0 disables
604 #log_statement = 'none'                 # none, ddl, mod, all
605 #log_replication_commands = off
606 #log_temp_files = -1                    # log temporary files equal or larger
607                                         # than the specified size in kilobytes;
608                                         # -1 disables, 0 logs all temp files
609 #log_timezone = 'GMT'
611 # - Process Title -
613 #cluster_name = ''                      # added to process titles if nonempty
614                                         # (change requires restart)
615 #update_process_title = on
618 #------------------------------------------------------------------------------
619 # STATISTICS
620 #------------------------------------------------------------------------------
622 # - Cumulative Query and Index Statistics -
624 #track_activities = on
625 #track_activity_query_size = 1024       # (change requires restart)
626 #track_counts = on
627 #track_io_timing = off
628 #track_wal_io_timing = off
629 #track_functions = none                 # none, pl, all
630 #stats_fetch_consistency = cache        # cache, none, snapshot
633 # - Monitoring -
635 #compute_query_id = auto
636 #log_statement_stats = off
637 #log_parser_stats = off
638 #log_planner_stats = off
639 #log_executor_stats = off
642 #------------------------------------------------------------------------------
643 # AUTOVACUUM
644 #------------------------------------------------------------------------------
646 #autovacuum = on                        # Enable autovacuum subprocess?  'on'
647                                         # requires track_counts to also be on.
648 #autovacuum_max_workers = 3             # max number of autovacuum subprocesses
649                                         # (change requires restart)
650 #autovacuum_naptime = 1min              # time between autovacuum runs
651 #autovacuum_vacuum_threshold = 50       # min number of row updates before
652                                         # vacuum
653 #autovacuum_vacuum_insert_threshold = 1000      # min number of row inserts
654                                                 # before vacuum; -1 disables insert
655                                                 # vacuums
656 #autovacuum_analyze_threshold = 50      # min number of row updates before
657                                         # analyze
658 #autovacuum_vacuum_scale_factor = 0.2   # fraction of table size before vacuum
659 #autovacuum_vacuum_insert_scale_factor = 0.2    # fraction of inserts over table
660                                                 # size before insert vacuum
661 #autovacuum_analyze_scale_factor = 0.1  # fraction of table size before analyze
662 #autovacuum_freeze_max_age = 200000000  # maximum XID age before forced vacuum
663                                         # (change requires restart)
664 #autovacuum_multixact_freeze_max_age = 400000000        # maximum multixact age
665                                                         # before forced vacuum
666                                                         # (change requires restart)
667 #autovacuum_vacuum_cost_delay = 2ms     # default vacuum cost delay for
668                                         # autovacuum, in milliseconds;
669                                         # -1 means use vacuum_cost_delay
670 #autovacuum_vacuum_cost_limit = -1      # default vacuum cost limit for
671                                         # autovacuum, -1 means use
672                                         # vacuum_cost_limit
675 #------------------------------------------------------------------------------
676 # CLIENT CONNECTION DEFAULTS
677 #------------------------------------------------------------------------------
679 # - Statement Behavior -
681 #client_min_messages = notice           # values in order of decreasing detail:
682                                         #   debug5
683                                         #   debug4
684                                         #   debug3
685                                         #   debug2
686                                         #   debug1
687                                         #   log
688                                         #   notice
689                                         #   warning
690                                         #   error
691 #search_path = '"$user", public'        # schema names
692 #row_security = on
693 #default_table_access_method = 'heap'
694 #default_tablespace = ''                # a tablespace name, '' uses the default
695 #default_toast_compression = 'pglz'     # 'pglz' or 'lz4'
696 #temp_tablespaces = ''                  # a list of tablespace names, '' uses
697                                         # only default tablespace
698 #check_function_bodies = on
699 #default_transaction_isolation = 'read committed'
700 #default_transaction_read_only = off
701 #default_transaction_deferrable = off
702 #session_replication_role = 'origin'
703 #statement_timeout = 0                          # in milliseconds, 0 is disabled
704 #lock_timeout = 0                               # in milliseconds, 0 is disabled
705 #idle_in_transaction_session_timeout = 0        # in milliseconds, 0 is disabled
706 #idle_session_timeout = 0                       # in milliseconds, 0 is disabled
707 #vacuum_freeze_table_age = 150000000
708 #vacuum_freeze_min_age = 50000000
709 #vacuum_failsafe_age = 1600000000
710 #vacuum_multixact_freeze_table_age = 150000000
711 #vacuum_multixact_freeze_min_age = 5000000
712 #vacuum_multixact_failsafe_age = 1600000000
713 #bytea_output = 'hex'                   # hex, escape
714 #xmlbinary = 'base64'
715 #xmloption = 'content'
716 #gin_pending_list_limit = 4MB
717 #createrole_self_grant = ''             # set and/or inherit
718 #event_triggers = on
720 # - Locale and Formatting -
722 #datestyle = 'iso, mdy'
723 #intervalstyle = 'postgres'
724 #timezone = 'GMT'
725 #timezone_abbreviations = 'Default'     # Select the set of available time zone
726                                         # abbreviations.  Currently, there are
727                                         #   Default
728                                         #   Australia (historical usage)
729                                         #   India
730                                         # You can create your own file in
731                                         # share/timezonesets/.
732 #extra_float_digits = 1                 # min -15, max 3; any value >0 actually
733                                         # selects precise output mode
734 #client_encoding = sql_ascii            # actually, defaults to database
735                                         # encoding
737 # These settings are initialized by initdb, but they can be changed.
738 #lc_messages = ''                       # locale for system error message
739                                         # strings
740 #lc_monetary = 'C'                      # locale for monetary formatting
741 #lc_numeric = 'C'                       # locale for number formatting
742 #lc_time = 'C'                          # locale for time formatting
744 #icu_validation_level = warning         # report ICU locale validation
745                                         # errors at the given level
747 # default configuration for text search
748 #default_text_search_config = 'pg_catalog.simple'
750 # - Shared Library Preloading -
752 #local_preload_libraries = ''
753 #session_preload_libraries = ''
754 #shared_preload_libraries = ''          # (change requires restart)
755 #jit_provider = 'llvmjit'               # JIT library to use
757 # - Other Defaults -
759 #dynamic_library_path = '$libdir'
760 #gin_fuzzy_search_limit = 0
763 #------------------------------------------------------------------------------
764 # LOCK MANAGEMENT
765 #------------------------------------------------------------------------------
767 #deadlock_timeout = 1s
768 #max_locks_per_transaction = 64         # min 10
769                                         # (change requires restart)
770 #max_pred_locks_per_transaction = 64    # min 10
771                                         # (change requires restart)
772 #max_pred_locks_per_relation = -2       # negative values mean
773                                         # (max_pred_locks_per_transaction
774                                         #  / -max_pred_locks_per_relation) - 1
775 #max_pred_locks_per_page = 2            # min 0
778 #------------------------------------------------------------------------------
779 # VERSION AND PLATFORM COMPATIBILITY
780 #------------------------------------------------------------------------------
782 # - Previous PostgreSQL Versions -
784 #array_nulls = on
785 #backslash_quote = safe_encoding        # on, off, or safe_encoding
786 #escape_string_warning = on
787 #lo_compat_privileges = off
788 #quote_all_identifiers = off
789 #standard_conforming_strings = on
790 #synchronize_seqscans = on
792 # - Other Platforms and Clients -
794 #transform_null_equals = off
797 #------------------------------------------------------------------------------
798 # ERROR HANDLING
799 #------------------------------------------------------------------------------
801 #exit_on_error = off                    # terminate session on any error?
802 #restart_after_crash = on               # reinitialize after backend crash?
803 #data_sync_retry = off                  # retry or panic on failure to fsync
804                                         # data?
805                                         # (change requires restart)
806 #recovery_init_sync_method = fsync      # fsync, syncfs (Linux 5.8+)
809 #------------------------------------------------------------------------------
810 # CONFIG FILE INCLUDES
811 #------------------------------------------------------------------------------
813 # These options allow settings to be loaded from files other than the
814 # default postgresql.conf.  Note that these are directives, not variable
815 # assignments, so they can usefully be given more than once.
817 #include_dir = '...'                    # include files ending in '.conf' from
818                                         # a directory, e.g., 'conf.d'
819 #include_if_exists = '...'              # include file only if it exists
820 #include = '...'                        # include file
823 #------------------------------------------------------------------------------
824 # CUSTOMIZED OPTIONS
825 #------------------------------------------------------------------------------
827 # Add settings for extensions here