pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
表 9.44展示了那些可以用于查询以及修改运行时配置参数的函数。
表 9.44. 配置设定函数
| Name | Return Type | 描述 |
|---|---|---|
|
text |
获取设置的当前值 |
|
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 | 描述 |
|---|---|---|
|
int |
取消后端的当前查询 |
该函数成功时返回 1,不成功则返回 0。活动后端的进程 ID(pid)可以从pg_stat_activity视图的procpid列中找到,或者通过用ps列出服务器上的postgres进程得到。
表 9.46中列出的函数有助于进行在线备份。这些函数仅限超级用户使用。
表 9.46. 备份控制函数
| Name | Return Type | 描述 |
|---|---|---|
|
text |
准备执行在线备份 |
|
text |
结束在线备份 |
pg_start_backup接受单个参数,它是一个任意的用户自定义备份标签。(通常是备份转储文件将要保存的名称。)该函数把一个备份标签文件写入数据库集簇的数据目录,然后以文本形式返回备份的起始 WAL 偏移。用户不必关注这个结果值,但提供它只是以防它有用。
pg_stop_backup 删除 pg_start_backup 创建的标签文件,并在 WAL 归档区域创建一个备份历史文件。历史文件包括传给 pg_start_backup 的标签、备份的起止 WAL 偏移以及备份的起止时间。返回值是备份的结束 WAL 偏移(同样可以忽略)。
有关正确使用这些函数的详细信息,参见第 22.3 节。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。