PostgreSQL 19 文档 · 53.11. pg_hba_file

文档 → PostgreSQL 19

受支持版本：当前版本 (18) / 17 / 16 / 15 / 14

测试与开发版本： 19 / devel

不受支持的版本： 13 / 12 / 11 / 10

测试版PostgreSQL 19 Beta 4 尚未正式发布，内容与行为在正式发布前可能变化。正式内容请看当前版本。

53.11. `pg_hba_file_rules`
上一页	上一级	第 53 章系统视图	起始页	下一页

53.11. `pg_hba_file_rules` #

视图 pg_hba_file_rules 提供客户端认证配置文件 pg_hba.conf 内容的摘要。文件中每个非空且非注释的行都会在该视图中显示一行，并带有注解，说明该规则是否能成功应用。

该视图有助于检查认证配置文件中的计划变更是否可行，或诊断先前的失败。请注意，该视图报告的是文件的当前内容，而不是服务器上次加载的内容。

默认情况下，pg_hba_file_rules 视图只能由超级用户读取。

表 53.11. pg_hba_file_rules 列

列类型描述
`rule_number` `int4` 如果该规则有效，则为其编号；否则为 `NULL`。这表示认证期间在找到匹配项之前，各条规则被考虑的顺序。
`file_name` `text` 包含此规则的文件名称
`line_number` `int4` 该规则在 `file_name` 中的行号
`type` `text` 连接类型
`database` `text[]` 这条规则应用的数据库名列表
`user_name` `text[]` 这条规则应用的用户及组名列表
`address` `text` 主机名或 IP 地址，或者 `all`、`samehost`、`samenet` 之一，对于本地连接为 NULL
`netmask` `text` IP 地址掩码，如果不适用则为 NULL
`auth_method` `text` 认证方法
`options` `text[]` 为认证方法指定的选项（如果有）
`error` `text` 如果非空，则为说明为什么该行无法处理的错误消息

列类型

描述

rule_number int4

如果该规则有效，则为其编号；否则为 NULL。这表示认证期间在找到匹配项之前，各条规则被考虑的顺序。

file_name text

包含此规则的文件名称

line_number int4

该规则在 file_name 中的行号

type text

连接类型

database text[]

这条规则应用的数据库名列表

user_name text[]

这条规则应用的用户及组名列表

address text

主机名或 IP 地址，或者 all、samehost、samenet 之一，对于本地连接为 NULL

netmask text

IP 地址掩码，如果不适用则为 NULL

auth_method text

认证方法

options text[]

为认证方法指定的选项（如果有）

error text

如果非空，则为说明为什么该行无法处理的错误消息

通常，反映错误条目的行只有 line_number 和 error 字段有值。

关于客户端认证配置的更多信息，参见第 20 章。

上一页	上一级	下一页
53.10. `pg_group`	起始页	53.12. `pg_ident_file_mappings`

译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游会在正式发布前持续修订。