Merge pull request #91 from balinorLiang/v4.0_release

release note update for IvorySQL v4.0

Author: gaoxueyu

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

@@ -4,35 +4,44 @@
 
 == 版本概览
 
-[**发行日期：2024年12月26日**]
+[**发行日期：2024年12月23日**]
 
 
 IvorySQL 4.0基于PostgreSQL 17.0，并修复了多个问题。更多信息请参考 https://docs.ivorysql.org/[文档网站] 。
 
-== 增强功能
+== 增强功能及问题修复
 
-- PostgreSQL 17.0 的增强功能
+- PostgreSQL 17.0
 
-1. VACUUM的新内存管理系统
-2. 新的SQL/JSON功能
-3. 各种查询性能改进
-4. 逻辑复制的增强功能
-5. 新的客户端连接选项
-6. pg_basebackup 现在支持增量备份
-7. COPY命令新增了一个选项 ON_ERROR ignore
+1. 新的 VACUUM 内存管理系统，可减少内存消耗并提升整体 VACUUM 性能。
+2. 新增 SQL/JSON 功能，包括构造函数、标识函数以及 JSON_TABLE() 函数，可将 JSON 数据转换为表格表示。
+3. 各种查询性能改进，包括基于流式 I/O 的顺序读取、在高并发下的写入吞吐量，以及在 B-tree 索引中对多个值的搜索优化。
+4. 增强逻辑复制功能。
+5. 新的客户端连接选项 sslnegotiation=direct，通过直接 TLS 握手避免额外的往返协商。
+6. pg_basebackup 现在支持增量备份。
+7. COPY 增加了新选项 ON_ERROR ignore，允许在出现错误时继续执行复制操作。
 
 +
 
 更多细节, 请参阅 https://www.postgresql.org/docs/release/17.0/[PostgreSQL发布说明].
 
+- IvorySQL 4.0
 
-== 问题修复
+1. Oracle 不可见列的兼容: https://github.com/IvorySQL/IvorySQL/issues/608[#608]
+在 Oracle 模式下新增对不可见列的支持，并在 psql 的扩展描述命令（\d+）中显示不可见列的信息。
+对表的常规访问将不会显示不可见列。不可见列必须通过其列名显式引用，查询和其他操作才能访问这些列。
+
+2. Oracle 包兼容性：https://github.com/IvorySQL/IvorySQL/issues/589[#589]
+支持 PL/SQL 包管理功能，包括创建、修改和描述包及包体。
+增强了 PostgreSQL 交互式终端（psql），新增 \k 命令，用于与包相关的操作。
+此外，通过新的 ACL 函数实现了高级权限管理，并引入了包缓存机制以提升性能。
+
+3. 函数 pg_get_functiondef 支持多个 OID 和函数名：https://github.com/IvorySQL/IvorySQL/issues/696[#696]
+
+4. 将 'ivorysql' 添加为默认数据库：https://github.com/IvorySQL/IvorySQL/issues/575[#575]
+
+5. 提供Ubuntu安装包：https://github.com/IvorySQL/IvorySQL/issues/703[#703]
 
-- 
-- 
-- 
-- 
-- 
 
 == 源代码
 
@@ -45,24 +54,21 @@ IvorySQL主要包含2个代码仓库:
 以下个人（按姓氏排序）作为补丁作者、提交者、审查者、测试者或问题报告者为此版本做出了贡献。
 
 - Cary Huang
-- Chase Wu
 - Grant Zhou
-- Håkan Arpfors
 - Imran Zaheer
-- Leo X.M. Zeng
-- ShanInfo
-- 冯磊
+- jerome-peng
+- 冯若航
+- 付贝
 - 高雪玉
-- 郭新源
 - 矫顺田
 - 梁翔宇
 - 吕新杰
 - 牛世继
-- 彭冲
 - 任娇
-- 尚雷
 - 王丽
 - 王守波
+- 许振伟
 - 文一
 - 严少安
+- 赵法威
 - 周家杰

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

@@ -41,11 +41,18 @@ https://www.ionos.com/help/server-cloud-infrastructure/server-administration/cre
 
 +
 
