创建 Cloud SQL for PostgreSQL 只读会话

您可以使用 cloudsql_session_read_only 会话参数创建只读 Cloud SQL for PostgreSQL 会话。与标准 PostgreSQL 只读选项相比,此方法是一种更可靠的方法,可防止在会话期间修改数据。使用 cloudsql_session_read_only 参数,您可以使会话暂时或永久处于只读状态。您可以在各种场景中使用此类只读会话来帮助保护数据完整性,包括使用 Model Context Protocol (MCP) 工具、报告工具和审核工具的会话。

默认情况下,cloudsql_session_read_only 设置为 off,这允许修改数据。

只读模式会阻止哪些操作

在只读会话中,数据库无法修改任何数据。具体而言,只读模式会阻止以下操作:

  • 只读模式会阻止生成新的交易 ID。无法启动可写事务,因此无法执行任何数据操纵语言 (DML) 或数据定义语言 (DDL) 指令。但是,如果在活跃的可写事务中设置了该标志,则可以执行基本 DML 和 DDL 指令,直到事务终止。

  • 只读模式会阻止以下类型的语句和调用:

    • VACUUM 和 NOTIFY 等语句。
    • 具有副作用的函数。这意味着,您无法调用同时定义为 VOLATILE 和 LANGUAGE C 或 LANGUAGE internal 的 FUNCTION 或执行 PROCEDURE,因为它们的某些副作用不需要交易 ID。例如 pg_promote()、pg_cancel_backend() 和 pg_terminate_backend()。
    • 外部数据封装容器。
    • 您在 SQL 过程语言 (PL) 中创建的任何函数或过程。

配置只读状态

在 Cloud SQL for PostgreSQL 会话期间,您可以使用 SET 语句更改 cloudsql_session_read_only 标志的值,如下所示:

  • SET cloudsql_session_read_only = 'on'

    此语句会将该会话设为只读,从而防止任何人在该标志保持设置为 on 的情况下修改数据。如需在会话后期继续修改数据,请将值改回 off:

  • SET cloudsql_session_read_only = 'off'

    将该标志设置回 off 会恢复会话中的写入权限,除非该标志设置为 locked。

  • SET cloudsql_session_read_only = 'locked'

    将该标志设置为 locked 会使会话永久处于只读状态。 将该标志设置为 locked 后,您无法在会话期间将该标志更改为任何其他值。

如需在连接到数据库后立即将会话永久设为只读,请将会话的连接字符串中嵌入 cloudsql_session_read_only 标志:

postgresql://USER:PASSWORD@HOST:PORT/DATABASE?options=-ccloudsql_session_read_only=locked

进行以下替换:

  • USER:创建会话的用户的用户名。
  • PASSWORD:用户的密码。
  • HOST:主机网址。
  • PORT:端口号
  • DATABASE:数据库名称。

这种方法还有一个额外的好处:如果您尝试连接到不支持只读会话的旧版 Cloud SQL,连接会失败。

您还可以拒绝特定数据库用户对所有未来连接的写入权限,如下所示:

ALTER USER USERNAME SET cloudsql_session_read_only = 'locked';

将 USERNAME 替换为您要将其访问权限限制为只读的用户的用户名。

在只读会话中启用特定函数

  • 您可以启用特定 FUNCTION 或 PROCEDURE,并将其定义为 VOLATILE 和 LANGUAGE C 或 LANGUAGE internal。为此,请将 SECURITY LABEL 附加到设置为 allow 的函数或过程。
  • 如需在会话中禁止使用特定函数,请将 SECURITY LABEL 语句设置为 deny。
  • 如需将不影响全局状态的函数列入许可清单,请创建一组预定义的安全标签:

    CREATE EXTENSION "google_read_only_session"
    

    google_read_only_session 扩展程序可实现以下功能:

    • 只读模式下允许使用的所有内置易失性 C 函数。
    • 数据库中加载的扩展程序中允许在只读模式下使用的所有函数,包括 pl/pgsql 和 pl/v8 语言的处理程序函数。

    如果您之后安装了一个或多个新扩展程序,则需要删除并重新创建 google_read_only_session 扩展程序,才能应用群组标签:

    > DROP EXTENSION google_read_only_session;
    > CREATE EXTENSION google_read_only_session;
    

    DROP 命令不会移除任何现有标签。第二个 CREATE 命令只是为新扩展程序中的易失性 C 函数添加标签。

后续步骤