从零开始学PostgreSQL (二)： 配置文件

文件位置
data_directory            指定用于数据存储的目录。此参数只能在服务器启动时设置。
config_file               指定主服务器配置文件
hba_file                  指定基于主机的身份验证的配置文件
ident_file                指定用户名映射的配置文件
external_pid_file         指定服务器应创建的以供服务器管理程序使用的其他进程 ID （PID） 文件的名称

连接设置
listen_addresses = '*'          # 监听的 IP 地址；
                                        # 使用逗号分隔的地址列表；
                                        # 默认为 'localhost'；使用 '*' 表示所有地址
                                        # （修改后需要重新启动）
port = 5432                             # 端口号（修改后需要重新启动）
max_connections = 2000                  # 确定与数据库服务器的最大并发连接数。默认值通常为 100 个连接（修改后需要重新启动）
#reserved_connections = 0               # 保留连接数（修改后需要重新启动）
#superuser_reserved_connections = 3     # 超级用户保留连接数（修改后需要重新启动）
#unix_socket_directories = '/run/postgresql' # 逗号分隔的目录列表（修改后需要重新启动）
#unix_socket_group = ''                 # Unix socket 的群组（修改后需要重新启动）
#unix_socket_permissions = 0777         # 使用八进制表示的权限（修改后需要重新启动）
#bonjour = off                          # 通过 Bonjour 发布服务器信息（修改后需要重新启动）
#bonjour_name = ''                      # 默认为计算机名称（修改后需要重新启动）

TCP 设置
#tcp_keepalives_idle = 0                # 指定没有网络活动的时间，在此之后，操作系统应向客户端发送 TCP keepalive 消息，单位为秒；0 选择系统默认值
#tcp_keepalives_interval = 0            # 指定应重新传输客户端未确认的 TCP keepalive 消息的时间量，单位为秒；0 选择系统默认值
#tcp_keepalives_count = 0               # 指定在服务器与客户端的连接被视为失效之前可能丢失的 TCP keepalive 消息数；0 选择系统默认值
#tcp_user_timeout = 0                   # 指定在强制关闭 TCP 连接之前，传输的数据可能保持未确认状态的时间量，单位为毫秒；0 选择系统默认值
#client_connection_check_interval = 0   # 在运行查询时检查客户端断开连接的时间间隔；0 表示从不检查

认证设置
#authentication_timeout = 1min          # 认证超时时间，范围为 1 秒至 600 秒
#password_encryption = scram-sha-256    # 密码加密方式，可以是 scram-sha-256 或 md5
#scram_iterations = 4096                # SCRAM 加密迭代次数
#db_user_namespace = off                # 是否启用数据库用户命名空间

# 使用 Kerberos 的 GSSAPI 认证
#krb_server_keyfile = 'FILE:${sysconfdir}/krb5.keytab'  # Kerberos 服务端密钥文件路径
#krb_caseins_users = off                # 是否区分大小写的用户名称
#gss_accept_delegation = off            # 是否接受委派

SSL设置
#ssl = off                             # 是否启用 SSL
#ssl_ca_file = ''                      # CA 证书文件路径
#ssl_cert_file = 'server.crt'          # 服务器证书文件路径
#ssl_crl_file = ''                     # 撤销列表文件路径
#ssl_crl_dir = ''                      # 撤销列表目录路径
#ssl_key_file = 'server.key'           # 服务器私钥文件路径
#ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL' # 允许的 SSL 加密算法
#ssl_prefer_server_ciphers = on        # 是否优先使用服务器端加密算法
#ssl_ecdh_curve = 'prime256v1'         # ECDH 曲线
#ssl_min_protocol_version = 'TLSv1.2'  # 最小的 SSL 协议版本
#ssl_max_protocol_version = ''         # 最大的 SSL 协议版本
#ssl_dh_params_file = ''               # DH 参数文件路径
#ssl_passphrase_command = ''           # SSL 密码短语命令
#ssl_passphrase_command_supports_reload = off  # SSL 密码短语命令是否支持重新加载


