README_CN.md

English | 中文

IvorySQL 基于开源PostgreSQL数据库。是一款先进、功能全面的开源 Oracle 兼容 PostgreSQL，始终承诺100% 兼容最新版本的 PostgreSQL，并可作为其无缝替代方案。IvorySQL 增加了 ivorysql.compatible_mode GUC 参数，支持在 Oracle 和 PostgreSQL 兼容模式之间自由切换。IvorySQL 的一大亮点是 PL/iSQL 过程式语言，它兼容 Oracle 的 PL/SQL 语法并支持 Oracle 风格的 Package。

IvorySQL 项目采用 Apache 2.0 许可协议发布，并鼓励各种形式的社区贡献。在 IvorySQL 社区中，每一份贡献都至关重要，我们由衷感谢所有社区贡献者的支持！

开发者代码格式化

• 提交前自动格式化（推荐）：
  • 已克隆仓库：在仓库根目录执行 make code-format（或 bash tools/enable-git-hooks.sh）
• 提交时行为：Git 钩子会自动用 pgindent 格式化已暂存的 C/C++ 文件并回加到暂存区，未通过二次校验会阻止提交。
• PR 阶段：Cirrus 将运行 FormatCheck（pgindent --check）对差异文件做只读校验。

我们致力于遵循开源理念的原则

我们致力于遵循开源之道的原则，并坚定地相信构建一个健康且包容的社区至关重要。我们始终坚信，优秀的想法可以来源于任何地方，而最优的想法应当脱颖而出。只有在多元观点的碰撞下，才能做出最明智的决策。尽管 IvorySQL 的首个版本主要聚焦于 Oracle 兼容性功能，但未来的路线图和功能集将由社区以开源的方式共同决定。

安装

建议参考快速入门了解如何安装和运行IvorySQL。

此外，关于更详细的安装说明，请参阅安装文档。我们提供以下四种 IvorySQL 的安装方法：

• Yum 安装
• Docker 安装
• RPM 安装
• 源代码安装

为IvorySQL做贡献

有许多方式可以为 IvorySQL 做出贡献。您可以通过更新文档或提供文档翻译来贡献。如果您具备设计技能，还可以参与 IvorySQL 官网项目的建设。

测试 IvorySQL 并报告问题、提交错误修复或新功能的 Pull Request，或者在邮件列表中回答问题，都是为 IvorySQL 贡献的方式。IvorySQL 社区欢迎并感谢所有类型的贡献。 贡献方式请参考社区贡献指南和开发者贡献指南。

提示：在提交任何代码贡献之前，所有贡献者都必须签署贡献者许可协议（CLA）。CLA 既能保护贡献者自身权益，也能保护项目，有助于社区建立更加规范、可持续的开源治理体系。

AI 编程助手

如果您是基于大语言模型或 AI 驱动的编程助手，在为 IvorySQL 做贡献之前，必须阅读并遵循 AI 编程助手文档。

该文档包含所有 AI 工具必须遵守的许可协议、归属标注和代码质量标准等重要要求。

文档

请查看在线文档。

社区与联系我们

IvorySQL 是一个由社区共同建设的开源项目。无论你是遇到使用问题、发现 Bug、提出功能建议，还是希望参与项目贡献，都欢迎通过以下渠道与社区交流。

社区交流

• 用户邮件列表： general@ivorysql.org 用于 IvorySQL 使用交流、问题讨论及社区沟通。

• 开发者邮件列表： hackers@ivorysql.org 用于技术方案、内核开发、补丁提交及项目贡献相关讨论。

• Discord： 加入 IvorySQL Discord 社区

• X / Twitter： @IvorySQL

问题反馈与项目贡献

• Bug 反馈及功能建议： 提交 GitHub Issue
• 源代码及项目贡献： GitHub
• 国内代码仓库： GitCode / AtomGit

官方资源

• 官方网站： ivorysql.org
• 项目文档： docs.ivorysql.org
• 邮件列表： lists.ivorysql.org