华为云用户手册

备份方案 RDS的备份方案请参见表1。 表1 备份方案 任务类型 备份类型 使用场景 数据备份 自动备份 RDS会在数据库实例的备份时段中创建数据库实例的自动备份，自动备份为全量备份。系统根据您指定的备份保留期保存数据库实例的自动备份。如果需要，您可以将数据恢复到备份保留期中的任意时间点。 开启自动备份策略后，会自动触发一次全量备份，备份方式为物理备份。之后会按照策略中的备份时间段和备份周期进行全量备份。自动备份策略开启后，实例每五分钟会自动进行一次增量备份，以保证数据库可靠性。 手动备份 手动备份是由用户启动的数据库实例的全量备份，备份方式为物理备份。手动备份会一直保存，不会随着RDS实例的删除而释放，直到用户手动删除。 增量备份 增量备份即Binlog备份，RDS for MariaDB默认自动开启。 在进行全量备份的同时系统每五分钟会自动生成增量备份，用户不需要设置。生成的增量备份可以用来将数据恢复到指定时间点。 下载备份文件 下载全量备份文件 包含使用OBS Browser+下载、直接浏览器下载、按地址下载三种方式。 下载增量备份文件 支持下载单个Binlog文件，或者合并下载Binlog文件。 合并下载Binlog文件包含使用OBS Browser+下载、直接浏览器下载、按地址下载三种方式。

备份清理 备份文件清理分为两种场景：手动备份清理和自动备份清理。 手动备份是由用户触发产生的全量备份，需要用户手动删除，否则会一直保存。 自动备份的备份文件不支持手动删除，可通过设置同区域备份策略调整备份保留天数，超出备份保留天数的已有备份文件会被自动删除。 Binlog本地日志清理： 清理Binlog日志时，即使设置保留时长为0，RDS也会保证主节点的Binlog同步到备节点、只读节点全部完成，并且备份到OBS成功以后才会执行清理。 如果选择的保留时长大于0，例如设置1天，那么在Binlog同步及备份成功后，本地Binlog日志将会继续保留1天，到期后自动删除。

约束限制 账户余额大于等于0元，才可进行克隆实例。 克隆实例需要具有相应的权限，您可联系华为云客服人员申请。 实例克隆过程中不会限制主实例业务访问，克隆实例中的数据和下发克隆动作时的数据一致，不能保证和主实例数据完全一致。 克隆的新实例磁盘类型和大小必须和主实例保持一致。 克隆的新实例AZ必须和主实例保持一致。 克隆实例的参数组、数据库版本、实例类型和主实例保持一致。 SQL Server 2008R2标准版和只读实例不支持实例克隆。 实例克隆过程中，主实例不能进行如下操作： 实例规格变更 开启透明数据加密（Transparent Data Encryption，简称TDE） 开启或关闭FileStream 数据迁移 恢复数据到自身 修改MSDTC相关内容 删除实例 手动切换主备实例 重置密码 单机转主备实例 实例版本升级

约束限制 RDS for MySQL 5.6、5.7、8.0版本的主备实例支持备机可用区迁移功能。其中，RDS for MySQL 5.6和5.7版本的本地盘实例备机可用区迁移，以及8.0版本的备机可用区迁移功能需要联系客服人员申请权限。 业务高峰期批量写操作可能会导致迁移失败，为确保迁移成功，请选择业务低峰期操作。 迁移期间将短暂停止DDL语句和event定时任务，请选择业务低峰期操作，避免业务异常中断。 关于区域和可用区的详情，请参见区域和可用区。

操作步骤 执行以下命令，进行跟踪标记。 EXEC msdb.dbo.rds_dbcc_trace @Trace_Flag, @Trace_Action; @ Trace_Flag：指定跟踪标记序号，当前仅支持 1117, 1118, 1204, 1211, 1222, 1224, 3604。 @ Trace_Action：指定跟踪标记操作，1为打开跟踪标记，0为关闭跟踪标记，-1为查看跟踪标记。 打开跟踪标记1117，示例如下： EXEC msdb.dbo.rds_dbcc_trace 1117, 1;

