1.22 docs

CN/antora.yml

@@ -1,7 +1,7 @@
 name: ivorysql-doc
 title: IvorySQL
-version: v1.17
-start_page: v1.17/welcome.adoc
+version: v1.22
+start_page: v1.22/welcome.adoc
 asciidoc:
   attributes:
     source-language: asciidoc@

CN/modules/ROOT/nav.adoc

@@ -1,38 +1,38 @@
-* xref:v1.17/welcome.adoc[欢迎]
-* xref:v1.17/1.adoc[发行说明]
-* xref:v1.17/2.adoc[关于IvorySQL]
+* xref:v1.22/welcome.adoc[欢迎]
+* xref:v1.22/1.adoc[发行说明]
+* xref:v1.22/2.adoc[关于IvorySQL]
 * IvorySQL入门
-** xref:v1.17/3.adoc[快速开始]
-** xref:v1.17/4.adoc[日常监控]
-** xref:v1.17/5.adoc[日常维护]
+** xref:v1.22/3.adoc[快速开始]
+** xref:v1.22/4.adoc[日常监控]
+** xref:v1.22/5.adoc[日常维护]
 * IvorySQL高级
-** xref:v1.17/6.adoc[安装指南]
-** xref:v1.17/7.adoc[开发者指南]
-** xref:v1.17/8.adoc[运维管理指南]
+** xref:v1.22/6.adoc[安装指南]
+** xref:v1.22/7.adoc[开发者指南]
+** xref:v1.22/8.adoc[运维管理指南]
 * IvorySQL生态
-** xref:v1.17/33.adoc[概述]
-** xref:v1.17/9.adoc[PostGIS]
-** xref:v1.17/10.adoc[pgvector]
-** xref:v1.17/34.adoc[PGroonga]
-** xref:v1.17/35.adoc[pgddl (DDL Extractor)]
-** xref:v1.17/36.adoc[pgRouting]
-** xref:v1.17/37.adoc[pg_cron]
-** xref:v1.17/38.adoc[pgsql-http]
-** xref:v1.17/40.adoc[pgvectorscale]
+** xref:v1.22/33.adoc[概述]
+** xref:v1.22/9.adoc[PostGIS]
+** xref:v1.22/10.adoc[pgvector]
+** xref:v1.22/34.adoc[PGroonga]
+** xref:v1.22/35.adoc[pgddl (DDL Extractor)]
+** xref:v1.22/36.adoc[pgRouting]
+** xref:v1.22/37.adoc[pg_cron]
+** xref:v1.22/38.adoc[pgsql-http]
+** xref:v1.22/40.adoc[pgvectorscale]
 * Oracle兼容功能列表
-** xref:v1.17/11.adoc[1、Ivorysql框架设计]
-** xref:v1.17/12.adoc[2、GUC框架]
-** xref:v1.17/13.adoc[3、大小写转换]
-** xref:v1.17/14.adoc[4、双模式设计]
-** xref:v1.17/15.adoc[5、兼容Oracle like]
-** xref:v1.17/16.adoc[6、兼容Oracle匿名块]
-** xref:v1.17/17.adoc[7、兼容Oracle函数与存储过程]
-** xref:v1.17/18.adoc[8、内置数据类型与内置函数]
-** xref:v1.17/19.adoc[9、新增Oracle兼容模式的端口与IP]
+** xref:v1.22/11.adoc[1、Ivorysql框架设计]
+** xref:v1.22/12.adoc[2、GUC框架]
+** xref:v1.22/13.adoc[3、大小写转换]
+** xref:v1.22/14.adoc[4、双模式设计]
+** xref:v1.22/15.adoc[5、兼容Oracle like]
+** xref:v1.22/16.adoc[6、兼容Oracle匿名块]
+** xref:v1.22/17.adoc[7、兼容Oracle函数与存储过程]
+** xref:v1.22/18.adoc[8、内置数据类型与内置函数]
+** xref:v1.22/19.adoc[9、新增Oracle兼容模式的端口与IP]
 * IvorySQL试验田