内存设置
shared_buffers = 128MB                  # 共享缓冲区大小，默认为 128kB（修改后需要重新启动）
#huge_pages = try                       # 使用巨大页面的设置，可以是 on、off 或 try（修改后需要重新启动）
#huge_page_size = 0                     # 巨大页面的大小，0 表示使用系统默认值（修改后需要重新启动）
#temp_buffers = 8MB                     # 临时缓冲区大小，最小为 800kB
#max_prepared_transactions = 0          # 最大预处理事务数，0 表示禁用该功能 （修改后需要重新启动）
# 注意：不建议将 max_prepared_transactions 设置为非零，除非你确实打算使用预处理事务。

#work_mem = 4MB                         # 每个工作进程可用的内存大小，最小为 64kB
#hash_mem_multiplier = 2.0              # 哈希表工作内存的倍数，范围为 1 到 1000.0
#maintenance_work_mem = 64MB            # 维护操作使用的内存大小，最小为 1MB
#autovacuum_work_mem = -1               # 自动清理操作使用的内存大小，最小为 1MB，-1 表示使用 maintenance_work_mem
#logical_decoding_work_mem = 64MB       # 逻辑解码操作使用的内存大小，最小为 64kB
#max_stack_depth = 2MB                  # 栈深度的最大值，最小为 100kB
#shared_memory_type = mmap              # 共享内存的类型，默认为操作系统支持的第一个选项：（修改后需要重新启动）
                                        #   mmap
                                        #   sysv
                                        #   windows
dynamic_shared_memory_type = posix      # 动态共享内存的类型，默认为操作系统支持的第一个选项：（修改后需要重新启动）
                                        #   posix
                                        #   sysv
                                        #   windows
                                        #   mmap
#min_dynamic_shared_memory = 0MB        # 最小动态共享内存大小
#vacuum_buffer_usage_limit = 256kB      # 清理和分析缓冲区访问策略环的大小；
                                        # 0 表示禁用清理缓冲区访问策略；


磁盘
#temp_file_limit = -1                   # 每个进程临时文件空间限制，单位为千字节，-1 表示无限制
基于成本的清理延迟
#vacuum_cost_delay = 0                  # 超过成本限制时进程将休眠的时间量，单位为毫秒（0 表示禁用）
#vacuum_cost_page_hit = 1               # 在共享缓冲区缓存中找到的缓冲区进行清空的估计成本
#vacuum_cost_page_miss = 2              # 清理必须从磁盘读取的缓冲区的估计成本
#vacuum_cost_page_dirty = 20            # 页面脏数据时的成本
#vacuum_cost_limit = 200                # 当吸尘操作累计的成本达到多少时，吸尘进程将进入休眠状态
后台写入进程
#bgwriter_delay = 200ms                 # 每轮之间的延迟时间，单位为毫秒
#bgwriter_lru_maxpages = 100            # 每轮最多写入的缓冲区数，0 表示禁用
#bgwriter_lru_multiplier = 2.0          # 每轮中写入的脏缓冲区数基于服务器进程在最近几轮中所需的新缓冲区数
#bgwriter_flush_after = 512kB           # 每当后台编写器写入的数据量超过此量时，请尝试强制操作系统向底层存储发出这些写入，0 表示禁用
异步行为
#backend_flush_after = 0                # 每当单个后端写入的数据量超过此量时，请尝试强制操作系统将这些写入事件发到底层存储，以页为单位，0 表示禁用
#effective_io_concurrency = 1           # 可以同时执行的并发磁盘 I/O 操作数，范围为 1 到 1000；0 表示禁用预取
#maintenance_io_concurrency = 10        # 用于指定在执行维护操作（如 VACUUM、REINDEX 等）时，允许并发 IO 操作的数量，范围为 1 到 1000；0 表示禁用预取
#max_worker_processes = 8               # 最大工作进程数（修改后需要重新启动）
#max_parallel_workers_per_gather = 2    # 每次并行操作的最大并行工作进程数，受 max_parallel_workers 限制
#max_parallel_maintenance_workers = 2   # 并行维护工作进程的最大数，受 max_parallel_workers 限制
#max_parallel_workers = 8               # 可以在并行操作中使用的最大工作进程数，默认值为 8
#parallel_leader_participation = on     # 并行操作中是否允许主进程参与
#old_snapshot_threshold = -1            # 设置使用查询快照时可以使用查询快照的最短时间，而不会出现“快照太旧”错误的风险。，单位为分钟到天数；-1 表示禁用；0 表示立即
                                        # （修改后需要重新启动）
