华为云用户手册

请求示例 POST https://{endpoint}/v2/{project_id}/csemonitor/metric { "name" : "test", "appId" : "default", "version" : "1.0.0", "instance" : "hostNameTest", "thread" : 0, "cpu" : 0, "memory" : { "1":"1" }, "interfaces" : [ { "time" : 0, "name" : "test", "qps" : 0, "latency" : 0, "rate" : 0, "total" : 0, "isCircuitBreakerOpen" : true, "failure" : 0, "shortCircuited" : 0, "semaphoreRejected" : 0, "threadPoolRejected" : 0, "countTimeout" : 0, "l995" : 0, "l99" : 0, "l90" : 0, "l75" : 0, "l50" : 0, "l25" : 0, "l5" : 0 } ] }

URI POST /v1/{project_id}/git/auths/{repo_type}/oauth 参数说明见表1。 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目ID。获取方法，请参考获取项目ID。 repo_type 是 String 仓库类型。 取值范围：CodeArts、Gitee、GitHub、BitBucket、GitLab。 表2 查询参数 参数 是否必选 参数类型 描述 tag 否 String 站点标签。

请求消息 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式）。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考获取用户Token。 表4 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 授权名称。 code 是 String git仓库授权后，重定向回来的url里面的code参数。 state 是 String git仓库授权后，一次性的认证编码和随机串。 code和state参数值获取方法： 在浏览器地址栏中输入访问获取授权重定向URL接口获取到的URL并回车。 在登录页面输入您的代码仓库账号和密码。 如果您已经登录代码仓库，则无需执行这一步。 在华为云控制台登录页面输入账号和密码，单击“登录”。 如果您已经登录华为云控制台，则无需执行这一步。 等待页面显示新建授权失败后，复制地址栏的URL。 例如： https://console.huaweicloud.com/servicestage/oauth?repo_type=github&code=04bed2df009f3fc9***c&state=%242a%2410%24.uQYThj5yKFs51w9s9ajeuQ0NSGshPH7IUfXoZLPlz7J%2FoAJ8B*** 对获取到的URL进行URL解码，获得解码后的URL。 示例如下： https://console.huaweicloud.com/servicestage/oauth?repo_type=github&code=04bed2df009f3fc9***c&state=$2a$10$.uQYThj5yKFs51w9s9ajeuQ0NSGshPH7IUfXoZLPlz7J/oAJ8B*** 获取其中code和state对应的参数值。 获取到的state参数值为一次性的认证编码和随机串，仅支持使用一次。如需再次调用本接口创建OAuth授权，请再次执行获取授权重定向URL获取URL并参考本方法获取code和state参数值。

响应消息 表5 响应参数 参数 参数类型 描述 authorization Object 授权结构体，请参考表6。 表6 authorization参数 参数 参数类型 描述 name String 授权名称。 repo_type String 仓库类型。 取值范围：github、gitlab、gitee、bitbucket。 repo_host String 仓库地址。 repo_home String 您的仓库主页。 repo_user String 您的仓库用户名。 avartar String 您的仓库头像。 token_type String 仓库授权方式。 create_time Long 仓库授权创建时间戳。 update_time Long 仓库授权修改时间戳。 status Integer 仓库授权状态。 0：正常 1：过期 2：未认证。

响应示例 { "authorization": { "name": "auth1", "repo_type": "github", "repo_host": "https://api.github.com", "repo_home": "https://github.com/tom-repo", "repo_user": "repo", "avartar": "https://avatars.githubusercontent.com/u/73919200?v=4", "token_type": "oauth", "create_time": 1649758626858, "update_time": 1649758626858, "status": 0 } }

