This topic describes the components of PolarDB-Tools and how to download and install PolarDB-Tools.
Usage guide
PolarDB-Tools is a set of PolarDB client tools for Alibaba Cloud Linux, Rocky Linux, CentOS Stream, and all versions of CentOS. It includes the following tools:
psql: A client tool to connect to PostgreSQL.
For more information, see the psql documentation on the official PostgreSQL website.
pg_dump: A logical backup tool for PostgreSQL used to back up a single database in a cluster.
For more information, see the pg_dump documentation on the official PostgreSQL website.
pg_restore: A backup and restoration tool for PostgreSQL used to restore backup files created by pg_dump and pg_dumpall.
For more information, see the pg_restore documentation on the official PostgreSQL website.
ecpg: An embedded SQL C preprocessor.
For more information, see the ecpg documentation on the official PostgreSQL website.
If you only need to run simple SQL statements to manage a PolarDB cluster, you can use the community version of psql. Note that the community version of psql does not support creating stored procedures. If you use it to create a stored procedure, the SQL string might be truncated.
When you use clients such as psql, pg_dump, and pg_restore, we recommend that you download the latest client version. New versions are backward compatible.
Download and install
Download the PolarDB-Tools installation package. The download links are as follows:
PolarDB database engine
System version
Processor architecture
PolarDB-Tools installation package
PostgreSQL 17
AliOS 8
Alibaba Cloud Linux 3
Noteglibc version: 2.32.
x86
ARM
AliOS 7
Alibaba Cloud Linux 2
Anolis 7
CentOS 7
Noteglibc version: 2.17.
x86
ARM
PostgreSQL 16
AliOS 8
Alibaba Cloud Linux 3
Noteglibc version: 2.32.
x86
ARM
AliOS 7
ALinux 2
Anolis 7
CentOS 7
Noteglibc version: 2.17.
x86
ARM
PostgreSQL 15
AliOS 8
Alibaba Cloud Linux 3
Noteglibc version: 2.32.
x86
ARM
AliOS 7
Alibaba Cloud Linux 2
Anolis 7
CentOS 7
Noteglibc version: 2.17.
x86
ARM
PostgreSQL 14
AliOS 8
Alibaba Cloud Linux 3
Noteglibc version: 2.32.
x86
ARM
Anolis 8
CentOS 8
Rocky 8
Noteglibc version: 2.28.
x86
ARM
AliOS 7
Alibaba Cloud Linux 2
Anolis 7
CentOS 7
Noteglibc version: 2.17.
x86
ARM
Run the following command to install the package.
NoteReplace the package name with the name of the package you downloaded.
yum install PolarDB-Tools-2.0.14.30.0-20250301091754.alios7.x86_64.rpmAfter the installation is complete, the tools are installed in the
/u01/polardb_pg_tools/bin/directory.