当前位置：首页 > article >正文

postgresql.conf与postgresql.auto.conf区别

article 2024/11/16 6:19:26

1. 简介

PostgreSQL 9.4版本开始引入postgresql.auto.conf 配置文件，作为postgresql.conf文件的补充，在配置文件格式上，它和postgresql.conf保持一致

1.1 postgresql.conf

这是一个静态的参数文件，包含了数据库服务器的基本配置信息。

该文件中的配置参数可以直接在文本编辑器中修改，并且这些修改会立即生效，无需重启数据库服务器。

一些常见的配置选项包括监听地址（listen_addresses）、日志级别（log_level）、备份相关设置（archive_command, archive_cleanup_command）等。

1.2 postgresql.auto.conf

1.2.1 创建原理

对于postgresql.conf、postgresql.auto.conf两个配置文件，他们均位于src/bin/initdb/initdb.c文件中的setup_config()函数内部完成。首先创建postres.conf文件，创建成功之后，再创建postgresql.auto.conf文件。
在这里插入图片描述

这是一个动态的参数文件，其内容在数据库运行过程中由 PostgreSQL 自动生成和修改。

该文件主要用于存储那些在postgresql.conf 中没有显式设置，但数据库运行时又需要的参数。

postgresql.auto.conf 文件的优先级高于 postgresql.conf，即如果两个文件中存在相同的配置项，系统会优先使用 postgresql.auto.conf 中的值。

由于 postgresql.auto.conf 的内容是动态生成的，因此不能直接使用文本编辑器修改，而必须通过 ALTER SYSTEM 命令在 psql 中进行修改。

2. 差异

2.1 文件默认内容不同

postgresql.conf文件创建成功之后，里面有PostgreSQL依赖的默认配置文件参数，比如“最大连接数、共享缓存区、时区等等”

max_connections = 100
shared_buffers = 128MB	
temp_buffers = 8MB

postgresql.auto.conf 配置文件，一开始除了两行文本注释说明之外，没有其他配置参数

# Do not edit this file manually!
# It will be overwritten by the ALTER SYSTEM command.
authentication_timeout = '80'
default_transaction_isolation = 'repeatable read'

2.2 文件修改方式不同

postgresql.auto.conf配置文件中初始化时的文本字符串提示一样：
不要手动修改该文件，它会被ALTER SYSTEM 命令给覆盖
该文件主要存储ALTER SYSTEM 命令设置的参数值。

2.2.1 ALTER SYSTEM 语句

ALTER SYSTEM语句是PG库的一个扩展，它用于在PostgreSQL数据库集群中修改服务器的配置参数。然后修改后的参数将保存在postgresql.auto.conf配置文件中。

ALTER SYSTEM的使用格式如下：

ALTER SYSTEM SET configuration_parameter {TO|=} {value|'value'|default}
ALTER SYSTEM RESET configuration_parameter
ALTER SYSTEM RESET ALL

覆盖参数值，postgresql.conf参数值不变。因为postgresql.auto.conf 文件的优先级高于 postgresql.conf

2.2.2 实验

template1=# show port;
 port
------
 5432
(1 行记录)

template1=# alter system set port=5435;
ALTER SYSTEM

postgresql.auto.conf
新增一条记录

port = 5435

template1=# show port;
 port
------
 5432
(1 行记录)


template1=# select pg_reload_conf();
 pg_reload_conf
----------------
 t
(1 行记录)

template1=# show port;
 port
------
 5432
(1 行记录)


template1=# alter system reset port;
ALTER SYSTEM