ServiceStage错误码 在向系统发出请求后，如果遇到错误，会在响应中包含响应的错误码描述错误信息。 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 错误码如下所示。 状态码 错误码 错误信息 描述 处理措施 400 SV CS TG.00100400 parameter invalid 错误请求 检查参数是否正确，稍后重试 400 SVCSTG.00100402 component was deployed, uninstall first 组件已部署，请先卸载 卸载组件后重试 400 SVCSTG.00100414 job id can not empty job id不能为空 请指定job id进行查询 400 SVCSTG.00100418 component instance action not defined 未定义组件实例操作 请指定合法的组件实例操作 400 SVCSTG.00100420 runtime not supported 不支持运行时 请指定支持的运行时 400 SVCSTG.00100422 base resource can not empty 基础资源不能为空 请设置基础资源 400 SVCSTG.00100425 instance artifacts can not be empty 实例的软件包或者镜像为空 报文中的artifact参数不能为空 400 SVCSTG.00100449 environment name is already used 环境名已被占用 重新提供一个新的环境名 400 SVCSTG.REPO.0400 parameter invalid 错误请求 检查参数是否正确，稍后重试 400 SVCSTG.REPO.0401 repository not implemented 错误请求 请选择其他仓库类型 400 SVCSTG.REPO.0402 oauth code or state invalid 错误请求 请重新进行OAuth2授权，获取正确的认证码和随机串 400 SVCSTG.REPO.0403 resource already exist 错误请求 调用查询接口，检查是否存在重复的资源 400 SVCSTG.REPO.0450 no repository authorization 错误请求 检查请求header是否输入正确授权名称 400 SVCSTG.REPO.0451 repository authorization invalid 错误请求 重新授权 400 SVCSTG.REPO.0452 clone url invalid 错误请求 检查查询参数clone_url是否正确. 示例：https://user-name@github.com/user-name/demo.git 404 SVCSTG.00100403 application not found 应用未找到 请指定已经存在的应用 404 SVCSTG.00100404 component not found 组件未找到 请指定已经存在的组件 404 SVCSTG.00100408 request not found 请求未找到 请指定已经存在的请求 404 SVCSTG.00100411 environment not found 环境未找到 请指定存在的环境 404 SVCSTG.00100412 instance not found 实例未找到 请对存在的实例进行操作 404 SVCSTG.00100424 elb instance not found elb实例未找到 请指定已经存在的elb实例 404 SVCSTG.00100429 job not found 构建工程未找到 请指定已经存在的构建工程 404 SVCSTG.00100433 application release not found 发布任务未找到 请选择已经存在的发布任务 404 SVCSTG.00100436 snapshot not found 实例快照未找到 请指定已经存在的实例快照 404 SVCSTG.00100438 template image not found 模板镜像未找到 请指定已经存在的模板镜像 404 SVCSTG.00100441 instance version is already used by other instances in the same environment 组件实例的版本号已被相同环境的其他实例所占用 重新提供一个新的版本号 405 SVCSTG.00100421 account is limit suspended 账户已被暂停限额 恢复账号至正常状态 405 SVCSTG.00100427 permission denied 没有权限 重新授权 408 SVCSTG.00100428 request timeout 系统处理超时 系统繁忙，请稍后再试 409 SVCSTG.00100401 application not empty 应用不为空 删除应用下的组件再删除应用 409 SVCSTG.00100413 instance name exists 实例名已经存在 更换实例名 409 SVCSTG.00100419 can not operate in current status 当前状态不能操作 当前操作未完成，请稍后再试 409 SVCSTG.00100423 component instance is not deletable 组件实例当前状态不可删除 当前操作未完成，请稍后再试 409 SVCSTG.00100426 environment is in use 环境已经被使用 删除部署在环境上的实例后再删除环境 409 SVCSTG.00100432 component in releasing 组件当前已在发布任务中 请等待当前发布任务执行结束后再重试 409 SVCSTG.00100435 release can not delete 发布任务当前状态不能删除 当前操作未完成，请稍后再试 409 SVCSTG.00100439 elb is already used in other instance of component elb实例已经在组件中被使用 请使用其他elb实例重试 500 SVCSTG.00100500 service internal error 服务内部错误 系统繁忙，请稍后重试 500 SVCSTG.00100501 remote service error 远程服务错误 系统繁忙，请稍后重试 500 SVCSTG.REPO.0500 service internal error 服务内部错误 网络异常等原因，稍后重试。 500 SVCSTG.REPO.0501 remote repository error 服务内部错误 检查请求参数是否正确，或者远端GIT的仓库文件已经被修改。 父主题： 附录

什么是区域、可用区？ 我们用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的 IaaS、PaaS 和 SaaS 类云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。 华为云租户的安全责任在于对使用的 IaaS、PaaS 和 SaaS 类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API 网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

审计 云审计 服务（Cloud Trace Service， CTS ），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 用户开通云审计服务并创建和配置追踪器后，CTS可记录GeminiDB的管理事件和数据事件用于审计。 CTS的详细介绍和开通配置方法，请参见CTS快速入门。 CTS支持追踪的GeminiDB Redis管理事件和数据事件列表，请参见支持审计的关键操作列表。 CTS支持追踪的GeminiDB Influx管理事件和数据事件列表，请参见支持审计的关键操作列表。 CTS支持追踪的GeminiDB Cassandra管理事件和数据事件列表，请参见支持审计的关键操作列表。 CTS支持追踪的GeminiDB Mongo管理事件和数据事件列表，请参见支持审计的关键操作列表。

