华为云用户手册

GeminiDB HBase 接口兼容性列表 GeminiDB HBase目前暂不支持集群运维与管理相关接口。如果有实例级别操作需求如重启等，可以使用控制台相关功能。 表1 接口功能分类 接口 功能 是否支持 数据接口 Get Get：单行查询。 是 Filter：服务端过滤。 部分支持 Consistency：数据强一致。 是 Versions：多版本查询。 是 Batch：批量单行读 即将上线 Put Put：单行插入。 是 Condition：条件插入。 是 TTL：过期数据自动删除。 是 Batch: 批量单行写 是 Versions：多版本写入。 是 Delete Delete：单行全部删除。 是 Delete：指定ColumnFamily/Qualifier删除。 是 Versions：多版本删除。 是 Batch： 批量单行删除 否 Prefix Delete：前缀删除 即将上线 Scan Scan：全量扫描。 是 Scan：指定start/stop行进行扫描。 是 TimeRange：过滤时间范围。 是 Filter：服务端过滤 部分支持 Versions：多版本查询。 是 Reversed：逆序查询。 是 Increment 普通Increment操作。 规划中 Append 普通Append操作。 规划中 Bulk Load 从文件批量导入数据。 规划中 元数据操作 Table Create：普通创表操作。 是 SplitKey：创表同时指定。 是 Region：自动分裂。 是 Disable/Delete：禁用/删表。 是 Compress：指定压缩算法（已自带数据压缩）。 暂无规划 Alter Table：增加ColumnFamily。 是 Alter Table：减少ColumnFamily。 规划中 集群管理接口 运维侧关注，客户无需关注。 Namespace 创建/删除Namespace。 是 其他参数指定。 暂无规划 额外支持 Coprocessor 支持自定义插件 暂无规划 二级索引 需要Column内容支持用户多样化查询 规划中 父主题： HBase协议兼容版实例