-** xref:v1.17/41.adoc[1、全局唯一索引]
-** xref:v1.17/42.adoc[2、新增无主键表默认支持逻辑复制]
-** xref:v1.17/43.adoc[3、修改列类型时自动重建依赖视图]
-* xref:v1.17/20.adoc[社区贡献指南]
-* xref:v1.17/21.adoc[工具参考]
-* xref:v1.17/22.adoc[FAQ]
+** xref:v1.22/41.adoc[1、全局唯一索引]
+** xref:v1.22/42.adoc[2、新增无主键表默认支持逻辑复制]
+** xref:v1.22/43.adoc[3、修改列类型时自动重建依赖视图]
+* xref:v1.22/20.adoc[社区贡献指南]
+* xref:v1.22/21.adoc[工具参考]
+* xref:v1.22/22.adoc[FAQ]

CN/modules/ROOT/pages/v1.22/1.adoc

@@ -0,0 +1,67 @@
+
+:sectnums:
+:sectnumlevels: 5
+
+## 版本介绍
+
+[**发行日期：2026年4月21日**]
+
+IvorySQL 1.22 基于 PostgreSQL 14.22，包含多种错误修复。
+
+## 增强功能
+
+- PostgreSQL 14.18-14.22 增强
+1. 避免在检查声明为 GB18030 编码的无效编码字符串时发生一字节缓冲区越界读取。
+2. 正确处理分区表上的自引用外键。
+3. 加强规划器估算函数中的安全检查。
+4. 防止 pg_dump 脚本被用于攻击执行恢复操作的用户。
+5. 在 `CREATE STATISTICS` 中检查对 schema 的 `CREATE` 权限。
+6. 避免 libpq 中分配大小计算时的整数溢出。
+7. 防范 `oidvector`/`int2vector` 的意外维度。
+8. 加固选择性估算器，防止其被附加到接受意外数据类型的操作符上。
+9. 修复在重放由旧版本生成的多事务截断 WAL 记录后的失败问题。
+10. 避免 `substring()` 应用于"toast"数据时产生无效编码的错误报告。
+更多详情，请访问 link:https://www.postgresql.org/docs/release/14.22/[PostgreSQL 发布说明]。
+
+## 主要特性
+
+- 升级至 PG 14.22 内核：link:https://github.com/IvorySQL/IvorySQL/pull/1223[Feature #1223] +
+    PostgreSQL 内核升级至 14.22 版本。
+
+- 全平台打包 +
+    提供 X86、ARM、MIPS、LoongArch 架构的多平台介质包。
+
+- PostgreSQL 扩展 +
+    新增支持 7 个 PostgreSQL 扩展：PostGIS、pgRouting、PGroonga、ddlx、pgsql-http、pgvector、pgvectorscale。
+
+- 全局唯一索引：link:https://github.com/IvorySQL/IvorySQL/pull/1230[Feature #1230] +
+    提供使用非分区键确保跨分区唯一性的分区表唯一索引，在 Postgres 和 Oracle 兼容模式下均可用，并支持创建、附加、分离、插入和更新操作。
+
+- 基表列类型变更时自动重建视图：link:https://github.com/IvorySQL/IvorySQL/pull/1224[Feature #1224] +
+    当执行列类型变更时，数据库自动保存所有依赖视图的定义，并在完成类型变更后按照正确的依赖顺序重建这些视图。
+
+- 无主键表的逻辑复制回退至 FULL IDENTITY：link:https://github.com/IvorySQL/IvorySQL/pull/1227[Feature #1227] +
+    引入新的 GUC 参数 logical_replication_fallback_to_full_identity，允许逻辑复制对配置为 DEFAULT IDENTITY 但缺少主键的表自动回退至 REPLICA IDENTITY FULL。
+
+## 源代码
+
+IvorySQL 的研发工作主要通过以下两个核心代码库进行维护：
+- IvorySQL 数据库源代码：https://github.com/IvorySQL/IvorySQL
+- IvorySQL 官方网站：https://github.com/IvorySQL/Ivory-www
+
+## 贡献人员
+以下个人（按字母顺序排列）作为补丁作者、提交者、审阅者、测试者或问题报告者为本版本做出了贡献。
+
+* Chao Li
+* David Zhang
+* Grant Zhou
+* Oreo Yang
+* Shuntian Jiao
+* Steven Niu
+* Xiaohui Liu
+* Xinjie LYU
+* Xueyu Gao
+* Zheng Tao
+* Zhenhao Pan
+
+link:https://github.com/IvorySQL/IvorySQL/compare/IvorySQL_1.17...IvorySQL_1.22[完整变更日志]

