README.md

# PostgreSQL 中文文档

PostgreSQL 中文文档社区，从实操的角度整理翻译 PostgreSQL 相关文档，包括快速开始、安装指南、开发工具配置、代码案例等。


## 内容列表
<details>
    <summary>展开查看内容列表</summary>

-   [前言](preface.html)

    -   [1.什么是PostgreSQL？](intro-whatis.html)

    -   [2.PostgreSQL的简史](history.html)

    -   [3.公约](notation.html)

    -   [4.进一步资料](resources.html)

    -   [5.漏洞报告指南](bug-reporting.html)

-   [一、教程](tutorial.html)

    -   [1.开始](tutorial-start.html)

    -   [2.SQL语言](tutorial-sql.html)

    -   [3.高级功能](tutorial-advanced.html)

-   [二、SQL语言](sql.html)

    -   [4.SQL语法](sql-syntax.html)

    -   [5.数据定义](ddl.html)

    -   [6.数据操纵](dml.html)

    -   [7.查询](queries.html)

    -   [8.数据类型](datatype.html)

    -   [9.功能和操作员](functions.html)

    -   [10.类型转换](typeconv.html)

    -   [11.索引](indexes.html)

    -   [12.全文搜索](textsearch.html)

    -   [13.并发控制](mvcc.html)

    -   [14.表演技巧](performance-tips.html)

    -   [15.并行查询](parallel-query.html)

-   [三、服务器管理](admin.html)

    -   [16.从二进制文件安装](install-binaries.html)

    -   [17.从源代码安装](installation.html)

    -   [18.从Windows上的源代码安装](install-windows.html)

    -   [19.服务器设置和操作](runtime.html)

    -   [20.服务器配置](runtime-config.html)

    -   [21.客户端身份验证](client-authentication.html)

    -   [22.数据库角色](user-manag.html)

    -   [23.管理数据库](managing-databases.html)

    -   [24.本地化](charset.html)

    -   [25.日常数据库维护任务](maintenance.html)

    -   [26.备份和恢复](backup.html)

    -   [27.高可用性、负载平衡和复制](high-availability.html)

    -   [28.监测数据库活动](monitoring.html)

    -   [29.监视磁盘使用情况](diskusage.html)

    -   [30.可靠性和预写日志](wal.html)

    -   [31.逻辑复制](logical-replication.html)

    -   [32.即时编译（JIT）](jit.html)

    -   [33.回归测试](regress.html)

-   [四、客户端接口](client-interfaces.html)

    -   [34.libpq-C库](libpq.html)

    -   [35.大型物体](largeobjects.html)

    -   [36.ECPG-C中的嵌入式SQL](ecpg.html)

    -   [37.信息模式](information-schema.html)

-   [五、服务器编程](server-programming.html)

    -   [38.扩展SQL](extend.html)

    -   [39.触发器](triggers.html)

    -   [40.事件触发器](event-triggers.html)

    -   [41.规则体系](rules.html)

    -   [42.程序语言](xplang.html)

    -   [43.PL/pgSQL——SQL过程语言](plpgsql.html)

    -   [44.PL/Tcl-Tcl过程语言](pltcl.html)

    -   [45.PL/Perl——Perl过程语言](plperl.html)

    -   [46.PL/Python——Python过程语言](plpython.html)

    -   [47.服务器编程接口](spi.html)

    -   [48.后台工作进程](bgworker.html)

    -   [49.逻辑解码](logicaldecoding.html)

    -   [50.复制进度跟踪](replication-origins.html)

-   [六、参考文献](reference.html)

    -   [一、SQL逗号-nds](sql-commands.html)
    -   [二、PostgreSQL客户端应用程序](reference-client.html)
    -   [三、 PostgreSQL Server应用程序](reference-server.html)