迁移准备 云数据库RDS服务支持开启公网访问功能，通过弹性公网IP进行访问。您也可通过弹性云服务器的内网访问云数据库RDS。 准备弹性云服务器或可通过公网访问云数据库RDS。 通过弹性云服务器连接云数据库RDS实例，需要创建一台弹性云服务器。 通过公网地址连接云数据库RDS实例，需具备以下条件。 先对云数据库RDS实例绑定公网地址，如何绑定公网地址，请参见绑定弹性公网IP。 保证本地设备可以访问云数据库RDS实例绑定的公网地址。 在准备的弹性云服务器或可访问云数据库RDS的设备上，安装MySQL客户端。 请参见如何安装MySQL客户端。 该弹性云服务器或可访问云数据库RDS的设备需要安装和RDS for MySQL数据库服务端相同版本的数据库客户端，MySQL数据库或客户端会自带mysqldump和mysql工具。 数据迁移到云数据库RDS后可能要面对更改IP的问题，为减少客户业务更改，降低迁移难度，支持更改内网IP，具体请参见查看和修改内网地址。 云数据库RDS的系统库mysql和sys不支持导入到RDS for MySQL实例。

常见问题 问题：近一天空间增长异常如何处理？ 解决方法：设置诊断阈值后如果出现近一天空间增长异常，需要检查表空间碎片，及时回收碎片，尽量不使用DELEDTE清空数据。如有其他疑问请提交工单联系客服为您解答。 问题：无主键表对数据库的影响是什么？ 解决方法：无主键表在数据库运行中会导致慢SQL，从而影响实例的稳定性。建议为无主键表添加主键，减少主从复制时延。 问题：无索引表对数据库的影响是什么？ 解决方法：无索引表在数据库运行中会导致慢SQL，从而影响实例的稳定性。建议为表字段添加对应索引，提升查询效率。

RDS支持的最大IOPS是多少 华为云关系型数据库服务支持的IOPS取决于云硬盘（Elastic Volume Service，简称EVS）的IO性能，具体请参见《云硬盘产品介绍》中“磁盘类型及性能介绍”的内容。。 RDS for MySQL本地SSD盘的IOPS如下： 表1 x86通用型规格对应的IOPS vCPU 内存(GB) 读IOPS 写IOPS 2 4 2000 2000 2 8 4000 4000 4 8 5000 5000 4 16 7000 7000 8 16 8000 8000 8 32 12000 12000 16 64 14000 14000 表2 独享型规格对应的IOPS vCPU 内存(GB) 读IOPS 写IOPS 4 16 4500 4500 4 32 9000 9000 8 32 9000 9000 8 64 18000 18000 16 64 18000 18000 16 128 36000 36000 32 128 36000 36000 32 256 72000 72000 64 512 144000 144000 父主题： 性能调优

操作背景 分布式事务指事务的参与者、支持事务的服务器、资源服务器以及事务管理器分别位于不同的分布式系统的不同节点之上。简单的说，就是一次大的操作由不同的小操作组成，这些小的操作分布在不同的服务器上，且属于不同的应用，分布式事务需要保证这些小操作要么全部成功，要么全部失败。本质上来说，分布式事务就是为了保证不同数据库的数据一致性。 MSDTC服务提供分布式事务服务，如果要在数据库中使用分布式事务，必须在参与的双方服务器启动MSDTC（Distributed Transaction Coordinator）服务。RDS for SQL Server在开启分布式事务的时候已经启动MSDTC，其他服务器请参考设置远程服务器MSDTC（分布式事务处理协调器）进行启动。 更多介绍请参见Microsoft SQL Server官网MS DTC 分布式事务介绍。

Top20表 展示空间占用Top20的数据表详细信息。不支持展示包含非英文字符集的表名。 图7 表信息 表5 表参数说明 参数 说明 表名 表的名称。 保留大小 表文件总的保留大小。 数据空间 表数据占用的总空间。 索引空间 表索引占用的总空间。 可用空间 表可用空间。 行数 表中数据的总行数。 索引数量 表中建立的索引数量。 创建时间 表创建时间，格式受实例字符集影响。 在表列表，单击“查看趋势”，可以查看近7天、近30天、自定义时间段内表的空间变化趋势。 图8 表数据趋势