兼容的接口列表 表1 接口列表 接口名称 CreateTable UpdateTable DescribeTable ListTables DeleteTable PutItem UpdateItem GetItem DeleteItem BatchWriteItem BatchGetItem Query Scan UpdateTimeToLive 表2 CreateTable接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 CreateTable 请求参数 AttributeDefinitions 是 是 - KeySchema 是 是 - TableName 是 是 Table Name 字符长度3~48，正则表达式（[\w-]+）。 BillingMode 否 否 计费属性，暂不支持。 GlobalSecondaryIndexes 否 是 - LocalSecondaryIndexes 否 是 - ProvisionedThroughput 否 是 - SSESpecification 否 否 当前版本不支持，规划中。 StreamSpecification 否 否 当前版本不支持，规划中。 Tags 否 否 当前版本不支持，规划中。 返回参数 TableDescription - 是 - 表3 UpdateTable接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 UpdateTable 请求参数 AttributeDefinitions 否 是 - BillingMode 否 否 计费属性，不予支持。 GlobalSecondaryIndexesUpdates 是 是 支持Create和Delete，不支持Update。 ProvisionedThroughput 否 否 计费属性，不予支持。 ReplicaUpdates 否 否 默认强一致性。 SSESpecification 否 否 当前版本不支持，规划中。 StreamSpecification 否 否 当前版本不支持，规划中。 TableName 是 是 - 返回参数 TableDescription - 是 - 表4 DescribeTable接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 DescribeTable 请求参数 TableName 是 是 - 返回参数 Table - 是 不支持itemCount字段。 表5 ListTables接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 ListTables 请求参数 ExclusiveStartTableName 否 是 - Limit 否 是 - 返回参数 LastEvaluatedTableName - 是 - TableNames - 是 - 表6 DeleteTable接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 DeleteTable 请求参数 TableName 是 是 - 返回参数 TableDescription - 是 - 表7 PutItem接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 PutItem 请求参数 Item 是 是 - TableName 是 是 - ConditionalOperator 否 否 遗弃参数，见ConditionExpression。 ConditionExpression 否 是 - Expected 否 否 遗弃参数，见该接口中ConditionExpression字段。 ExpressionAttributeNames 否 是 - ExpressionAttributeValues 否 是 - ReturnConsumedCapacity 否 否 计费属性，暂不支持。 ReturnItemCollectionMetrics 否 否 统计属性，暂不支持。 ReturnValues 否 是 - 返回参数 Attributes - 是 - ConsumedCapacity - 否 计费属性，暂不支持。 ItemCollectionMetrics - 否 统计属性，暂不支持。 表8 UpdateItem接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 UpdateItem 请求参数 Key 是 是 - TableName 是 是 - AttributeUpdates 否 否 遗弃参数，见该接口中UpdateExpression字段。 ConditionalOperator 否 否 遗弃参数，见该接口中UpdateExpression字段。 ConditionExpression 否 是 - Expected 否 否 遗弃参数，见该接口中UpdateExpression字段。 ExpressionAttributeNames 否 是 - ExpressionAttributeValues 否 是 - ReturnConsumedCapacity 否 否 计费属性，暂不支持。 ReturnItemCollectionMetrics 否 否 统计属性，暂不支持。 ReturnValues 否 是 - UpdateExpression 否 是 - 返回参数 Attributes - 是 - ConsumedCapacity - 否 计费属性，暂不支持。 ItemCollectionMetrics - 否 统计属性，暂不支持。 表9 GetItem接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 GetItem 请求参数 Key 是 是 - TableName 是 是 - AttributesToGet 否 否 遗弃参数，见该接口中ProjectionExpression字段。 ConsistentRead 否 否 默认强一致性。 ExpressionAttributeNames 否 是 - ProjectionExpression 否 是 - ReturnConsumedCapacity 否 否 计费属性，暂不支持。 返回参数 ConsumedCapacity - 否 计费属性，暂不支持。 Item - 是 - 表10 DeleteItem接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 DeleteItem 请求参数 Key 是 是 - TableName 是 是 - ConditionalOperator 否 否 遗弃参数，见该接口中ConditionExpression字段。 ConditionExpression 否 是 - Expected 否 否 遗弃参数，见该接口中ConditionExpression字段。 ExpressionAttributeNames 否 是 - ExpressionAttributeValues 否 是 - ReturnConsumedCapacity 否 否 计费属性，暂不支持。 ReturnItemCollectionMetrics 否 否 统计属性，暂不支持。 ReturnValues 否 是 - 返回参数 Attributes - 是 - ConsumedCapacity - 否 计费属性，暂不支持。 ItemCollectionMetrics - 否 统计属性，暂不支持。 表11 BatchWriteItem接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 BatchWriteItem 请求参数 RequestItems 是 是 - ReturnConsumedCapacity 否 否 计费属性，暂不支持。 ReturnItemCollectionMetrics 否 否 统计属性，暂不支持。 返回参数 ConsumedCapacity - 否 计费属性，暂不支持。 ItemCollectionMetrics - 否 统计属性，暂不支持。 UnprocessedItems - 是 - 表12 BatchGetItem接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 BatchGetItem 请求参数 RequestItems 是 是 无 ReturnConsumedCapacity 否 否 计费属性，暂不支持。 返回参数 ConsumedCapacity - 否 统计属性，暂不支持。 Responses - 是 - UnprocessedKeys - 是 - 表13 Query接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 Query 请求参数 TableName 是 是 - AttributesToGet 否 否 遗弃参数，见该接口中ProjectionExpression字段。 ConditionalOperator 否 否 遗弃参数，见该接口中ProjectionExpression字段。 ConsistentRead 否 否 默认强一致性。 ExclusiveStartKey 否 是 - ExpressionAttributeNames 否 是 - ExpressionAttributeValues 否 是 - FilterExpression 否 是 - IndexName 否 是 - KeyConditionExpression 否 是 - KeyConditions 否 否 遗弃参数，见该接口中KeyConditionExpression字段。 Limit 否 是 - ProjectionExpression 否 是 - QueryFilter 否 否 遗弃参数，见该接口中FilterExpression字段。 ReturnConsumedCapacity 否 否 计费属性，暂不支持。 ScanIndexForward 否 是 - Select 否 是 不支持Count。 返回参数 ConsumedCapacity - 否 计费属性，暂不支持。 Count - 是 - Items - 是 - LastEvaluatedKey - 是 - ScannedCount - 是 - 表14 Scan接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 Scan 请求参数 TableName 是 是 - AttributesToGet 否 否 遗弃参数，见该接口中ProjectionExpression字段。 ConditionalOperator 否 否 遗弃参数，见该接口中ConditionExpression字段。 ConsistentRead 否 否 默认强一致性。 ExclusiveStartKey 否 是 - ExpressionAttributeNames 否 是 - ExpressionAttributeValues 否 是 - FilterExpression 否 是 - IndexName 否 是 - Limit 否 是 - ProjectionExpression 否 是 - ReturnConsumedCapacity 否 否 计费属性，暂不支持。 ScanFilter 否 否 遗弃参数，该接口中FilterExpression字段。 Segment 否 是 - Select 否 是 不支持Count类型。 TotalSegments 否 是 - 返回参数 ConsumedCapacity 否 否 计费属性，暂不支持。 Count - 是 - Items - 是 - LastEvaluatedKey - 是 - ScannedCount - 是 - 表15 UpdateTimeToLive接口兼容性介绍 接口名称 参数 是否必选 是否支持 备注 UpdateTimeToLive 请求参数 TableName 是 是 - TimeToLiveSpecification 是 是 - 返回参数 TimeToLiveSpecification - 是 -

负载均衡 DynamoDB应用程序通常先连接一个URL，然后在服务端内部进行请求的分发。我们希望GeminiDB DynamoDB接口的请求均匀分布在所有节点。为了实现这个目标，我们提供了低成本并且小型的库，并将该库附加到DynamoDB SDK，其基本原理是在DynamoDB SDK发送请求前，拦截器会修改请求头中的目标地址为当前集群存活节点列表中的任意一个节点，从而达到负载均衡的目的。下面提供简单的使用示例： TABLE_NAME ='user' // seed url URL = boto3_lb.setup(['***.***.***.***'],'http',8000,'fake.domain.com') dynamodb = boto3.resource('dynamodb', endpoint_url=URL,region_name='None', aws_access_key_id='None', aws_secret_access_key='None')