-执行以下命令安装：
+创建或编辑IvorySQL yum源配置文件/etc/yum.repos.d/ivorysql.repo
 ```
-$ sudo dnf install -y https://yum.highgo.ca/dists/ivorysql-rpms/repo/ivorysql-release-4.0-1.noarch.rpm
-
-$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test --skip-broken --nogpgcheck
+vim /etc/yum.repos.d/ivorysql.repo
+[ivorysql4]
+name=IvorySQL Server 4 $releasever - $basearch
+baseurl=https://yum.highgo.com/dists/ivorysql-rpms/4/redhat/rhel-$releasever-$basearch
+enabled=1
+gpgcheck=0
+```
+保存退出后，安装IvorySQL4
+```
+$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
 ```
 ....
 

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

@@ -21,13 +21,19 @@ IvorySQL安装方式包括以下5种：
 [[yum源安装]]
 == yum源安装
 
-** 执行dnf命令
+创建或编辑IvorySQL yum源配置文件/etc/yum.repos.d/ivorysql.repo
 ```
-$ sudo dnf install -y https://yum.highgo.ca/dists/ivorysql-rpms/repo/ivorysql-release-4.0-1.noarch.rpm
-
-$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test --skip-broken --nogpgcheck
+vim /etc/yum.repos.d/ivorysql.repo
+[ivorysql4]
+name=IvorySQL Server 4 $releasever - $basearch
+baseurl=https://yum.highgo.com/dists/ivorysql-rpms/4/redhat/rhel-$releasever-$basearch
+enabled=1
+gpgcheck=0
+```
+保存退出后，安装IvorySQL4
+```
+$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
 ```
-安装完毕将创建yum源配置文件/etc/yum.repos.d/ivorysql.repo。
 
 ** 查看安装结果
 ```

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

@@ -8,7 +8,7 @@
 == 主节点
 
 === 安装并启动数据库
-yum源快速安装数据库，请参考xref:4.0/3.adoc[快速安装]。
+yum源快速安装数据库，请参考xref:v4.0/3.adoc[快速安装]。
 
 想要获取更多安装方式，请参考xref:v4.0/6.adoc#安装指南[安装指南]。
 

EN/modules/ROOT/pages/v4.0/1.adoc

@@ -5,11 +5,11 @@
 
 == Version Overview
 
-[**Release date: December 26, 2024**]
+[**Release date: December 23, 2024**]
 
 IvorySQL 4.0, based on PostgreSQL 17.0, and Fixed a series of bugs. For a comprehensive list of updates, please visit our https://docs.ivorysql.org/[documentation site].
 
-== Enhancements
+== Enhancements & Fixed Issue
 
 - PostgreSQL 17.0 Enhancements
 
@@ -25,13 +25,19 @@ IvorySQL 4.0, based on PostgreSQL 17.0, and Fixed a series of bugs. For a compre
 
 For further details, visit https://www.postgresql.org/docs/release/17.0/[PostgreSQL’s release notes].
 
-== Fixed Issue
+- IvorySQL 4.0
 
-- 
-- 
-- 
-- 
-- 
+1. Oracle invisible columns compatibility: https://github.com/IvorySQL/IvorySQL/issues/608[#608]
+Add support for invisible columns and describe invisible columns in psql extended describe (\d+) in oracle mode only. Any general access to a table will not display invisible columns. Invisible columns must be explicitly referenced by their column name for queries and other operations to access them.
+
+2. Oracle package compatibility: https://github.com/IvorySQL/IvorySQL/issues/589[#589]
+Support PL/SQL package management, including creating, altering, and describing packages and package bodies. The PostgreSQL interactive terminal (psql) has been enhanced with a new \k command for package-related operations. Additionally, advanced privilege management is enabled through new ACL functions, and package caching has been implemented to boost performance.
+
+3. Function pg_get_functiondef support multiple OIDs and function names: #696
+
+4. Add 'ivorysql' as default database: #575
+
+5. Provide Ubuntu installation package: #703
 
 == Source Code
 
@@ -44,25 +50,22 @@ IvorySQL's development is maintained across two main repositories:
 
 The following individuals (in alphabetical order) have contributed to this release as patch authors, committers, reviewers, testers, or reporters of issues.
 
+- Bei Fu
 - Cary Huang
-- Chase Wu
-- Chong Peng
+- Fawei Zhao
 - Grant Zhou
 - Hope Gao
-- Håkan Arpfors
 - Imran Zaheer
 - Jiajie Zhou
+- jerome-peng
 - Jiao Ren
-- Lei Feng
-- Lei Shang
-- Leo X.M. Zeng
-- Lily Wang
-- ShanInfo
+- Li Wang
+- Ruohang Feng
 - Shawn Yan
 - Shiji Niu
 - Shoubo Wang
 - Shuntian Jiao
 - Xiangyu Liang
 - Xinjie Lv
-- Xinyuan Guo
-- Yi Wen
+- Yi Wen
+- Zhenwei Xu

EN/modules/ROOT/pages/v4.0/29.adoc

@@ -15,7 +15,7 @@ Invisible columns are also useful during application migration. Making new colum
 
 The invisible columns allowing users to conceal specific columns during operations like SELECT *. You can use invisible column to make changes to a table without disrupting applications that use the table.Any generic access of a table does not show the invisible columns in the table.Invisible columns must be explicitly referenced by column names in order to be accessed in queries and other operations.
 
-Support for invisible columns in psql extended describle (\d+) is added,in oracle mode only.
+Support for invisible columns in psql extended describe (\d+) is added,in oracle mode only.
 
 == Test cases
 
@@ -51,7 +51,7 @@ ivorysql=# select a,b,c from mytable;
  1 | 2 | 3
 (1 row)
 ```