日志 GeminiDB Redis 支持查看数据库级别的慢日志，执行时间的单位为ms。通过该日志，可查找出执行效率低的语句，进行优化。 慢日志的详细介绍，请参见慢日志。 GeminiDB Cassandra 支持查看数据库级别的慢日志，执行时间的单位为ms。通过该日志，可查找出执行效率低的语句，进行优化。 慢日志的详细介绍，请参见慢日志。 GeminiDB Mongo 支持查看数据库级别的慢日志，执行时间的单位为ms。通过该日志，可查找出执行效率低的语句，进行优化。 慢日志的详细介绍，请参见慢日志。 支持查看数据库级别的错误日志，包括数据库运行的Warning和Error级别的信息，有助于分析系统中存在的问题。 错误日志的详细介绍，请参见错误日志。

修订记录 发布日期 修订记录 2023-07-30 第十次正式发布。 计费说明，新增购买按需实例时会冻结一部分保证金，以及保证金返还的条件。 2023-05-12 第九次正式发布。 权限管理，新增常用操作“数据库补丁升级”。 2022-11-15 第八次正式发布。 新增安全。 2021-04-15 第六次正式发布。 调整文档结构。 2020-07-30 第五次正式发布。 新增计费说明。 2020-04-30 第四次正式发布。 GeminiDB Mongo支持ARM规格。 支持通过DAS登录GeminiDB Cassandra实例。 2020-03-31 第三次正式发布。 新增权限管理。 2020-01-20 第二次正式发布。 GeminiDB Influx公测。 GeminiDB Redis公测。 2019-07-18 第一次正式发布。

计费项 云数据库 GeminiDB按照您实例规格和存储空间计费，即云数据库 GeminiDB的价格=实例规格价格+存储空间价格。 表1 计费项说明 计费项 计费说明 数据库实例 按照您选择的实例规格计费。 针对实例提供包年包月和按需（小时）计费方式。 数据库存储 按照您选择存储空间收费。 备份存储（可选） 云数据库 GeminiDB的备份数据存储在OBS上。购买实例存储空间后，云数据库 GeminiDB将同比例赠送备份存储空间，用于存储备份数据。例如，您购买的实例存储空间为100GB时，会得到赠送的100GB备份存储空间。当备份数据没有超出100GB，将免费存储在OBS上；当备份数据超出100GB，超出部分将根据OBS的计费规则收费。 公网流量 云数据库 GeminiDB实例支持公网访问，公网访问会产生带宽流量费；云数据库 GeminiDB实例在云内部网络产生的流量不计费。 云数据库 GeminiDB管理费用详情，请参见产品价格详情l。您可以通过云数据库 GeminiDB提供的价格计算器，选择您需要的实例规格，来快速计算出购买云数据库 GeminiDB实例的参考价格。

续费 目前云数据库 GeminiDB提供“包年/包月”和“按需计费”购买方式，您可以根据业务需要定制相应计算能力和存储空间的数据库实例。 “按需计费”方式，即按实际使用时长计费，以自然小时为单位整点计费，不足一小时按实际使用时长计费，只要您账户上有足够余额，就可以一直使用服务。当账户余额不足时，就会导致欠费，因此在欠费前请及时充值。 “包年/包月”计费方式，您在购买时一次性付费，使用过程中不会再另外扣费，只要您的账户上有足够余额，则不会影响您的使用。 如需续费，请进入“续费管理”页面进行续费操作。

高安全 网络隔离 通过虚拟私有云（Virtual Private Cloud，简称VPC）和网络安全组实现网络隔离。虚拟私有云允许租户通过配置虚拟私有云入站IP范围，来控制连接数据库的IP地址段。数据库实例运行在租户独立的虚拟私有云内，可提升数据库实例的安全性。您可以综合运用子网和安全组的配置，来完成数据库实例的隔离。 访问控制 可以通过虚拟私有云对数据库实例所在的安全组入站、出站规则进行限制，从而控制可以连接数据库的网络范围。 传输加密 通过SSL加密实现传输加密。使用从服务控制台上下载的CA根证书，并在连接数据库时提供该证书，对数据库服务端进行认证并达到加密传输的目的。 安全防护 云数据库 GeminiDB具有多层网络防护。通过虚拟私有云、子网、安全组、DDoS防护以及SSL安全访问等多层安全防护体系，有力地抗击各种恶意攻击，保证数据安全。 基于虚拟私有云技术，真正实现租户隔离和访问控制。 通过传输层SSL安全协议，提供安全及数据完整性保障。 可在IP及端口层面进行安全访问限制，加强云数据库 GeminiDB与其他服务间的安全访问。 性能监控 云数据库 GeminiDB具有完善的性能监控，为您分担60%以上的运维工作。对CPU使用率、IOPS、网络吞吐量等实例信息实时监控及报警，随时随地了解实例动态。

