Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CN/antora.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: ivorysql-doc
title: IvorySQL
version: v4.5
start_page: v4.5/welcome.adoc
version: v4.6
start_page: v4.6/welcome.adoc
asciidoc:
attributes:
source-language: asciidoc@
Expand Down
3 changes: 3 additions & 0 deletions CN/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@
* IvorySQL高级
** xref:v4.6/6.adoc[安装指南]
** xref:v4.6/7.adoc[集群搭建]
** 容器化指南
*** xref:v4.6/37.adoc[K8S部署]
*** xref:v4.6/38.adoc[Docker Swarm & Docker Compose部署]
** xref:v4.6/8.adoc[开发者指南]
** xref:v4.6/9.adoc[运维管理指南]
** xref:v4.6/10.adoc[迁移指南]
Expand Down
85 changes: 53 additions & 32 deletions CN/modules/ROOT/pages/v4.6/1.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,50 +4,65 @@

== 版本概览

[**发行日期:2025年06月04日**]
[**发行日期:2025年09月10日**]


IvorySQL 4.5,基于PostgreSQL 17.5,并修复了多个问题。有关更新的完整列表,请访问我们的 https://docs.ivorysql.org/[文档网站] 。
IvorySQL 4.6,基于PostgreSQL 17.6,并修复了多个问题。有关更新的完整列表,请访问我们的 https://docs.ivorysql.org/[文档网站] 。

== 增强功能及问题修复

- PostgreSQL 17.5
- PostgreSQL 17.6

1. 修复了在检查声明为 GB18030 编码的无效字符串时,可能发生的一字节缓冲区超读(one-byte buffer overread)问题,增强了系统处理无效编码数据的稳健性。
2. 确保对分区表上存在的自引用外键(self-referential foreign keys)进行正确处理,提升了复杂数据结构下分区表的可靠性。
3. 避免了在 brin_bloom_union() 函数中合并已压缩的 BRIN 摘要(summaries)时,可能发生的数据丢失风险,保障了索引数据的准确性。
4. 修正了在嵌套 WITH 子句中的 INSERT/UPDATE/DELETE/MERGE 命令所附带的 WITH 子句内,对外部公共表表达式(CTE)名称引用时的处理逻辑,确保了复杂查询的正确执行。
5. 修复了 ALTER TABLE ADD COLUMN 命令,以确保在添加列时,能够正确处理包含默认值的域(domain)类型,提高了表结构变更操作的准确性
1. 加强规划器估算函数中的安全检查。

2. 防止利用 pg_dump 脚本攻击执行恢复操作的用户。

3. 在 pg_dump 输出结果的注释信息中,将名称内的换行符转换为空格。

4. 修复 BRIN numeric_minmax_multi_ops 支持函数中距离计算错误的问题。

5. 避免可接受的 XML 输入大小出现性能回退。


更多细节, 请参阅 https://www.postgresql.org/docs/release/17.6/[PostgreSQL发布说明].

+

更多细节, 请参阅 https://www.postgresql.org/docs/release/17.5/[PostgreSQL发布说明].
- IvorySQL 4.6 新特性

- IvorySQL 4.5
1. 内核升级至 PG 17.6

1. MIPS 全平台打包支持:特性 https://github.com/IvorySQL/IvorySQL/issues/736[#736]
2. 兼容MongoDB
+
为 MIPS 架构提供多平台介质包,支持国内外主流操作系统,包括 Red Hat、Debian、麒麟、UOS、凝思等
提供基于 FerretDB 与 DocumentDB 支持兼容 MongoDB 的解决方案

2. 新增IvorySQL 在线体验平台:特性 https://github.com/IvorySQL/ivorysql-wasm/issues/1[#1]
3. loongarch 架构全平台打包支持
+
提供面向 loongarch 架构的多平台软件包,支持国内外主流操作系统,包括Red Hat、Debian、麒麟(Kylin)、统信(UOS)以及 NSAR OS 等。
提供面向龙芯架构(LoongArch)的多平台介质包,兼容国内外主流操作系统,包括红帽(Red Hat)、Debian、麒麟(Kylin)、统信UOS、凝思NSAR OS等,同时支持x86、ARM及MIPS架构。

4. 新增IvorySQL 在线体验平台
+
提供一个基于 Web 的平台,用户可直接通过浏览器界面在线体验 IvorySQL V4.5 并进行数据库交互。

3. 新增社区行为准则:特性 https://github.com/IvorySQL/IvorySQL/issues/808[#808]
5. 容器化部署支持 (Docker Swarm)
+
为社区参与者明确了行为规范和期望,旨在营造一个友好且互相尊重的社区环境
支持在 Docker、Swarm 环境中部署 IvorySQL 单机数据库与高可用集群

4. 更新社区贡献指南:特性 https://github.com/IvorySQL/ivorysql_docs/pull/121[#121]
6. 容器化部署支持 (Kubernetes)
+
对社区贡献流程、规范和最佳实践进行了修订与完善,方便贡献者参与
支持使用 Helm 在 Kubernetes 上部署 IvorySQL 单机数据库与高可用集群

5. 实现文档构建与网站更新自动化:特性 https://github.com/IvorySQL/ivorysql_docs/issues/115[#115]
7. https://github.com/IvorySQL/ivory-cloud/releases/tag/ivyc_4.0[IvorySQL Cloud v4.0] 发布
+
通过 Pull Request (PR) 自动触发文档构建及官方网站内容更新流程
IvorySQL云平台当前支持IvorySQL v4数据库的订阅管理,以及其周边生态的全面管理