预写日志
wal_level = replica                    # WAL 日志级别，可以是 minimal（最小）、replica（复制）、logical（逻辑）
                                       # （修改后需要重启）
fsync = on                             # 是否将数据刷新到磁盘以确保崩溃安全性（关闭此选项可能导致不可恢复的数据损坏）
synchronous_commit = on                # 同步提交级别（指定在数据库服务器向客户端返回“成功”指示之前必须完成的 WAL 处理）；
                                       # off、local、remote_write、remote_apply 或 on
wal_sync_method = fsync                # WAL 同步方法，默认为操作系统支持的第一个选项：
                                       #   open_datasync（使用选项写入 WAL 文件open()O_DSYNC)
                                       #   fdatasync（每次提交时调用）（Linux 和 FreeBSD 上的默认选项）
                                       #   fsync（每次提交时调用）
                                       #   fsync_writethrough（每次提交时调用，强制写入任何磁盘写入缓存）
                                       #   open_sync（使用选项写入 WAL 文件）
full_page_writes = on                 # 从部分页面写入中恢复
wal_log_hints = off                   # 是否对非关键更新也执行全页写入
                                       # （修改后需要重启）
wal_compression = off                 # 启用全页写入的压缩；
                                       # off、pglz、lz4、zstd 或 on
wal_init_zero = on                    # 新的 WAL 文件是否进行零填充
wal_recycle = on                      # 回收 WAL 文件
wal_buffers = -1                      # WAL 缓冲区大小，最小为 32kB，-1 根据 shared_buffers 设置
                                       # （修改后需要重启）
wal_writer_delay = 200ms              # 指定 WAL 编写器刷新 WAL 的频率，以时间为单位，毫秒
wal_writer_flush_after = 1MB          # 指定 WAL 编写器刷新 WAL 的频率，以页面计量，0 禁用
wal_skip_threshold = 2MB              # 跳过 WAL 的阈值（当 is 和 事务在创建或重写永久关系后提交时，此设置确定如何保留新数据）

commit_delay = 0                      # 提交延迟，范围 0-100000，单位为微秒
commit_siblings = 5                   # 同时进行提交的事务数，范围 1-1000

检查点设置
#checkpoint_timeout = 5min              # 自动 WAL 检查点之间的最长时间，范围 30秒-1天
#checkpoint_completion_target = 0.9     # 检查点完成目标时长，范围 0.0 - 1.0
#checkpoint_flush_after = 256kB         # 每多少页刷新检查点，0 表示禁用
#checkpoint_warning = 30s               # 检查点警告时间，0 表示禁用
max_wal_size = 1GB                      # WAL 日志文件最大大小
min_wal_size = 80MB                     # WAL 日志文件最小大小

# - 恢复过程中的预取设置 -

#recovery_prefetch = try                # 是否预取WAL中引用的页面？
#wal_decode_buffer_size = 512kB         # 预取时的前瞻窗口大小 (需要重启生效)
归档
# - 归档设置 -
#archive_mode = off             # 启用归档; off, on, or always(更改需重启)
#archive_library = ''           # 用于归档WAL文件的库
                                # (空字符串表示使用archive_command)
#archive_command = ''           # 用于归档WAL文件的命令
                                # 占位符: %p = 要归档的文件路径
                                #         %f = 仅文件名
                                # 例如: 'test ! -f /mnt/server/archivedir/%f && cp %p /mnt/server/archivedir/%f'
#archive_timeout = 0            # 在多少秒后强制切换到下一个WAL文件; 0 表示禁用

# - 归档恢复 -

# 以下仅在恢复模式中使用。
#restore_command = ''           # 用于恢复已归档WAL文件的命令
                                # 占位符: %p = 要恢复的文件路径
                                #         %f = 仅文件名
                                # 例如: 'cp /mnt/server/archivedir/%f %p'
#archive_cleanup_command = ''   # 每次重启点执行的清理归档命令
#recovery_end_command = ''      # 恢复完成时执行的命令

恢复目标设置
# 仅在执行有针对性的恢复时设置这些选项。