使用须知 GeminiDB DynamoDB只支持使用DynamoDB的API对表进行增删改操作，控制台只支持读操作。 非DynamoDB的API创建的表，无法在GeminiDB DynamoDB中使用。 当前版本不支持流量统计、流量限制、事务功能（TransactWriteItems， TransactGetItems）。 当前版本不支持按需备份接口：CreateBackup、DescribeBackup、 DeleteBackup、 ListBackups、 RestoreTableFromBackup。 在DynamoDB中，哈希键（或分区键）决定项目存储在DynamoDB内部存储中的位置。DynamoDB使用专有的哈希函数，GeminiDB DynamoDB使用的是Murmur3算法，这种差异会导致Scan操作返回的数据顺序不同。 相关应用程序需要使用负载均衡插件将请求均匀地发送到所有节点。若不使用该插件，则只会发送到指定的单个Endponit地址。详细的负载均衡插件代码包可联系GeminiDB DynamoDB的客服提供。 表/索引名称中不能包含的字符有："."。 由于编码方式不同，GeminiDB DynamoDB表中的每行数据不会严格限制400KB大小。 DDL接口均为同步接口。

支持的表达式 GeminiDB DynamoDB中的ConditionExpression支持的函数语法如下： function ::= attribute_exists (path) | attribute_not_exists (path) | attribute_type (path, type) | begins_with (path, substr) | contains (path, operand) contains(path,operand)中operand只能是属性值（即传入的value占位符）。 GeminiDB DynamoDB中的UpdateExpression语法如下： update-expression ::= [ SET action [, action] ... ] [ REMOVE action [, action] ...] [ ADD action [, action] ... ] [ DELETE action [, action] ...] set-action ::= path =value value ::= operand | operand '+' operand | operand '-' operand operand ::= path | function function ::= if_not_exists (path, value) | list_append (list1, list2) remove-action ::= path add-action ::= path value delete-action ::= path value SET path = operand语法中，不支持operand是path的场景。 SET path = operand1 '+'|'-' operand2语法中，operand1必须等于path，operand2必须是属性值 SET path = if_not_exists (path, value)语法中，两个path必须相等，且value只能是表达式属性值。 所有的value只能是占位符,比如':placeholder'。

支持审计的关键操作列表 通过 云审计 服务，您可以记录与GeminiDB Cassandra相关的操作事件，便于日后的查询、审计和回溯。 表1 GeminiDB Cassandra的关键操作列表 操作名称 资源类型 事件名称 创建实例 instance NoSQLCreateInstance 删除实例 instance NoSQLDeleteInstance 扩容节点 instance NoSQLEnlargeInstance 缩容节点 instance NoSQLReduceInstance 重启实例 instance NoSQLRestartInstance 恢复到新实例 instance NoSQLRestoreNewInstance 磁盘扩容 instance NoSQLExtendInstanceVolume 重置密码 instance NoSQLResetPassword 修改实例名称 instance NoSQLRenameInstance 规格变更 instance NoSQLResizeInstance 绑定弹性公网IP instance NoSQLBindEIP 解绑弹性公网IP instance NoSQLUnBindEIP 实例冻结 instance NoSQLFreezeInstance 实例解冻 instance NoSQLUnfreezeInstance 创建备份 backup NoSQLCreateBackup 删除备份 backup NoSQLDeleteBackup 设置备份策略 backup NoSQLSetBackupPolicy 添加实例标签 tag NoSQLAddTags 修改实例标签 tag NoSQLModifyInstanceTag 删除实例标签 tag NoSQLDeleteInstanceTag 创建参数模板 parameterGroup NoSQLCreateConfigurations 修改参数模板 parameterGroup NoSQLUpdateConfigurations 修改实例参数 parameterGroup NoSQLUpdateInstanceConfigurations 复制参数模板 parameterGroup NoSQLCopyConfigurations 重置参数模板 parameterGroup NoSQLResetConfigurations 应用参数模板 parameterGroup NoSQLApplyConfigurations 删除参数模板 parameterGroup NoSQLDeleteConfigurations 删除扩容失败的节点 instance NoSQLDeleteEnlargeFailNode 切换SSL instance NoSQLSwitchSSL 修改实例安全组 instance NoSQLModifySecurityGroup 存储空间自动扩容 instance NoSQLModifyAutoEnlargePolicy 搭建双活关系 instance NoSQLBuildBiactiveInstance 实例导出参数模板 instance NoSQLSaveConfigurations 回收站策略 instance NoSQLModifyRecyclePolicy 父主题： 审计

