Skip to content
Open
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
28 changes: 24 additions & 4 deletions .github/workflows/merge-build-push.yml
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,16 @@ jobs:
echo # Newline for better readability

if [[ -n "$DETECTED_VERSION" ]]; then
NEW_START_PAGE="${START_PAGE_COMPONENT_NAME}::v${DETECTED_VERSION}/${START_PAGE_FILE_PATH}"
# v5.1+ uses flat structure (no version prefix in path)
# v5.0 and earlier use nested structure (version prefix in path)
# Use version comparison: if DETECTED_VERSION >= 5.1, use flat structure
if [[ "$(printf '%s\n' "5.1" "$DETECTED_VERSION" | sort -V | head -n1)" == "5.1" ]]; then
# For v5.1+: ivorysql-doc:v5.1:welcome.adoc (no version prefix in path)
NEW_START_PAGE="${START_PAGE_COMPONENT_NAME}:v${DETECTED_VERSION}:${START_PAGE_FILE_PATH}"
else
# For v5.0 and earlier: ivorysql-doc:v5.0:v5.0/welcome.adoc (with version prefix)
NEW_START_PAGE="${START_PAGE_COMPONENT_NAME}:v${DETECTED_VERSION}:v${DETECTED_VERSION}/${START_PAGE_FILE_PATH}"
fi
yq -i ".site.start_page = \"$NEW_START_PAGE\"" "$PLAYBOOK_FILE"
echo "Updated .site.start_page in $PLAYBOOK_FILE to: $NEW_START_PAGE"
else
Expand Down Expand Up @@ -133,7 +142,17 @@ jobs:
set -euo pipefail

TARGET_BRANCH="v${LATEST_VERSION}"
EXPECTED_PATH="ivorysql-doc/v${LATEST_VERSION}/v${LATEST_VERSION}/welcome.html"

# v5.1+ uses flat structure (single-level path)
# v5.0 and earlier use nested structure (double-level path)
# Use version comparison: if LATEST_VERSION >= 5.1, use flat structure
if [[ "$(printf '%s\n' "5.1" "$LATEST_VERSION" | sort -V | head -n1)" == "5.1" ]]; then
# For v5.1+: ivorysql-doc/v5.1/welcome.html (single-level)
EXPECTED_PATH="ivorysql-doc/v${LATEST_VERSION}/welcome.html"
else
# For v5.0 and earlier: ivorysql-doc/v5.0/v5.0/welcome.html (double-level)
EXPECTED_PATH="ivorysql-doc/v${LATEST_VERSION}/v${LATEST_VERSION}/welcome.html"
fi

