All Products
Search
Document Center

PolarDB:PolarDB-Tools

Last Updated:Jun 19, 2025

This topic describes the components of PolarDB-Tools and how to download and install PolarDB-Tools.

Usage

PolarDB-Tools is a set of client tools for PolarDB. PolarDB-Tools is compatible with Linux operating systems, including Alibaba Cloud Linux, Rocky Linux, CentOS Stream, and CentOS. The following table describes the tools in PolarDB-Tools.

  • psql: PostgreSQL client connection tool.

  • pg_dump: PostgreSQL logical backup tool for backing up a single database in the cluster.

  • pg_restore: PostgreSQL backup restore tool for restoring backup files from.

  • ecpg: Embedded SQL C preprocessor.

Note
  • If you need to execute only simple SQL statements to manage PolarDB clusters, you can use the psql community edition. Take note that the community edition of the psql tool does not allow you to create stored procedures. If you use the community edition of the psql tool to create stored procedures, SQL statements may be unexpectedly truncated.

  • To use the psql, pg_dump, or pg_restore tool, you can directly download the latest version of PolarDB-Tools. The latest version is compatible with older versions.

Download and installation

  1. Download the PolarDB-Tools installation package. The following table lists the download links for different operating system versions.

    PolarDB database engine

    Operating system version

    Processor architecture

    PolarDB-Tools installation package

    PostgreSQL 17

    AliOS 8/

    ALinux 3/

    Anolis 8/

    CentOS 8

    X86

    PolarDB-Tools-2.0.17.1.0-20250118123226.al8.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.17.1.0-20250118123226.al8.aarch64.rpm

    AliOS 7/

    ALinux 2/

    Anolis 7/

    CentOS 7

    X86

    PolarDB-Tools-2.0.17.1.0-20250118123226.alios7.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.17.1.0-20250118123226.alios7.aarch64.rpm

    PostgreSQL 16

    AliOS 8/

    ALinux 3/

    Anolis 8/

    CentOS 8

    X86

    PolarDB-Tools-2.0.16.3.0-20250313193430.al8.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.16.3.0-20250313193430.al8.aarch64.rpm

    AliOS 7/

    ALinux 2/

    Anolis 7/

    CentOS 7

    X86

    PolarDB-Tools-2.0.16.3.0-20250313193430.alios7.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.16.3.0-20250313193430.alios7.aarch64.rpm

    PostgreSQL 15

    AliOS 8/

    ALinux 3/

    Anolis 8/

    CentOS 8

    X86

    PolarDB-Tools-2.0.15.2.0-20240805142651.al8.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.15.2.0-20240805142651.al8.aarch64.rpm

    AliOS 7/

    ALinux 2/

    Anolis 7/

    CentOS 7

    X86

    PolarDB-Tools-2.0.15.2.0-20240805142651.alios7.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.15.2.0-20240805142651.alios7.aarch64.rpm

    PostgreSQL 14

    AliOS 8/

    ALinux 3/

    Anolis 8/

    CentOS 8

    X86

    PolarDB-Tools-2.0.14.33.0-20250523102322.al8.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.14.33.0-20250523102322.al8.aarch64.rpm

    AliOS 7/

    ALinux 2/

    Anolis 7/

    CentOS 7

    X86

    PolarDB-Tools-2.0.14.33.0-20250523102322.alios7.x86_64.rpm

    ARM

    PolarDB-Tools-2.0.14.33.0-20250523102322.alios7.aarch64.rpm

  2. Run the following installation command.

    yum install PolarDB-Tools-2.0.14.30.0-20250301091754.alios7.x86_64.rpm
    Note

    Replace the sample name used in the preceding command with the name of the installation package that you download.

    After the installation package is installed, the tools in PolarDB-Tools appear in the /u01/polardb_pg_tools/bin/ directory of the system.