约束与限制 按需计费云数据库绑定的资源（弹性公网IP）可能不支持随实例同步变更计费模式，请参考表1查看绑定资源的计费规则及处理措施。 表1 弹性公网IP计费模式变更规则 资源 计费模式 计费方式 带宽类型 是否支持随GeminiDB Cassandra按需转包年/包月 处理措施 弹性公网IP 按需计费 按带宽计费 独享带宽 是 在控制台的弹性公网IP页面进行按需转包年/包月操作。 详细内容，请参见变更弹性公网IP计费方式。 弹性公网IP 按需计费 按流量计费 独享带宽 否 按需、按流量计费EIP不支持直接转为包年/包月EIP。变更方法如下： 先转为按需、按带宽计费的EIP。 再由按需、按带宽计费EIP转为包年/包月EIP。 详细内容，请参见变更弹性公网IP计费方式。

使用须知 磁盘容量变更目前既支持扩容，也支持缩容。 缩容场景下，待变更到的磁盘容量必须大于已用量的125%，向上取整。 扩容磁盘无需重启实例，在此期间，服务不中断，不影响您正常使用数据库。 缩容磁盘也无需重启实例，在此期间，服务不中断，不影响您正常使用数据库。 磁盘满容量后，允许继续写入，针对包周期实例，超出的部分将按需计费，推荐进行扩容磁盘，享受包周期优惠政策。 存储详情支持在“实例管理”页面显示，您可以联系客服进行开通。

使用须知 正在执行操作的实例不能手动删除，只有在实例操作完成后，才可删除实例。 “按需计费”类型的实例删除后将不再产生费用，实例生成的自动备份会被同步删除，保留的手动备份会继续收取费用。 实例删除后，该实例上的数据以及相关的自动备份将全部被清除，且不可恢复，请谨慎操作。建议您在删除实例前先创建备份，具体操作请参见创建手动备份。 实例删除后，实例下所有节点将同步被删除。 删除的实例在释放后会在回收站保留一段时间，您可在回收站中对实例进行重建操作。

典型应用 互联网应用 GeminiDB Cassandra的超强读写、弹性扩展，以及高强度的故障容忍，能够支持大并发低延时的访问需求，具备高可用和弹性扩容能力，使其适用于具有产品目录、推荐、个性化引擎、交易流水等功能的大数据量的互联网网站。 优势： 大规模集群部署 单套集群最大支持100个节点部署，适用于写入规模和数据量大的互联网场景。 高可用易扩展 单节点宕机不会影响整个集群的可用性，计算节点和存储空间可独立快速扩容，扩容期间业务无感知。 实时高并发写入 实时高并发写入，适合电商领域高并发海量订单，写入性能高。 工业数据采集 GeminiDB Cassandra兼容Cassandra生态，帮助客户整合多种终端采集来源，实时存储采集的指标，提供聚合分析，实时统计等功能。 优势： 大规模集群部署 适用于工业制造海量指标采集存储的场景。 高可用高性能 支持7*24小时在线持续高并发写入。 极速备份恢复 通过存储快照技术实现极速备份恢复能力。 分钟级扩容 轻松应对作业/项目高峰。

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 通过企业项目进行成本分配 在进行成本分配之前，建议开通企业项目并做好企业项目的规划，可以根据企业的组织架构或者业务项目来划分。在购买云资源时选择指定企业项目，新购云资源将按此企业项目进行成本分配。详细介绍请参见通过企业项目维度查看成本分配。 图1 选择企业项目 通过成本标签进行成本分配 标签是华为云为了标识云资源，按各种维度（例如用途、所有者或环境）对云资源进行分类的标记。推荐企业使用预定义标签进行成本归集，具体流程如下： 图2 添加标签 详细介绍请参见通过成本标签维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。 父主题： 成本管理

