全部產品
Search
文件中心

PolarDB:PolarDB-Tools

更新時間:Nov 15, 2024

本文介紹了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/目錄下。