-=== Support for invisible columns in psql extended describle (\d+) in Oracle mode
+=== Support for invisible columns in psql extended describe (\d+) in Oracle mode
 ```
 ivorysql=# \d+ mytable
                                                    Table "public.mytable"

EN/modules/ROOT/pages/v4.0/3.adoc

@@ -40,17 +40,18 @@ https://www.ionos.com/help/server-cloud-infrastructure/server-administration/cre
 
 +
 
-Run the following commands to perform yum installation:
+Create or edit IvorySQL yum repository configuration  /etc/yum.repos.d/ivorysql.repo
 ```
-$ sudo dnf install -y https://yum.highgo.ca/dists/ivorysql-rpms/repo/ivorysql-release-4.0-1.noarch.rpm
-
-$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test --skip-broken
+vim /etc/yum.repos.d/ivorysql.repo
+[ivorysql4]
+name=IvorySQL Server 4 $releasever - $basearch
+baseurl=https://yum.highgo.com/dists/ivorysql-rpms/4/redhat/rhel-$releasever-$basearch
+enabled=1
+gpgcheck=0
 ```
-IvorySQL will be installed in a folder named 'ivorysql-version', such as 'ivorysql-4', within the /usr/local/ivorysql directory.
-
-Grant ivorysql privileges:
+After saving and exiting, you can install IvorySQL 4 with the following steps
 ```
-$ sudo chown -R ivorysql:ivorysql /usr/local/ivorysql
+$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
 ```
 
 [[setting-environment-variables]]

EN/modules/ROOT/pages/v4.0/6.adoc

@@ -22,15 +22,19 @@ Before getting started, please create an user and grant it root privileges. All
 [[Yum-installation]]
 == Yum installation
 
-** Run dnf install commands
+Create or edit IvorySQL yum repository configuration  /etc/yum.repos.d/ivorysql.repo
 ```
-$ sudo dnf install -y https://yum.highgo.ca/dists/ivorysql-rpms/repo/ivorysql-release-4.0-1.noarch.rpm
-
-$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test --skip-broken --nogpgcheck
+vim /etc/yum.repos.d/ivorysql.repo
+[ivorysql4]
+name=IvorySQL Server 4 $releasever - $basearch
+baseurl=https://yum.highgo.com/dists/ivorysql-rpms/4/redhat/rhel-$releasever-$basearch
+enabled=1
+gpgcheck=0
+```
+After saving and exiting, you can install IvorySQL 4 with the following steps
+```
+$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
 ```
-IvorySQL then will be installed in the /usr/local/ivorysql directory.
-
-Yum configuration file /etc/yum.repos.d/ivorysql.repo will be created after the successful installation.
 
 ** Checking installation results
 ```