↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0
历史版本PostgreSQL 8.0 已于 2010 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

9.20. 系统管理函数 #

表 9.44展示了那些可以用于查询以及修改运行时配置参数的函数。

表 9.44. 配置设定函数

Name Return Type 描述
current_setting(setting_name) text 获取设置的当前值
set_config(setting_name, new_value, is_local) text 设置参数并返回新值

函数current_setting返回设置setting_name的当前值。它对应于SQL命令SHOW。例如:

SELECT current_setting('datestyle');

 current_setting
-----------------
 ISO, MDY
(1 row)

set_config将参数setting_name设置为new_value。如果is_local为true,新值仅适用于当前事务。如果要让新值适用于当前会话,请改用false。该函数对应于 SQL 命令SET。例如:

SELECT set_config('log_statement_stats', 'off', false);

 set_config
------------
 off
(1 row)

表 9.45中展示的函数向其他服务器进程发送控制信号。该函数仅限超级用户使用。

表 9.45. Backend Signalling Functions

Name Return Type 描述
pg_cancel_backend(pid) int 取消后端的当前查询

该函数成功时返回 1,不成功则返回 0。活动后端的进程 ID(pid)可以从pg_stat_activity视图的procpid列中找到,或者通过用ps列出服务器上的postgres进程得到。

表 9.46中列出的函数有助于进行在线备份。这些函数仅限超级用户使用。

表 9.46. 备份控制函数

Name Return Type 描述
pg_start_backup(label_text) text 准备执行在线备份
pg_stop_backup() text 结束在线备份

pg_start_backup接受单个参数,它是一个任意的用户自定义备份标签。(通常是备份转储文件将要保存的名称。)该函数把一个备份标签文件写入数据库集簇的数据目录,然后以文本形式返回备份的起始 WAL 偏移。用户不必关注这个结果值,但提供它只是以防它有用。

pg_stop_backup 删除 pg_start_backup 创建的标签文件,并在 WAL 归档区域创建一个备份历史文件。历史文件包括传给 pg_start_backup 的标签、备份的起止 WAL 偏移以及备份的起止时间。返回值是备份的结束 WAL 偏移(同样可以忽略)。

有关正确使用这些函数的详细信息,参见第 22.3 节。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。