docs: add IvorySQL 5.4 Pgpool-II integration guide - #296
Open
messere1 wants to merge 2 commits into
Open
Conversation
Assisted-by: OpenAI:gpt-5
|
🚀 IvorySQL-Docs Preview Ready
|
Contributor
|
Thank you for your contribution. We will review it as soon as possible. |
Contributor
|
Pgpool-II 复用了PG的语法解析器，那么站在IvorySQL的角度，当SQL语句全部是Oracle兼容语法时，似乎会全部路由到主节点。 |
Distinguish PostgreSQL-syntax load balancing from Oracle-mode connectivity, document primary routing on parse errors, and describe per-node routing validation. Assisted-by: OpenAI:gpt-5
Contributor
Author
|
谢谢提醒。我核对了 Pgpool-II 4.7 的发行说明和负载均衡规则(https://www.pgpool.net/docs/4.7/en/html/runtime-config-load-balancing.html)：它使用 PostgreSQL 18 的解析器；在本文采用的流复制模式下，Pgpool-II 无法解析的语句会发送到主库。因此，超出其解析器语法范围的 Oracle 专用语句，即使启用 load_balance_mode，也不会获得读负载均衡。 设置 ivorysql.compatible_mode = oracle 不会切换 Pgpool-II 的解析器，但也不意味着该会话中的每条 SQL 都无法解析。能够解析的只读查询仍需满足其余负载均衡条件。 已在 f3b911b 中同步修改中英文文档：
|
|
🚀 IvorySQL-Docs Preview Ready
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Why
Pgpool-II adds connection pooling, streaming-replication awareness, and read scaling in front of IvorySQL. The existing ecosystem documentation did not contain a tested IvorySQL-specific setup or explain the boundary between a minimal pooling configuration and a production failover design.
Fixes IvorySQL/IvorySQL#1118
Validation
Environment: Ubuntu 22.04 x86_64, IvorySQL 5.4 / PostgreSQL 18.4, Pgpool-II 4.7.2.
SHOW POOL_NODESreported both nodesup, withprimary/standbyroles and zero replication delaySHOW POOL_PROCESSESconfirmed backend connection-pool activityivorysql.compatible_mode = oracleand queried through Pgpool-II successfully--failure-level WARNgit diff --checkpassesUser impact
Users gain a reproducible path to pool IvorySQL connections and scale reads. The guide intentionally disables automatic failover in the minimal example and lists the fencing, promotion, authentication, and consistency work required before production use.