if [[ "${MERGED_PR_BASE}" != "${TARGET_BRANCH}" ]]; then
echo "Base branch ${MERGED_PR_BASE} is not the latest version branch ${TARGET_BRANCH}, skip index redirect check."
Expand All @@ -152,8 +171,9 @@ jobs:
if grep -q "${EXPECTED_PATH}" "${FILE_PATH}"; then
echo "${FILE_PATH} already points to latest ${LATEST_VERSION}."
else
# Replace all version segments like vX.Y or vX.Y.Z in href/location/meta/script targets
sed -i -E "s@ivorysql-doc/v[0-9]+(\\.[0-9]+){1,2}/v[0-9]+(\\.[0-9]+){1,2}/welcome\\.html@${EXPECTED_PATH}@g" "${FILE_PATH}"
# Replace path to latest version
# Handle both old double-level and new single-level path formats
sed -i -E "s@ivorysql-doc/v[0-9]+(\\.[0-9]+){1,2}/(v[0-9]+(\\.[0-9]+){1,2}/)?welcome\\.html@${EXPECTED_PATH}@g" "${FILE_PATH}"
UPDATE_NEEDED=true
echo "Updated ${FILE_PATH} to latest ${LATEST_VERSION} redirect."
fi
Expand Down
2 changes: 1 addition & 1 deletion CN/antora.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: ivorysql-doc
title: 文档中心
version: v5.1
start_page: v5.1/welcome.adoc
start_page: welcome.adoc
asciidoc:
attributes:
source-language: asciidoc@
Expand Down
150 changes: 75 additions & 75 deletions CN/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
@@ -1,90 +1,90 @@
* IvorySQL
** xref:v{ivorysql-version}/welcome.adoc[欢迎]
** xref:v{ivorysql-version}/1.adoc[发行说明]
** xref:v{ivorysql-version}/2.adoc[关于IvorySQL]
** xref:welcome.adoc[欢迎]
** xref:1.adoc[发行说明]
** xref:2.adoc[关于IvorySQL]
** IvorySQL入门
*** xref:v{ivorysql-version}/3.1.adoc[快速开始]
*** xref:v{ivorysql-version}/3.2.adoc[日常监控]
*** xref:v{ivorysql-version}/3.3.adoc[日常维护]
*** xref:3.1.adoc[快速开始]
*** xref:3.2.adoc[日常监控]
*** xref:3.3.adoc[日常维护]
** IvorySQL高级
*** xref:v{ivorysql-version}/4.1.adoc[安装指南]
*** xref:v{ivorysql-version}/4.2.adoc[集群搭建]
*** xref:v{ivorysql-version}/4.5.adoc[迁移指南]
*** xref:v{ivorysql-version}/4.3.adoc[开发者指南]
*** xref:4.1.adoc[安装指南]
*** xref:4.2.adoc[集群搭建]
*** xref:4.5.adoc[迁移指南]
*** xref:4.3.adoc[开发者指南]
*** 容器化指南
**** xref:v{ivorysql-version}/4.6.1.adoc[K8S部署]
**** xref:v{ivorysql-version}/4.6.2.adoc[Operator部署]
**** xref:v{ivorysql-version}/4.6.4.adoc[Docker & Podman部署]
**** xref:v{ivorysql-version}/4.6.3.adoc[Docker Swarm & Docker Compose部署]
*** xref:v{ivorysql-version}/4.4.adoc[运维管理指南]
**** xref:4.6.1.adoc[K8S部署]
**** xref:4.6.2.adoc[Operator部署]
**** xref:4.6.4.adoc[Docker & Podman部署]
**** xref:4.6.3.adoc[Docker Swarm & Docker Compose部署]
*** xref:4.4.adoc[运维管理指南]
*** 云服务平台指南
**** xref:v{ivorysql-version}/4.7.1.adoc[IvorySQL Cloud安装]
**** xref:v{ivorysql-version}/4.7.2.adoc[IvorySQL Cloud使用]
**** xref:4.7.1.adoc[IvorySQL Cloud安装]
**** xref:4.7.2.adoc[IvorySQL Cloud使用]
** IvorySQL生态
*** xref:v{ivorysql-version}/cpu_arch_adp.adoc[芯片架构适配]
*** xref:v{ivorysql-version}/os_arch_adp.adoc[操作系统适配]
*** xref:cpu_arch_adp.adoc[芯片架构适配]
*** xref:os_arch_adp.adoc[操作系统适配]
*** 生态组件适配
**** xref:v{ivorysql-version}/5.0.adoc[概述]
**** xref:v{ivorysql-version}/5.1.adoc[postgis]
**** xref:v{ivorysql-version}/5.2.adoc[pgvector]
**** xref:v{ivorysql-version}/5.3.adoc[pgddl(DDL Extractor)]
**** xref:v{ivorysql-version}/5.4.adoc[pg_cron]
**** xref:v{ivorysql-version}/5.5.adoc[pgsql-http]
**** xref:v{ivorysql-version}/5.6.adoc[plpgsql_check]
**** xref:v{ivorysql-version}/5.7.adoc[pgroonga]
**** xref:v{ivorysql-version}/5.8.adoc[pgaudit]
**** xref:v{ivorysql-version}/5.9.adoc[pgrouting]
**** xref:v{ivorysql-version}/5.10.adoc[system_stats]
**** xref:5.0.adoc[概述]
**** xref:5.1.adoc[postgis]
**** xref:5.2.adoc[pgvector]
**** xref:5.3.adoc[pgddl(DDL Extractor)]
**** xref:5.4.adoc[pg_cron]
**** xref:5.5.adoc[pgsql-http]
**** xref:5.6.adoc[plpgsql_check]
**** xref:5.7.adoc[pgroonga]
**** xref:5.8.adoc[pgaudit]
**** xref:5.9.adoc[pgrouting]
**** xref:5.10.adoc[system_stats]
** IvorySQL架构设计
*** 查询处理
**** xref:v{ivorysql-version}/6.1.1.adoc[双parser]
**** xref:6.1.1.adoc[双parser]
*** 兼容框架
**** xref:v{ivorysql-version}/7.1.adoc[框架设计]
**** xref:v{ivorysql-version}/7.2.adoc[GUC框架]
**** xref:v{ivorysql-version}/7.4.adoc[双模式设计]
**** xref:v{ivorysql-version}/6.2.1.adoc[initdb过程]
**** xref:7.1.adoc[框架设计]
**** xref:7.2.adoc[GUC框架]
**** xref:7.4.adoc[双模式设计]
**** xref:6.2.1.adoc[initdb过程]
*** 兼容特性
**** xref:v{ivorysql-version}/6.3.1.adoc[like]
**** xref:v{ivorysql-version}/6.3.3.adoc[RowID]
**** xref:v{ivorysql-version}/6.3.2.adoc[OUT 参数]
**** xref:v{ivorysql-version}/6.3.4.adoc[%TYPE、%ROWTYPE]
**** xref:v{ivorysql-version}/6.3.5.adoc[NLS 参数]
**** xref:v{ivorysql-version}/6.3.6.adoc[函数与存储过程]
**** xref:v{ivorysql-version}/6.3.7.adoc[嵌套子函数]
**** xref:v{ivorysql-version}/6.3.8.adoc[Force View]
**** xref:v{ivorysql-version}/6.3.9.adoc[大小写转换]
**** xref:v{ivorysql-version}/6.3.10.adoc[sys_guid 函数]
**** xref:v{ivorysql-version}/6.3.11.adoc[空字符串转null]
**** xref:v{ivorysql-version}/6.3.12.adoc[CALL INTO]
**** xref:6.3.1.adoc[like]
**** xref:6.3.3.adoc[RowID]
**** xref:6.3.2.adoc[OUT 参数]
**** xref:6.3.4.adoc[%TYPE、%ROWTYPE]
**** xref:6.3.5.adoc[NLS 参数]
**** xref:6.3.6.adoc[函数与存储过程]
**** xref:6.3.7.adoc[嵌套子函数]
**** xref:6.3.8.adoc[Force View]
**** xref:6.3.9.adoc[大小写转换]
**** xref:6.3.10.adoc[sys_guid 函数]
**** xref:6.3.11.adoc[空字符串转null]
**** xref:6.3.12.adoc[CALL INTO]
*** 内置函数
**** xref:v{ivorysql-version}/6.4.1.adoc[sys_context]
**** xref:v{ivorysql-version}/6.4.2.adoc[userenv]
*** xref:v{ivorysql-version}/6.5.adoc[国标GB18030]
**** xref:6.4.1.adoc[sys_context]
**** xref:6.4.2.adoc[userenv]
*** xref:6.5.adoc[国标GB18030]
** Oracle兼容功能列表
*** xref:v{ivorysql-version}/7.3.adoc[1、大小写转换]
*** xref:v{ivorysql-version}/7.5.adoc[2、LIKE操作符]
*** xref:v{ivorysql-version}/7.6.adoc[3、匿名块]
*** xref:v{ivorysql-version}/7.7.adoc[4、函数与存储过程]
*** xref:v{ivorysql-version}/7.8.adoc[5、内置数据类型与内置函数]
*** xref:v{ivorysql-version}/7.9.adoc[6、端口与IP]
*** xref:v{ivorysql-version}/7.10.adoc[7、XML函数]
*** xref:v{ivorysql-version}/7.11.adoc[8、sequence]
*** xref:v{ivorysql-version}/7.12.adoc[9、包]
*** xref:v{ivorysql-version}/7.13.adoc[10、不可见列]
*** xref:v{ivorysql-version}/7.14.adoc[11、RowID]
*** xref:v{ivorysql-version}/7.15.adoc[12、OUT 参数]
*** xref:v{ivorysql-version}/7.16.adoc[13、%TYPE、%ROWTYPE]
*** xref:v{ivorysql-version}/7.17.adoc[14、NLS 参数]
*** xref:v{ivorysql-version}/7.18.adoc[15、Force View]
*** xref:v{ivorysql-version}/7.19.adoc[16、嵌套子函数]
*** xref:v{ivorysql-version}/7.20.adoc[17、sys_guid 函数]
*** xref:v{ivorysql-version}/7.21.adoc[18、空字符串转null]
*** xref:v{ivorysql-version}/7.22.adoc[19、CALL INTO]
*** xref:7.3.adoc[1、大小写转换]
*** xref:7.5.adoc[2、LIKE操作符]
*** xref:7.6.adoc[3、匿名块]
*** xref:7.7.adoc[4、函数与存储过程]
*** xref:7.8.adoc[5、内置数据类型与内置函数]
*** xref:7.9.adoc[6、端口与IP]
*** xref:7.10.adoc[7、XML函数]
*** xref:7.11.adoc[8、sequence]
*** xref:7.12.adoc[9、包]
*** xref:7.13.adoc[10、不可见列]
*** xref:7.14.adoc[11、RowID]
*** xref:7.15.adoc[12、OUT 参数]
*** xref:7.16.adoc[13、%TYPE、%ROWTYPE]
*** xref:7.17.adoc[14、NLS 参数]
*** xref:7.18.adoc[15、Force View]
*** xref:7.19.adoc[16、嵌套子函数]
*** xref:7.20.adoc[17、sys_guid 函数]
*** xref:7.21.adoc[18、空字符串转null]
*** xref:7.22.adoc[19、CALL INTO]
** IvorySQL贡献指南
*** xref:v{ivorysql-version}/8.1.adoc[社区贡献指南]
*** xref:v{ivorysql-version}/8.2.adoc[asciidoc语法快速参考]
** xref:v{ivorysql-version}/9.adoc[工具参考]
** xref:v{ivorysql-version}/10.adoc[FAQ]
*** xref:8.1.adoc[社区贡献指南]
*** xref:8.2.adoc[asciidoc语法快速参考]
** xref:9.adoc[工具参考]
** xref:10.adoc[FAQ]
* PostgreSQL
** xref:v{ivorysql-version}/100.adoc[PG参数参考手册]
** xref:v{ivorysql-version}/110.adoc[PG函数参考手册]
** xref:100.adoc[PG参数参考手册]
** xref:110.adoc[PG函数参考手册]
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -157,4 +157,4 @@ TIP: Docker运行IvorySQL时,需要添加额外参数,如 psql -d ivorysql -

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

