目录

gin_pending_list_limit

一个控制 GIN 待定列表大小的系统参数

gin_pending_list_limit 是一个 配置参数，用于确定 GIN 待定条目列表的最大大小。

gin_pending_list_limit 在 PostgreSQL 9.5 中添加。

用法

如果创建 GIN 索引时启用了 fastupdate（这是默认设置），则新的索引条目将添加到待定列表中，这比让单个语句直接将条目写入索引要快。然而，在某个时候，列表需要被写入索引；这会在以下任一情况发生时发生：

  • 发生一个更新 GIN 索引的 DML 操作，并且待定列表超过了 gin_pending_list_limit。
  • 待定列表超过了 gin_pending_list_limit，并且索引的表被 vacuumed。
  • 在索引上执行了 gin_clean_pending_list()。

gin_pending_list_limit 也可以作为 GIN 索引的存储参数来定义。

可以使用 contrib 模块 pgstattuple 中的 pgstatginindex() 函数来查询当前 GIN 待定列表的大小。

默认值

对于 gin_pending_list_limit，默认值为：4MB。

按 PostgreSQL 版本详细信息

gin_pending_list_limit (PostgreSQL 19)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 18)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 17)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 16)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 15)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 14)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 13)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 12)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 11)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 10)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 9.6)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

gin_pending_list_limit (PostgreSQL 9.5)

设置 4096
单位 kB
类别 客户端连接默认值 / 语句行为
简短描述 设置 GIN 索引待定列表的最大大小。
扩展描述  
上下文 user
变量类型 整数
来源 默认
最小值 64
最大值 2147483647
枚举值  
启动值 4096
重置值 4096
源文件  
源行  
需要重启 false

文档： gin_pending_list_limit

变更历史

分类

GUC 配置项, 索引

另请参阅

gin_clean_pending_list(), pgstattuple

反馈

提交任何关于“gin_pending_list_limit”的评论、建议或修正 在此处。