数据库操作

查看集群列表

当数据库集群安装成功后，可以通过 ptk ls 来查看当前用户已经安装过的集群列表

由于 PTK 的元数据存储于 $HOME/.ptk 目录下，所以仅能查看当前用户安装的，无法查看其他用户安装的集群列表。

示例：

$ ptk ls
cluster_name|  id  |         addr          | user |       data_dir        |          db_version          |     create_time     | comment
------------------+------+-----------------------+------+-----------------------+------------------------------+---------------------+----------
     c1     | 6001 | 192.168.100.100:26000 | ptk1 | /home/ptk1/mogdb/data | MogDB 3.0.3 (build 23ba838d) | 2022-11-09 15:01:34 |

可以在输出表中查看如下信息：

cluster_name: 集群名称
id: 安装时给实例分配的ID
addr: 实例地址列表
user: 运行的系统用户
data_dir: 实例的数据目录
db_version: 数据库版本信息
create_time: 集群创建时间
comment: 集群备注

集群安装成功后，在之后管理集群操作时，使用 -n 参数指定集群名称。

查看集群状态

ptk cluster -n <CLUSTER_NAME> status

集群状态定义

状态	含义
Normal	集群所有实例正常可用
Unavailable	集群无主不可用, 或者主库不是正常状态
Degraded	集群可用，但是部分备节点不可用
Stopped	集群全部节点停止
MultiPrimary	集群出现多个主实例

实例状态定义

实例状态在和数据库内核定义的列表保持一致基础上，新增 SSH Disconnect

状态	含义
Unknown	未知状态
Normal	正常
Need repair	复制断开，待修复
Starting	实例启动中
Wait promoting	等待角色提升
Promoting	角色提升中
Demoting	角色降级中
Building	正在重建
Catchup	正在追赶日志
Coredump	实例崩溃
Stopped	实例停止
SSH Disconnect	实例机器SSH连接失败

启动集群

在安装完数据库集群后，PTK 默认会将数据库集群启动。

如果安装时指定了 --skip-launch-db 的话，数据库会处于停止状态。

启动整个集群命令：

ptk cluster -n <CLUSTER_NAME> start

PTK 默认会启动集群内所有实例，PTK 也支持指定单个实例启动：

-H 或 --host 参数指定实例的 IP

ptk cluster -n <CLUSTER_NAME> start -H <IP>

-i 或 --id 参数可以指定实例的 ID （ID 可通过 ptk ls 获取）

ptk cluster -n <CLUSTER_NAME> start -i <ID>

停止集群

停止整个集群命令：

ptk cluster -n <CLUSTER_NAME> stop

PTK 默认会停止集群内所有实例，PTK 也支持指定单个实例停止：

-H 或 --host 参数指定实例的 IP

ptk cluster -n <CLUSTER_NAME> stop -H <IP>

-i 或 --id 参数可以指定实例的 ID （ID 可通过 ptk ls 获取）

ptk cluster -n <CLUSTER_NAME> stop -i <ID>

重启集群

重启操作即启动和停止的组合操作，同样支持启动和停止支持的所有参数

ptk cluster -n <CLUSTER_NAME> restart

重建指定数据库实例

重建实例的操作，内部是通过调用 gs_ctl build 来实现的，重建仅支持指定单个实例进行操作。

ptk cluster -n c1 build -H 172.16.0.190