ITPub博客

zsqlzsql是GaussDB100提供的交互和查询的客户端工具。除了具备操作数据库的基本功能，zsql还提供了若干高级特性，便于用户使用。概述连接数据库执行命令使用DESC命令查看信息使用PROMPT打印信息使用SPOOL命令保存执行结果设置参数查询参数生成分析报告其他功能退出zsql

功能介绍GaussDB100提供逻辑复制工具用于将GaussDB100的业务数据复制到其他商业数据库或数据源。目录说明表1LOGICREP目录说明目录说明GaussDB_100_1.0.1-LOGICREP/logicrep逻辑复制服务工具包。GaussDB_100_1.0.1-LOGICREP/l

下表总结了每个Roach操作的参数。表1使用PythonGaussRoach.py的各Roach操作的参数参数备份恢复删除验证显示停止启动--all-backups---√----backup-key-√√√√----prior-backup-key√-------clean-√------mast

功能help命令用于提供Roach工具支持的命令的帮助信息。命令格式pythonGaussRoach.py--help|-h参数说明无使用指南无命令示例查看Roach工具的帮助信息。pythonGaussRoach.py--help系统回显GaussRoach.pyisautilitytobacku

功能version命令用于查询Roach工具的版本号。命令格式pythonGaussRoach.py--version|-v参数说明无。使用指南无命令示例查询Roach工具的版本号。pythonGaussRoach.py--version系统回显pythonGaussRoach.py--versio

功能delete命令用于删除磁盘上的集群级备份。它可与级联选项一起使用，用于删除特定备份密钥的所有相关备份。命令格式pythonGaussRoach.py-tdelete--mode[cluster/single]--backup-keybackup-key--media-typemedia-typ

功能show命令用于以列表形式显示备份集信息，Roach支持查看所有备份集信息和指定备份存储介质的备份集信息。命令格式pythonGaussRoach.py-tshow--all-backups--backup-keybackup-key--media-typemedia-type--meta&gt

功能stop命令用于停止运行中的备份操作。命令格式pythonGaussRoach.py-tstop参数说明表1停止备份命令的命令行参数参数名参数描述取值范围缺省值应用实例-tRoach界面支持多种功能。指定该参数为stop表示调用停止功能。-tbackup-tstop-tdelete-tresto

功能start命令用于在集群恢复操作成功后启动集群。命令格式pythonGaussRoach.py-tstart--media-typemedia-type[--restore-new-cluster]参数说明表1启动命令的命令行参数参数名参数描述取值类型缺省值应用实例-tRoach接口支持多种功能

分布式部署模式下，Roach工具支持将旧集群的DISK备份集和NBU备份集恢复到新集群中，以重建或复制集群，包括全量恢复和增量恢复。单机/主备部署模式下不支持该操作。前提条件集群A与新集群B的集群版本、拓扑结构、安装包、数据库用户、DN主备关系相同。注意事项恢复集群时会自动停止新集群。操作步骤以om

单机/主备/分布式部署模式下，基于时间点的集群恢复均支持磁盘或NBU介质的集群恢复，包括全量恢复和增量恢复。注意事项恢复集群时会自动停止集群。操作步骤以omm用户身份登录GaussDB100任意服务器。进入$ROACH_HOME目录。cd$ROACH_HOME执行恢复操作。pythonGaussRo

支持从磁盘或NBU恢复集群。前提条件执行恢复操作时的集群中节点数量必须与备份操作完成时的节点数量相同。注意事项恢复集群时会自动停止集群。在恢复集群之前用户需要执行文件清理操作，用户可在执行恢复命令时增加--clean参数来完成该操作。这样系统会先检测是否满足恢复条件，只有满足时才会清理集群数据。操作

功能restore命令用于从磁盘或NBU恢复集群数据。恢复完成后要执行Roach启动命令，集群才能够正常，详见启动命令。命令格式基于备份集（全量/增量）恢复至当前集群pythonGaussRoach.py-trestore--modecluster--clean--master-portmaster

恢复命令命令说明基于备份集（全量/增量）恢复至当前集群基于时间点（全量/增量）恢复至当前集群基于备份集（全量/增量）恢复至新集群

功能执行恢复操作前，单独验证备份集完整性。在备份时打开备份完整性开关，并指定备份集验证类型才可以进行验证，已经执行过恢复的备份集不能再次进行验证。命令格式pythonGaussRoach.py-tvalidate--meta>metadata_path--media-typedisk--val

功能backup命令用于备份集群数据到NBU或磁盘，支持•全量备份集群和•增量备份集群两种备份类型。命令格式全量备份分布式部署模式下pythonGaussRoach.py-tbackup--modecluster--master-portmaster-port--media-typemedia-ty

Roach工具的约束和限制如下：常见约束限制备份和恢复过程中的集群和节点配置，及版本号必须相同。Roach工具运行过程中，不能进行Roach的其他功能操作。一个节点上进行备份操作时，其它节点上只能执行stop操作。仅支持数据库安装用户（即使用gs_preinstall执行预安装时参数-U指定的用户）

GaussRoach.py约束和限制备份命令验证备份集完整性恢复命令启动命令停止备份命令显示目录信息命令备份删除命令版本命令帮助命令Roach操作参数

数据库集群部署成功后，GaussDB100提供了gs_wsr工具将DN上的WSR报告统一生成并打包返回。前提条件可以正常连接GaussDB100数据库。集群用户互信正常。语法创建WSR的定时任务gs_wsr-tcreatetask--time=MINUTES删除WSR的定时任务gs_wsr-tdel

用户会根据GaussDB100提供的新特性，确定是否对现有系统进行升级。背景信息如果升级过程中出现异常导致升级失败，并且自动回滚失败时，需要用户自动执行回滚命令进行手动回滚。注意事项暂不支持用户进行升级操作，升级前请联系技术支持。集群用户互信正常。仅支持离线升级。当前升级支持二进制升级和小版本升级。