高可靠 数据备份 数据备份包括自动和手动两种方式。自动备份为系统自动创建的数据库实例的全量备份，手动备份是由用户启动的数据库实例的全量备份，且备份成功后均支持恢复。 备份数据存储至 对象存储服务 （Object Storage Service，简称OBS），在提高数据容灾能力的同时有效降低磁盘空间占用。创建实例时，默认开启自动备份策略，实例创建成功后，将自动执行一次全量备份，该备份文件默认保留7天，创建成功后可以设置自动备份的周期，修改备份策略。同时，用户也可以根据自身业务特点随时发起备份，手动备份会一直保存，直到用户手动删除。

数据保护技术 云数据库 GeminiDB通过多种数据保护手段和特性，保障存储在GeminiDB中的数据安全可靠。 表1 GeminiDB的数据保护手段和特性 数据保护手段 简要说明 详细介绍 传输加密（SSL） GeminiDB Redis、GeminiDB Mongo、GeminiDB Cassandra和GeminiDB Influx实例支持非SSL和SSL传输协议，为保证数据传输的安全性，推荐您使用更加安全的SSL协议。 GeminiDB Redis：设置SSL 数据加密 GeminiDB Influx：设置SSL数据加密 GeminiDB Cassandra：设置SSL数据加密 GeminiDB Mongo：设置SSL数据加密 跨可用区部署 为了达到更高的可靠性，GeminiDB支持选择3可用区，可用区之间内网互通，不同可用区之间物理隔离，GeminiDB会自动将实例下的节点Hash均衡部署在3个可用区内，实现跨可用区容灾部署。 GeminiDB Redis：购买实例选择跨可用区部署 GeminiDB Influx：购买实例选择跨可用区部署 GeminiDB Cassandra：购买实例选择跨可用区部署 GeminiDB Mongo：购买实例选择跨可用区部署 负载均衡 GeminiDB Redis支持负载均衡，数据访问可以均衡的分散在集群的不同节点，避免热点，最大化集群整体的吞吐量。 GeminiDB Redis：通过负载均衡地址连接实例 双活容灾 GeminiDB Redis支持搭建双活关系，通过两个GeminiDB Redis实例间的数据同步，来应对实例级的故障，保障业务的连续性。 GeminiDB Redis：搭建双活关系 同城容灾 GeminiDB Cassandra主实例支持搭建主备高可用架构，当主实例发生突发性自然灾害等状况，主实例节点无法连接时，可将容灾实例切换为主实例。 GeminiDB Cassandra：创建容灾实例 异地双活 GeminiDB Cassandra接口提供了异地双活功能，通过异地实例间数据的双向同步和业务灵活调度能力，实现了业务恢复和故障恢复解耦，保障了故障场景下业务的连续性。 GeminiDB Cassandra：异地双活原理介绍 删除保护 云数据库 GeminiDB支持将退订后的包年包月实例和删除的按需实例，加入回收站管理。通过数据库回收站中重建实例功能，可以恢复1~7天内删除的实例。 GeminiDB Redis：回收站 GeminiDB Influx：回收站 GeminiDB Cassandra：回收站 GeminiDB Mongo：回收站 父主题： 安全

IoT 云数据库 GeminiDB兼容Cassandra接口，拥有超强写入性能，专为密集写入而设计。它适用于各种不同的行业，例如制造业、物流业、医疗保健业、房地产业、能源生产业、农业等等。 无论传感器类型如何，都可以很好地处理传入数据，并为进一步的数据分析提供了可能。 优势： 超强写入：相比于其他NoSQL服务，拥有超强的写入性能。 弹性扩展：基于计算存储分离的分布式架构，分钟级计算节点扩容，应对业务高峰期；秒级存储扩容应对7*24不间断的大数据量写入。

