# 2202G — invalid_tablesample_repeat

> PostgreSQL SQLSTATE 2202G 的来源与诊断参考。
---

# 2202G

## 速览 {#at-a-glance}
TABLESAMPLE 的 REPEATABLE seed 为 NULL 时无效。固定执行器路径报告 `TABLESAMPLE REPEATABLE parameter cannot be null`。

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `2202G` |
| 条件名 | `invalid_tablesample_repeat` |
| 状态 | `有效` |
| 已知存在于 | `9.5.0` |
| 锁定快照 | `9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3` |
| 宏 | `ERRCODE_INVALID_TABLESAMPLE_REPEAT` |
| 别名 | `—` |

<!-- source facts: data/errcodes/2202G.json -->
<!-- END SQLSTATE FACTS -->

## 报文 {#messages}
执行器守卫使用以下首要文本：

| 守卫 | 首要文本 |
| --- | --- |
| `REPEATABLE` 表达式为 NULL | `TABLESAMPLE REPEATABLE parameter cannot be null` |

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

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

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

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

## 相关 {#related}
[`2202H`](../2202h/)、[`22004`](../22004/)

## 来源 {#sources}
执行器在 [`src/backend/executor/nodeSamplescan.c#L232-267`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/executor/nodeSamplescan.c#L232) 中先求值方法参数，再求值可选的 repeat 表达式。结构化[证据记录](../../data/evidence/2202g.json)保留 2202G 守卫及其与 2202H 的边界；本页未运行自然案例。