Top20库 展示空间占用Top20的数据库详细信息，包括库文件信息。 图4 库信息 表3 库参数说明 参数 说明 数据库 数据库名。 状态 数据库状态。 总空间（MB） 当前单库总的占用空间，单位MB。 已使用（MB） 当前单库已使用空间，单位MB。 可用空间（MB） 当前单库剩余可用空间，单位MB。 日志已使用（MB） 当前单库事务日志已使用空间，单位MB。 日志可用（MB） 当前单库事务日志可用空间，单位MB。 在数据库列表，单击“查看趋势”，可以查看近7天、近30天、自定义时间段内库的空间变化趋势。 图5 库数据趋势 单击数据库前面的，可打开当前库所包含的库文件列表。 表4 库文件列表参数说明 参数 说明 文件组 文件所在的文件组名，Log文件的文件组为NULL。 文件类型 文件的类型，通常为Data、Log或Filestream类型。 文件名 数据库文件的名称。 总空间大小（MB） 文件占用的总空间，单位MB。 已使用空间（MB） 文件已使用空间，单位MB。 可用空间（MB） 文件可用空间，单位MB。 文件最大限制（MB） 文件空间最大限制，单位MB，值为-1时表示不受限制。 文件自动增长量 文件自动增长的步长单位，固定值单位MB，或百分比。 在库文件列表，勾选单个或多个文件，单击“批量文件收缩”，执行文件收缩命令（master、msdb、model、rdsadmin库限制下发）。 图6 批量文件收缩

基本使用 全文检索中文分词功能 -- 查看Zhparser的词典配置 SELECT ts_token_type('zhparser'); -- 配置中文解析器 CREATE TEXT SEARCH CONFIGURATION testzhcfg (PARSER = zhparser); 添加分词策略 -- 添加名词（n）、动词（v）、形容词（a）、成语（i）、叹词（e）和习用语（l） 六种分词策略 ALTER TEXT SEARCH CONFIGURATION testzhcfg ADD MAPPING FOR n,v,a,i,e,l WITH simple; 测试分词效果（to_tsvector） SELECT to_tsvector('testzhcfg','华为云数据库 RDS for PostgreSQL是一种典型的开源关系型数据库，在保证数据可靠性和完整性方面表现出色，支持互联网电商、地理位置应用系统、金融保险系统、复杂数据对象处理等场景。'); to_tsvector ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------------- 'for':5 'postgresql':6 'rds':4 '云':2 '互联网':19 '保证':11 '典型':8 '出色':17 '华为':1 '可靠性':13 '地理位置':21 '场景':30 '处理':28 '复杂':25 '完整性':14 '对象':27 '应用系统':22 '开源':9 '支持':18 '数据':12,26 '数据库':3,10 '方面':15 '是':7 '电商':20 '等':29 '系统':24 '表现':16 '金融保险':23 (1 row) 测试分词效果（to_tsquery） SELECT to_tsquery('testzhcfg', 'PostgreSQL是一种典型的开源关系型数据库，在保证数据可靠性和完整性方面表现出色'); to_tsquery --------------------------------------------------------------------------------------------------------------------------------------------- 'postgresql' & '是' & '典型' & '开源' & '数据库' & '保证' & '数据' & '可靠性' & '完整性' & '方面' & '表现' & '出色' (1 row)

支持的版本说明 RDS for PostgreSQL 9.5、9.6、10、11、12、13、14最新的小版本支持该插件。可通过以下SQL语句查询当前实例是否支持该插件： SELECT * FROM pg_available_extension_versions WHERE name = 'zhparser'; 如果不支持，可通过升级内核小版本或者使用转储与还原升级大版本使用该插件。 RDS PostgreSQL实例支持的插件，具体请参见支持的插件列表。

