Skip to content

Commit 0589b08

Browse files
balinorLiangbalinorLiang
committed
modify docs for ivorysql4.2 release
1 parent 9fc91c7 commit 0589b08

18 files changed

Lines changed: 117 additions & 156 deletions

File tree

‎CN/modules/ROOT/pages/v4.0/1.adoc‎

Lines changed: 22 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -4,55 +4,40 @@
44

55
== 版本概览
66

7-
[**发行日期：2024年12月23日**]
7+
[**发行日期：2025年01月16日**]
88

99

10-
IvorySQL 4.0基于PostgreSQL 17.0，并修复了多个问题。更多信息请参考 https://docs.ivorysql.org/[文档网站] 。
10+
IvorySQL 4.2，基于PostgreSQL 17.2，并修复了多个问题。有关更新的完整列表，请访问我们的 https://docs.ivorysql.org/[文档网站] 。
1111

1212
== 增强功能及问题修复
1313

14-
- PostgreSQL 17.0
14+
- PostgreSQL 17.1
1515

16-
1. 新的 VACUUM 内存管理系统，可减少内存消耗并提升整体 VACUUM 性能。
17-
2. 新增 SQL/JSON 功能，包括构造函数、标识函数以及 JSON_TABLE() 函数，可将 JSON 数据转换为表格表示。
18-
3. 各种查询性能改进，包括基于流式 I/O 的顺序读取、在高并发下的写入吞吐量，以及在 B-tree 索引中对多个值的搜索优化。
19-
4. 增强逻辑复制功能。
20-
5. 新的客户端连接选项 sslnegotiation=direct，通过直接 TLS 握手避免额外的往返协商。
21-
6. pg_basebackup 现在支持增量备份。
22-
7. COPY 增加了新选项 ON_ERROR ignore，允许在出现错误时继续执行复制操作。
16+
1. 确保在行级安全性 (RLS) 适用于非顶层表引用时，将缓存的计划标记为依赖于调用角色。
17+
2. 使 libpq 丢弃在 SSL 或 GSS 协议协商期间接收到的错误消息。
18+
3. 修复 SET SESSION AUTHORIZATION 和 SET ROLE 之间的非预期交互。
19+
4. 防止受信任的 PL/Perl 代码更改环境变量。
20+
5. 修复在附加或分离表分区时，外键约束的目录状态更新问题。
2321

24-
+
25-
26-
更多细节, 请参阅 https://www.postgresql.org/docs/release/17.0/[PostgreSQL发布说明].
27-
28-
- IvorySQL 4.0
22+
- PostgreSQL 17.2
2923

30-
1. Oracle 不可见列的兼容: https://github.com/IvorySQL/IvorySQL/issues/608[#608]
24+
1. 修复与结构体 ResultRelInfo 一起工作的扩展的 ABI 兼容性问题。
25+
2. 恢复 ALTER {ROLE|DATABASE} SET role 的功能。
26+
3. 修复逻辑复制槽的 restart_lsn 可能倒退的情况。
27+
4. 避免在执行 pg_rewind 时删除仍然需要的 WAL 文件。
28+
5. 修复与删除共享统计信息条目相关的竞态条件问题。
3129

3230
+
3331

34-
在 Oracle 模式下新增对不可见列的支持，并在 psql 的扩展描述命令（\d+）中显示不可见列的信息。
35-
对表的常规访问将不会显示不可见列。不可见列必须通过其列名显式引用，查询和其他操作才能访问这些列。
36-
37-
2. Oracle 包兼容性: https://github.com/IvorySQL/IvorySQL/issues/589[#589]
38-
39-
+
32+
更多细节, 请参阅 https://www.postgresql.org/docs/release/17.2/[PostgreSQL发布说明].
4033

41-
支持 PL/SQL 包管理功能，包括创建、修改和描述包及包体。
42-
增强了 PostgreSQL 交互式终端（psql），新增 \k 命令，用于与包相关的操作。
43-
此外，通过新的 ACL 函数实现了高级权限管理，并引入了包缓存机制以提升性能。
34+
- IvorySQL 4.2
4435

45-
3. 函数 pg_get_functiondef 支持多个 OID 和函数名: https://github.com/IvorySQL/IvorySQL/issues/696[#696]
36+
1. 修复了 pg_upgrade: https://github.com/IvorySQL/IvorySQL/issues/721[#721]
4637

47-
+
48-
49-
增强函数 pg_get_functiondef() 以支持在参数列表中传入多个函数 OID。现在，它还可以导出具有相同名称但不同参数的函数定义。
50-
51-
4. 将 'ivorysql' 添加为默认数据库: https://github.com/IvorySQL/IvorySQL/issues/575[#575]
52-
53-
+
38+
2. 提供了 Rocky9 安装包: https://github.com/IvorySQL/IvorySQL/issues/724[#724]
5439