6. 改进贡献者工作流程,通过 /assign 命令自我分配任务:特性 https://github.com/IvorySQL/ivorysql_docs/issues/109[#109]
- IvorySQL 4.6 问题修复

7. IvorySQL Operator V4 适配 IvorySQL 4.5:特性 https://github.com/IvorySQL/ivory-operator/pull/79[#79]
1. 在aarch64平台上缺少依赖库libcrypt。
2. p执行make和make install时,前缀test_开头的测试项被错误地编译和安装到extension目录。
3. 文档:修复一些错别字。
4. 文档:修复安装部分的文档错误。
5. 文档:更新社区贡献流程。

== 源代码

Expand All @@ -59,23 +74,29 @@ IvorySQL主要包含2个代码仓库:
== 贡献人员
以下个人(按姓氏排序)作为补丁作者、提交者、审查者、测试者或问题报告者为此版本做出了贡献。

- Cary Huang
- Denis Lussier
- Flyingbeecd
- caffiendo
- Cédric Villemain
- flyingbeecd
- Grant Zhou
- huchangqiqi
- Pedro Lopez
- RRRRhl
- shangwei007
- tiankongbuqi
- Yasir Hussain Shah
- 初少林
- 冯若航
- 高雪玉
- 李苑
- 牛世继
- 矫顺田
- 纪虎林
- 类延良
- 梁翔宇
- 吕新杰
- 牛世继
- 潘振浩
- 石卓妍
- 隋戈
- 陶郑
- 王康
- 王守波
- 杨世华
- 严少安
- 赵法威
- 邹仁利
- 杨世华
- 赵法威
4 changes: 2 additions & 2 deletions CN/modules/ROOT/pages/v4.6/10.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -448,7 +448,7 @@ $ createdb orcl

$ psql

psql (17.5)
psql (17.6)

Type "help" for help.

Expand Down Expand Up @@ -477,7 +477,7 @@ ivorysql=#
```
$ psql orcl

psql (17.5)
psql (17.6)

Type "help" for help.

Expand Down
4 changes: 2 additions & 2 deletions CN/modules/ROOT/pages/v4.6/12.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ HNSW (Hierarchical Navigating Small World) 是一种基于图的索引算法,
== 安装
[TIP]
====
环境中已经安装了IvorySQL4.5及以上版本,安装路径为/usr/local/ivorysql/ivorysql-4
环境中已经安装了IvorySQL4.6及以上版本,安装路径为/usr/local/ivorysql/ivorysql-4
====

=== 源码安装
Expand All @@ -49,7 +49,7 @@ sudo --preserve-env=PG_CONFIG make install
** 创建pgvector扩展
```
[ivorysql@localhost ivorysql-4]$ psql
psql (17.5)
psql (17.6)
Type "help" for help.

ivorysql=# create extension vector;
Expand Down
26 changes: 13 additions & 13 deletions CN/modules/ROOT/pages/v4.6/2.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -69,16 +69,16 @@ IvorySQL是一个功能强大的开源对象关系数据库管理系统(ORDBMS)

== 与Oracle的兼容性

* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/14[ivorysql框架设计]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/15[GUC框架]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/16[大小写转换]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/17[双模式设计]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/18[兼容Oracle like]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/19[兼容Oracle匿名块]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/20[兼容Oracle函数与存储过程]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/21[内置数据类型与内置函数]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/22[新增Oracle兼容模式的端口与IP]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/26[XML函数]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/27[兼容Oracle sequence]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/28[包]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.5/v4.5/29[不可见列]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/14[ivorysql框架设计]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/15[GUC框架]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/16[大小写转换]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/17[双模式设计]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/18[兼容Oracle like]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/19[兼容Oracle匿名块]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/20[兼容Oracle函数与存储过程]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/21[内置数据类型与内置函数]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/22[新增Oracle兼容模式的端口与IP]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/26[XML函数]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/27[兼容Oracle sequence]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/28[包]
* https://docs.ivorysql.org/cn/ivorysql-doc/v4.6/v4.6/29[不可见列]
2 changes: 1 addition & 1 deletion CN/modules/ROOT/pages/v4.6/23.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ IvorySQL由一个核心开发团队维护,该团队拥有对GitHub上的IvoryS

== **贡献者指南**

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

=== 贡献前的准备

Expand Down
12 changes: 6 additions & 6 deletions CN/modules/ROOT/pages/v4.6/3.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ gpgcheck=0
```
保存退出后,安装IvorySQL4
```
$ sudo dnf install -y ivorysql4-4.5
$ sudo dnf install -y ivorysql4-4.6
```

正确安装后,数据库将被安装在/usr/ivory-4/文件夹内
Expand Down Expand Up @@ -108,27 +108,27 @@ ivorysql 3238 1551 0 20:35 pts/0 00:00:00 grep --color=auto postgres

** 从Docker Hub上获取IvorySQL镜像
```
$ docker pull ivorysql/ivorysql:4.5-ubi8
$ docker pull ivorysql/ivorysql:4.6-ubi8
```

** 运行IvorySQL
```
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.5-ubi8
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.6-ubi8
```

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

== 数据库连接

psql连接数据库:
```
$ psql -d <database>
psql (17.5)
psql (17.6)
Type "help" for help.

ivorysql=#
Expand All @@ -141,4 +141,4 @@ TIP: Docker运行IvorySQL时,需要添加额外参数,如 psql -d ivorysql -

现在可以开始使用IvorySQL啦!就是这么简单!

想要获得更多安装方式,请参考xref:v4.5/6.adoc[安装指南]
想要获得更多安装方式,请参考xref:v4.6/6.adoc[安装指南]
Loading