PostgreSQL / 系统课时

创建登录角色

创建登录角色

本课完成一个可用于应用或人员登录的 PostgreSQL 角色,并配置密码、有效期和连接上限。你还会知道这些属性何时生效,以及为什么角色创建成功后仍可能无法连接数据库。

学习目标

  • 使用 CREATE ROLE 创建可登录角色
  • 配置密码有效期和连接数限制
  • 查询并核对登录角色的关键属性

创建前的条件

执行者需要 CREATEROLE 属性或超级用户权限。建议在测试数据库先验证命令,并确认服务器使用安全的密码加密方式;生产环境还应通过密钥管理、环境变量或身份认证系统传递凭据。

角色名在集群范围内唯一,不属于某个单独数据库。创建角色时设置 LOGIN,才能把它作为数据库账户使用。

主示例:创建并检查登录角色

下面的 SQL 创建 report_user,密码有效至 2027 年末,最多允许 3 个并发连接。示例角色名不能已存在。

sql
CREATE ROLE report_user
  LOGIN
  PASSWORD 'ChangeMe_2026!'
  VALID UNTIL '2027-12-31 23:59:59+08'
  CONNECTION LIMIT 3;

SELECT
  rolname,
  rolcanlogin,
  rolconnlimit,
  to_char(
    rolvaliduntil AT TIME ZONE 'Asia/Kuala_Lumpur',
    'YYYY-MM-DD HH24:MI:SS'
  ) AS valid_until
FROM pg_roles
WHERE rolname = 'report_user';

预期结果

text
   rolname   | rolcanlogin | rolconnlimit |     valid_until
-------------+-------------+--------------+---------------------
 report_user | t           |            3 | 2027-12-31 23:59:59

VALID UNTIL 只限制密码认证的有效期,不会自动删除角色。CONNECTION LIMIT 为 -1 时表示不限制;设置为 3 后,数据库会限制该角色的普通并发会话数量。

常用维护操作

修改密码可使用 ALTER ROLE report_user PASSWORD 'NewStrongPassword';,临时禁止新登录可使用 ALTER ROLE report_user NOLOGIN;。NOLOGIN 不会主动断开已经建立的会话,需要配合会话管理完成紧急停用。

若要恢复登录,执行 ALTER ROLE report_user LOGIN;。删除角色前,应先处理它拥有的对象、成员关系和权限,否则 DROP ROLE 可能因依赖关系失败。

登录失败时的检查顺序

先确认 rolcanlogin、密码有效期和连接上限,再检查目标数据库的 CONNECT 权限。随后检查 pg_hba.conf 是否允许该来源地址、数据库和角色使用指定认证方式。

角色属性正确但认证规则未放行时,客户端仍会收到连接失败。反之,即使 pg_hba.conf 允许认证,没有 CONNECT 权限也无法进入目标数据库。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建登录角色

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

登录哪都通