进阶使用 利用分词进行全文索引，示例：为t1表的name字段创建全文索引，使用时将SQL语句中的表名(t1)和字段(name)替换为实际业务中的表名和字段值。 -- 创建测试表 CREATE TABLE t1(name text); INSERT INTO t1 VALUES ('华为云数据RDS for PostgreSQL是一种典型的开源关系型数据库'); INSERT INTO t1 VALUES ('在保证数据可靠性和完整性方面表现出色'); INSERT INTO t1 VALUES ('支持互联网电商、地理位置应用系统、金融保险系统、复杂数据对象处理等场景'); -- 创建索引 CREATE INDEX idx_t1 ON t1 USING gin (to_tsvector('testzhcfg',upper(name) )); -- 使用全文索引 SELECT * FROM t1 WHERE to_tsvector('testzhcfg',upper(t1.name)) @@ to_tsquery('testzhcfg','(互联网)') ; name ----------------------------------------------------------------------------------------------------------- 支持互联网电商、地理位置应用系统、金融保险系统、复杂数据对象处理等场景 (1 row)

简介 PostgreSQL自带的parser插件适用于分词比较简单的语言（如英语），按照标点、空格切分语句即可获得有含义的词语，而中文比较复杂，词语之间没有空格分隔，长度也不固定，分词还和语义有关，因此parser不能用来做中文分词，建议使用zhparser。 zhparser是PostgreSQL的中文分词插件，安装后可以使PostgreSQL支持中文的全文检索（Full Text Search）。 全文检索总体介绍，请参见全文检索。 更多信息，请参见zhparser官方文档。

服务器级别排序规则 下表为部分操作系统（OS）区域设置确定的默认排序规则。 表4 操作系统排序规则 Windows区域设置 默认排序规则 南非荷兰语（南非） Latin1_General_CI_AS 阿尔萨斯语（法国） Latin1_General_CI_AS 巴斯克语（巴斯克） Latin1_General_CI_AS 波斯尼亚语（波斯尼亚和黑塞哥维那，拉丁语） Latin1_General_CI_AS 保加利亚语（保加利亚） Cyrillic_General_CI_AS 中文（澳门特别行政区） Latin1_General_CI_AI 中文（中华人民共和国） Chinese_PRC_CI_AS 荷兰语（荷兰） Latin1_General_CI_AS 英语（澳大利亚） Latin1_General_CI_AS 英语（印度） Latin1_General_CI_AS 英语（加拿大） Latin1_General_CI_AS 英语（新西兰） Latin1_General_CI_AS 英语（英国） Latin1_General_CI_AS 英语（美国） Latin1_General_CI_AS 菲律宾语（菲律宾） Latin1_General_CI_AS 意大利语（意大利） Latin1_General_CI_AS 泰语（泰国） Thai_CI_AS

字符集排序规则 表2 排序规则说明 排序规则选项 说明 区分大小写（_CS） 区分大写字母和小写字母。 如果指定此项，排序时小写字母将在其对应的大写字母之前。 如果未指定此选项，排序规则将不区分大小写。 即RDS for SQL Server 在排序时将大写字母和小写字母视为相同。 通过指定 _CI，可以显式选择不区分大小写。 区分重音（_AS） 区分重音字符和非重音字符。 例如，“a”和“ấ”为不同字符。 如果未指定此选项，则排序规则将不区分重音。 即RDS for SQL Server 在排序时将字母的重音形式和非重音形式视为相同。 通过指定 _AI，可以显式选择不区分重音。

支持的实例字符集 RDS for SQL Server当前支持的实例字符集如表1所示： 表1 支持的实例字符集 实例字符集 说明 Chinese_PRC_90_CI_AI Chinese-PRC-90，不区分大小写、不区分重音（兼容SQL Server 2005）。 Chinese_PRC_CI_AI Chinese-PRC，不区分大小写、不区分重音。 Chinese_PRC_CI_AS Chinese-PRC，不区分大小写、区分重音。 Chinese_PRC_CS_AS Chinese-PRC，区分大小写、区分重音。 Cyrillic_General_CI_AS Cyrllic_General，不区分大小写，区分重音。 SQL_Latin1_General_CP1_CI_AS 对于Unicode 数据为 Latin1_General，不区分大小写，区分重音。 THAI_CI_AS THAI，不区分大小写、区分重音。

