用户指南

总览

当您登录HashData SaaS控制台后，您就可以开始查看和使用HashData数据库了。 账号申请及登录方式请查阅入门指南-获取账户。

点击控制台左侧的【总览】，您可以在总览页面查看到目前的集群概况、集群健康状态、配额使用情况、计费信息、告警信息、费用概览以及工单信息等等。

具体每个模块介绍如下：

• 集群概况

  您在此可以查看到当前用户下集群的总量、元数据集群数量、计算集群数量以及数仓集群数量。

  

• 集群健康状态

  您在此可以查看到当前用户下集群的健康状态，包括健康集群数量、诊断中集群数量、不健康集群数量以及故障集群数量。

  

• 配额使用情况

  您在此可以查看到当前用户下，配额的使用情况，包括数据库集群配额和云主机资源配额，这样可以让您更直观的了解数据库资源使用情况。

  

  

• 计费信息

  您在此可以查看到当前用户下的费用使用情况，包括服务费用和公网IP费用，可以查看近一年、近半年、近三十天。

  

• 告警信息

  您在此可以查看当前用户下的告警数量，正在告警、今日告警数以及近7日告警数。

  

• 最近公告

  您在此可以查看公告信息，例如产品公告、升级公告以及其他公告等等。

  

• 费用概览

  您在此可以查看当前用户账户余额、本月消费以及代金券情况，还可以进行充值。

  

• 工单信息

  您在此可以查看当前用户的工单信息，包括未处理工单数量、处理中工单数量、待确认工单数量以及已确认工单数量。

  

数据仓库

点击服务平台左侧的【数据仓库】，此模块主要是创建、查看以及管理HashData数据库。接下来详细介绍HashData数据库创建的步骤。您可以开始您的HashData数据库创建之旅。

选择云环境

选择云环境，目前支持青云、腾讯云以及阿里云。本操作步骤中选择青云为例。

新建元数据服务

1. 点击【新建元数据服务】

   