#recovery_target = ''           # 设置为 'immediate' 可以在达到一致状态后立即结束恢复(更改需重启)
#recovery_target_name = ''      # 恢复到指定的命名恢复点 (更改需重启)
#recovery_target_time = ''      # 恢复到指定的时间戳 (更改需重启)
#recovery_target_xid = ''       # 恢复到指定的事务ID(更改需重启)
#recovery_target_lsn = ''       # 恢复到指定的WAL LSN (更改需重启)
#recovery_target_inclusive = on # 指定停止的方式:
                                # 在指定恢复目标之后（on）
                                # 在指定恢复目标之前（off） (更改需重启)
#recovery_target_timeline = 'latest'    # 恢复到特定的时间线: 'current', 'latest' 或时间线ID (更改需重启)
#recovery_target_action = 'pause'       # 恢复目标后应执行的操作: 'pause', 'promote', 'shutdown' (更改需重启)

复制
# - 发送服务器设置 -

# 在主服务器和任何将发送复制数据的备用服务器上设置这些选项。
#max_wal_senders = 10           # walsender 进程的最大数量(更改需重启)
#max_replication_slots = 10     # 复制插槽的最大数量(更改需重启)
#wal_keep_size = 0              # 保留的WAL文件大小，单位为MB；0 表示禁用
#max_slot_wal_keep_size = -1    # 每个插槽保留的WAL文件大小，单位为MB；-1 表示禁用
#wal_sender_timeout = 60s       # walsender 的超时时间，单位为毫秒；0 表示禁用
#track_commit_timestamp = off   # 是否收集事务提交的时间戳
                                # (更改需重启)

# - 主服务器设置 

# 这些设置在备用服务器上会被忽略。
#synchronous_standby_names = '' # 提供同步复制的备用服务器
                                # 可以选择同步备用服务器、同步备用服务器的数量，
                                # 以及以逗号分隔的应用程序名称列表
                                # '*' 表示所有备用服务器

# - 备用服务器设置 -

# 这些设置在主服务器上会被忽略。
#primary_conninfo = ''                  # 发送服务器的连接字符串
#primary_slot_name = ''                 # 发送服务器上的复制插槽名称
#hot_standby = on                       # "off" 在恢复期间禁止查询(更改需重启)
#max_standby_archive_delay = 30s        # 从归档中读取WAL时取消查询的最大延迟时间 -1 表示无限延迟
#max_standby_streaming_delay = 30s      # 从流式WAL中读取取消查询的最大延迟时间 -1 表示无限延迟
#wal_receiver_create_temp_slot = off    # 如果未设置primary_slot_name，则创建临时插槽
#wal_receiver_status_interval = 10s     # 至少每隔此时间发送一次响应 0 禁用
#hot_standby_feedback = off             # 从备用服务器发送信息以防止查询冲突
#wal_receiver_timeout = 60s             # 接收者等待主服务器通信的时间 单位为毫秒；0 禁用
#wal_retrieve_retry_interval = 5s       # 在失败尝试后重新尝试检索WAL之前等待的时间
#recovery_min_apply_delay = 0           # 恢复期间应用更改的最小延迟时间

# - 订阅者设置 -

# 这些设置在发布者上会被忽略。
#max_logical_replication_workers = 4    # 指定逻辑复制工作线程的最大数量，从max_worker_processes中获取(更改需重启)
#max_sync_workers_per_subscription = 2  # 每个订阅的最大同步工作线程数，从max_logical_replication_workers中获取
#max_parallel_apply_workers_per_subscription = 2        # 每个订阅的最大并行应用工作线程数，从max_logical_replication_workers中获取
查询优化
# - 查询计划方法配置 -

#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     启用或禁用查询计划器对 TID 扫描计划类型的使用

# - 查询计划成本常量 -

