PolarDBTools的组成以及如何下载安装PolarDBTools-阿里云帮助中心

本章节介绍了PolarDB-Tools的组成以及如何下载安装PolarDB-Tools。

PolarDB-Tools由一组适用于Alibaba Cloud Linux、Rocky Linux、CentOS Stream以及CentOS所有版本的PolarDB客户端工具集组成，包含了以下几种工具：

说明

建议使用Polar-Tools来管理PolarDB PostgreSQL版（兼容Oracle）。

Polar-Tools中的工具（如：psql、pg_dump等）与对应的社区版本工具存在差异，Polar-Tools中的工具针对PolarDB PostgreSQL版（兼容Oracle）进行了适配。使用社区版本的psql、pg_dump等工具可能会出现未知异常、备份或恢复的对象数据不完整等情况。

工具名称	描述	使用说明
psql	客户端连接工具。	请参见PostgreSQL官网psql使用说明。
polarplus	兼容Oracle的PolarDB客户端连接工具。	请参见PolarPlus。
pg_dump	逻辑备份工具，用于备份集群中的一个数据库。	请参见pg_dump。
pg_dumpall	逻辑备份工具，用于备份集群中的所有数据库。	请参见PostgreSQL官网pg_dumpall使用说明。
pg_basebackup	物理备份工具，用于备份集群中的全部数据。	请参见PostgreSQL官网pg_basebackup使用说明。
pg_restore	备份恢复工具，用于恢复pg_dump和pg_dumpall的备份文件。	请参见PostgreSQL官网pg_restore使用说明。

下载与安装

下载PolarDB-Tools安装包，下载链接：PolarDB-Tools.tar.gz，下载后解压得到的PolarDB-Tools目录结构如下所示。

polardb-tools
├── bin
│   ├── pg_basebackup
│   ├── pg_dump
│   ├── pg_dumpall
│   ├── pg_restore
│   └── psql
├── etc
│   └── sysconfig
├── help
├── lib
├── login.sql
├── polarplus -> ./polarplus.sh
├── polarplus.jar
└── polarplus.sh

解压得到的PolarDB-Tools目录下的bin目录即可执行程序，对于polarplus程序请参考PolarPlus进行相关配置后使用。
您可以通过修改全局环境变量配置文件（/etc/profile）或个人环境变量配置文件（如/root/.bash_profile、/root/.bashrc、$HOME/.bash_profile、$HOME/.bashrc）将PolarDB-Tools工具添加至PATH环境变量中，便于直接使用相应工具。
1. 打开配置文件，此处以$HOME/.bashrc为例：
```
vim $HOME/.bashrc
```
2. 在文件末尾添加以下配置，将{pwd}替换为polardb-tools目录所在的绝对路径。
```
export PATH=$PATH:/{pwd}/polardb-tools/bin
```
3. 执行如下语句使其生效。
```
source $HOME/.bashrc
```

说明

如果使用相关工具时遇到类似以下的错误提示，则表明当前环境中缺少运行时所需的动态库，可通过yum install命令安装对应的包以解决此类问题。

psql: error while loading shared libraries: libreadline.so.6: cannot open shared object file: No such file or directory