约束限制 仅支持RDS for MySQL 5.6版本升级到5.7最新版本。有关内核版本详情，请参见内核版本说明。 对于主备实例，复制延迟大于300秒无法升级大版本。 实例中存在异常节点，无法升级大版本。 MySQL 5.7及之后版本不再支持Sequence Engine，升级前请确认。 目前RDS for MySQL实例最大可支持50万张表，大于50万张表时，可能会导致大版本升级失败。 云数据库RDS for MySQL暂不支持已开启事件定时器功能的实例升级大版本，若您想使用该功能，请先关闭事件定时器。具体操作请参考开启或关闭事件定时器。

注意事项 升级数据库大版本过程将造成不超过五分钟的业务中断，请您尽量在业务低峰期执行该操作，并且确保您的应用有自动重连机制。 升级主实例大版本时，如有只读实例，也会同步升级只读实例的大版本，升级大版本过程将造成不超过五分钟的业务中断，请您选择合适的时间升级（不支持单独升级只读实例的大版本）。 升级大版本后，实例会升级到新的内核大版本，不支持降级。 请务必仔细对比升级前后版本差异，如有必要建议新建一个RDS for MySQL 5.7版本实例进行语法测试，避免应用使用的低版本语法或特性在升级高版本后不支持。 建议您克隆原实例，先使用克隆实例进行升级测试，确认各项功能正常后再升级原实例。 内核大版本升级期间需要确保实例预留了足够的空间支撑升级过程中的业务写入。 大版本升级定时任务需预准备，设置后不可取消。 升级大版本后，升级前的备份将不可用于新版本实例，时间点恢复功能将不能选择升级前的时间点。 大版本升级过程中禁止event的DDL操作，如create event、drop event和alter event。 大版本升级后，规格参数会恢复到升级版本的默认值，包括以下参数：threadpool_size、innodb_buffer_pool_size、innodb_io_capacity、innodb_io_capacity_max、innodb_buffer_pool_instances、back_log、max_connections。

通过DRS升级大版本 RDS for MySQL支持通过DRS将RDS for MySQL 5.6版本数据迁移到5.7版本。使用该方式进行大版本升级，需要提前准备好待迁移到的高版本数据库实例。 您可以在“实例管理”页面，单击目标实例名称，在页面右上角，单击“迁移数据库”，进入数据复制服务信息页面。 具体迁移操作，请参见《数据复制服务用户指南》的“入云迁移”内容。 表1 MySQL数据库版本信息 源数据库版本 目标数据库版本 迁移类型 RDS for MySQL/自建MySQL/其他云MySQL 5.5.x 5.6.x 5.7.x 8.0.x RDS for MySQL 5.6.x 5.7.x 8.0.x MySQL数据库版本升级 DRS仅支持从低版本迁移到高版本。