CN/modules/ROOT/pages/v1.17/10.adoc → CN/modules/ROOT/pages/v1.22/10.adoc

@@ -26,7 +26,7 @@ HNSW (Hierarchical Navigating Small World) 是一种基于图的索引算法，
 
 ** 设置PG_CONFIG环境变量
 ```
-export PG_CONFIG=/usr/local/ivorysql/ivorysql-1.17/bin/pg_config
+export PG_CONFIG=/usr/local/ivorysql//bin/pg_config
 ```
 
 ** 拉取pg_vector源码
@@ -44,7 +44,7 @@ sudo --preserve-env=PG_CONFIG make install
 
 ** 创建pgvector扩展
 ```
-[ivorysql@localhost ivorysql-1.17]$ psql
+[ivorysql@localhost ]$ psql
 psql
 Type "help" for help.
 

CN/modules/ROOT/pages/v1.17/2.adoc → CN/modules/ROOT/pages/v1.22/2.adoc

@@ -67,12 +67,12 @@ IvorySQL是一个功能强大的开源对象关系数据库管理系统(ORDBMS)
 
 == 与Oracle的兼容性
 
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/11[1.ivorysql框架设计]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/12[2.GUC框架]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/13[3.大小写转换]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/14[4.双模式设计]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/15[5.兼容Oracle like]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/16[6.兼容Oracle匿名块]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/17[7.兼容Oracle函数与存储过程]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/18[8.内置数据类型与内置函数]
-* https://docs.ivorysql.org/cn/ivorysql-doc/v1.17/v1.17/19[9.新增Oracle兼容模式的端口与IP]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/11[1.ivorysql框架设计]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/12[2.GUC框架]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/13[3.大小写转换]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/14[4.双模式设计]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/15[5.兼容Oracle like]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/16[6.兼容Oracle匿名块]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/17[7.兼容Oracle函数与存储过程]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/18[8.内置数据类型与内置函数]
+* https://docs.ivorysql.org/cn/ivorysql-doc/v1.22/v1.22/19[9.新增Oracle兼容模式的端口与IP]

CN/modules/ROOT/pages/v1.17/3.adoc → CN/modules/ROOT/pages/v1.22/3.adoc

@@ -30,15 +30,15 @@ Linux version 3.10.0-1160.el7.x86_64 (mockbuild@kbuilder.bsys.centos.org) (gcc v
 
 [source,]
 ----
-[highgo@ivorysql ~]$ wget https://github.com/IvorySQL/IvorySQL/archive/refs/tags/IvorySQL_1.17.tar.gz
-[highgo@ivorysql ~]$ tar -zxvf  IvorySQL_1.17.tar.gz 
+[highgo@ivorysql ~]$ wget https://github.com/IvorySQL/IvorySQL/archive/refs/tags/IvorySQL_1.22.tar.gz
+[highgo@ivorysql ~]$ tar -zxvf  IvorySQL_1.22.tar.gz 
 ----
 
 **进入下载好的项目目录中**
 
 [source,]
 ----
-[highgo@ivorysql ~]$ mv IvorySQL-IvorySQL_1.17 IvorySQL; ls
+[highgo@ivorysql ~]$ mv IvorySQL-IvorySQL_1.22 IvorySQL; ls
 IvorySQL
 [highgo@ivorysql ~]$ cd IvorySQL/
 ----
@@ -170,19 +170,19 @@ image::p2.png[]
 
 下载RPM包:在Centos7上使用wget下载
 
-wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 
 
 安装IvorySQL
 [source,]
 ----
-yum install IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+yum install IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 ----
 
 初始化单机数据库
 [source,]
 ----
-/opt/IvorySQL-1.17/bin/initdb -D data/
+/opt/IvorySQL-1.22/bin/initdb -D data/
 ----
 
 ===== 集群安装（一主一备）
@@ -193,12 +193,12 @@ yum install IvorySQL-1.17-fde5539-20250326.x86_64.rpm
 
 下载RPM包:在Centos7上使用wget下载
 
-wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 
 安装IvorySQL
 [source,]
 ----
-yum install IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+yum install IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 ----
 
 
@@ -207,7 +207,7 @@ yum install IvorySQL-1.17-fde5539-20250326.x86_64.rpm
 初始化主节点
 [source,]
 ----
-/opt/IvorySQL-1.17/bin/initdb -D data/
+/opt/IvorySQL-1.22/bin/initdb -D data/
 ./initdb ../data-primary -U postgres
 ----
 
@@ -234,7 +234,7 @@ host    replication     all             0.0.0.0/0            trust
 1、 基础备份
 [source,shell]
 ----
-cd /opt/IvorySQL-1.17/bin
+cd /opt/IvorySQL-1.22/bin
 ./pg_basebackup -h 127.0.0.1 -p 5333 -U repl -W -Fp -Xs -Pv -R -D ../data-standby01
 ----
 
@@ -259,18 +259,18 @@ vi ../data-standby01/postgresql.conf
 
 下载RPM包:在Centos7上使用wget下载
 
-wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 
 安装IvorySQL
 [source,]
 ----
-yum install IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+yum install IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 ----
 
 初始化主节点
 [source,]
 ----
-/opt/IvorySQL-1.17/bin/initdb -D data/
+/opt/IvorySQL-1.22/bin/initdb -D data/
 ----
 
 启动服务，创建用户
@@ -312,16 +312,16 @@ host    replication     all             0.0.0.0/0            trust
 
 下载RPM包:在Centos7上使用wget下载
 
-wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+wget https://github.com/IvorySQL/IvorySQL/releases/download/Ivory_REL_1_17/IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 
 安装IvorySQL
 
-    yum install IvorySQL-1.17-fde5539-20250326.x86_64.rpm
+    yum install IvorySQL-1.22-5a0861c-20260416.x86_64.rpm
 
 1、 基础备份
 [source,shell]
 ----
-cd /opt/IvorySQL-1.17/bin
+cd /opt/IvorySQL-1.22/bin
 ./pg_basebackup -h 192.168.xx.xx -p 5333 -U repl -W -Fp -Xs -Pv -R -D ../data-standby01
 ----
 

CN/modules/ROOT/pages/v1.17/33.adoc → CN/modules/ROOT/pages/v1.22/33.adoc

@@ -12,14 +12,14 @@ IvorySQL 作为一款兼容 Oracle 且基于 PostgreSQL 的高级开源数据库
 [cols="2,1,3,3"]
 |====
 |*插件名称*|*版本*|*功能描述*|*适用场景*
-| xref:v1.17/9.adoc[PostGIS] | 3.4.0 | 为 IvorySQL 提供地理空间数据支持，包括空间索引、空间函数和地理对象存储 | 地理信息系统（GIS）、地图服务、位置数据分析 
-| xref:v1.17/10.adoc[pgvector] | 0.8.0 | 支持向量相似性搜索，可用于存储和检索高维向量数据| AI 应用、图像检索、推荐系统、语义搜索
-| xref:v1.17/34.adoc[PGroonga] | 4.0.1 | 提供多语言全文搜索功能，支持超高速文本检索和模糊匹配 | 日志分析、多语言内容搜索、实时搜索引擎
-| xref:v1.17/35.adoc[pgddl (DDL Extractor)] | 0.20 | 提取数据库中的 DDL（数据定义语言）语句，便于版本管理和迁移 | 数据库版本控制、CI/CD 集成、结构比对与同步
-| xref:v1.17/36.adoc[pgRouting] | 3.5.1 | 基于地理数据的路径规划扩展，支持最短路径、旅行商问题等算法 | 物流规划、交通网络分析、路径优化服务
-| xref:v1.17/37.adoc[pg_cron]​ | 1.6.0 | 提供数据库内部的定时任务调度功能，支持定期执行SQL语句 | 数据清理、定期统计、自动化维护任务
-| xref:v1.17/38.adoc[pgsql-http]​ | 1.7.0 | 允许在SQL中发起HTTP请求，与外部Web服务进行交互 | 数据采集、API集成、微服务调用
-| xref:v1.17/40.adoc[pgvectorscale] | 0.8.0 | 提供向量数据的分片和分布式扩展支持，提升大规模向量处理性能 | 分布式向量数据库、高并发向量查询
+| xref:v1.22/9.adoc[PostGIS] | 3.4.0 | 为 IvorySQL 提供地理空间数据支持，包括空间索引、空间函数和地理对象存储 | 地理信息系统（GIS）、地图服务、位置数据分析 
+| xref:v1.22/10.adoc[pgvector] | 0.8.0 | 支持向量相似性搜索，可用于存储和检索高维向量数据| AI 应用、图像检索、推荐系统、语义搜索
+| xref:v1.22/34.adoc[PGroonga] | 4.0.1 | 提供多语言全文搜索功能，支持超高速文本检索和模糊匹配 | 日志分析、多语言内容搜索、实时搜索引擎
+| xref:v1.22/35.adoc[pgddl (DDL Extractor)] | 0.20 | 提取数据库中的 DDL（数据定义语言）语句，便于版本管理和迁移 | 数据库版本控制、CI/CD 集成、结构比对与同步
+| xref:v1.22/36.adoc[pgRouting] | 3.5.1 | 基于地理数据的路径规划扩展，支持最短路径、旅行商问题等算法 | 物流规划、交通网络分析、路径优化服务
+| xref:v1.22/37.adoc[pg_cron]​ | 1.6.0 | 提供数据库内部的定时任务调度功能，支持定期执行SQL语句 | 数据清理、定期统计、自动化维护任务
+| xref:v1.22/38.adoc[pgsql-http]​ | 1.7.0 | 允许在SQL中发起HTTP请求，与外部Web服务进行交互 | 数据采集、API集成、微服务调用
+| xref:v1.22/40.adoc[pgvectorscale] | 0.8.0 | 提供向量数据的分片和分布式扩展支持，提升大规模向量处理性能 | 分布式向量数据库、高并发向量查询
 |====
 
 这些插件均经过 IvorySQL 团队的测试和适配，确保在 IvorySQL 环境下稳定运行。用户可以根据业务需求选择合适的插件，进一步提升数据库系统的能力和灵活性。

CN/modules/ROOT/pages/v1.17/34.adoc → CN/modules/ROOT/pages/v1.22/34.adoc

@@ -17,7 +17,7 @@ IvorySQL的安装包里已经集成了PGroonga插件，如果使用安装包安
 除PGroonga社区提供的安装方式以外，IvorySQL社区也提供了源码安装方式，源码安装环境为 Ubuntu 24.04(x86_64)。
 
 [TIP]
-环境中已经安装了IvorySQL1.17及以上版本，安装路径为/usr/local/ivorysql/ivorysql-1
+环境中已经安装了IvorySQL1.22及以上版本，安装路径为/usr/local/ivorysql/ivorysql-1
 
 ==== 安装 groonga