与其他服务的关系 云数据库 GeminiDB与其他服务的关系，如图1所示。 图1 云数据库 GeminiDB与其他服务的关系 表1 云数据库 GeminiDB与其他服务的关系 服务名称 云数据库 GeminiDB与其他服务的关系 弹性云服务器 弹性云服务器（Elastic Cloud Server，简称ECS）为云数据库 GeminiDB提供可弹性申请的计算资源，为数据库实例提供运行环境。 虚拟私有云 通过虚拟私有云（Virtual Private Cloud，简称VPC）和网络安全组实现网络隔离。虚拟私有云允许租户通过配置虚拟私有云入站IP范围，来控制连接数据库的IP地址段。数据库实例运行在租户独立的虚拟私有云内，可提升数据库实例的安全性。 弹性公网IP 弹性公网IP（Elastic IP，简称EIP）提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。 对象存储服务 备份数据存储至对象存储服务（Object Storage Service，简称OBS），在提高数据容灾能力的同时有效降低磁盘空间占用。 云审计服务 云审计服务（Cloud Trace Service，简称CTS），记录了云数据库 GeminiDB相关的操作事件，方便用户日后的查询、审计和回溯。 统一身份认证 服务 统一身份认证服务（Identity and Access Management，简称 IAM ）为云数据库 GeminiDB提供了权限管理功能。 标签管理服务 标签管理服务（Tag Management Service，简称TMS）用于用户在云平台，通过统一的标签管理各种资源。标签管理服务与各服务共同实现标签管理能力，标签管理服务提供全局标签管理能力，各服务维护自身标签管理。

典型应用 互联网应用 优势： 高性能 能够处理高吞吐量和低延迟的交易请求，保证实时性。 可靠性 通过数据冗余和故障转移机制，确保数据的安全性和可用性。 扩展性 支持水平扩展，能够应对不断增长的数据量和并发访问需求。 工业数据采集 优势： 强大的存储能力 能够存储大规模的结构化和非结构化数据，并提供高效的数据读取。 快速的查询和聚合 支持复杂的查询操作和聚合分析，提供快速且灵活的数据处理能力。 分布式计算 与分布式计算框架（如Hadoop和Spark）结合使用，能够实现高效的大数据分析。

数据库实例规格 同一实例类型根据内存的配置不同分为多种实例规格，针对不同的应用场景，您可以选择不同规格的实例。 本章节主要介绍GeminiDB HBase实例支持的实例规格信息。数据库实例规格与所选的CPU机型相关，请以实际环境为准。 表1 GeminiDB HBase集群实例规格 规格名称 vCPU（个） 内存（GB） 最小存储空间（GB） 最大存储空间（GB） geminidb.hbase.xlarge.4 4 16 100 24,000 geminidb.hbase.2xlarge.4 8 32 100 48,000 geminidb.hbase.4xlarge.4 16 64 100 96,000 geminidb.hbase.8xlarge.4 32 128 100 192,000 父主题： 产品介绍

GeminiDB Cassandra各版本的生命周期规划 EOM：End of Marketing，停止该版本的销售。 EOS：End of Service & support，停止该版本的服务，建议您在执行作业时选择最新版本的引擎。在该日期之后，不再提供该软件版本的任何技术服务支持。 表1 GeminiDB Cassandra各版本生命周期规划表 版本 当前状态 华为云商用时间 计划EOM时间 计划EOS时间 3.11 已商用 2019年12月 2026年9月 2027年9月

备份原理 GeminiDB Redis采用存算分离的架构，备份原理图1所示。GeminiDB Redis存储池中对数据进行秒级快照，通过计算层透传，以压缩文件的形式存储在OBS存储服务中，不会额外占据实例的存储空间。快照的创建和删除对计算层无影响，上传过程会临时消耗少量计算资源，实例的CPU和内存指标会略微升高，属正常现象。 相比于社区版Redis较慢的备份速度以及产生性能抖动的问题，GeminiDB Redis备份速度更快，对性能几乎不产生影响。 图1 备份原理

备份存储 GeminiDB Redis的备份数据存储至对象存储服务（Object Storage Service，简称OBS），在提高数据容灾能力的同时有效降低磁盘空间占用。 购买实例存储空间后，GeminiDB Redis将同比例赠送备份存储空间，用于存储备份数据。例如，您购买的实例存储空间为100GB时，会得到赠送的100GB备份存储空间。当备份数据没有超出100GB，将免费存储在OBS上；当备份数据超出100GB，超出部分将根据OBS的计费规则收费，详情请参见OBS计费详情。