想要获得更多安装方式,请参考xref:v{ivorysql-version}/4.1.adoc[安装指南]
想要获得更多安装方式,请参考xref:4.1.adoc[安装指南]
File renamed without changes.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ IvorySQL安装方式包括以下5种:
- <<源码安装>>
- <<deb安装>>

本章将详细介绍每种方式的安装、运行及卸载过程。想要更快获得IvorySQL,请参阅xref:v{ivorysql-version}/3.1.adoc#快速开始[快速开始]。
本章将详细介绍每种方式的安装、运行及卸载过程。想要更快获得IvorySQL,请参阅xref:3.1.adoc#快速开始[快速开始]。

同样,安装前请先创建一个用户,并赋予其root权限,安装、使用和卸载均以该用户执行。这里以ivorysql用户为例。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@
== 主节点

=== 安装并启动数据库
yum源快速安装数据库,请参考xref:v{ivorysql-version}/3.1.adoc#从yum源安装ivorysql数据库[从yum源安装ivorysql数据库]。
yum源快速安装数据库,请参考xref:3.1.adoc#从yum源安装ivorysql数据库[从yum源安装ivorysql数据库]。

想要获取更多安装方式,请参考xref:v{ivorysql-version}/4.1.adoc[安装指南]。
想要获取更多安装方式,请参考xref:4.1.adoc[安装指南]。