云审计服务支持的漏洞管理服务操作列表 通过云审计服务，用户可以记录与漏洞管理服务相关的操作事件，便于日后的查询、审计和回溯。 开启了云审计服务后，系统开始记录漏洞管理服务资源的操作。 云审计服务管理控制台保存最近7天的操作记录，查看云审计日志操作请参考查看审计事件。 云审计服务支持的漏洞管理服务操作列表如表1所示。 表1 云审计服务支持的漏洞管理服务操作列表 操作名称 资源类型 事件名称 网站 创建域名 domain createDomain 删除域名 domain deleteDomain 编辑域名 domain editDomain 免认证/一键认证 domain authenticateDomain 快捷认证 domain authorizeDomain 创建漏洞扫描任务 scan createScanTask 创建内部漏洞扫描任务 scan createInnerScanTask 重启漏洞扫描任务 scan restartScanTask 取消漏洞扫描任务 scan cancelScanTask 编辑漏洞扫描任务 scan editScanTask 创建订阅套餐 resource createPurchaseOrder 更新订阅套餐 resource createAlterOrder 批量更新订阅套餐 resource createBatchAlterOrder 新用户注册 resource createVSSResource 删除监测任务 monitor deleteMonitorJob 暂停监测任务 monitor pauseMonitorJob 恢复监测任务 monitor resumeMonitorJob 忽略漏洞 vuln addVulnFalsePositive 取消忽略漏洞 vuln deleteVulnFalsePositive 生成网站扫描报告 report generateWebScanReport 下载网站扫描报告 report downloadWebScanReport 主机 添加主机 host addHost 删除主机 host deleteHost 编辑主机 host editHost 更换分组 host changeHostGroup 新增主机组 host addHostGroup 编辑主机组 host editHostGroup 删除主机组 host deleteHostGroup 创建主机扫描任务 scan createHostScanTask 取消主机扫描任务 scan cancelHostScanTask 添加跳板机 jumper saveJumperServer 编辑跳板机 jumper editJumperServer 删除跳板机 jumper deleteJumperServer 添加smb授权 credential saveSmbCredential 编辑smb授权 credential editSmbCredential 删除smb授权 credential deleteSmbCredential 添加ssh授权 credential saveSshCredential 编辑ssh授权 credential editSshCredential 删除ssh授权 credential deleteSshCredential 添加租户委托 tenant addTenantAgency 删除租户委托 tenant deleteTenantAgency 清空资源 cleanup resourcesCleanUp 忽略漏洞 vuln addVulnFalsePositive 取消忽略漏洞 vuln deleteVulnFalsePositive 生成主机扫描报告 report generateHostScanReport 下载主机扫描报告 report downloadHostScanReport 父主题： 云审计服务支持的关键操作

修改内网域名 在使用内网域名的过程中，如果发现内网域名的配置信息不符合您的业务需求，可以重新设置域名的管理员邮箱地址、域名的描述信息。 更多关于域名管理员邮箱的信息，请参见SOA记录中的Email格式为什么变化了？。 进入内网域名列表页面。 选择待修改的内网域名，单击“操作”列下的“修改”。 进入“修改内网域名”页面。 图1 修改内网域名 根据实际需要，修改“邮箱”或“描述”信息。 单击“确定”，保存修改后的内网域名。

常见域名检测问题及解决措施 表1 常见域名检测问题及解决措施 类型 检测项 错误信息提示 解决措施 域名信息 域名服务商 - - 域名到期时间 域名到期 请联系您的域名服务商进行续费。 在华为云域名服务商注册的域名续费详细请参考域名续费。 域名状态 clientHold或serverHold 解析不生效，请联系您的域名服务商处理。 DNS服务商 是否是华为云DNS服务器地址。 非华为云DNS服务器地址，请联系当前使用DNS服务商处理。 如果需要使用华为云DNS解析，请参考怎样查看并修改域名的DNS服务器地址？。 DNS解析 公共DNS解析结果 未检测到域名的DNS记录。 华为云DNS服务商，请登录DNS控制台创建域名并添加解析记录，详细请参见网站解析。 非华为云DNS服务商，请联系当前使用DNS服务商处理。 域名TTL生效时间 - - 网站信息 网站备案 网站未备案 网站未备案，访问将会被阻断，详细请参考网站备案。 80端口检查 端口不通 请联系您公司的运维人员检查网站配置。 443端口检查 端口不通 HTTP状态码 端口不通，请检查服务器设置 Ping检查 失败 华为云DNS服务商，请登录DNS控制台创建域名并添加解析记录。详细请参见网站解析。 非华为云DNS服务商，请联系当前使用的DNS服务商处理。 工信部黑名单 在黑名单 请联系您的域名服务商解决。

