statement_timeout 是一个 配置参数，用于确定语句自动超时的时长。
statement_timeout 在 PostgreSQL 7.3 中添加。
默认值
statement_timeout 的默认值为：0（已禁用）。
用法
建议在会话级别设置 statement_timeout，而不是通过 postgresql.conf 全局设置。
按 PostgreSQL 版本分列的详细信息
statement_timeout (PostgreSQL 17)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 16)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 15)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 14)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 13)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 12)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 11)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 10)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 9.6)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 9.5)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
| 挂起的重启 |
否 |
文档: statement_timeout
statement_timeout (PostgreSQL 9.4)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
文档: statement_timeout
statement_timeout (PostgreSQL 9.3)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
文档: statement_timeout
statement_timeout (PostgreSQL 9.2)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
文档: statement_timeout
statement_timeout (PostgreSQL 9.1)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
文档: statement_timeout
statement_timeout (PostgreSQL 9.0)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
文档: statement_timeout
statement_timeout (PostgreSQL 8.4)
| 设置 |
0 |
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
0 |
| 重置值 |
0 |
| 源文件 |
|
| 源代码行号 |
|
文档: statement_timeout
statement_timeout (PostgreSQL 8.3)
| 设置 |
|
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
文档: statement_timeout
statement_timeout (PostgreSQL 8.2)
| 设置 |
|
| 单位 |
毫秒 |
| 类别 |
客户端连接默认值 / 语句行为 |
| 简短描述 |
设置任何语句允许的最大持续时间（以毫秒为单位）。 |
| 额外描述 |
值为 0 将关闭超时。 |
| 上下文 |
用户 |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
文档: statement_timeout
更改历史记录
示例
statement_timeout 的基本用法示例
postgres=# SET statement_timeout = '5s';
SET
Time: 0.793 ms
postgres=# SELECT pg_sleep(10);
ERROR: canceling statement due to statement timeout
Time: 5001.041 ms (00:05.001)