操作步骤 登录管理控制台。 在“实例管理”页面，单击“购买数据库实例”。 在“服务选型”页面，选择计费模式，兼容接口选择HBase，填写并选择实例相关信息后，单击“立即购买”。 图1 计费模式和基本信息 表1 计费方式 参数 描述 计费模式 目前仅支持按需计费模式。 用户选购完服务配置后，无需设置购买时长，系统会根据消费时长对账户余额进行扣费。 表2 基本信息 参数 描述 区域 租户所在的区域。 须知： 请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。不同区域内的产品内网不互通，且购买后不能更换，请谨慎选择。 实例名称 设置实例名称时，需要满足如下规则。 实例名称允许和已有名称重复。 实例名称长度在4个到64个字节之间，必须以字母或中文字开头，区分大小写，可以包含字母、数字、中划线、下划线或中文（一个中文字符占用3个字节），不能包含其他特殊字符。 兼容接口 HBase 实例类型 集群 版本 3.11 可用区 指在同一区域下，电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。 图2 规格与存储 表3 规格与存储 参数 描述 性能规格 CPU规格越高，性能越好。请根据实际业务场景，选取符合业务类型的性能规格。 节点数量 节点数量可选择范围为3～21，请根据实际需要进行选取。 存储空间 存储空间的取值范围（最大值和最小值）与所选的实例规格有关 调整存储空间容量时，选择容量大小必须为整数，且至少需选择1GB的扩容量。 图3 网络配置 表4 网络配置 参数 描述 虚拟私有云 实例所在的 虚拟专用网络 ，可以对不同业务进行网络隔离。您可根据需要创建或选择所需的虚拟私有云。 如果没有可用的VPC，系统自动为您分配资源。 如何创建VPC，请参见《虚拟私有云用户指南》中的“创建虚拟私有云基本信息及默认子网”。 您还可以通过共享VPC功能，使用其他账号共享的VPC和子网。 共享VPC是基于 资源访问管理 （Resource Access Manager，简称 RAM ）服务的机制，VPC的所有者可以将VPC内的子网共享给其他账号使用，以实现网络资源的共享和统一管理，提升资源管控效率、降低运维成本。 有关VPC子网共享的更多信息，请参见《虚拟私有云用户指南》的“共享VPC”相关内容。 说明： 目前实例创建完成后不支持切换 虚拟私有云VPC ，请谨慎选择所属虚拟私有云。 如需与E CS 进行内网通信，实例与需要通信的ECS需要处于同一个虚拟私有云下，或者不同虚拟私有云之间配置对等连接。 子网 通过子网提供与其他网络隔离的、可以独享的网络资源，以提高网络安全。 说明： 目前不支持选择IPV6网段的子网，建议您在使用时创建并选择IPV4网段的子网。 内网安全组 安全组限制安全访问规则，加强与其他服务间的安全访问。请确保所选取的安全组允许客户端访问数据库实例。 如果没有可用的安全组，系统自动为您分配资源。 图4 数据库配置 表5 数据库配置 参数 描述 管理员账户名 管理员账户名默认为rwuser。 管理员密码 用户设置的密码。 长度为8～32个字符。 必须是大写字母、小写字母、数字、特殊字符的组合，其中可输入特殊字符~!@#%^*-_=+?。 系统会进行弱密码校验，安全起见，请输入高强度密码。 请妥善管理您的密码，因为系统将无法获取您的密码信息。 确认密码 必须和管理员密码一致。 企业项目 该参数针对企业用户使用。 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理，默认项目为default。 请在下拉框中选择所在的企业项目。更多关于企业项目的信息，请参见《企业管理用户指南》。 参数模板 数据库参数模板就像是数据库引擎配置值的容器，参数模板中的参数可应用于一个或多个相同类型的数据库实例。实例创建成功后，参数模板可进行修改。 用户可以在实例创建完成之后根据业务需要进行调整。 SSL安全连接 SSL证书是一种遵守SSL协议的服务器数字证书，能在客户端和服务器端之间建立加密通道，保证数据在传输过程中不被窃取或篡改。 您可以开启SSL连接，提高数据安全性。 说明： 如果您在创建实例时未开启SSL安全连接，可以待实例创建成功后开启，操作详情请参见设置SSL 数据加密 。 表6 标签 参数 描述 标签 可选配置，对GeminiDB HBase的标识。使用标签可以方便识别和管理您拥有的GeminiDB HBase资源。 每个实例默认最多支持20个标签配额。 如您的组织已经设定GeminiDB HBase的相关标签策略，则需按照标签策略规则为实例添加标签。标签如果不符合标签策略的规则，则可能会导致实例创建失败，请联系组织管理员了解标签策略详情。 标签由标签“键”和标签“值”组成。 键：如果要为数据库实例添加标签，该项为必选参数。 对于每个实例，每个标签的键唯一。长度不超过128字符，只能包含数字（0-9）、英文字母（A-Z，a-z）、下划线（_）、点（.）、连接符（-）和中文。 值：如果要为数据库实例添加标签，该项为可选参数。 长度不超过255个字符，只能包含数字（0-9）、英文字母（A-Z，a-z）、下划线（_）、点（.）、连接符（-）和中文。 在“订单详情确认”页面，核对实例信息。 如果需要修改，单击“上一步”，修改实例信息。 核对无误后，勾选协议，单击“提交”，开始创建实例。 在“实例管理”页面，您可以查看并管理实例。 实例创建过程中，运行状态显示为“创建中”。 实例创建完成后，运行状态显示为“正常”。 如果页面长时间未刷新，您可以单击页面右上角的刷新页面查看实例运行状态。 创建实例时，系统默认开启自动备份策略。因此，实例创建成功后，系统会自动创建一个全量备份。 实例创建完成后，在“实例管理”页面的兼容接口列显示“Cassandra 3.11.3”，实际为兼容HBase的Cassandra接口，使用与HBase无差异，可放心使用。

前提条件 已成功创建GeminiDB DynamoDB实例，且实例状态正常。 已创建弹性云服务器，其中弹性云服务器规格为16U64G，磁盘空间大于100GB。创建弹性云服务器的方法，请参见《弹性云服务器快速入门》中“创建弹性云服务器”章节。 AWS DynamoDB与弹性云服务器之间通过专线传输数据，请确保弹性云服务器和AWS DynamoDB以及GeminiDB DynamoDB网络通畅。 GeminiDB DynamoDB存储容量不得小于AWS DynamoDB存储容量。 AWS DynamoDB开启流接口。

