54.9. pg_hba_file_rules — PostgreSQL 16

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

开发中的版本： 19 / 20devel

已结束支持的版本： 13 / 12 / 11 / 10

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

54.9. `pg_hba_file_rules` #

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

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

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

表 54.9. 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 字段有值。

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

上一页	上一级	下一页
54.8. `pg_group`	起始页	54.10. `pg_ident_file_mappings`