55-
5. 提供Ubuntu安装包: https://github.com/IvorySQL/IvorySQL/issues/703[#703]
40+
3. 修复了 IvorySQL 文档中的英文语法错误: https://github.com/IvorySQL/ivorysql_docs/pull/95[#95]
5641

5742

5843
== 源代码
@@ -66,21 +51,15 @@ IvorySQL主要包含2个代码仓库:
6651
以下个人（按姓氏排序）作为补丁作者、提交者、审查者、测试者或问题报告者为此版本做出了贡献。
6752

6853
- Cary Huang
54+
- Denis Lussier
6955
- Grant Zhou
70-
- Imran Zaheer
71-
- jerome-peng
72-
- 冯若航
73-
- 付贝
7456
- 高雪玉
7557
- 矫顺田
7658
- 梁翔宇
7759
- 吕新杰
7860
- 牛世继
79-
- 任娇
8061
- 王丽
8162
- 王守波
82-
- 文一
83-
- 许振伟
63+
- 王志斌
8464
- 严少安
85-
- 赵法威
86-
- 周家杰
65+
- 赵法威

‎CN/modules/ROOT/pages/v4.0/10.adoc‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Ora2Pg 由一个 Perl 脚本（ora2pg）以及一个 Perl 模块（ https://gith
4545

4646
|===
4747
| linux环境 | Oracle版本 | IvorySQL版本
48-
| Centos Stream 9 | 19.0.0.0 | 4.0
48+
| Centos Stream 9 | 19.0.0.0 | 4.2
4949
|===
5050

5151
=== 依赖环境安装
@@ -449,7 +449,7 @@ $ createdb orcl
449449
450450
$ psql
451451
452-
psql (17.0)
452+
psql (17.2)
453453
454454
Type "help" for help.
455455
@@ -478,7 +478,7 @@ ivorysql=#
478478
```
479479
$ psql orcl
480480
481-
psql (17.0)
481+
psql (17.2)
482482
483483
Type "help" for help.
484484

‎CN/modules/ROOT/pages/v4.0/11.adoc‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -89,9 +89,9 @@ $ export PKG_CONFIG_PATH=$PROTOBUFC_HOME/lib:$PKG_CONFIG_PATH
8989

9090
** 安装 PostGIS
9191
```
92-
$ wget https://download.osgeo.org/postgis/source/postgis-3.4.0.tar.gz
93-
$ tar -xvf postgis-3.4.0.tar.gz
94-
$ cd postgis-3.4.0
92+
$ wget https://download.osgeo.org/postgis/source/postgis-3.4.2.tar.gz
93+
$ tar -xvf postgis-3.4.2.tar.gz
94+
$ cd postgis-3.4.2
9595
$ sh autogen.sh
9696
$ ./configure --with-geosconfig=/usr/local/geos-3.9.2/bin/geos-config --with-projdir=/usr/local/proj-8.2.1 --with-gdalconfig=/usr/local/gdal-3.4.3/bin/gdal-config --with-protobufdir=/usr/local/protobuf-c-1.4.1 --with-pgconfig=/usr/local/ivorysql/ivorysql-4/bin/pg_config
9797
$ make && make install
@@ -109,7 +109,7 @@ CREATE EXTENSION
109109
ivorysql=# SELECT * FROM pg_available_extensions WHERE name = 'postgis';
110110
name | default_version | installed_version | comment
111111
---------+-----------------+-------------------+------------------------------------------------------------
112-
postgis | 3.4.0 | 3.4.0 | PostGIS geometry and geography spatial types and functions
112+
postgis | 3.4.2 | 3.4.2 | PostGIS geometry and geography spatial types and functions
113113
(1 row)
114114
```
115115

‎CN/modules/ROOT/pages/v4.0/12.adoc‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ HNSW (Hierarchical Navigating Small World) 是一种基于图的索引算法，
2323
== 安装
2424
[TIP]
2525
====
26-
环境中已经安装了IvorySQL4.0及以上版本，安装路径为/usr/local/ivorysql/ivorysql-4
26+
环境中已经安装了IvorySQL4.2及以上版本，安装路径为/usr/local/ivorysql/ivorysql-4
2727
====
2828

2929
=== 源码安装
@@ -49,7 +49,7 @@ sudo --preserve-env=PG_CONFIG make install
4949
** 创建pgvector扩展
5050
```
5151
[ivorysql@localhost ivorysql-4]$ psql
52-
psql (17.0)
52+
psql (17.2)
5353
Type "help" for help.
5454