-   [七、内部构件](internals.html)

    -   [51.PostgreSQL内部结构概述](overview.html)

    -   [52.系统目录](catalogs.html)

    -   [53.前端/后端协议](protocol.html)

    -   [54.PostgreSQL编码约定](source.html)

    -   [55.母语支持](nls.html)

    -   [56.编写过程语言处理程序](plhandler.html)

    -   [57.编写外国数据包装器](fdwhandler.html)

    -   [58.编写表格抽样方法](tablesample-method.html)

    -   [59.编写自定义扫描提供程序](custom-scan.html)

    -   [60.遗传查询优化器](geqo.html)

    -   [61.表访问方法接口定义](tableam.html)

    -   [62.索引访问方法接口定义](indexam.html)

    -   [63.通用记录](generic-wal.html)

    -   [64.B树索引](btree.html)

    -   [65.主要索引](gist.html)

    -   [66.标准普尔GiST指数](spgist.html)

    -   [67.杜松子酒指数](gin.html)

    -   [68.布林指数](brin.html)

    -   [69.散列索引](hash-index.html)

    -   [70.数据库物理存储](storage.html)

    -   [71.系统目录声明和初始内容](bki.html)

    -   [72.规划者如何使用统计数据](planner-stats-details.html)

    -   [73.备份清单格式](backup-manifest-format.html)

-   [八、附录](appendixes.html)

    -   [A.PostgreSQL错误代码](errcodes-appendix.html)

    -   [B.日期/时间支持](datetime-appendix.html)

    -   [C.SQL关键字](sql-keywords-appendix.html)

    -   [D.SQL一致性](features.html)

    -   [E.发行说明](release.html)

    -   [F.额外提供的模块](contrib.html)

    -   [G.额外提供的程序](contrib-prog.html)

    -   [H.外部项目](external-projects.html)

    -   [I.源代码存储库](sourcerepo.html)

    -   [J.文件](docguide.html)

    -   [K.PostgreSQL限制](limits.html)

    -   [L.首字母缩略词](acronyms.html)

    -   [M.词汇表](glossary.html)

    -   [N.颜色支持](color.html)

    -   [O.过时或重命名的功能](appendix-obsolete.html)

</details>

## 贡献者列表
<div id="list" style="display: flex; flex-wrap: wrap">
    <a href="https://gitcode.net/zkxw2008" style="padding-right: 5px;">
        <img width="40px;" src="https://profile.csdnimg.cn/E/1/2/1_zkxw2008">
    </a>
    <a href="https://gitcode.net/lshemail" style="padding-right: 5px;">
        <img width="40px;" src="https://profile.csdnimg.cn/D/4/5/1_lshemail">
    </a>
</div>

## 参与贡献流程

所有 **`PostgreSQL 熟练使用者`** 可以参与到`PostgreSQL 中文文档`的建设中来，选择自己感兴趣题目，可以直接撰写文章，也可以翻译 [PostgreSQL 官方](https://www.postgresql.org/docs/14/index.html) 上面的内容，也可以校对别人翻译的文章。具体贡献流程如下。
![](./readme/readme-1.png)

### 1. 阅读文档帮助改善

在[`PostgreSQL 中文文档`](https://docs.gitcode.net/pg/guide)上浏览某一篇文档时，发现有不准确的地方，可以`随时`在该页面的左下方点击`在 GitCode 上编辑此页`。
![](./readme/readme-2.png)

### 2. 在 `GitCode` 校对/创作

进入 `GitCode` 之后，会自动定位到你想要修改的文件，修改文件内容。

#### 2-1. 仓库的成员

如果是仓库的成员，点击`“编辑”按钮，会直接进入可编辑的状态，供你修改文件内容。

![](./readme/readme-3.png)

![](./readme/readme-4.png)

#### 2-2. 非仓库的成员

如果是非仓库的成员，点击`“编辑”`，`GitCode` 会提醒你没有权限编辑，可以点击`Fork`按钮，将该项目克隆到你的 `GitCode` 账户下。

![](./readme/readme-5.png)


### 3. 内容编辑完成提交PR

内容编辑完成者向[此仓库](https://gitcode.net/dev-cloud/pg)提交 MR（Merge Request）。

### 4. 审核
[主仓库](https://gitcode.net/dev-cloud/pg) 管理者会 Review，符合要求的，即会 Merge 到[主仓库](https://gitcode.net/dev-cloud/pg)中。

### 5. 查看更新
Merge 成功之后，稍等片刻就可以刷新页面查看更新。


## 专业词汇表（持续更新，欢迎补充）
| 术语                       | 翻译                       |
|--------------------------|--------------------------|
| PostgreSQL              | PostgreSQL              |


<!-- 
## 声明 -->