备份方案 GeminiDB Redis实例支持自动备份和手动备份两种方案。 自动备份 您可以在管理控制台设置自动备份策略，系统将会按照自动备份策略中设置的备份时间段和备份周期进行自动备份，并且会按照设置的备份保留天数对备份文件进行存放。 自动备份的备份文件不支持手动删除，可通过修改自动备份策略调整备份保留天数，超出备份保留天数的已有备份文件会被自动删除。 手动备份 手动备份是由用户根据自身业务特点随时启动的数据库实例的全量备份，会一直保存，直到用户手动删除。 建议您定期对数据库进行备份，当数据库故障或数据损坏时，可以通过备份恢复数据库，从而保证数据可靠性。 表1 备份方案 备份方案 使用场景 自动备份 系统按照自动备份策略，对数据库进行自动备份，您可以根据业务需求修改自动备份策略。 手动备份 根据自身业务特点手动启动数据库实例的全量备份。

Server management config 系列命令通过控制台提供服务化。 表13 Server management支持的命令 命令 是否支持 备注 command √ - dbsize √ 因采用MVCC机制，查询结果为估计值，非实时准确值。 flushall √ 双活场景下不支持该命令。 flushdb √ 双活双写场景下备实例不支持该命令。 info √ 相比开源Redis增加了部分信息项。 role √ - time √ -

需要使用Hashtag的多Key命令 以下命令需要使用hashtag，否则会报crossslot错误。 表16 需要使用Hashtag的多Key命令 命令类型 命令 String msetnx List blpopbrpop brpoplpush brpoplpush Set sdiffsdiffstore sinter sinterstore smove sunionsunionstore Sorted Set zinterstore zunionstore Stream xread xreadgroup HyperLogLog pfcount pfmerge Geo georadius georadiusbymember Bitmap bitop Lua eval evalsha

Bloom Filter GeminiDB Redis的布隆过滤器底层使用Hash结构实现，请不要使用Hash类型的同名Key。 bf.loadchunk和bf.scandump命令用于迁移，因存储方式不同，不予支持。 出于安全考虑，bf.reserve初始设置的capacity上限为2621440(2M)， 当输入的capacity值超过2M时会将capacity自动设置为2M。如需要更大的capacity，请使用布隆过滤器的扩展功能；expansion参数上限为10，超过限制时会自动调整为10。 详情请参考Bloom Filter介绍和Bloom Filter命令说明。 表15 Bloom Filter支持的命令 命令 是否支持 备注 bf.add √ - bf.exists √ - bf.info √ - bf.insert √ - bf.madd √ - bf.mexists √ - bf.reserve √ -

Generic GeminiDB Redis允许不同类型数据使用同名key，如果不同数据类型使用了同名key，则type和del命令按照string、hash、list、zset、set、stream的顺序查找key，并对第一个找到的类型进行处理。 表8 Generic支持的命令 命令 是否支持 备注 del √ - dump √ - exists √ - expire √ - expireat √ - keys √ - move x - persist √ - pexpire √ - pexpireat √ - pttl √ - randomkey √ - rename √ - renamenx √ - restore √ - scan √ - sort √ cluster不支持by选项, 与社区保持一致；暂不支持store选项。 touch √ - ttl √ - type √ - unlink √ -

为域名添加解析记录集 内网域名创建成功后，需要为内网域名设置解析记录集，以便使用域名来访问实例。以下操作以添加A类型记录集为例，其他更多类型记录集请参见添加记录集。 单击新建的内网域名名称，进入“解析记录”页面，单击右上方“添加记录集”。 图5 添加记录集 在“添加记录集”弹出框中，根据界面提示填写记录集参数。 图6 添加解析记录集 参数配置说明请参见增加A类型记录集。 单击“确定”。 返回“解析记录”页面。 添加完成后，您可以在域名对应的记录集列表中查看已添加的记录集。当记录集的状态显示为“正常”时，表示记录集添加成功。

迁移原理 使用开源工具kvrocks2redis进行Kvrocks到GeminiDB Redis的迁移，在此基础上，从GeminiDB Redis源码层面对Kvrocks的namespace功能进行适配。 迁移过程分为全量和增量两个阶段：迁移开始后，先进行全量迁移，此时对kvrocks打快照，并记录对应的数据版本（seq）。然后解析全量数据文件成redis命令写入GeminiDB Redis。全量迁移完成后进入持续的增量迁移过程，迁移工具循环给Kvrocks发送PSYNC命令，将获取到的增量数据不断转发给GeminiDB Redis，完成增量迁移 。