5555
ivorysql=# create extension vector;

‎CN/modules/ROOT/pages/v4.0/23.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ IvorySQL由一个核心开发团队维护，该团队拥有对GitHub上的IvoryS
2929

3030
== **贡献者指南**
3131

32-
在贡献之前，我们需要了解下IvorySQL目前的版本以及文档的版本。目前，我们维护着4.0等版本，我们的版本紧跟PG的更新步伐，贡献之前请更新至最新版本。之后我们需要细心浏览一下贡献的样式风格，熟悉代码贡献风格、提Issue样式、拉取PR标题样式、代码注释样式、文档贡献样式、文章贡献样式，这可以帮助您尽快成为IvorySQL的贡献者奥~。
32+
在贡献之前，我们需要了解下IvorySQL目前的版本以及文档的版本。目前，我们维护着4.2等版本，我们的版本紧跟PG的更新步伐，贡献之前请更新至最新版本。之后我们需要细心浏览一下贡献的样式风格，熟悉代码贡献风格、提Issue样式、拉取PR标题样式、代码注释样式、文档贡献样式、文章贡献样式，这可以帮助您尽快成为IvorySQL的贡献者奥~。
3333

3434
=== 贡献前的准备
3535

‎CN/modules/ROOT/pages/v4.0/3.adoc‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -115,27 +115,27 @@ ivorysql 3238 1551 0 20:35 pts/0 00:00:00 grep --color=auto postgres
115115

116116
** 从Docker Hub上获取IvorySQL镜像
117117
```
118-
$ docker pull ivorysql/ivorysql:4.0-ubi8
118+
$ docker pull ivorysql/ivorysql:4.2-ubi8
119119
```
120120

121121
** 运行IvorySQL
122122
```
123-
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.0-ubi8
123+
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.2-ubi8
124124
```
125125

126126
** 查看IvorySQL容器运行是否成功
127127
```
128128
$ docker ps | grep ivorysql
129129
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
130-
6faa2d0ed705 ivorysql:4.0-ubi8 "docker-entrypoint.s…" 50 seconds ago Up 49 seconds 5866/tcp, 0.0.0.0:5434->5432/tcp ivorysql
130+
6faa2d0ed705 ivorysql:4.2-ubi8 "docker-entrypoint.s…" 50 seconds ago Up 49 seconds 5866/tcp, 0.0.0.0:5434->5432/tcp ivorysql
131131
```
132132

133133
== 数据库连接
134134

135135
psql连接数据库：
136136
```
137137
$ psql -d <database>
138-
psql (17.0)
138+
psql (17.2)
139139
Type "help" for help.
140140

141141
ivorysql=#

‎CN/modules/ROOT/pages/v4.0/6.adoc‎

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -61,12 +61,12 @@ dnf search ivorysql
6161

6262
** 从Docker Hub上获取IvorySQL镜像
6363
```
64-
$ docker pull ivorysql/ivorysql:4.0-ubi8
64+
$ docker pull ivorysql/ivorysql:4.2-ubi8
6565
```
6666

6767
** 运行IvorySQL
6868
```
69-
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.0-ubi8
69+
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.2-ubi8
7070
```
7171
-e参数说明
7272
|====
@@ -94,17 +94,17 @@ $ sudo dnf install -y lz4 libicu libxslt python3
9494
```
9595
** 获取rpm包
9696
```
97-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-4.0-1.rhel8.x86_64.rpm
98-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-contrib-4.0-1.rhel8.x86_64.rpm
99-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-devel-4.0-1.rhel8.x86_64.rpm
100-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-docs-4.0-1.rhel8.x86_64.rpm
101-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-libs-4.0-1.rhel8.x86_64.rpm
102-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-llvmjit-4.0-1.rhel8.x86_64.rpm
103-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-plperl-4.0-1.rhel8.x86_64.rpm
104-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-plpython3-4.0-1.rhel8.x86_64.rpm
105-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-pltcl-4.0-1.rhel8.x86_64.rpm
106-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-server-4.0-1.rhel8.x86_64.rpm
107-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-test-4.0-1.rhel8.x86_64.rpm
97+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-4.2-1.rhel8.x86_64.rpm
98+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-contrib-4.2-1.rhel8.x86_64.rpm
99+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-devel-4.2-1.rhel8.x86_64.rpm
100+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-docs-4.2-1.rhel8.x86_64.rpm
101+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-libs-4.2-1.rhel8.x86_64.rpm
102+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-llvmjit-4.2-1.rhel8.x86_64.rpm
103+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-plperl-4.2-1.rhel8.x86_64.rpm
104+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-plpython3-4.2-1.rhel8.x86_64.rpm
105+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-pltcl-4.2-1.rhel8.x86_64.rpm
106+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-server-4.2-1.rhel8.x86_64.rpm
107+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql4-test-4.2-1.rhel8.x86_64.rpm
108108
```
109109
** 安装rpm包
110110

