PolarDBTools的組成以及如何下載安裝PolarDBTools - PolarDB

本章節介紹了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