[NOTE]
主节点数据库需要安装并**启动**
Expand Down Expand Up @@ -56,9 +56,9 @@ $ pg_ctl restart

== 备节点
=== 安装数据库
Yum源快速安装数据库,请参考xref:v{ivorysql-version}/3.1.adoc#从yum源安装ivorysql数据库[从yum源安装ivorysql数据库]。
Yum源快速安装数据库,请参考xref:3.1.adoc#从yum源安装ivorysql数据库[从yum源安装ivorysql数据库]。

想要获取更多安装方式,请参考xref:v{ivorysql-version}/4.1.adoc[安装指南]。
想要获取更多安装方式,请参考xref:4.1.adoc[安装指南]。

[NOTE]
备节点数据库只需要安装,**不需要启动**
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
28 changes: 28 additions & 0 deletions CN/modules/ROOT/pages/5.0.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
:sectnums:
:sectnumlevels: 5


[discrete]
== IvorySQL生态插件适配列表

IvorySQL 作为一款兼容 Oracle 且基于 PostgreSQL 的高级开源数据库,具备强大的扩展能力,支持丰富的生态系统插件。这些插件可以帮助用户在不同场景下增强数据库功能,包括地理信息处理、向量检索、全文搜索、数据定义提取和路径规划等。以下是当前 IvorySQL 官方兼容和支持的主要插件列表:


