# 方法与术语

> GUC 大典统一使用的证据边界、生命周期规则、默认值语义、Pigsty 夹具与双语术语表。
---

所有条目都使用同一套证据模型，避免实测值在不知不觉中变成调优传说。

## 证据标签 {#evidence-labels}

| 标签 | 含义 | 发布规则 |
| --- | --- | --- |
| Fact | 直接实测，或可追溯到固定版本来源 | 带上版本、路径、链接或验证状态 |
| Analysis | 基于事实和公开机制推导的解释 | 展示推理，不冒充来源作者的原话 |
| Advice | 面向具体工作负载的运维建议 | 明示假设、取舍和需要验证的指标 |
| 待人工复核 | 对 Pigsty 取值理由的编辑推断 | 绝不写成维护者已经表达的理由 |
{.full-width}

## 生命周期规则 {#lifecycle-rules}

- 参数全集是 PostgreSQL 9.0–19 Beta 3 各版本点 `pg_settings.name` 的并集。
- **首次观测**是矩阵中第一次出现的版本点。PG9.0 表示“研究边界时已经存在”，不代表“在 PG9.0 引入”。
- **移除版本**是最后一次连续出现之后的第一个大版本，并自动检查所有更高版本均不存在。
- 引入提交是另一项 Git 事实，通过 GUC 表源码的 pickaxe 搜索获得；它不会覆盖实测存在矩阵。

## 默认值术语 {#default-value-vocabulary}

| 术语 | 定义 |
| --- | --- |
| `boot_val` | 上游 `pg_settings` 的 boot 值；跨大版本默认值比较使用这一列。 |
| `setting` | 官方容器完成 `initdb` 后的当前值；它可能不同于 `boot_val`。 |
| 原始单位 | `unit` 列原样保留，包括 `8kB` 这样的块计数单位。 |
| 人类可读值 | 保守换算，仅用于显示，绝不替代原始值和单位。 |

## Pigsty 夹具 {#pigsty-fixture}

对比矩阵使用 8 核、32 GiB 内存、100 GiB SSD 主库和角色默认变量，针对每个
PostgreSQL 大版本实际渲染 OLTP、OLAP、CRIT、TINY 四套完整 Patroni 模板。记录包括
源码表达式、解析值、配置层级及其与上游 `boot_val` 的比较。模板没有该键时明确记为
“未修改”。用户 `pg_parameters` 是独立的 `postgresql.auto.conf` 覆盖层，角色默认值为空。
对已停止维护或测试版 PostgreSQL 渲染当前 Pigsty 模板只是一种历史投影，不表示当前
Pigsty 支持该版本。

## 测试版边界 {#beta-boundary}

PostgreSQL 19 Beta 3 作为固定的预发布证据点参与参数并集以及 PG18→19 Beta 3 差异。
所有仅见于测试版的条目都会提示：名称、默认值和行为在正式发布前仍可能变化。

## 官方链接 {#official-links}

爬虫逐版本抓取全部官方 `runtime-config*.html` 页面，记录响应哈希，并检查预期的
`GUC-*` ID。只有实际找到精确锚点时才发布 URL；内部或未公开参数会记录状态，不会
伪造官方链接。