操作场景 云解析服务支持对记录集的批量操作，可以为多个域名批量删除指定“主机记录”的所有记录集。 如果批量删除单个域名的记录集，还可以参考批量删除记录集（单个域名）操作。 删除记录集后，不可恢复，请谨慎操作。 本节以表1所示内容为例，介绍批量删除记录集的操作。 表1 批量删除记录集示例 域名 主机记录 说明 exampletest1.com - 批量删除域名exampletest1.com的所有记录集。 123 批量删除域名123.exampletest1.com的所有记录集。 exampletest2.com - 批量删除域名exampletest2.com的所有记录集。 123 批量删除域名123.exampletest2.com的所有记录集。 exampletest3.com - 批量删除域名exampletest3.com的所有记录集。 123 批量删除域名123.exampletest3.com的所有记录集。

操作步骤 进入公网域名列表页面。 在域名列表中，勾选待批量删除记录集的域名，并在域名列表上方的“批量操作”下拉框中，选择“批量删除记录集”。 图1 批量删除记录集 在“批量操作”页面的“批量删除记录集”页签，如表1所示设置参数。 域名：待批量删除记录集的主域名。 步骤4中已经勾选了待批量删除记录集的域名，此处无需设置。 如果您直接单击“批量删除记录集”，未勾选待批量删除记录集的域名，则需要填写域名的主域名，多个域名以换行符分隔。 删除类型：默认勾选“删除满足下方任意一个条件的记录”。 当前仅支持“主机记录等于”，即批量删除指定“主机记录”的记录集。 图2 设置批量删除参数 单击“提交”，完成批量删除记录集操作。 您可以在每个域名对应的记录集列表中查看对应的记录集是否删除成功。 图3 为exampletest1.com添加的记录集 图4 为exampletest2.com添加的记录集 图5 为exampletest3.com添加的记录集 操作完成后，您可以在“批量操作记录”页面查看操作名称、操作结果、操作时间和状态信息，还可以下载失败操作记录。

接入流程 流程说明如下： 申请入驻云商店，成为商家。 云商店运营人员审核公司的资质信息。 准备生产接口服务器，根据本接入指南开发生产接口。 在卖家中心调试生产接口。 加入联营计划，成为联营商家。 在卖家中心申请发布商品。 云商店运营人员审批通过后，产品发布为联营商品。 在卖家中心自助管理生产接口通知消息。 联营License类商品接入可参考《License类商品接入视频指导（旧版）》。 父主题： 联营License类商品接入指南（旧版）

接入流程 License类商品接入云商店的流程如下图所示： 流程说明如下： 申请入驻云商店，成为服务商（即云商店商家）。 云商店运营人员审核公司的资质信息。 准备生产接口服务器，根据本接入指南开发生产接口。 在卖家中心申请测试授权码。 通过测试授权码，调测云商店授权码开放接口。 在卖家中心调试商家接入生产接口。 在卖家中心申请发布License商品，模版选择License授权码。 云商店运营人员审批通过后商品发布成功。 在卖家中心自助管理生产接口通知消息。 联营License类商品接入可参考《License类商品接入视频指导（2.0）》。 父主题： 联营License类商品接入指南（2.0版本）

编解码插件的输入/输出格式样例 假定某款水表支持的服务定义如下： 服务类型 属性名称 属性说明 属性类型（数据类型） Battery - - - - batteryLevel 电量(0--100)% int Meter - - - - signalStrength 信号强度 int - currentReading 当前读数 int - dailyActivityTime 日激活通讯时长 string 那么数据上报时decode接口的输出： { "identifier": "12345678", "msgType": "deviceReq", "data": [ { "serviceId": "Meter", "serviceData": { "currentReading": "46.3", "signalStrength": 16, "dailyActivityTime": 5706 }, "eventTime": "20160503T121540Z" }, { "serviceId": "Battery", "serviceData": { "batteryLevel": 10 }, "eventTime": "20160503T121540Z" } ] } 收到数据上报后，平台对设备的应答响应，调用encode接口编码，输入为 { "identifier": "123", "msgType": "cloudRsp", "request"：[ 1, 2 ], "errcode": 0, "hasMore": 0 } 假定某款水表支持的命令定义如下： 基本功能名称 分类 名称 命令参数 数据类型 枚举值 WaterMeter 水表 - - - - - CMD SET_TEMPERATURE_READ_PERIOD - - - - - - value int - - RSP SET_TEMPERATURE_READ_PERIOD_RSP - - - - - - result int 0表示成功，1表示输入非法，2表示执行失败 那么命令下发调用encode接口时，输入为 { "identifier": "12345678", "msgType": "cloudReq", "serviceId": "WaterMeter", "cmd": "SET_TEMPERATURE_READ_PERIOD", "paras": { "value": 4 }, "hasMore": 0 } 收到设备的命令应答后，调用decode接口解码，解码的输出 { "identifier": "123", "msgType": "deviceRsp", "errcode": 0, "body": { "result": 0 } }

