2202G

速览

TABLESAMPLE 的 REPEATABLE seed 为 NULL 时无效。固定执行器路径报告 TABLESAMPLE REPEATABLE parameter cannot be null。

报文

执行器守卫使用以下首要文本：

含义

在 tablesample_init 中，PostgreSQL 先求值每个 TABLESAMPLE 方法参数；参数为 NULL 时报告 2202H。随后它单独求值可选的 REPEATABLE 表达式；结果为 NULL 时进入 2202G。非 NULL 的 REPEATABLE 值已由解析器转换为 float8，再用 hashfloat8 生成采样 seed。因此本码覆盖重复采样 seed 为 NULL 的约束，不覆盖负 seed 或方法百分比范围。

诊断

检查 REPEATABLE 表达式的实际求值结果，包括可能变成 SQL NULL 的参数或函数。区分 TABLESAMPLE 方法参数为 NULL 的 2202H，以及非 NULL 但百分比、数量或时间无效且由选定方法校验的情况。首要报文可以确认是重复 seed 分支。

处理

为 REPEATABLE 提供非 NULL 表达式；如果不需要确定性重复，也可以省略该子句。若方法参数触发 2202H，应单独修正该参数。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交可重试修正后的语句。

版本

锁定目录从 9.5.0 起记录该条件；本页固定源码路径为 PostgreSQL 18.6。未声称本页有自然运行观察。

相关

2202H、22004

来源

执行器在 src/backend/executor/nodeSamplescan.c#L232-267 中先求值方法参数，再求值可选的 repeat 表达式。结构化证据记录保留 2202G 守卫及其与 2202H 的边界；本页未运行自然案例。