Merge branch 'IvorySQL:master' into master

Author: jiaoshuntian

CN/modules/ROOT/nav.adoc

@@ -70,6 +70,9 @@
 *** xref:master/ecosystem_components/pg_profile.adoc[pg_profile]
 *** xref:master/ecosystem_components/pg_repack.adoc[pg_repack]
 *** xref:master/ecosystem_components/pgdog.adoc[PgDog]
+*** xref:master/ecosystem_components/pg_readonly.adoc[pg_readonly]
+*** xref:master/ecosystem_components/zhparser.adoc[zhparser]
+*** xref:master/ecosystem_components/pgbackrest.adoc[pgBackRest]
 * 监控运维
 ** xref:master/getting-started/daily_monitoring.adoc[日常监控]
 ** xref:master/getting-started/daily_maintenance.adoc[日常维护]

CN/modules/ROOT/pages/master/ecosystem_components/ecosystem_overview.adoc

@@ -37,6 +37,9 @@ IvorySQL 作为一款兼容 Oracle 且基于 PostgreSQL 的高级开源数据库
 | 24 | xref:master/ecosystem_components/pg_profile.adoc[pg_profile] | 4.11 | 收集数据库资源密集型活动的统计，基于两次采样点的差量分析生成历史负载报告，帮助定位性能瓶颈 | 数据库性能分析
 | 25 | xref:master/ecosystem_components/pg_repack.adoc[pg_repack] | 1.5.3 | 在几乎不阻塞业务读写的情况下在线重整表和索引、消除存储膨胀，效果类似 VACUUM FULL | 表与索引在线重建、存储空间回收
 | 26 | xref:master/ecosystem_components/pgdog.adoc[PgDog] | 0.1.45 | 专为 PostgreSQL 设计的高性能、开源集群中间件（代理工具），采用 Rust 语言编写 | 自动分片、连接池和负载均衡功能
+| 27 | xref:master/ecosystem_components/pg_readonly.adoc[pg_readonly] | 1.0.5 | 可将 PostgreSQL 数据库集群设置为只读 | 系统调试、灾难恢复
+| 28 | xref:master/ecosystem_components/zhparser.adoc[zhparser] | master branch | 用于中文全文搜索的PostgreSQL插件，基于SCWS（即：简易中文分词系统）实现了一个中文解析器 | 搜索引擎、关键字提取
+| 29 | xref:master/ecosystem_components/pgbackrest.adoc[pgBackRest] | 2.58.0 | 可靠的 PostgreSQL 备份和恢复解决方案 | 容灾备份、大库备份、异地/多层容灾
 |====
 
 这些插件均经过 IvorySQL 团队的测试和适配，确保在 IvorySQL 环境下稳定运行。用户可以根据业务需求选择合适的插件，进一步提升数据库系统的能力和灵活性。

CN/modules/ROOT/pages/master/ecosystem_components/pg_readonly.adoc

@@ -0,0 +1,94 @@
+:sectnums:
+:sectnumlevels: 5
+
+= pg_readonly
+
+== 概述
+pg_readonly 是一个能够将所有 PostgreSQL 的数据库设为只读的插件。 
+
+pg_readonly 没有特定的GUC参数，它依靠内存中的全局标志来管理只读状态，并提供了SQL函数来设置或者查询全局标志。 
+这个全局标志是集群级别的，集群中的数据库要么全部是只读的，要么全部是可读可写的。
+
+只读模式通过过滤SQL语句实现。
+[literal]
+----
+允许不包含有写动作函数的SELECT语句；
+DML (INSERT, UPDATE, DELETE) 和 DDL 语句包括 TRUNCATE 完全不允许；
+DCL 语句 GRANT 与 REVOKE 也是禁止的；
+----
+
+== 安装
+
+[TIP]
+源码安装环境为 Ubuntu 24.04(x86_64)，环境中已经安装了IvorySQL，安装路径为/path-to/ivorysql
+
+=== 源码安装
+
+[literal]
+----
+# 从 https://github.com/pierreforstmann/pg_readonly/releases/tag/1.0.6 下载 1.0.6 的源码包 1.0.6.tar.gz
+tar xvf 1.0.6.tar.gz
+cd pg_readonly-1.0.6
+
+# 编译安装
+make PG_CONFIF=/path-to/ivorysql/bin/pg_config 
+make PG_CONFIF=/path-to/ivorysql/bin/pg_config install
+----
+
+=== 配置预加载库
+修改 data 目录中的 ivorysql.conf 文件，向 shared_preload_libraries 中追加 pg_readonly。
+shared_preload_libraries = 'pg_readonly'
+
+== 创建Extension并确认pg_readonly版本
+
+psql 连接到数据库，执行如下命令：
+[literal]
+----
+ivorysql=# CREATE EXTENSION pg_readonly;
+CREATE EXTENSION
+
+ivorysql=# SELECT * FROM pg_available_extensions WHERE name = 'pg_readonly';
+    name     | default_version | installed_version | location |          comment           
+-------------+-----------------+-------------------+----------+----------------------------
+ pg_readonly | 1.0.6           | 1.0.6             | $system  | cluster database read only
+(1 row)
+----
+
+== 使用
+
+=== 检查单个函数
+
+[literal]
+----
+-- 查询当前集群只读状态
+select get_cluster_readonly();
+ get_cluster_readonly 
+----------------------
+ f
+(1 row)
+
+-- 设置当前集群为只读
+select set_cluster_readonly();
+ set_cluster_readonly 
+----------------------
+ t
+(1 row)
+
+-- 只读的集群只允许 SELECT 语句
+select * from t;
+ x | y 
+---+---
+(0 rows)
+
+update t set x=33 where y='abc';
+ERROR:  cannot execute UPDATE in a read-only transaction
+
+select 1 into tmp;
+ERROR:  cannot execute UPDATE in a read-only transaction
+
+create table tmp(c text);
+ERROR:  cannot execute UPDATE in a read-only transaction
+----
+
+更多详细使用方法和高级特性，请参阅 https://github.com/pierreforstmann/pg_readonly 。
+