ITPub博客

cmctl是GaussDB100提供的用来控制集群服务的工具。该工具主要供OM调用，及集群服务自恢复时使用。功能介绍cmctlquery命令用于查询集群状态、集群中各实例的状态。cmctlreload命令用于重新加载集群配置，在需要改变集群成员等场景下使用。cmctlreload命令导入的新的配置文

cm是GaussDB100提供的用来集群管理的工具，包含cmctl、cmagent、cmserver、cmconfig、cmversion、cmhelp6个工具。cmctlcmctl是GaussDB100提供的用来控制集群服务的工具。该工具主要供OM调用，及集群服务自恢复时使用。cm_ctlcmag

本节所描述的工具主要为GaussDB100进程间运行使用的工具（主要为“2-数据库管理工具”提供相关能力），不建议用户直接使用，以防对系统运行带来影响。cmcm是GaussDB100提供的用来集群管理的工具，包含cmctl、cmagent、cmserver、cmconfig、cmversion、cm

功能介绍zencrypt工具用于密码加密，增强通讯安全，用户不直接感知。zencrypt工具的操作日志默认记录在$GSDB_HOME/log/oper路径下，日志文件名称为：zencrypt.olog。其中，zencrypt工具的日志保留个数：10，日志文件最大大小：10M，日志文件权限：600，日

操作场景在zsql中执行EXIT命令或QUIT命令可以退出当前zsql工具，即执行结束。若EXITCOMMIT的状态ON，在执行EXIT命令或QUIT命令后会触发数据提交操作，这样可以保证数据不被丢失。CLEAR命令可以清除当前命令行中的内容。示例使用EXIT命令退出当前zsql工具。EXIT使用Q

删除指定快照当前仅支持在DN上删除指定快照，不支持在CN上删除指定快照。callWSR$DROP_SNAPSHOT_RANGE(n,m);n：要删除的起始快照ID。m：要删除的截止快照ID。WSR相关视图ADM_HIST_SNAPSHOT：历史快照信息ADM_HIST_WR_CONTROL：WSR相

操作场景WSR（WorkloadStatisticsReport）用于生成性能分析报告。默认只有SYS用户有权限执行相关操作。普通用户如需使用，需要SYS用户授权：grantstatisticstouser;将statistics角色授予给普通用户。授权后，普通用户具有创建快照、查看快照、生成WSR

操作场景查询参数信息，支持模糊查询，不区分大小写。语法格式SHOW[PARAMETER[S]|PARAMETER[S]parameter_name|attr_name]参数说明PARAMETER[S]展示所有配置参数的详细信息（包括参数名称、参数的实时运行值、参数生效方式、参数类型以及修改后的参数值

zsql客户端允许使用“SET”命令设置一些客户端参数。语法格式SET[attr_name][value]参数说明attr_name属性名。可设置的属性如下所示：AUTO[COMMIT]是否自动提交。取值范围：ON，打开自动提交。OFF，关闭自动提交。默认值：OFFBIND是否开启强制输入绑定参数。

操作场景使用SPOOL命令，可以记录操作日志，便于数据库管理。操作步骤zsql可以使用SPOOL命令，将执行结果输出到操作系统的文件中去。语法如下所示。--指定输出文件,可以为相对路径,也可以为绝对路径SPOOLfile_path--保存执行结果,并关闭当前输出文件流SPOOLoff指定SPOOL文

操作场景使用SPOOL命令，可以记录操作日志，便于数据库管理。操作步骤zsql可以使用SPOOL命令，将执行结果输出到操作系统的文件中去。语法如下所示。--指定输出文件,可以为相对路径,也可以为绝对路径SPOOLfile_path--保存执行结果,并关闭当前输出文件流SPOOLoff指定SPOOL文

操作场景使用PROMPT命令，打印用户输入的内容，可以在脚本中使用此命令向用户提供信息，用于提示信息。以回车作为输入结束的标志，遇行末分号则此分号不予显示。限制输入字符串长度（包括PROMPT命令在内）为64K字节。示例打印用户信息：PROMPTPleaseenterausernamePROMPTF

操作场景zsql客户端中允许使用命令DESCRIBE或其简写DESC查看数据库对象（表、视图或同名词）的定义信息，或者查看SQL语句。语法格式查看数据库对象的定义信息。DESCRIBE[-o|-O]object或者DESC[-o|-O]object查看SQL语句。显示使用SELECT语句查询时的列描

操作场景无提示模式下执行SQL语句，执行结果会统一输出到指定文件中，而不是回显到当前屏幕。操作步骤连接数据库时指定无提示模式。zsqlomm@192.168..1-ssilent.logPleaseenterpassword:************connected.连接数据库的更多方法请参见“连

操作场景zsql允许绑定参数。参数绑定就是绑定一个变量到用作预处理的SQL语句中的对应命名占位符或问号占位符。可以有效的防止SQL注入。绑定参数的应用范围非常广，在应用程序中经常用到，可以在SQL语句中绑定多个参数，按照提示依次输入绑定类型和绑定值，就可以使得SQL语句正常执行。使用方法占位符号的格

操作场景zsql允许执行SQL脚本文件。SQL脚本文件是一个SQL文件里面包含了一批SQL语句集合。语法如下所示。文本单行最大长度为64K。单个可执行sql语句的最大长度不大于1M。使用@或者start命令执行SQL脚本使用zsql工具登录数据库后，可使用@、@@或者start命令执行SQL脚本，命

操作场景使用zsql可以执行SQL语句，完成数据、对象、权限的增、删、改、查等操作。单个可执行的sql语句最大长度不大于1M。在客户端界面直接输入单个可执行的sql语句时，确保单行小于4k字节。如果大于4k，请使用换行分隔，否则会造成语句输入不完整。执行SQL以创建表为例。CREATETABLEpl

执行命令zsql支持以下几种类型的命令输入:SQL命令，用于处理数据库中的数据，可以管理数据库，如创建用户，权限管理，配置数据库参数（需要数据库管理员权限），检测数据库系统。zsql命令用于格式化查询结果，设置会话参数，执行客户端SQL脚本，存储SQL执行结果。数据导入和导出单机/主备部署模式下：数

GaussDB100支持如下两种登录数据库的方式。口令认证登录：包括远程连接的加密口令认证和本地连接的非加密口令认证。本地免密登录：Linux系统用户登录，已经完成访问人员鉴权。所以允许通过zsql工具，登录本机运行中的数据库。SYS免密登录后可以重置SYS密码。zsql连接数据库时如果使用非交互式

zsql提供了的命令行接口，帮助用户连接服务端、使用GaussDB100。zsql具有自己独特的命令和环境。zsql执行主要有三种用法：用法一：zsql-h|-v用法二：zsql不带任何参数执行zsql，进入交互模式，再通过'connuser/password@host:port'连接到数据库。用法