#seq_page_cost = 1.0          # 设置计划员对磁盘页读取成本的估计值，该读取是一系列顺序读取的一部分
#random_page_cost = 4.0       # 设置计划员对非顺序提取的磁盘页的成本的估计值
#cpu_tuple_cost = 0.01        # 设置计划员对查询期间处理每一行的成本的估计值
#cpu_index_tuple_cost = 0.005 # 设置计划员对索引扫描期间处理每个索引条目的成本的估计值
#cpu_operator_cost = 0.0025   # 设置计划员对处理查询期间执行的每个运算符或函数的成本的估计值
#parallel_setup_cost = 1000.0 # 设置计划员对启动并行工作进程的成本的估计
#parallel_tuple_cost = 0.1    # 设置计划员对将一个元组从一个并行工作进程转移到另一个进程的成本的估计值
#min_parallel_table_scan_size = 8MB  设置必须扫描的最小表数据量，以便考虑并行扫描
#min_parallel_index_scan_size = 512kB  设置必须扫描的索引数据的最小量，以便考虑并行扫描
#effective_cache_size = 4GB   设置计划器对可用于单个查询的磁盘缓存的有效大小的假设

#jit_above_cost = 100000         # 如果查询比这个成本昂贵，则执行JIT编译；-1 禁用
#jit_inline_above_cost = 500000  # 如果查询比这个成本昂贵，则内联小函数；-1 禁用
#jit_optimize_above_cost = 500000 # 如果查询比这个成本昂贵，则使用昂贵的JIT优化；-1 禁用

# - 遗传查询优化器 -

#geqo = on    启用或禁用遗传查询优化
#geqo_threshold = 12      使用遗传查询优化来规划至少涉及这么多项的查询
#geqo_effort = 5             # 范围 1-10
#geqo_pool_size = 0          # 根据工作量选择默认值
#geqo_generations = 0        # 根据工作量选择默认值
#geqo_selection_bias = 2.0   # 范围 1.5-2.0
#geqo_seed = 0.0             # 范围 0.0-1.0

# - 其他查询计划选项 -

#default_statistics_target = 100    # 范围 1-10000
#constraint_exclusion = partition  # 控制查询计划器对表约束的使用，以优化查询。on、off 或 partition
#cursor_tuple_fraction = 0.1       # 设置计划器对将要检索的游标行的比例的估计值 范围 0.0-1.0
#from_collapse_limit = 8
#jit = on                          # 允许 JIT 编译
#join_collapse_limit = 8           # 1 禁用显式 JOIN 子句的折叠
#plan_cache_mode = auto            # auto、force_generic_plan 或 force_custom_plan
#recursive_worktable_factor = 10.0 # 范围 0.001-1000000

报告和日志记录
# - 日志位置 -
log_destination = 'stderr'     # 有效值是 stderr、csvlog、jsonlog、syslog 和 eventlog，取决于平台
logging_collector = on         # 启用捕获 stderr、jsonlog 和 csvlog 到日志文件。需要启用此项才能使用 csvlog 和 jsonlog。（更改需要重启）

# 只有在 logging_collector 启用时才会使用以下选项：
log_directory = 'log'         # 日志文件写入的目录，可以是绝对路径或相对于 PGDATA 的路径
log_filename = 'postgresql-%a.log'  # 日志文件名模式，可以包含 strftime() 转义字符
#log_file_mode = 0600         # 日志文件的创建模式，以 0 开始使用八进制表示
log_rotation_age = 1d         # 自动轮换日志文件的时间间隔。0 禁用。
log_rotation_size = 0         # 自动轮换日志文件的输出大小。0 禁用。
log_truncate_on_rotation = on # 如果启用，同名的旧日志文件会被截断而不是追加。但此种截断仅在基于时间的轮换时发生，不包括重启或基于大小的轮换。默认为关闭，即在所有情况下追加到现有文件。

# - 何时记录日志 -

#log_min_messages = warning           # 记录消息的最低级别: debug5 debug4 debug3 debug2  debug1  info notice warning error log fatal panic

#log_min_error_statement = error      # 记录错误语句的最低级别: debug5 debug4 debug3 debug2  debug1  info notice warning error log fatal 
                                      # panic  (实际上是禁用的)
#log_min_duration_statement = -1      # -1 表示禁用，0 记录所有语句及其持续时间，> 0 仅记录运行时间至少为指定毫秒数的语句
#log_min_duration_sample = -1         # -1 表示禁用，0 记录样本语句及其持续时间，> 0 仅记录运行时间至少为指定毫秒数的样本语句；
                                      # 样本比例由 log_statement_sample_rate 决定
#log_statement_sample_rate = 1.0      # 超过 log_min_duration_sample 的语句的记录比例；
                                      # 1.0 记录所有这样的语句，0.0 从不记录