产品优势 使用成本低 随着业务的发展，企业数据量持续不断地增加，DynamoDB读写请求累加带来的费用也日渐高涨。而GeminiDB DynamoDB协议具有较高的性价比，既能提供更高的吞吐，又可以降低一半的DynamoDB使用成本，尤其当数据量较大时成本降低更加明显。 更灵活开发的部署方式 DynamoDB是一项全托管服务，用户使用需要遵循一定的部署方式和规则。相比之下，GeminiDB DynamoDB协议可以根据用户的具体需求灵活地部署服务，客户可以选择部署在私有云或公有云上，而不是被锁定在昂贵的平台上。无论在哪种部署环境下，GeminiDB DynamoDB协议都可以保证服务的稳定和高效。 平滑的迁移 除了以上两点，GeminiDB DynamoDB协议可以完全兼容DynamoDB的语法和数据模型，所以从DynamoDB迁移到GeminiDB DynamoDB协议将变得非常容易，应用程序也不需要进行任何修改，迁移工作将会更高效便捷，对业务也更加友好。

扩展JSON语义： 表2 扩展JSON语义 关键字 作用 filter 在查询语句中json查询的关键字。 term 查询时判断某个document是否包含某个具体的值。 match 将被询值进行分词，进行全文检索。 range 查询指定某个字段在某个特定的范围。(范围查询子关键字："eq"/"gte"/"gt"/"lte"/"lt") bool 必须和 "must"、"should"、"must not" 一起组合出复杂的查询。 must bool类型的子查询，封装"term"、"match"、"range" 查询。 should bool类型的子查询，封装"term"、"match"、"range" 查询。 must not bool类型的子查询，封装"term"、"match"、"range" 查询。 sort 支持全局索引列排序功能。

查看实例IP地址 登录管理控制台。 在“实例管理”页面，单击目标实例名称，进入基本信息页面。 方法一： 在“基本信息”页面下方节点信息列表中，即可查看到GeminiDB HBase实例下各个节点的内网IP地址。 GeminiDB HBase实例目前不支持绑定公网IP。 图1 查看IP地址 在网络信息区域可以查看到GeminiDB HBase实例的端口，界面显示默认为8635，实际使用的默认端口为2181。 图2 查看端口 方法二： 您也可以单击实例“基本信息”左侧导航中的“连接管理”，即可查看到实例的内网IP地址和端口。 图3 查看IP和端口

约束与限制 包年/包月的云数据库绑定的资源（弹性公网IP）可能不支持随云数据库同步变更计费模式，请参考表1查看绑定资源的计费规则及处理措施。 表1 弹性公网IP计费模式变更规则 资源 计费模式 计费方式 带宽类型 是否支持随GeminiDB Influx包年/包月转按需 处理措施 弹性公网IP 包年/包月 按带宽计费 独享带宽 否 在控制台的弹性公网IP页面进行按需转包年/包月操作。 详细内容，请参见变更弹性公网IP计费方式。 弹性公网IP 包年/包月 按流量计费 独享带宽 否 包年/包月EIP不支持直接转为按需、按流量计费EIP。变更方法如下： 先转为按需、按带宽计费EIP。 再由按需、按带宽计费EIP转为按需、按流量计费EIP。 详细内容，请参见变更弹性公网IP计费方式。

约束与限制 按需计费云数据库绑定的资源（弹性公网IP）可能不支持随实例同步变更计费模式，请参考表1查看绑定资源的计费规则及处理措施。 表1 弹性公网IP计费模式变更规则 资源 计费模式 计费方式 带宽类型 是否支持随GeminiDB Influx按需转包年/包月 处理措施 弹性公网IP 按需计费 按带宽计费 独享带宽 是 在控制台的弹性公网IP页面进行按需转包年/包月操作。 详细内容，请参见变更弹性公网IP计费方式。 弹性公网IP 按需计费 按流量计费 独享带宽 否 按需、按流量计费EIP不支持直接转为包年/包月EIP。变更方法如下： 先转为按需、按带宽计费的EIP。 再由按需、按带宽计费EIP转为包年/包月EIP。 详细内容，请参见变更弹性公网IP计费方式。

