Add new documents for the extensions pgroonga ddlx pgrouting

Author: yuanyl630

CN/modules/ROOT/nav.adoc

@@ -14,6 +14,9 @@
 * IvorySQL生态
 ** xref:v4.5/11.adoc[PostGIS]
 ** xref:v4.5/12.adoc[pgvector]
+** xref:v4.5/34.adoc[PGroonga]
+** xref:v4.5/35.adoc[pgddl (DDL Extractor)]
+** xref:v4.5/36.adoc[pgRouting]
 * IvorySQL架构设计
 ** 查询处理
 *** xref:v4.5/31.adoc[双parser]

CN/modules/ROOT/pages/v4.5/34.adoc

@@ -0,0 +1,101 @@
+
+:sectnums:
+:sectnumlevels: 5
+
+= PGroonga
+
+== 概述
+PostgreSQL 内置了全文搜索功能，但在处理​​大规模数据​​、​​复杂查询​​以及​​非英语语言（特别是中日韩等 CJK 语言）​​ 时，其功能和性能可能无法满足高性能应用的需求。
+
+PGroonga 应运而生，它是一个 PostgreSQL 的扩展插件，将 ​​Groonga​​ 这款高性能的全功能全文搜索引擎与 PostgreSQL 数据库深度融合。Groonga 本身是一个优秀的开源搜索引擎，以其极致的速度和丰富的功能著称，尤其擅长处理多语言文本。PGroonga 的使命就是将 Groonga 的强大能力无缝地带入 PostgreSQL 的世界，为用户提供远超原生全文搜索的体验。
+
+== 安装
+根据开发环境，用户可从 https://pgroonga.github.io/install[PGroonga安装] 页面选择适合自己的方式进行PGroonga安装。
+
+=== 源码安装
+除PGroonga社区提供的安装方式以外，IvorySQL社区也提供了源码安装方式，源码安装环境为 Ubuntu 24.04(x86_64)。
+
+[TIP]
+环境中已经安装了IvorySQL4.6及以上版本，安装路径为/usr/local/ivorysql/ivorysql-4
+
+==== 安装 groonga
+
+** 安装依赖 kytea
+```
+git clone https://github.com/neubig/kytea.git
+autoreconf -i
+./configure
+make
+sudo make install
+```
+
+** 安装依赖 libzmq
+```
+从https://github.com/zeromq/libzmq/releases/tag/v4.3.5 下载zeromq-4.3.5.tar.gz
+tar xvf zeromq-4.3.5.tar.gz
+cd zeromq-4.3.5/
+./configure
+make
+sudo make install
+```
+
+** 下载 groonga包，安装指定依赖
+```
+wget https://packages.groonga.org/source/groonga/groonga-latest.tar.gz
+tar xvf groonga-15.1.5.tar.gz
+cd groonga-15.1.5
+#运行这个脚本安装依赖，支持apt和dnf包管理工具
+./ setup.sh
+```
+
+** 编译安装
+```
+# -S 指定groonga源码目录, -B 指定build目录，这个目录是个源码目录之外的一个只用于build的目录
+cmake -S /home/ivorysql/groonga-15.1.5 -B /home/ivorysql/groonga_build --preset=release-maximum
+cmake --build /home/ivorysql/groonga_build
+sudo cmake --install /home/ivorysql/groonga_build
+# 更新动态链接库缓存 
+sudo ldconfig
+```
+
+** 验证 groonga安装成功
+```
+$ groonga --version
+Groonga 15.1.5 [Linux,x86_64,utf8,match-escalation-threshold=0,nfkc,mecab,message-pack,mruby,onigmo,zlib,lz4,zstandard,epoll,apache-arrow,xxhash,blosc,bfloat16,h3,simdjson,llama.cpp]
+```
+
+==== 安装 pgroonga
+```
+wget https://packages.groonga.org/source/pgroonga/pgroonga-4.0.1.tar.gz
+tar xvf pgroonga-4.0.1.tar.gz
+cd pgroonga-4.0.1
+```
+
+编译PGroonga，有个选项：HAVE_MSGPACK=1，它是用于支持WAL，使用这个选项需要安装msgpack-c 1.4.1或者更高版本。在基于Debian的平台使用libmsgpack-dev包，在CentOS 7上用msgpack-devel
+```
+#安装依赖
+sudo apt install libmsgpack-dev
+```
+
+运行make前确保pg_config命令的路径在PATH环境变量里
+```
+make HAVE_MSGPACK=1
+make install
+```
+
+== 创建Extension并确认PGroonga版本
+
+psql 连接到数据库，执行如下命令：
+```
+ivorysql=# CREATE extension pgroonga;
+CREATE EXTENSION
+
+ivorysql=# SELECT * FROM pg_available_extensions WHERE name = 'pgroonga';
+  name   | default_version | installed_version |                          comment
+---------+-----------------+-------------------+-------------------------------------------------------------------------------
+ pgroonga| 4.0.1           | 4.0.1             | Super fast and all languages supported full text search index based on Groonga
+(1 row)
+```
+
+== 使用
+关于PGroonga的使用，请参阅 https://pgroonga.github.io/tutorial[PGroonga官方文档]

CN/modules/ROOT/pages/v4.5/35.adoc