@@ -169,12 +169,12 @@ $ sudo apt -y install pkg-config libreadline-dev libicu-dev libldap2-dev uuid-de
169169

170170
** 获取deb包
171171
```
172-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql-4.0.x86_64.deb
172+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.0/ivorysql-4.2.x86_64.deb
173173
```
174174

175175
** 安装deb包
176176
```
177-
$ sudo dpkg -i ivorysql-4.0.x86_64.deb
177+
$ sudo dpkg -i ivorysql-4.2.x86_64.deb
178178
```
179179
数据库将被安装在/usr/local/ivorysql路径下。
180180

@@ -242,7 +242,7 @@ ivorysql 130445 130274 0 02:45 pts/1 00:00:00 grep --color=auto postgres
242242
psql连接数据库：
243243
```
244244
$ psql -d <database>
245-
psql (17.0)
245+
psql (17.2)
246246
Type "help" for help.
247247

248248
ivorysql=#
@@ -267,7 +267,7 @@ TIP: Docker运行IvorySQL时，需要添加额外参数，参考：psql -d ivory
267267
执行以下命令依次卸载：
268268
```
269269
$ sudo dnf remove -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
270-
$ sudo rpm -e ivorysql-release-4.0-1.noarch
270+
$ sudo rpm -e ivorysql-release-4.2-1.noarch
271271
```
272272

273273
=== docker安装的卸载
@@ -276,7 +276,7 @@ $ sudo rpm -e ivorysql-release-4.0-1.noarch
276276
```
277277
$ docker stop ivorysql
278278
$ docker rm ivorysql
279-
$ docker rmi ivorysql/ivorysql:4.0-ubi8
279+
$ docker rmi ivorysql/ivorysql:4.2-ubi8
280280
```
281281

282282
=== rpm安装的卸载

‎CN/modules/ROOT/pages/v4.0/7.adoc‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ ivorysql 6567 6139 0 21:54 ? 00:00:00 postgres: walreceiver streaming
120120
在主节点上psql连接数据库，并查看集群状态：
121121
```
122122
$ psql -d ivorysql
123-
psql (17.0)
123+
psql (17.2)
124124
Type "help" for help.
125125

126126
ivorysql=# select * from pg_stat_replication;
@@ -141,7 +141,7 @@ xmin | state | sent_lsn | write_lsn | flush_lsn | replay_lsn | write_lag |
141141
例如，在主节点创建一个新的数据库test，并在主节点进行查询：
142142
```
143143
$ psql -d ivorysql
144-
psql (17.0)
144+
psql (17.2)
145145
Type "help" for help.
146146

147147
ivorysql=# create database test;
@@ -161,7 +161,7 @@ ivorysql=# \l
161161
在备节点查询：
162162
```
163163
$ psql -d ivorysql
164-
psql (17.0)
164+
psql (17.2)
165165
Type "help" for help.
166166
167167
ivorysql=# \l

‎CN/modules/ROOT/pages/v4.0/9.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ pg_upgrade 工具可以支持IvorySQL跨版本的就地升级。 升级可以在
9999

100100
== 管理IvorySQL版本
101101

102-
IvorySQL基于PostgreSQL开发，版本更新频率与PostgreSQL版本更新频率保持一致，每年更新一个大版本，每季度更新一个小版本。IvorySQL目前发布的版本有1.0到4.0，分别基于PostgreSQL 14.0到17.0进行开发，最新版本为IvorySQL 4.0，基于PostgreSQL 17.0进行开发。IvorySQL 的所有版本全部都做到了向下兼容。相关版本特性可以查看 https://www.ivorysql.org/zh-CN/releases-page[官网]。
102+
IvorySQL基于PostgreSQL开发，版本更新频率与PostgreSQL版本更新频率保持一致，每年更新一个大版本，每季度更新一个小版本。IvorySQL目前发布的版本有1.0到4.0，分别基于PostgreSQL 14.0到17.2进行开发，最新版本为IvorySQL 4.2，基于PostgreSQL 17.2进行开发。IvorySQL 的所有版本全部都做到了向下兼容。相关版本特性可以查看 https://www.ivorysql.org/zh-CN/releases-page[官网]。
103103

104104

105105
== 管理IvorySQL数据库访问

0 commit comments

Comments
 (0)