支持审计的关键操作列表 通过云审计服务，您可以记录与GeminiDB Influx相关的操作事件，便于日后的查询、审计和回溯。 表1 GeminiDB Influx的关键操作列表 操作名称 资源类型 事件名称 创建实例 instance NoSQLCreateInstance 删除实例 instance NoSQLDeleteInstance 扩容节点 instance NoSQLEnlargeInstance 缩容节点 instance NoSQLReduceInstance 重启实例 instance NoSQLRestartInstance 恢复到新实例 instance NoSQLRestoreNewInstance 磁盘扩容 instance NoSQLExtendInstanceVolume 重置密码 instance NoSQLResetPassword 修改实例名称 instance NoSQLRenameInstance 规格变更 instance NoSQLResizeInstance 绑定弹性公网IP instance NoSQLBindEIP 解绑弹性公网IP instance NoSQLUnBindEIP 实例冻结 instance NoSQLFreezeInstance 实例解冻 instance NoSQLUnfreezeInstance 创建备份 backup NoSQLCreateBackup 删除备份 backup NoSQLDeleteBackup 设置备份策略 backup NoSQLSetBackupPolicy 添加实例标签 tag NoSQLAddTags 修改实例标签 tag NoSQLModifyInstanceTag 删除实例标签 tag NoSQLDeleteInstanceTag 创建参数模板 parameterGroup NoSQLCreateConfigurations 修改参数模板 parameterGroup NoSQLUpdateConfigurations 修改实例参数 parameterGroup NoSQLUpdateInstanceConfigurations 复制参数模板 parameterGroup NoSQLCopyConfigurations 重置参数模板 parameterGroup NoSQLResetConfigurations 应用参数模板 parameterGroup NoSQLApplyConfigurations 删除参数模板 parameterGroup NoSQLDeleteConfigurations 删除扩容失败的节点 instance NoSQLDeleteEnlargeFailNode 切换SSL instance NoSQLSwitchSSL 修改实例安全组 instance NoSQLModifySecurityGroup 实例导出参数模板 instance NoSQLSaveConfigurations 回收站策略 instance NoSQLModifyRecyclePolicy 父主题： 审计

兼容接口和版本 介绍GeminiDB Influx目前支持的兼容接口和版本。 表1 兼容接口和版本 兼容接口 实例类型 版本 InfluxDB 集群 集群是基于多个节点（至少是三节点）组成。集群的主要特点是横向扩展能力强，能满足不断增长的数据量需求，因此当您对可用性要求较高、数据量较大、未来扩展性要求较高的情况下，推荐您使用集群架构。 单节点 单节点实例只有一个节点，无法保证SLA，建议仅用于测试和功能验证。 1.7，1.8 父主题： 产品介绍

监控指标 如下监控指标需要在实例节点查看，具体方法请参见查看监控指标。 表1 GeminiDB Influx支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） gemini001_cpu_usage CPU利用率 该指标为从系统层面采集的CPU使用率。 单位：% 0~100 % GeminiDB Influx实例的节点 1分钟 gemini002_mem_usage 内存利用率 该指标为从系统层面采集的内存使用率。 单位：% 0~100 % GeminiDB Influx实例的节点 1分钟 gemini003_bytes_out 网络输出吞吐量 统计平均每秒从测量对象的所有网络适配器输出的流量。 单位：kb/s ≥ 0 kb/s GeminiDB Influx实例的节点 1分钟 gemini004_bytes_in 网络输入吞吐量 统计平均每秒从测量对象的所有网络适配器输入的流量。 单位：kb/s ≥ 0 kb/s GeminiDB Influx实例的节点 1分钟 nosql005_disk_usage 存储容量使用率 该指标为存储容量使用率。 单位：% 0~100 % GeminiDB Influx实例 1分钟 nosql006_disk_total_size 存储容量总容量 该指标为实例的存储容量总容量。 单位：GB ≥ 0 GB GeminiDB Influx实例 1分钟 nosql007_disk_used_size 存储容量使用量 该指标为实例的存储容量使用量。 单位：GB ≥ 0 GB GeminiDB Influx实例 1分钟 influxdb001_series_num 时间线数量 描述总的时间线数量。 单位：Counts ≥ 0 Counts GeminiDB Influx实例的节点 1分钟 influxdb002_query_req_ps 每秒查询请求 描述每秒查询请求的数量。 单位：Counts/s ≥ 0 Counts/s GeminiDB Influx实例的节点 1分钟 influxdb003_write_req_ps 每秒写入请求 描述每秒写入请求的数量。 单位：Counts/s ≥ 0 Counts/s GeminiDB Influx实例的节点 1分钟 influxdb004_write_points_ps 写入数据点 描述每秒写入的数据点数量。 单位：Counts/s ≥ 0 Counts/s GeminiDB Influx实例的节点 1分钟 influxdb005_write_concurrency 写入并发量 描述并发写入的请求数量。 单位：Counts ≥ 0 Counts GeminiDB Influx实例的节点 1分钟 influxdb006_query_concurrency 查询并发量 描述并发查询的请求数量。 单位：Counts ≥ 0 Counts GeminiDB Influx实例的节点 1分钟

使用须知 可维护时间段目前处于公测状态，如果您想使用，请联系客服开通。 目前只有实例重启、规格变更和补丁升级支持可维护时间段。 已经选择可维护时间段的规格变更和补丁升级，不能再立即执行；实例重启可以立即执行。 您可以取消待执行的任务。 修改可维护时间段，不影响原有可维护时间段内定时任务的执行时间。 可维护时间段不要和备份的时间冲突，否则可能会导致定时任务失败。 在可维护时间段内，定时任务10分钟扫描一次，执行任务；临近可维护时间段结束时下发的任务，有可能扫描不到，取消执行。