#log_transaction_sample_rate = 0.0    # 不考虑其持续时间，记录语句的事务比例；
                                      # 1.0 记录所有事务的语句，0.0 从不记录
#log_startup_progress_interval = 10s  # 长时间运行的启动操作之间的进度更新时间。
                                      # 0 禁用此功能，> 0 表示以毫秒为间隔

# - 记录内容 -

#debug_print_parse = off
#debug_print_rewritten = off
#debug_print_plan = off
#debug_pretty_print = on
#log_autovacuum_min_duration = 10min  # 记录自动清理活动；
                                      # -1 禁用，0 记录所有操作及其持续时间，> 0 仅记录运行时间至少为指定毫秒数的操作
#log_checkpoints = on                导致在服务器日志中记录检查点和重新启动点
#log_connections = off             导致记录与服务器的每次尝试连接，以及成功完成客户端身份验证（如有必要）和授权
#log_disconnections = off            导致记录会话终止
#log_duration = off                   导致记录每个已完成的语句的持续时间
#log_error_verbosity = default       # 简洁、默认或详细消息
#log_hostname = off                      连接日志消息仅显示连接主机的 IP 地址
log_line_prefix = '%m [%p] '         # 特殊值:
                                      #   %a = 应用程序名称
                                      #   %u = 用户名
                                      #   %d = 数据库名称
                                      #   %r = 远程主机和端口
                                      #   %h = 远程主机
                                      #   %b = 后端类型
                                      #   %p = 进程 ID
                                      #   %P = 并行组的进程 ID
                                      #   %t = 没有毫秒的时间戳
                                      #   %m = 带毫秒的时间戳
                                      #   %n = 带毫秒的时间戳（Unix epoch格式）
                                      #   %Q = 查询 ID（如果没有或未计算为 0）
                                      #   %i = 命令标签
                                      #   %e = SQL 状态
                                      #   %c = 会话 ID
                                      #   %l = 会话行号
                                      #   %s = 会话启动时间戳
                                      #   %v = 虚拟事务 ID
                                      #   %x = 事务 ID（如果没有为 0）
                                      #   %q = 非会话进程中止
                                      #   %% = '%'
                                      # 例如 '<%u%%%d> '
#log_lock_waits = off                 # 记录锁等待 >= 死锁超时的锁
#log_recovery_conflict_waits = off    # 记录备用恢复冲突等待 >= 死锁超时
#log_parameter_max_length = -1        # 记录语句时，将绑定参数值限制为 N 字节；-1 表示完整打印，0 禁用
#log_parameter_max_length_on_error = 0 # 记录错误时，将绑定参数值限制为 N 字节；-1 表示完整打印，0 禁用
#log_statement = 'none'               # none、ddl、mod、all
#log_replication_commands = off
#log_temp_files = -1                 # 记录临时文件等于或大于指定大小的文件（以 KB 为单位）；-1 禁用，0 记录所有临时文件
log_timezone = 'Asia/Shanghai'

# - 进程标题 -
#cluster_name = ''                   # 如果非空，添加到进程标题中（更改需要重新启动）
#update_process_title = on

统计信息
# - 累积查询和索引统计 -