编解码插件打包 插件编程完成后，需要使用Maven打包成jar包，并制作成插件包。 Maven打包 打开DOS窗口，进入“pom.xml”所在的目录。 输入maven打包命令：mvn package。 DOS窗口中显示“BUILD SUCCESS”后，打开与“pom.xml”目录同级的target文件夹，获取打包好的jar包。 jar包命名规范为：设备类型-厂商ID-版本.jar，例如：WaterMeter-Huawei-version.jar。 com目录存放的是class文件。 META-INF下存放的是OSGI框架下的jar的描述文件（根据pom.xml配置生成的）。 OSGI-INF下存放的是服务配置文件，把编解码注册为服务，供平台调用（只能有一个xml文件）。 其他jar是编解码引用到的jar包。 制作插件包 新建文件夹命名为“package”，包含一个“preload/”子文件夹。 将打包好的jar包放到“preload/”文件夹。 在“package”文件夹中，新建“package-info.json”文件。该文件的字段说明和模板如下： 注：“package-info.json”需要以UTF-8无BOM格式编码。仅支持英文字符。 表4 “package-info.json”字段说明 字段名 字段描述 是否必填 specVersion 描述文件版本号，填写固定值："1.0"。 是 fileName 软件包文件名，填写固定值："codec-demo" 是 version 软件包版本号。描述package.zip的版本，请与下面的bundleVersion取值保持一致。 是 deviceType 设备类型，与产品模型文件中的定义保持一致。 是 manufacturerName 制造商名称，与产品模型文件中的定义保持一致，否则无法上传到平台。 是 platform 平台类型，本插件包运行的物联网平台的操作系统，填写固定值："linux"。 是 packageType 软件包类型，该字段用来描述本插件最终部署的平台模块，填写固定值："CIGPlugin"。 是 date 出包时间，格式为："yyyy-MM-dd HH-mm-ss"，如"2017-05-06 20:48:59"。 否 description 对软件包的自定义描述。 否 ignoreList 忽略列表，默认为空值。 是 bundles 一组bundle的描述信息。 注：bundle就是压缩包中的jar包，只需要写一个bundle。 是 表5 bundles的字段说明 字段名 字段描述 是否必填 bundleName 插件名称，和上文中pom.xml的Bundle-SymbolicName保持一致。 是 bundleVersion 插件版本，与上面的version取值保持一致。 是 priority 插件优先级，可赋值默认值：5。 是 fileName 插件jar的文件名称。 是 bundleDesc 插件描述，用来介绍bundle功能。 是 versionDesc 插件版本描述，用来介绍版本更迭时的功能特性。 是 package-info.json文件模板： { "specVersion":"1.0", "fileName":"codec-demo", "version":"1.0.0", "deviceType":"WaterMeter", "manufacturerName":"Huawei", "description":"codec", "platform":"linux", "packageType":"CIGPlugin", "date":"2017-02-06 12:16:59", "ignoreList":[], "bundles":[ { "bundleName": "WaterMeter-Huawei", "bundleVersion": "1.0.0", "priority":5, "fileName": "WaterMeter-Huawei-1.0.0.jar", "bundleDesc":"", "versionDesc":"" }] } 选中“package”文件夹中的全部文件，打包成zip格式（“package.zip”）。 注：“package.zip”中不能包含“package”这层目录。 离线插件包最大限制为4M，如果超出4M，请自行分析并将包大小裁剪到4M以内。