使用须知 目标实例必须与弹性云服务器在同一个虚拟私有云和子网内才能访问。 该弹性云服务器必须处于目标实例所属安全组允许访问的范围内。 如果目标实例所属安全组为默认安全组， 则无需设置安全组规则。 如果目标实例所属安全组非默认安全组，请查看安全组规则是否允许该弹性云服务器访问。具体操作请参考设置安全组规则。 如果安全组规则允许弹性云服务器访问，即可连接实例。 如果安全组规则不允许弹性云服务器访问，需要在实例安全组添加一条“入”的访问规则。

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 通过企业项目进行成本分配 在进行成本分配之前，建议开通企业项目并做好企业项目的规划，可以根据企业的组织架构或者业务项目来划分。在购买云资源时选择指定企业项目，新购云资源将按此企业项目进行成本分配。详细介绍请参见通过企业项目维度查看成本分配。 图1 选择企业项目 通过成本标签进行成本分配 标签是华为云为了标识云资源，按各种维度（例如用途、所有者或环境）对云资源进行分类的标记。推荐企业使用预定义标签进行成本归集，具体流程如下： 图2 添加标签 详细介绍请参见通过成本标签维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。 父主题： 成本管理

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

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

备份原理 GeminiDB Influx有专门负责备份管理的节点（三个Meta节点中ID最小的Meta节点，后续称为M1节点）。如图1所示，GeminiDB Influx的备份在M1节点上进行，通过对数据进行秒级快照，并将生成的备份文件以压缩包的形式存储在对象存储服务（OBS）中，不会额外占据GeminiDB Influx实例的存储空间。备份上传过程中会消耗一定的CPU，因此会存在CPU上涨的现象，一般涨幅范围在5%~15%，该现象属于正常现象。 图1 备份原理

使用须知 支持SELECT查询命令。 支持INSERT写入数据命令。 支持数据库操作命令（包括创建数据库、删除数据库、展示数据库等命令）。 支持用户操作命令（包括创建用户、删除用户、展示用户、授权用户、修改用户密码等命令）。 支持保留策略操作命令（包括创建保留策略、删除保留策略、展示保留策略、修改保留策略等命令）。 支持CONTINUOUS QUERY操作命令（包括创建CONTINUOUS QUERY、删除CONTINUOUS QUERY、展示CONTINUOUS QUERY等命令）。

用户服务 服务 作用范围 系统权限 权限类别 权限描述 业务支撑系统（BSS） （项目级服务） 须知： 授权时，除了全局服务外，需要授予其他所有区域的权限。 区域级项目 BSS Administrator 角色 费用中心、资源中心、账号中心的所有执行权限。 BSS ReadonlyAccess 策略 费用中心、成本中心、消息中心的只读权限。 BSS FinanceAccess 费用中心（BSS）财务管理员，拥有财务操作相关的所有权限。 Enterprise Project BSS FullAccess 企业项目支持的所有运营权限。 企业项目管理服务（EPS） （全局级服务） 全局服务 EPS FullAccess 策略 企业项目管理服务所有权限。 EPS ReadOnlyAccess 企业项目管理服务只读权限。 工单管理（Service Ticket） （全局级服务） 全局服务 Ticket Administrator 角色 工单管理的所有执行权限。 Ticket Group Operator 该权限用于处理同组其他用户工单，以便协同办公。 专业服务 （全局级服务、项目级服务） 所有项目 PSDMFullAccess 策略 专业服务交付管理平台的所有权限。 PSDMReadOnlyAccess 专业服务交付管理平台的只读权限。 网站备案 （全局级服务） 全局服务 Beian Administrator 角色 备案服务管理员，拥有备案服务的所有执行权限。

视频 服务 作用范围 系统权限 权限类别 权限描述 媒体处理 （MPC） （项目级服务） 区域级项目 MPC Administrator 角色 媒体处理的所有执行权限。 视频点播 服务（VOD） （项目级服务） 区域级项目 VOD Administrator 角色 视频点播服务里的所有操作权限，操作对象为所有的媒资文件。 VOD Group Administrator 除全局配置以及 域名 管理以外的其他点播服务操作权限，操作对象为用户所在组创建的媒资文件。 VOD Group Operator 具有除审核媒资、删除媒资、全局配置、域名管理以外的其他点播服务操作权限，操作对象为用户所在组创建的媒资文件。 VOD Group Guest 仅具备查询媒资文件的权限，操作对象为用户所在组创建的媒资文件。 VOD Operator 具有除审核媒资、全局配置、域名管理以外的其他点播服务操作权限，操作对象为用户所在组创建的视频文件。 VOD Guest 视频点播服务只读权限。 VOD FullAccess 策略 视频点播服务所有权限。 VOD ReadOnlyAccess 视频点播服务只读权限。 VOD CommonOperations 视频点播服务基本操作权限。具有除全局配置、域名管理、权限管理、审核设置、音视频托管以外的其他点播服务操作权限。 视频直播 服务（Live） （项目级服务） 区域级项目 Live FullAccess 策略 视频直播服务所有权限。 Live ReadOnlyAccess 视频直播服务只读权限。 实时音视频 （SparkRTC） （全局服务） 全局服务 RTC FullAccess 策略 实时音视频服务所有权限。 RTC ReadOnlyAccess 实时音视频服务只读权限。