PostgreSQL / 系统课时

认识主要配置文件

认识主要配置文件

本课解决“PostgreSQL 的配置到底放在哪里、分别控制什么”的问题。完成后,你能从数据库内部定位实际配置文件与数据目录,并判断连接控制、服务器参数和自动写入配置分别由哪个文件负责。

学习目标

  • 定位数据目录以及主要配置文件的实际路径
  • 区分 postgresql.conf、pg_hba.conf 与 postgresql.auto.conf
  • 理解修改配置前应先确认实例与文件来源

从数据库内部定位文件

不要根据安装教程猜测路径。不同操作系统、软件包和容器镜像的目录布局可能不同,应直接连接目标实例查询。

sql
SELECT
    current_setting('data_directory') AS data_directory,
    current_setting('config_file') AS config_file,
    current_setting('hba_file') AS hba_file,
    current_setting('ident_file') AS ident_file;

预期结果

text
data_directory   | config_file                  | hba_file                  | ident_file
 | /postgresql.conf       | /pg_hba.conf        | /pg_ident.conf

实际路径会因安装方式而不同。查询结果指向当前连接实例正在使用的文件,避免误改另一套 PostgreSQL 实例。

postgresql.conf:服务器运行参数

postgresql.conf 保存内存、连接数、日志、检查点和查询行为等参数,例如 shared_buffers、max_connections、log_min_duration_statement。文件中可以包含其他配置文件,因此某个参数的最终值不一定来自主文件本身。

可通过 pg_settings.source、sourcefile 和 sourceline 查看参数的当前来源。修改前应记录原值,并确认参数是重载生效还是必须重启。

pg_hba.conf:客户端认证规则

pg_hba.conf 决定“谁可以从哪里连接哪个数据库,以及使用什么认证方式”。规则按从上到下的顺序匹配,命中第一条后便停止继续查找。

常见字段包括连接类型、数据库、用户、客户端地址和认证方法。开放远程连接时,不应简单允许全部地址,而应限制网段、用户和数据库,并优先使用安全认证方式。

数据目录与自动配置文件

数据目录保存表数据、事务日志、状态文件及实例级配置。除明确要求外,不应手工移动、复制或删除其中的运行文件。

执行 ALTER SYSTEM 后,PostgreSQL 会把设置写入数据目录中的 postgresql.auto.conf。该文件通常拥有较高配置优先级,排查“明明改了主配置却不生效”时,应同时检查它。

pg_ident.conf 用于外部系统用户名与数据库角色的映射,只有认证规则使用相应映射时才参与连接过程。

修改配置的安全顺序

先确认连接的是目标实例,再查询参数当前值与来源。修改文件后执行语法和连接验证,最后根据参数类型选择重载或重启。生产环境还应保留配置备份和变更记录,避免无法快速回滚。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识主要配置文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通