@@ -0,0 +1,44 @@
+
+:sectnums:
+:sectnumlevels: 5
+
+= pgddl (DDL Extractor) 
+
+== 概述
+pgddl 是一个专为 PostgreSQL 数据库设计的 SQL 函数扩展，它能够直接从数据库系统目录中生成清晰、格式化的 SQL DDL (数据定义语言) 脚本，例如 CREATE TABLE 或 ALTER FUNCTION。它解决了 PostgreSQL 原生缺乏类似 SHOW CREATE TABLE 命令的问题，让用户无需借助外部工具（如 pg_dump）即可在纯 SQL 环境中轻松获取对象的创建语句。
+
+该扩展通过一组简单的 SQL 函数提供了一套完整的解决方案，其优势包括：仅需使用 SQL 查询即可操作、支持通过 WHERE 子句灵活筛选对象、并能智能处理对象之间的依赖关系，生成包含 Drop 和 Create 步骤的完整脚本。这使得它特别适用于数据库变更管理、升级脚本编写和结构审计等场景。
+
+需要注意的是，ddlx 仍在发展中，可能尚未覆盖所有 PostgreSQL 对象类型和高级选项。生成的脚本建议始终在非生产环境中先行检查和测试，以确保其正确性与安全性。
+
+== 安装
+
+[TIP]
+环境中已经安装了IvorySQL4.6及以上版本，安装路径为/usr/local/ivorysql/ivorysql-4
+
+=== 源码安装
+从https://github.com/lacanoid/pgddl/releases/tag/0.20 下载pgddl-0.20.tar.gz，解压缩。
+
+```
+cd pgddl-0.20
+# 设置PG_CONFIG环境变量值为pg_config路径，eg：/usr/local/ivorysql/ivorysql-4/bin/pg_config
+make PG_CONFIG=/path/to/pg_config
+make PG_CONFIG=/path/to/pg_config install
+```
+
+== 创建Extension并确认ddlx版本
+
+psql 连接到数据库，执行如下命令：
+```
+ivorysql=# CREATE extension ddlx;
+CREATE EXTENSION
+
+ivorysql=# SELECT * FROM pg_available_extensions WHERE name = 'ddlx';
+ name | default_version | installed_version |         comment         
+------+-----------------+-------------------+-------------------------
+ ddlx | 0.20            | 0.20              | DDL eXtractor functions
+(1 row)
+```
+
+== 使用
+关于pgddl的使用，请参阅 https://github.com/lacanoid/pgddl[ddlx官方文档]

CN/modules/ROOT/pages/v4.5/36.adoc

@@ -0,0 +1,56 @@
+
+:sectnums:
+:sectnumlevels: 5
+
+= pgRouting
+
+== 概述
+pgRouting 是一个基于 PostgreSQL/PostGIS 数据库构建的开源地理空间路由扩展库。它为数据库赋予了强大的网络分析功能，使其能够处理复杂的路径规划与图论计算问题，例如计算两点之间的最短路径、执行旅行推销员（TSP）分析或计算服务区范围等。它将路由算法直接嵌入到数据库中，从而避免了在应用层进行复杂的数据传输与计算。
+
+该扩展的核心优势在于能够利用 PostgreSQL 强大的数据管理能力和 PostGIS 丰富的空间函数，直接在数据库内部对空间网络数据执行高效计算。这不仅简化了应用程序的开发流程，还通过减少数据移动大幅提升了大规模网络分析的性能。
+
+pgRouting 广泛应用于物流配送、交通导航、网络分析、城市规划及供应链管理等多个领域。其开源特性吸引了全球开发者持续的贡献与完善，使其成为空间数据库领域进行路径分析和网络求解的首选工具之一。
+
+== 安装
+
+[TIP]
+环境中已经安装了IvorySQL4.6及以上版本，安装路径为/usr/local/ivorysql/ivorysql-4
+
+=== 源码安装
+
+** 安装依赖
+对perl有依赖，perl一般在装IvorySQL时已经装上了，这里不用再装
+CMake版本要求 >= 3.12, Boost版本 >= 1.56
+```
+#安装依赖
+sudo apt install cmake libboost-all-dev
+```
+
+** 编译安装
+```
+wget https://github.com/pgRouting/pgrouting/releases/download/v3.5.1/pgrouting-3.5.1.tar.gz
+tar xvf pgrouting-3.5.1.tar.gz
+cd pgrouting-3.5.1
+mkdir build
+cd build
+cmake .. -DPOSTGRESQL_PG_CONFIG=/path/to/pg_config  # eg: /usr/local/ivorysql/ivorysql-4/bin/pg_config
+make
+sudo make install
+```
+
+== 创建Extension并确认ddlx版本
+
+psql 连接到数据库，执行如下命令：
+```
+ivorysql=# CREATE extension pgrouting;
+CREATE EXTENSION
+
+ivorysql=# SELECT * FROM pg_available_extensions WHERE name = 'pgrouting';
+   name    | default_version | installed_version |       comment       
+-----------+-----------------+-------------------+---------------------
+ pgrouting | 3.5.1           |                   | pgRouting Extension
+(1 row)
+```
+
+== 使用
+关于pgRouting的使用，请参阅 https://docs.pgrouting.org/[pgRouting官方文档]