pg_readme_test_extension

概览

Bundled test fixture; its control default_version is forever and it does not require hstore; package ownership follows pg_readme: PGDG RPM 0.7.0 and PIGSTY DEB 0.7.1.

版本

构建

您可以使用 pig build 命令构建 pg_readme 扩展的 DEB 包：

pig build pkg pg_readme         # 构建 DEB 包

安装

您可以直接安装 pg_readme 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

• 安装
• pig
• dnf
• apt

pig install pg_readme;          # 当前活跃 PG 版本安装

pig ext install -y pg_readme -v 18  # PG 18
pig ext install -y pg_readme -v 17  # PG 17
pig ext install -y pg_readme -v 16  # PG 16
pig ext install -y pg_readme -v 15  # PG 15
pig ext install -y pg_readme -v 14  # PG 14

dnf install -y pg_readme_18       # PG 18
dnf install -y pg_readme_17       # PG 17
dnf install -y pg_readme_16       # PG 16
dnf install -y pg_readme_15       # PG 15
dnf install -y pg_readme_14       # PG 14

apt install -y postgresql-18-pg-readme   # PG 18
apt install -y postgresql-17-pg-readme   # PG 17
apt install -y postgresql-16-pg-readme   # PG 16
apt install -y postgresql-15-pg-readme   # PG 15
apt install -y postgresql-14-pg-readme   # PG 14

创建扩展：

CREATE EXTENSION pg_readme_test_extension;

用法

来源：

• pg_readme 0.7.1 README
• 测试扩展控制文件
• 测试扩展 SQL 固件
• Pigsty 软件包矩阵

pg_readme_test_extension 是 pg_readme 随附的集成测试固件。它会安装带注释的域、类型、表、视图、例程、触发器和处理指令，以便上游验证 pg_extension_readme()。它不是应用功能，也不是生产依赖。

使用测试固件

CREATE EXTENSION pg_readme CASCADE;
CREATE EXTENSION pg_readme_test_extension;

SELECT pg_extension_readme('pg_readme_test_extension'::name);

使用输出测试或演示生成器，然后从一次性数据库中移除该固件：

DROP EXTENSION pg_readme_test_extension;

边界与注意事项

• 上游发行版本为 0.7.1，但该固件的控制版本刻意使用字面量 forever。
• 该固件随 pg_readme 一起提供；当前 Pigsty DEB 软件包为 0.7.1，而 RPM 软件包仍为 0.7.0。两边的扩展版本都保持 forever。
• 它可重定位，本身不要求 hstore，并会创建使用通用名称的示例对象。仅应安装在这些对象不会与真实应用模式冲突的环境中。
• 它的 SQL 接口用于覆盖生成器行为，并可能随测试演进而改变。不要让应用代码依赖这些固件对象。