[cols="1,2,1,3,3"]
|====
|*序号*|*插件名称*|*版本*|*功能描述*|*适用场景*
| 1 | xref:5.1.adoc[postgis] | 3.5.4 | 为 IvorySQL 提供地理空间数据支持,包括空间索引、空间函数和地理对象存储 | 地理信息系统(GIS)、地图服务、位置数据分析
| 2 | xref:5.2.adoc[pgvector] | 0.8.1 | 支持向量相似性搜索,可用于存储和检索高维向量数据| AI 应用、图像检索、推荐系统、语义搜索
| 3 | xref:5.3.adoc[pgddl (DDL Extractor)] | 0.31 | 提取数据库中的 DDL(数据定义语言)语句,便于版本管理和迁移 | 数据库版本控制、CI/CD 集成、结构比对与同步
| 4 | xref:5.4.adoc[pg_cron]​ | 1.6.0 | 提供数据库内部的定时任务调度功能,支持定期执行SQL语句 | 数据清理、定期统计、自动化维护任务
| 5 | xref:5.5.adoc[pgsql-http]​ | 1.7.0 | 允许在SQL中发起HTTP请求,与外部Web服务进行交互 | 数据采集、API集成、微服务调用
| 6 | xref:5.6.adoc[plpgsql_check] | 2.8 | 提供PL/pgSQL代码的静态分析功能,可在开发阶段发现潜在错误 | 存储过程开发、代码质量检查、调试优化
| 7 | xref:5.7.adoc[pgroonga] | 4.0.4 | 提供​非英语语言全文搜索功能,满足高性能应用的需求 | 中日韩等语言的全文搜索功能
| 8 | xref:5.8.adoc[pgaudit] | 18.0 | 提供细粒度的审计功能,记录数据库操作日志,便于安全审计和合规性检查 | 数据库安全审计、合规性检查、审计报告生成
| 9 | xref:5.9.adoc[pgrouting] | 3.8.0 | 提供地理空间数据的路由计算功能,支持多种算法和数据格式 | 地理空间分析、路径规划、物流优化
| 10 | xref:5.10.adoc[system_stats] | 3.2 | 提供用于访问系统级统计信息的函数 | 系统监控
|====

这些插件均经过 IvorySQL 团队的测试和适配,确保在 IvorySQL 环境下稳定运行。用户可以根据业务需求选择合适的插件,进一步提升数据库系统的能力和灵活性。

我们也将持续扩展和丰富 IvorySQL 的插件生态,欢迎社区开发者提交新的插件适配建议或代码贡献。如需了解更多每个插件的详细使用方法和最新兼容版本,请参阅各插件对应的文档章节。
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
28 changes: 0 additions & 28 deletions CN/modules/ROOT/pages/v5.1/5.0.adoc

This file was deleted.

2 changes: 1 addition & 1 deletion EN/antora.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: ivorysql-doc
title: IvorySQL
version: v5.1
start_page: v5.1/welcome.adoc
start_page: welcome.adoc
asciidoc:
attributes:
source-language: asciidoc@
Expand Down
Loading