云原生数据库 PolarDB：PolarDB-Tools

工具名称

描述

使用方法

与原生工具区别

psql

PostgreSQL的客户端连接工具。

与原生psql工具使用方法一致，详情请参见PostgreSQL官网psql使用说明。

• 针对PolarDB PostgreSQL版（兼容Oracle）进行适配，支持Oracle兼容性语法，使用社区版本可能会出现未知异常。

• 在管理PolarDB集群过程中，如果您仅需执行简单的SQL语句，可以使用社区版psql工具。请注意，社区版psql工具不支持创建存储过程，且在创建存储过程时，SQL字符串会出现异常截断的情况。

• 使用psql客户端时，可以直接下载最新版本的PolarDB-Tools，新版本可以兼容老版本。

pg_dump

PostgreSQL的逻辑备份工具，用于备份集群中一个数据库。

与原生pg_dump使用方法一致，详情请参见PostgreSQL官网pg_dump的使用说明。

• PolarDB支持控制台进行数据备份和Redo日志备份操作。详情请参见备份策略设置。

• 针对PolarDB PostgreSQL版（兼容Oracle）进行适配，支持Oracle兼容性语法，使用社区版本可能会存在部分对象无法dump等行为。

• 使用pg_dump客户端时，可以直接下载最新版本的PolarDB-Tools，新版本可以兼容老版本。

pg_restore

PostgreSQL的备份恢复工具，用于恢复pg_dump和pg_dumpall的备份文件。

与原生pg_restore使用方法一致，详情请参见PostgreSQL官网pg_restore使用说明。

• PolarDB支持按时间点恢复数据和按备份集（快照）恢复数据两种恢复方式，将历史数据恢复到新集群中。详情请参见恢复操作说明。

• 针对PolarDB PostgreSQL版（兼容Oracle）进行适配，支持Oracle兼容性语法，使用社区版本可能会存在部分对象无法restore等行为。

• 使用pg_restore客户端时，可以直接下载最新版本的PolarDB-Tools，新版本可以兼容老版本。

ecpg

嵌入式SQL C预处理器。

与原生ecpg使用方法一致，详情请参见PostgreSQL官网ecpg的使用说明。

• 针对PolarDB PostgreSQL版（兼容Oracle）进行适配，支持Oracle兼容性语法，使用社区版本可能会存在部分对象转换失败等行为。

• 使用ecpg客户端时，可以直接下载最新版本的PolarDB-Tools，新版本可以兼容老版本。

pg_repack

回收表空间的客户端工具。

使用方法请参见pg_repack（存储空间整理）。

• 与在PolarDB PostgreSQL版（兼容Oracle）侧安装的pg_repack插件配合使用。

• pg_repack要求客户端与服务端插件版本相同，在使用时请下载与插件版本相匹配的PolarDB-Tools包。