PolarDB-Tools

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

使用指南

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

工具名称

描述

使用方法

与原生工具区别

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包。

下载与安装

  1. 下载PolarDB-Tools安装包,下载链接如下:

    系统版本

    处理器架构

    PolarDB内核小版本

    pg_repack版本

    PolarDB-Tools版本

    PolarDB-Tools安装包

    AliOS 8/

    ALinux 3/

    Anolis 8/

    CentOS 8

    X86

    2.0.14.26.0

    1.5.1-1

    20241030

    PolarDB-Tools-2.0.14.26.0-20241023104506.al8.x86_64.rpm

    ARM

    2.0.14.26.0

    1.5.1-1

    20241030

    PolarDB-Tools-2.0.14.26.0-20241023104506.al8.aarch64.rpm

    AliOS 7/

    ALinux 2/

    Anolis 7/

    CentOS 7

    X86

    2.0.14.26.0

    1.5.1-1

    20241030

    PolarDB-Tools-2.0.14.26.0-20241023104506.alios7.x86_64.rpm

    ARM

    2.0.14.26.0

    1.5.1-1

    20241030

    PolarDB-Tools-2.0.14.26.0-20241023104506.alios7.aarch64.rpm

  2. 执行以下命令,进行安装。

    yum install PolarDB-Tools-2.0.14.10.0-20230622222102.al8.x86_64.rpm	
    说明

    其中安装包名称请以实际下载获取的安装包名称为准。

    安装完成后,工具在系统的/u01/polardb_pg_tools/bin/目录下。