#track_activities = on
#track_activity_query_size = 1024  # (修改后需要重新启动)
#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
监控
#compute_query_id = auto  启用查询标识符的核心计算
#log_statement_stats = off
#log_parser_stats = off
#log_planner_stats = off
#log_executor_stats = off
自动清理
#autovacuum = on                  # 启用自动清理子进程？'on' 需要同时启用 track_counts。
#autovacuum_max_workers = 3       # 最大自动清理子进程数 (修改后需要重新启动)
#autovacuum_naptime = 1min        # 自动清理运行之间的时间间隔
#autovacuum_vacuum_threshold = 50 # 执行 VACUUM 前更新的最小行数
#autovacuum_vacuum_insert_threshold = 1000 # 执行 VACUUM 前插入的最小行数；-1 禁用插入 VACUUM
#autovacuum_analyze_threshold = 50 # 执行 ANALYZE 前更新的最小行数
#autovacuum_vacuum_scale_factor = 0.2 # VACUUM 执行前表大小的分数
#autovacuum_vacuum_insert_scale_factor = 0.2 # 插入 VACUUM 执行前插入数量与表大小的分数
#autovacuum_analyze_scale_factor = 0.1 # ANALYZE 执行前表大小的分数
#autovacuum_freeze_max_age = 200000000 # 强制执行 VACUUM 前的最大 XID 年龄 (修改后需要重新启动)
#autovacuum_multixact_freeze_max_age = 400000000 # 强制执行 VACUUM 前的最大 multixact 年龄 (修改后需要重新启动)
#autovacuum_vacuum_cost_delay = 2ms # 自动 VACUUM 的默认 VACUUM 成本延迟，以毫秒为单位；-1 表示使用 vacuum_cost_delay
#autovacuum_vacuum_cost_limit = -1 # 自动 VACUUM 的默认 VACUUM 成本限制；-1 表示使用 vacuum_cost_limit
客户端连接默认值
# - 语句行为 -
#client_min_messages = notice    # 消息的最低级别:debug5 debug4 debug3 debug2  debug1 log  notice warning error 
#search_path = '"$user", public' # 模式名称
#row_security = on
#default_table_access_method = 'heap'
#default_tablespace = ''         # 表空间名称，'' 使用默认
#default_toast_compression = 'pglz' # 'pglz' 或 'lz4'
#temp_tablespaces = ''           # 表空间名称列表，'' 只使用默认表空间
#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           # 毫秒为单位，0 表示禁用
#lock_timeout = 0                # 毫秒为单位，0 表示禁用
#idle_in_transaction_session_timeout = 0 # 毫秒为单位，0 表示禁用
#idle_session_timeout = 0        # 毫秒为单位，0 表示禁用
#vacuum_freeze_table_age = 150000000   #参数决定了在 VACUUM 进行冻结操作前，一个表的事务年龄（从上次 VACUUM 到现在的事务数）应该达到多少
#vacuum_freeze_min_age = 50000000     #这个参数控制了行版本在被标记为冻结前需要有多“老”
#vacuum_failsafe_age = 1600000000     #参数设置了一个绝对的界限，当事务 ID 的年龄接近这个值时，系统将开始发出警告，提醒管理员采取行动
#vacuum_multixact_freeze_table_age = 150000000  #与 vacuum_freeze_table_age 类似，但针对多事务 ID。当一个多事务的年龄超过这个设置时，将触发冻结操作
#vacuum_multixact_freeze_min_age = 5000000   # 控制多事务 ID 在被冻结前需要有多“老”
#vacuum_multixact_failsafe_age = 1600000000  #与 vacuum_failsafe_age 相似，但用于多事务 ID，设置了一个绝对的界限，以避免多事务 ID 环绕问题
#bytea_output = 'hex'            # hex, escape
#xmlbinary = 'base64'
#xmloption = 'content'
#gin_pending_list_limit = 4MB
#createrole_self_grant = ''      # 设置和/或继承
区域设置和格式化
datestyle = 'iso, mdy'
#intervalstyle = 'postgres'
timezone = 'Asia/Shanghai'
#timezone_abbreviations = 'Default' # 选择可用时区缩写集。
                                    # 目前有
                                    #   Default
                                    #   Australia (historical usage)
                                    #   India
                                    # 您可以在 share/timezonesets/ 中创建自己的文件。
#extra_float_digits = 1           # 最小 -15，最大 3；>0 实际上选择精确输出模式
#client_encoding = sql_ascii      # 实际上，默认为数据库编码

# 这些设置由 initdb 初始化，但它们可以更改。
lc_messages = 'en_US.UTF-8'      # 系统错误消息字符串的区域设置
lc_monetary = 'en_US.UTF-8'      # 货币格式的区域设置
lc_numeric = 'en_US.UTF-8'       # 数字格式的区域设置
lc_time = 'en_US.UTF-8'          # 时间格式的区域设置

#icu_validation_level = warning   # 报告 ICU 区域设置验证错误的级别

错误处理

#exit_on_error = off             # 在任何错误时终止会话？
#restart_after_crash = on        # 后端崩溃后重新初始化？
#data_sync_retry = off           # 数据 fsync 失败时重试或紧急情况？
                                  # (修改后需要重新启动)
#recovery_init_sync_method = fsync # fsync, syncfs (Linux 5.8+)

配置文件包含设置

