gs_backup

背景信息

openGauss部署成功后,在数据库运行的过程中,会遇到各种问题及异常状态。openGauss提供了gs_backup工具帮助openGauss备份、恢复重要数据、显示帮助信息和版本号信息。

前提条件

  • 可以正常连接openGauss数据库。
  • 在进行还原时,需要保证各节点备份目录中存在备份文件。
  • 需以操作系统用户omm执行gs_backup命令。

语法

  • 备份数据库主机

    gs_backup -t backup --backup-dir=BACKUPDIR [-h HOSTNAME] [--parameter] [--binary] [--all] [-l LOGFILE]
    
  • 恢复数据库主机

    gs_backup -t restore --backup-dir=BACKUPDIR [-h HOSTNAME] [--parameter] [--binary] [--all] [-l LOGFILE] [--force]
    
  • 显示帮助信息

    gs_backup -? | --help
    
  • 显示版本号信息

    gs_backup -V | --version
    

参数说明

gs_backup参数可以分为如下几类:

  • 备份数据库主机参数:

    • -h

      指定存储备份文件的主机名称。

      取值范围:主机名称。如果不指定主机名称,则备份当前集群。

    • --backup-dir=BACKUPDIR

      备份文件保存路径。

    • --parameter

      备份参数文件,不指定--parameter、--binary、--all参数时默认只备份参数文件。

    • --binary

      备份app目录下的二进制文件。

    • --all

      备份app目录下的二进制文件、pg_hba.conf和postgresql.conf文件。

    • -l

      指定日志文件及存放路径。

      默认值:$GAUSSLOG/om/gs_backup-YYYY-MM-DD_hhmmss.log

  • 恢复数据库主机参数:

    • -h

      指定需要恢复主机的名称。

      取值范围:主机名称。如果不指定主机,则恢复对应的备份节点。

    • --backup-dir=BACKUPDIR

      恢复文件提取路径。

    • --parameter

      恢复参数文件,不指定--parameter、--binary、--all参数时默认只恢复参数文件。

    • --binary

      恢复二进制文件。

    • --all

      恢复二进制和参数文件。

    • -l

      指定日志文件及存放路径。

      默认值:$GAUSSLOG/om/gs_backup-YYYY-MM-DD_hhmmss.log

    • --force

      节点的静态文件丢失之后强行restore,仅限--all或者--binary参数使用时才生效。

  • 其他参数:

    • -?, --help

      显示帮助信息。

    • -V, --version

      显示版本号信息。

    • -t

      指定操作类型。

      取值范围:backup或者restore。

示例

  • 使用gs_backup脚本备份数据库主机。

    gs_backup -t backup --backup-dir=/opt/software/gaussdb/backup_dir -h plat1 --parameter
    Parsing configuration files.
    Successfully parsed the configuration file.
    Performing remote backup.
    Remote backup succeeded.
    Successfully backed up cluster files.
    
  • 使用gs_backup脚本恢复数据库主机。

    gs_backup -t restore --backup-dir=/opt/software/gaussdb/backup_dir -h plat1 --parameter
    Parsing configuration files.
    Successfully parsed the configuration file.
    Performing remote restoration.
    Successfully restored cluster files.
    
意见反馈
编组 3备份
openGauss 2024-03-19 00:49:40
取消