2. 请输入元数据集群名称，备注内容选填(注：此使用手册我们使用hashdata_test作为元数据集群名称）

   点击【下一步：服务配置】

   

3. 请填写服务配置

   按需选择计算集群规模，填写默认数据库、默认密码、默认用户名。

   点击【下一步：模块配置】

   

4. 请填写模块配置

   此部分包括元数据集群FDB配置、ETCD配置以及元数据配置。请按需选择主机类型、硬盘类型、硬盘大小以及节点数。

   主机类型分类如下：

   

   其中基础配置版还分为基础型和本地基础型，二者所支持的硬盘不同，本地基础型可以选择使用的是系统盘，一般不考虑高可用。企业配置型则使用SSD硬盘。

   由于是演示使用，该使用手册全部使用默认值。具体操作页面如下：

   • FDB配置

     

   • Etcd配置

     

   • 元数据配置

     

5. 点击【下一步：总览】

   此时您可以预览元数据集群的基本信息。

   如果发现有配置不合理地方，可以点击上一步进行调整。如果确认无误，点击确认创建。

   

6. 查看元数据集群创建情况

   状态1：创建中

   

   状态2：创建成功（运行中）

   

7. 您可以查看已经创建成功的元数据集群基本信息

   点击【基本信息】

   

这样您就成功创建HashData元数据服务。

关于元数据集群的运维操作，例如启动、停止、扩容、缩容等操作，将在后续章节中介绍。

新建数据仓库服务

接下来您将开始创建数据仓库服务。HashData数据库的元数据灵活性较高，您可以选择多集群共享元数据也可以选择不共享元数据，此时您务必需要了解清楚是否需要使用共享元数据。接下来分两种情况创建数据仓库服务。

不共享元数据

1. 点击【新建数据仓库】

   

2. 填写计算集群的名称，备注可以选填

   点击【下一步：服务配置】

   

3. 配置数据仓库服务

   • 共享元数据服务选择【否】
   • 高可用、本地存储以及对象存储区域根据实际需求进行选择
   • 默认数据库/默认密码/默认用户名 按需填写，也可以使用默认值

   点击【下一步：模块配置】

   

4. 配置数据仓库服务的资源（注：资源说明在元数据服务创建章节前面章节已经介绍）

   点击【下一步：总览】

   

5. 预览数据仓库服务资源情况

   如果发现资源不合理，可点击上一步进行修改，如果确认无误，请点击【确认创建】

   

6. 查看计算集群创建情况

   状态1:创建中

   

   状态2:创建成功（运行中）

   

共享元数据

1. 点击【新建数据仓库】

   

2. 填写计算集群的名称，备注可以选填

   点击【下一步：服务配置】

   

3. 配置数据仓库服务

   • 共享元数据服务选择【是】
   • 选择元数据服务，选择前一步所创建的元数据服务hashdata_test

   点击【下一步：模块配置】

   

4. 配置数据仓库服务的资源（注：资源说明在元数据服务创建前面章节已经介绍）

   点击【下一步：总览】

   

5. 预览数据仓库服务资源情况

   如果发现资源不合理，可点击上一步进行修改，如果确认无误，请点击【确认创建】

   

6. 查看计算集群创建情况

   状态1：创建中

   

   状态2：创建成功（运行中）

   

这样您就创建好数据仓库服务了，包含了不共享元数据和共享元数据两种。如果您选择的是共享元数据，而且您需要创建多个计算集群时，此时HashData的集群间数据共享的优势就得到很好的体现，数据只存储一份，数据不冗余，多集群共享。

公网IP

HashData数据库支持通过公网方式访问，您可以申请公网IP，方便后续绑定使用。

1. 点击左侧【公网IP】

   

2. 填写公网IP名称、宽带计费模式、最大宽带以及备注信息（注：该使用手册中公网IP名称为hashdata_test）

   

3. 公网IP创建成功

   

公网IP创建成功后，我们将在后续中基本操作中介绍如何绑定公网IP。

联系人组

HashData SaaS服务联系人组主要是针对告警信息的通知人而设置的，您可以将所需要的联系人添加到联系人组，而后在告警信息设置时候，选择相应的联系人组。添加联系人组以及联系人的方式如下：

1. 点击左侧的【联系人组】

   点击【创建】

   

2. 填写联系人组名称

   该使用手册联系人组名称使用test

   

3. 联系人组创建成功

   

4. 添加联系人

   

5. 通知方式可以选择邮件或者短信，一个联系人组下可以多个联系人

   该使用手册中使用邮件/zhangsan为联系人

   

6. 联系人创建成功

   

您的联系人组以及联系人已经创建成功，后续在设置告警信息时可以使用。

任务

您可以在任务下，查看您所有数据库集群的操作日志记录，包括数据库集群启动、停止、重启、扩容、缩容等等，可以查询到具体的操作日志，方便统一管理。

点击左侧【任务】

数据恢复

您可以在这里完成数据恢复。

1. 登录控制台，点击【定时数据保护】→【恢复备份数据】→【新建】

   

2. 选择要恢复的任务，点击【下一步】

3. 选择要恢复的时间点和数据源，可以选择恢复整个实例或者单个、多个数据库。

4. 选择恢复客户端、恢复位置、用户名称、恢复实例等信息，点击【下一步】。

   

5. 恢复信息确认，确认之后再输入框输入“YES”，点击【确定】后，新建任务完成。

6. 运行恢复任务。

租户管理

租户管理主要是针对当前租户下的群组、用户管理。

群组

群组是租户下用户与数据仓库的集合。每个租户可以有多个群组，每个群组可以包含多个用户和多个可管理的数据仓库，群组内的所有用户对群组内的数据仓库具有相同的管理权限。

1. 点击【租户管理】-【群组】-【创建】

   

2. 填写群组名称和群组描述

   

3. 点击【确认】，群组添加成功

   

4. 点击【添加成员】

   

5. 将所需用户添加到群组中，可以选择该用户是否设置为管理员。

   

6. 点击【添加服务】

   选择服务名称，可选择范围为该用户下的所有集群

   选择角色，角色分为user、dba和admin。其中user权限较低，可以进入查看所选择的服务，dba拥有部分的操作权限（不具体删除集群权限），admin拥有所有的操作权限。

   

   

这样您已经成功创建群组，并添加成员和添加服务。

用户

用户是一个可以登录管理平台并进行各种操作的实体。租户管理员可以进行用户的创建、删除和编辑等操作。

1. 点击【租户管理】-【用户】-【创建】

   

2. 填写新用户的基本信息，需确定是否启用、是否管理员、是否超级管理员。

   

3. 成功创建用户

   

在线版本热升级

HashData集群可以自动处理版本升级。

1. 服务补丁

   • 持续时间：整个过程将花费不到10分钟。
   • 业务影响：在此期间，不影响业务连续性。

2. 服务升级：

   • 持续时间：整个过程将花费不到30分钟。
   • 业务影响：在此期间，不影响业务连续性。

   版本升级图示

   

HashData SaaS服务常规操作

数据仓库服务基本操作

绑定/解绑公网IP

HashData数据库通过绑定公网IP，可以使用外部网络进行访问，同时也可以解绑公网IP。

1. 点击【数据仓库】，选择已经创建好的数据仓库集群，在主节点部分，点击【更多操作】-【绑定公网IP】

   

2. 选择已经创建完成的公网IP，该使用手册在3.3章节已经创建新增公网IP hashdata_test，点击【确认】

   

3. 您已经成功绑定公网IP

   

   接下来您可以通过外网访问HashData数据库了。

4. 如果您不需要公网IP了，您还可以解绑公网IP，操作如下：

   

客户端工具

您可以使用任何与 PostgreSQL 数据库 9.3 及以上版本兼容的客户端工具连接 HashData 数据库，我们建议您下载并使用 DBWeaver 连接 HashData 数据库。

下载地址：https://dbeaver.io/download/

如果您的客户端工具需要您配置数据库驱动程序，那么您需要选择 PostgreSQL 数据库驱动程序。 连接数据库使用的 IP 地址是您前面在计算集群主节点上的公网 IP 地址， 端口号使用默认的 5432 端口。

1. 选择数据库【PostgreSQL】

   

2. 填写数据库连接信息

   

这样您就可以使用DBWeaver 进行数据开发工作了。

启动

您可以对某个已经停止的计算集群启动，成功启动后，您就可以正常使用HashData数据库了，具体操作步骤如下：

1. 点击【数据仓库】-选择已经停止的集群-【基本信息】-【更多操作】-【启动】

   

2. 查看启动状态

   通过【基本信息】查看

   

3. 查看停止的集群是否成功启动

   可以通过【日志】查看

   

这样您已经成功启动已停止的计算集群。

停止

如果您创建的集群暂时不使用了，您可以选择停止服务，具体操作步骤如下：

1. 点击【数据仓库】-选择需要停止的集群-【基本信息】-【更多操作】-【停止】

   

2. 确认是否停止

   

3. 查看集群状态

   可以通过【日志】查看停止状态

   

4. 查看计算集群是否成功停止

   可以通过【日志】查看停止是否成功

   

这样您已经成功停止计算集群服务。

重启

您可以对已经运行的计算集群进行重启，具体操作步骤如下：

1. 点击【数据仓库】-选择需要操作的集群-【基本信息】-【更多操作】-【重启】

   

2. 确认是否重启

   

3. 查看重启状态

   可以通过【日志】查看

   

4. 计算集群已成功重启

   可以通过【日志】查看

   

这样您已经成功重启计算集群。

扩容

您可以对已经创建成功的集群根据实际需要进行扩容，具体操作步骤如下：

1. 点击【数据仓库】-选择需要扩容的集群-【基本信息】-【更多操作】-【扩容】。

   

2. 选择扩容后的Segment节点数，该使用手册针对前一章节创建的计算集群，由2个计算节点扩容至4个计算节点。

   

3. 查看扩容状态

   可以通过【基本信息】查看

   

   也可以通过【日志】查看

   

4. 查看扩容是否成功

   通过【基本信息】查看

   

   也可以通过【日志】查看

   

这样您已经完成了计算集群由2个节点扩容至4个计算节点。

缩容

您可以对已经创建成功的集群根据实际需要进行缩容，具体操作步骤如下：

1. 点击【数据仓库】-选择需要缩容的集群-【基本信息】-【更多操作】-【缩容】。

   

2. 选择缩容后的Segment节点数，该使用手册针对前一章节创建并扩容后的计算集群，由4个计算节点扩容至2个计算节点。

   

3. 查看缩容状态

   可以通过【基本信息】查看

   

   也可以通过【日志】查看

   

4. 查看缩容是否成功

   可以通过【基本信息】查看

   

   也可以通过【日志】查看

   

磁盘扩容

您可以对已经创建好的集群硬盘进行扩容，具体操作如下：

在对计算集群硬盘进行扩容前，需要停止计算集群服务。

1. 点击【数据仓库】-选择磁盘需要扩容的集群-【基本信息】-【更多操作】-【磁盘扩容】。

   

2. 选择磁盘扩容后的大小，包含主节点和计算节点，可以对任意节点进行磁盘扩容，该使用手册中，将主节点和计算节点由之前20G扩容至30G。

   

3. 磁盘扩容状态

   可以通过【日志】查看

   

4. 查看磁盘扩容是否成功

   可以通过【基本信息】查看

   

   也可以通过【日志】查看

   

这样您已经完成磁盘扩容。请记住，需要重新启动计算集群。

修改备注

您在此可以对已经创建的集群备注进行修改，具体操作步骤如下：

1. 点击【数据仓库】-选择需要修改的集群-【基本信息】-【更多操作】-【修改备注】

   

2. 填写修改后的备注

   

3. 备注修改完成

   

维护模式

您在此可以选择当前的集群是否需要告警、是否需要故障恢复。

1. 点击【数据仓库】-选择需要操作的集群-【基本信息】-【更多操作】-【维护模式】

   

2. 选择是否需要告警，是否需要故障恢复

   

3. 成功定义维护模式

   

保护模式

您可以在此选择是否使用保护模式，当集群设置为保护模式时，该集群不能被删除。操作步骤如下：

1. 点击【数据仓库】-选择需要操作的集群-【基本信息】-【更多操作】-【保护模式】

   

2. 确定是否需要保护模式

   

3. 保护模式修改成功

   

项目标签

您在此可以为当前集群设置项目标签，以便识别集群归属的项目，如果您设置了项目标签，在告警信息中也会显示项目标签。具体设置方式如下：

1. 点击【数据仓库】-选择需要操作的集群-【基本信息】-【更多操作】-【项目标签】

   

2. 填写项目标签

   

3. 项目标签修改成功

   

   这样您就完成了项目标签的修改。

删除

如果您确定某个集群不再使用了，可以选择删除集群，已删除的集群是无法恢复的，所以请谨慎操作。具体操作步骤如下：

1. 点击【数据仓库】-选择需要操作的集群-【基本信息】-【更多操作】-【删除】。

   

2. 确认是否删除

   

3. 查看删除是否成功

   可以通过【日志】查看

   

告警规则设置与修改

您可以根据实际需要，设置数据库告警规则，在数据库出现异常时候，可以及时通知到您。HashData数据库告警规则分为两种，预定义和自定义。

1. 预定义告警，规则如下：

   

   默认情况下，预定义的告警均生效，用户可以按需禁用、修改或者重置预定义告警信息，具体操作如下：

   1）修改和重置告警规则

   

   2）禁用告警规则

   

   3）修改告警信息的联系人组

   

   修改为前一步创建的test联系人组

   

2. 自定义告警

   若预定义告警信息无法满足您的需求，您还可以自定义告警信息

   1）点击【数据仓库】-选择需要操作的集群-【告警规则】-【添加告警规则】。

   

   2）按需输入需要关注的告警信息以及告警信息发送时间、发送模版等等。

   

   将自定义告警规则提交，如果数据库出现异常，您就可以收到相应的告警信息。

权限

您在此可以查看目前的权限情况，群组列表以及群组权限，还可以添加群组。此模块与前文介绍的【群组】模块类似。

点击【数据仓库】-选择需要查看的集群-【权限】

群组添加方式如下：

1. 点击【添加群组】

   

2. 选择所需要添加的群组以及角色

   角色分为user、dba和admin。其中user权限较低，可以进入查看所选择的服务，dba拥有部分的操作权限（不具体删除集群权限），admin拥有所有的操作权限。

   

3. 群组添加成功

   

日志

您可以查看所在集群的操作日志，操作方式如下：

点击【数据仓库】-选择需要查看的集群-【日志】

日志功能，在前面诸多操作已经有使用到。

健康状态

您可以通过健康状况直观观察到当前集群的状态信息，集群是否健康，包括Master节点、Segment节点。

点击【数据仓库】-选择需要查看的集群-【健康状态】

故障恢复

您可以通过故障恢复情况观察当前集群是否有未处理的故障以及已经自愈的故障，方便您了解数据库的整体运行情况。

点击【数据仓库】-选择需要查看的集群-【故障恢复】

工单创建与查看

工单系统是您与HashData最直接有效的沟通平台。您可以通过工单系统咨询任何问题，我们的工作人员会第一时间为您解决问题，同时我们也欢迎您通过工单向HashData提出宝贵的建议。

您可以在HashData SaaS服务平台创建与查看工单，具体操作如下：

1. 点击【我的工单】

   

2. 查看我的工单

   

3. 选择【创建工单】，填写相关的工单信息并提交。