sdb_maria_ctl 是 MariaDB 实例组件的管理工具。用户通过 sdb_maria_ctl 既可以初始化、启动和停止实例，也可以修改实例的引擎配置参数。
| 参数 | 描述 | 是否必填 |
|---|---|---|
| -h | 返回帮助说明 | 否 |
| -D | 指定数据库储存路径 | 是 |
| -l | 指定日志文件，默认在安装路径下，与实例名同名 | 否 |
| -P | 指定 MariaDB 服务的监听端口，默认为 6101 | 否 |
| -f | 指定 pid 文件，默认为数据库储存路径下的 mysqld.pid |
否 |
| -s | 指定 mysqld.sock 文件，默认为数据库储存路径下的 mysqld.sock |
否 |
| -w | 指定本地连接 root 用户的密码 | 否 |
| -g | 指定要加入的实例组名，默认为空 | 否 |
| -k | 指定实例组用户密码的密钥，默认为空 | 否 |
| -a | 客户端最大连接数，默认为 1024 | 否 |
| -e | 错误日志级别，默认为 3 | 否 |
| -v | 输出版本信息 | 否 |
| --sdb-conn-addr | 所连接 SequoiaDB 集群的协调节点地址 | 否 |
| --sdb-user | SequoiaDB 用户名 | 否 |
| --sdb-passwd | SequoiaDB 用户密码 | 否 |
| --sdb-cipherfile | SequoiaDB 用户密码的密文文件路径 | 否 |
| --sdb-token | SequoiaDB 用户密码的加密令牌 | 否 |
| 打印日志信息 | 否 | |
| --baklog | 删除实例时是否备份日志文件 | 否 |
运行 sdb_maria_ctl 工具时，应使用数据库管理用户（安装 MariaDB 实例组件时指定，默认为 sdbadmin）权限。
创建实例
sdb_maria_ctl addinst <INSTNAME> <-D DATADIR> [-l LOGFILE] [--print] [-P PORT] [-f PIDFILE] [-s SOCKETFILE] [-w PASSWORD] [-g INST_GROUP_NAME] [-k INST_GROUP_KEY] [--sdb-conn-addr=ADDR] [--sdb-user USER] [--sdb-passwd PASSWD] [--sdb-cipherfile PATH] [--sdb-token TOKEN]
添加一个 myinst 的实例，指定数据库存储路径为 /opt/sequoiasql/mariadb/database/3306/，指定密码为 123456
$ sdb_maria_ctl addinst myinst -D /opt/sequoiasql/mariadb/database/3306/ -l /opt/sequoiasql/mariadb/database/myinst.log --print -P 3306 -f /opt/sequoiasql/mariadb/database/myinst.pid -s /opt/sequoiasql/mariadb/database/myinst.sock -w 123456
启动实例
sdb_maria_ctl start <INSTNAME> [--print]
$ sdb_maria_ctl start myinst
查看实例状态
sdb_maria_ctl status [INSTNAME]
$ sdb_maria_ctl status myinst
重启实例
sdb_maria_ctl restart <INSTNAME>
$ sdb_maria_ctl restart myinst
停止实例
sdb_maria_ctl stop <INSTNAME> [--print]
$ sdb_maria_ctl stop myinst
删除实例
sdb_maria_ctl delinst <INSTNAME> [--baklog]
$ sdb_maria_ctl delinst myinst
查看所有添加的实例
$ sdb_maria_ctl listinst
启动所有实例
$ sdb_maria_ctl startall
停止所有实例
$ sdb_maria_ctl stopall
创建一个实例并加入实例组
sdb_maria_ctl addinst <INSTNAME> <-D DATADIR> [-l LOGFILE] [--print] [-P PORT] [-f PIDFILE] [-s SOCKETFILE] [-w PASSWORD] [-g INST_GROUP_NAME] [-k INST_GROUP_KEY] [--sdb-conn-addr=ADDR] [--sdb-user USER] [--sdb-passwd PASSWD] [--sdb-cipherfile PATH] [--sdb-token TOKEN]
先初始化一个名为“sql_group”实例组
$ ha_inst_group_init sql_group
Note：
ha_inst_group_init 的使用可参考实例组。
创建一个名为“inst1”的 MariaDB 实例并加入 sql_group 实例组
$ sdb_maria_ctl addinst inst1 -D /opt/sequoiasql/mariadb/database/3309 -P 3309 -g sql_group
已有实例加入实例组
sdb_maria_ctl join <INSTANCE> <-g INST_GROUP_NAME> [-k INST_GROUP_KEY] [--force]
将 inst2 实例加入到实例组
$ sdb_maria_ctl join inst2 -g sql_group
从实例组中移除实例
sdb_maria_ctl leave <INSTANCE> <-g INST_GROUP_NAME> [--force]
从 sql_group 实例组中移除 inst2 实例
$ sdb_maria_ctl leave inst2 -g sql_group
用户可通过 sdb_maria_ctl 指定实例名修改所有 SequoiaDB 引擎配置，各配置项说明可参考 SequoiaDB 引擎配置。实例组功能的使用及相关配置项可参考实例组。
sdb_maria_ctl chconf <INSTNAME> [-P PORT] [-e LEVEL] [-a MAX-CON]
[--sdb-conn-addr=ADDR] [--sdb-user=USER] [--sdb-passwd=PASSWD] [--sdb-auto-partition=BOOL] [--sdb-use-bulk-insert=BOOL]
[--sdb-bulk-insert-size=SIZE] [--sdb-use-autocommit=BOOL]
[--sdb-debug-log=BOOL] [--sdb-token=TOKEN] [--sdb-cipherfile=PATH] [--sdb-error-level=ENUM] [--sdb-replica-size=SIZE]
[--sdb-use-transaction=BOOL] [--sdb-optimizer-options=SET]
[--sdb-rollback-on-timeout=BOOL] [--sdb-execute-only-in-mysql=BOOL]
[--sdb-selector-pushdown-threshold=THRESHOLD] [--sdb-alter-table-overhead-threshold=THRESHOLD]
[--sdb-lock-wait-timeout=TIMEOUT] [--sdb-use-rollback-segments=BOOL] [--sdb-stats-mode=MODE] [--sdb-stats-sample-num=NUM]
[--sdb-stats-sample-percent=DOUBLE] [--sdb-stats-cache=BOOL] [--inst-group-name=NAME] [--inst-group-key=KEY]
修改 myinst 实例的 SequoiaDB 连接地址
$ sdb_maria_ctl chconf myinst --sdb-conn-addr=sdbserver1:11810,sdbserver2:11810