# 这些选项允许从除了默认 postgresql.conf 之外的文件中加载设置。
# 注意，这些是指令，而不是变量赋值，因此可以有多个有效设置。

#include_dir = '...'             # 包含以 '.conf' 结尾的文件的目录，例如 'conf.d'
#include_if_exists = '...'       # 仅在文件存在时包含文件
#include = '...'                # 包含文件
其他
# 文本搜索的默认配置
default_text_search_config = 'pg_catalog.english'

# - 共享库预加载 -

#local_preload_libraries = ''
#session_preload_libraries = ''
#shared_preload_libraries = ''    # (修改后需要重新启动)
#jit_provider = 'llvmjit'        # 要使用的 JIT 库

# - 其他默认值 -

#dynamic_library_path = '$libdir'
#gin_fuzzy_search_limit = 0


#------------------------------------------------------------------------------
# 锁管理
#------------------------------------------------------------------------------

#deadlock_timeout = 1s
#max_locks_per_transaction = 64   # 最小为 10
                                  # (修改后需要重新启动)
#max_pred_locks_per_transaction = 64 # 最小为 10
                                      # (修改后需要重新启动)
#max_pred_locks_per_relation = -2 # 负值意味着
                                  # (max_pred_locks_per_transaction
                                  #  / -max_pred_locks_per_relation) - 1
#max_pred_locks_per_page = 2      # 最小为 0


#------------------------------------------------------------------------------
# 版本和平台兼容性
#------------------------------------------------------------------------------

# - 以前的 PostgreSQL 版本 -
#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

# - 其他平台和客户端 -

#transform_null_equals = off

listen_addresses:
设置 PostgreSQL 监听的网络地址。在生产环境中，你可能需要监听所有接口或特定的 IP 地址。
port:
PostgreSQL 默认监听的端口是 5432。在生产环境中，如果需要，可以更改此端口号。
max_connections:
设定数据库服务器可以同时接受的最大连接数。根据服务器的内存和 CPU 资源，以及预期的并发用户数进行调整。
shared_buffers:
设置用于缓冲数据库块的共享内存大小。在生产环境中，通常将其设置为服务器总内存的 25% 至 40%。
effective_cache_size:
设置 PostgreSQL 应假设的缓存大小。通常设置为服务器总内存的 75%。
maintenance_work_mem:
设定在执行如 VACUUM FULL, CREATE INDEX, REINDEX 等维护操作时可以使用的内存。根据可用内存调整。
checkpoint_completion_target:
设定在检查点期间，PostgreSQL 努力完成的 I/O 操作百分比。通常设置为 0.9（90%）。
wal_level:
设置写入 WAL（Write-Ahead Log）的日志级别。在生产环境中，通常设置为 replica 或 logical，以支持流复制或逻辑解码。
wal_log_hints:
如果设置为 on，WAL 将包含额外的信息，有助于分析和调试。
log_destination:
设定日志的输出目的地。在生产环境中，通常设置为 stderr 和 syslog。
log_min_duration_statement:
设置记录慢查询的最小执行时间。根据性能监控需求调整。
log_min_error_statement:
设置记录错误的最低级别。通常设置为 error 或更高。
log_line_prefix:
设置日志记录行的前缀，通常包含数据库名和用户信息。
log_checkpoints, log_connections, log_disconnections, log_lock_waits, log_statement, log_temp_files:
控制各种事件的记录。根据监控和审计需求进行调整。
work_mem:
设置每个后台工作进程可以使用的内存。根据查询复杂性和服务器资源调整。
max_wal_senders:
设定可以同时发送 WAL 数据的最大流复制连接数。
max_replication_slots:
设定可以同时保持的最大逻辑解码复制槽数。
max_worker_processes:
设定可以同时运行的后台工作进程的最大数目。
max_parallel_workers_per_gather 和 max_parallel_workers:
控制并行查询可以使用的最大工作进程数。
ssl:
如果需要加密客户端连接，设置 SSL 相关参数。
autovacuum 相关参数:
调整 autovacuum_max_workers, autovacuum_naptime, autovacuum_vacuum_threshold, autovacuum_analyze_threshold 等参数，以适应数据库的工作负载。
archive_mode 和 archive_command:
如果使用归档模式，需要设置这些参数。