华为云用户手册

注意事项 智能压缩默认对格式为 .js、.html、.css、.xml、.json、.shtml、.htm的文件进行压缩。 如果源站配置了MD5值校验，请勿开启此功能。CDN对静态文件压缩时，会改变MD5值，导致压缩后的文件的和源站文件的MD5值不一致。 部分浏览器暂不支持Brotli压缩，您可以前往这里查询。 后台有特殊配置的域名无法开启智能压缩。 同时开启Gzip、Brotli压缩方式时，优先执行Brotli压缩。 常见的图片文件类型（PNG、JPG、JPEG等）和视频文件类型（MP4、AVI、WMV等）已经做了内容的压缩处理，开启Gzip压缩或Brotli压缩没有效果，此类文件无需开启智能压缩。

修订记录 发布日期 修订记录 2024-04-10 第一百零七次正式发布。 本次更新说明如下： 智能压缩支持配置参与压缩的文件大小。 2024-03-28 第一百零六次正式发布。 本次更新说明如下： 支持配置国际和国密双证书。 2024-03-26 第一百零五次正式发布。 本次更新说明如下： 新增“客户端证书配置”功能。 下线日志合并工具功能。 2024-03-13 第一百零四次正式发布。 本次更新说明如下： IP黑白名单功能支持配置500个IP地址。 2024-03-06 第一百零三次正式发布。 本次更新说明如下： 下线“域名下线策略”功能。 2024-02-21 第一百零二次正式发布。 本次更新说明如下： 新增“共享缓存”功能。 2024-01-25 第一百零一次正式发布。 本次更新说明如下： 控制台升级新调性，文档采用新图。 2024-01-24 第一百次正式发布。 本次更新说明如下： 统计分析支持按照业务类型筛选域名。 2024-01-18 第九十九次正式发布 本次更新说明如下： 批量配置证书支持按HTTPS状态搜索域名。 2024-01-11 第九十八次正式发布 本次更新说明如下： 复制配置模块新增“复制到新添加域名”功能。 2023-12-28 第九十七次正式发布 本次更新说明如下： 状态码缓存支持3XX。 2023-12-20 第九十六次正式发布 本次更新说明如下： 用量封顶支持配置“告警阈值”。 2023-12-14 第九十五次正式发布 本次更新说明如下： 用户可查看缓存规则中的“强制缓存”逻辑。 2023-11-24 第九十四次正式发布 本次更新说明如下： 新增“用量封顶”功能。 2023-11-23 第九十三次正式发布 本次更新说明如下： 新版统计分析上线“业务监控”功能。 2023-11-02 第九十二次正式发布 本次更新说明如下： 统计分析新版界面上线。 2023-10-24 第九十一次正式发布 本次更新说明如下： 新增访问URL重写功能。 2023-10-19 第九十次正式发布 本次更新说明如下： 回源超时时间可以配置300s。 自定义HTTP header的值支持配置1024个字符。 刷新预热可以查询到失败原因。 2023-10-18 第八十九次正式发布 本次更新说明如下： 新增浏览器缓存过期时间功能。 缓存刷新和缓存预热支持encode转码功能。 2023-10-12 第八十八次正式发布 本次更新说明如下： 数据导出功能支持导出已经创建的运营报表中的相关数据。 2023-09-15 第八十七次正式发布 本次更新说明如下： 源站配置支持自定义优先级。 2023-09-12 第八十六次正式发布 本次更新说明如下： URL鉴权功能支持选择指定后缀的文件参与鉴权。 2023-09-08 第八十五次正式发布 本次更新说明如下： 新增回源SNI功能。 2023-09-05 第八十四次正式发布 本次更新说明如下： 原统计分析中的功能“明细导出”修改为“数据导出”。 2023-08-30 第八十三次正式发布 本次更新说明如下： IP黑白名单最多支持配置200个IP。 高级回源支持配置回源协议、回源HOST。 2023-08-23 第八十二次正式发布 本次更新说明如下： 参数Access-Control-Allow-Origin支持配置带端口的域名，详见HTTP header配置（跨域请求）。 下线“第三方存储桶”源站功能。 2023-08-17 第八十一次正式发布 本次更新说明如下： 修改域名下线策略为停用域名后的解析逻辑，由“解析回源”修改为“删除解析”。 2023-08-08 第八十次正式发布 本次更新说明如下： 回源机制变更，多个源站IP的情况下回源采用负载均衡机制，详见源站配置。 2023-08-07 第七十九次正式发布 本次更新说明如下： 数据分析功能替代原“热点统计”功能。 2023-07-27 第七十八次正式发布 本次更新说明如下： 新增 CES 监控上报功能。 2023-07-26 第七十七次正式发布 本次更新说明如下： 修改部分配置限制，全站加速的域名不支持配置回源URL改写、高级回源、Range回源、回源跟随、回源是否校验ETag、状态码缓存时间、视频拖拽。 2023-07-13 第七十六次正式发布 本次更新说明如下： 支持给域名加备注，详见启用/停用加速域名。 新增IP访问限频功能。 2023-07-11 第七十五次正式发布 本次更新说明如下： User-Agent黑白名单功能支持配置更多特殊字符。 2023-07-10 第七十四次正式发布 本次更新说明如下： 刷新预热支持拖入已编辑好的TXT文档。 2023-06-26 第七十三次正式发布 本次更新说明如下： 启用源站配置新界面。 2023-06-13 第七十二次正式发布 本次更新说明如下： 资源包管理新界面发布，支持多维度搜索和导出功能。 2023-06-09 第七十一次正式发布 本次更新说明如下： 高级源站为IP或域名时，支持配置端口。 2023-06-06 第七十次正式发布 本次更新说明如下： 支持配置HSTS。 2023-05-29 第六十九次正式发布 本次更新说明如下： 支持配置国密证书。 支持SCM证书。 2023-05-17 第六十八次正式发布 本次更新说明如下： 新增“请求限速”功能。 2023-05-11 第六十七次正式发布 本次更新说明如下： 统计分析增加“运营报表”功能。 2023-05-08 第六十六次正式发布 本次更新说明如下： 全站加速支持修改服务范围。 M3U8/MPD文件支持配置鉴权继承。 2023-04-26 第六十五次正式发布 本次更新说明如下： 修改源站配置时支持配置第三方对象存储作为源站。 2023-04-24 第六十四次正式发布 本次更新说明如下： “智能压缩”支持自定义压缩格式。 2023-04-19 第六十三次正式发布 本次更新说明如下： 统计分析新增“明细导出”功能。 2023-04-06 第六十二次正式发布 本次更新说明如下： 下线“OBS私有桶回源”功能，合入源站配置，当源站选择“OBS桶域名”且接入私有桶时，需要勾选下方“私有桶”选项。 2023-03-29 第六十一次正式发布 本次更新说明如下： 新增“标签”功能。 2023-03-20 第六十次正式发布 本次更新说明如下： 优化了部分章节描述、新增示例、新增适用场景及完善参数描述。 “缓存遵循源站”功能合入到“缓存规则”章节。 2023-03-16 第五十九次正式发布 本次更新说明如下： 优化了部分章节描述、新增示例、新增适用场景及完善参数描述。 2023-02-24 第五十八次正式发布 本次更新说明如下： 跨域支持配置泛域名和多域名。 2023-02-20 第五十七次正式发布 本次更新说明如下： 部分鉴权方式开放设置“鉴权参数”和“鉴权KEY（备）”。 2023-02-14 第五十六次正式发布 本次更新说明如下： HTTPS配置增加“SCM证书”选项。 强制跳转功能增加“跳转方式”，可选301或302跳转。 2023-02-09 第五十五次正式发布 本次更新说明如下： 全站加速域名新增“WebSocket配置”功能。 2022-12-13 第五十四次正式发布 本次更新说明如下： 新增“回源是否校验ETag”功能。 2022-12-06 第五十三次正式发布 本次更新说明如下： 新增“高级回源”功能。 “防盗链”功能支持配置带端口IP。 2022-11-08 第五十二次正式发布 本次更新说明如下： 新增“变更业务类型”功能。 “URL鉴权”支持指定鉴权范围。 2022-10-27 第五十一次正式发布 本次更新说明如下： 新增“视频拖拽”功能。 2022-09-27 第五十次正式发布 本次更新说明如下： “缓存刷新”支持对目录中有变化的资源刷新。 2022-08-25 第四十九次正式发布 本次更新说明如下： “智能压缩”功能迁移到“高级配置”目录下。 2022-08-18 第四十八次正式发布 本次更新说明如下： 新增Linux版本的“日志下载工具”。 2022-08-05 第四十七次正式发布 本次更新说明如下： 控制台支持配置“远程鉴权”功能。 2022-04-26 第四十六次正式发布 本次更新说明如下： 支持配置国密证书。 2022-04-26 第四十五次正式发布 本次更新说明如下： 上线“IPv6开关”、“回源超时时间”、“TLS版本配置”、“状态码缓存时间”、“自定义错误页面”功能。 2022-03-24 第四十四次正式发布 本次更新说明如下： 上线“变更服务范围”功能。 缓存规则支持配置60条。 2022-03-22 第四十三次正式发布 本次更新说明如下： 日志管理章节更新“日志下载工具”。 控制台支持配置O CS P Stapling。 2022-03-10 第四十二次正式发布 本次更新说明如下： “强制跳转”、“HTTP/2”、“回源协议”的配置从“HTTPS配置”剥离。 当源站为OBS桶域名时，支持配置备源站。 支持跨账号添加“OBS桶域名”作为CDN的源站。 2022-03-04 第四十一次正式发布 本次更新说明如下： 回源HOST配置从原“回源配置”调整到“修改源站信息”。 2022-01-06 第四十次正式发布 本次更新说明如下： 控制台支持配置Brotli压缩。 2021-12-06 第三十九次正式发布 本次更新说明如下： URL鉴权功能支持选择加密算法。 2021-11-25 第三十八次正式发布 本次更新说明如下： 复制配置功能支持选取配置项。 2021-11-11 第三十七次正式发布 本次更新说明如下： 新增改写回源URL配置功能。 2021-10-26 第三十六次正式发布 本次更新说明如下： IP黑白名单支持IPv6格式。 缓存规则配置增加推荐配置。 防盗链配置支持带端口。 2021-10-11 第三十五次正式发布 本次更新说明如下： 控制台新增自助配置“UA黑白名单”。 控制台支持导出域名基本配置。 2021-09-28 第三十四次正式发布 本次更新说明如下： 新增统计文档“全站使用量统计”。 控制台统计功能调整。 2021-08-31 第三十四次正式发布 本次更新说明如下： 部分配置增加示例：“回源请求头”、“缓存规则”、“回源HOST”、“IP黑白名单”。 2021-05-27 第三十三次正式发布 本次更新说明如下： 控制台新增自助配置“URL”鉴权功能。 2021-04-01 第三十二次正式发布 本次更新说明如下： HTTPS证书配置新增“强制跳转HTTP”功能。 2021-03-09 第三十一次正式发布 本次更新说明如下： 新增“复制配置”。 2021-02-02 第三十次正式发布 本次更新说明如下： 新增“回源请求头” 回源配置章节增加“概述” 缓存配置章节增加“概述” 2020-10-09 第二十九次正式发布 本次更新说明如下： 修改“缓存刷新和缓存预热”章节目录，优化章节内容。 2020-06-11 第二十八次正式发布 本次更新说明如下： 在“修改源站信息”章节中下线“源站校验”章节。 优化文档相关描述。 2020-04-10 第二十七次正式发布 本次更新说明如下： 新增“域名证书管理”章节。 优化文档相关描述。 2020-01-02 第二十六次正式发布 本次更新说明如下： 在“修改源站信息”章节中新增源站校验方式。 优化文档相关描述。 2019-10-28 第二十五次正式发布 本次更新说明如下： 在“域名管理”章节下新增“功能概述”章节。 在相关章节后新增与该章节相关的FAQ链接。 优化文档相关描述。 2019-06-21 第二十四次正式发布 本次更新说明如下： 新增“HTTPS证书格式转换”章节。 新增“启用/停用加速域名”、“移除加速域名”、“重新审核加速域名”章节。 优化文档相关描述。 2019-05-31 第二十三次正式发布 本次更新说明如下： 新增“权限管理”章节。 优化文档相关描述。 2019-05-08 第二十二次正式发布 本次更新说明如下： 合并“启用/停用CDN”、“移除加速域名”、“重新审核加速域名”到“域名操作”章节。 移动“HTTPS证书要求”、“HTTP/2介绍”至“HTTPS配置”章节。 移动“配置CNAME”中非华为云DNS配置方法到“更多资源”。 优化文档中有关操作步骤的内容，将配置说明融入操作步骤。 优化文档描述，描述中增加超链接引导。 2019-04-23 第二十一次正式发布 本次更新说明如下： 移动“故障处理”章节至常见问题中。 优化文档相关细节描述。 2019-03-29 第二十次正式发布。 本次更新说明如下： 新增“域名下线策略”章节。 2019-02-28 第十九次正式发布。 本次更新说明如下： 优化文档细节内容。 2019-02-14 第十八次正式发布。 本次更新说明如下： 新增“域名配额管理”章节。 新增“刷新预热配额管理”章节。 2019-01-28 第十七次正式发布。 本次更新说明如下： 优化文档相关细节描述。 新增相关故障处理方法。 2018-12-28 第十六次正式发布。 本次更新说明如下： 优化配置回源HOST章节内容。 新增相关故障处理方法。 2018-11-30 第十五次正式发布。 本次更新说明如下： 文档大纲结构优化调整。 文档相关细节优化。 新增“域名准入要求”章节。 新增“约束与限制”章节。 2018-10-30 第十四次正式发布。 本次更新说明如下： 新增概览页新版相关说明。 2018-09-29 第十三次正式发布。 本次更新说明如下： 优化“审计”章节内容。 2018-08-30 第十二次正式发布。 本次更新说明如下： 新增第2章“企业项目”。 新增3.2.4章“配置HTTP header”。 更新3.2.2章“配置防盗链”内容，增加“规则”输入文本框支持泛域名添加说明。 更新3.3.1章“配置缓存策略”内容，增加CDN支持全路径缓存规则说明。 更新3.8.2章“配置回源参数”内容，增加私有桶回源的相关说明。 2018-07-30 第十一次正式发布。 本次更新说明如下： 更新2.8.2章“配置回源参数”内容，增加302回源跟随的相关说明。 2018-07-05 第十次正式发布。 本次更新说明如下： 原文档第1章节、第2章节“开通CDN”、“入门”合并独立发布为“快速入门”手册。 更新2.2.1章“配置HTTPS安全加速”内容，增加华为云托管证书的操作说明。 新增2.2.3章节“配置IP黑名单”。 更新2.7章“日志管理”内容，增加日志合并下载的相关说明。 更新2.8.2章“配置回源参数”内容，增加Range回源的相关说明。 新增2.9章节“流量包管理”。 2018-05-15 第九次正式发布。 本次更新说明如下： 新增4.6章“诊断工具”。 2018-03-30 第八次正式发布。 本次更新说明如下： 原版本第1章“简介”从用户指南拆分，发布为独立手册《CDN产品简介》。 更新2.2章“配置CNAME”内容。 更新3.5.2章“统计分析”内容，增加相关服务范围的查询说明及操作步骤。 新增3.5.2.1章“统计说明”。 新增3.5.2.7章“状态码统计”。 新增4.2、4.3、4.4、4.5章的相关问题处理内容。 2018-02-28 第七次正式发布。 本次更新说明如下： 更新4.3.1章“配置缓存策略”内容，删除“忽略cache-control”相关说明及操作步骤。 更新4.6章“日志管理”内容，增加相关Range字段说明及日志名称说明。 2018-01-03 第六次正式发布。 本次更新说明如下： 新增4.5.2.4章“热点统计”。 新增4.5.2.5章“行为统计”。 新增4.2.1章“配置HTTPS安全加速”内容，增加HTTP/2相关的解释说明。 新增7.2章“HTTP/2介绍”。 2017-12-05 第五次正式发布。 本次更新说明如下： 合并调整4.1章“加速域名”、4.2章“基本配置”为4.7章“域名管理”。 新增4.1章“配置说明”。 新增4.2.1章“配置HTTPS安全加速”内容，增加“回源方式”与“强制跳转”的相关解释说明。 新增4.6章“日志管理”内容，增加“日志说明”和“日志格式”。 2017-11-15 第四次正式发布。 本次更新说明如下： 新增4.6.2.1章“使用量统计” 新增4.6.2.2章“访问情况统计”。 新增4.6.2.3章“源站统计”。 2017-09-28 第三次正式发布。 本次更新说明如下： 修改1.7章“ 定价 ”，与CDN计费相关的内容请参见购买指南。 删除2.2章“申请公测”。 新增2.2章“开通CDN”。 修改4.6.1章“CDN运行概况”，增加购买流量包信息。 2017-09-15 第二次正式发布。 本次更新说明如下： 新增4.6章“资源监控”。 新增4.7章“日志管理”。 2017-07-29 第一次正式发布。

计费说明 表2 计费说明 计费模式 变更操作 对费用的影响 包年/包月 扩容磁盘 您需要按照扩容的磁盘容量，结合使用周期内的剩余时间，补交差价。 例如：（以下价格仅作示例，实际价格以控制台显示为准） 客户于2023/6/1在华北-北京四购买规格为通用型 2vCPUs 8GB的RDS for MySQL 5.7单机实例，SSD云盘存储，存储空间40GB，购买周期为一个月。存储空间单价为1元/GB/月。 客户在2023/6/15将磁盘扩容60GB，扩容后总容量100GB。 补交费用 = 存储空间扩容量 x 单价 x 剩余周期 公式中的剩余周期为每个自然月的剩余天数/对应自然月的最大天数。 本示例中，剩余周期=15（6月份剩余未使用天数）/ 30（6月份最大天数）= 0.5，代入公式可得补交费用 = 60 x 1 x 0.5 = 30元 按需计费 扩容磁盘 扩容的磁盘容量按小时计费。具体请参见产品价格详情。

约束限制 账户余额大于等于0元，才可进行扩容。 实例状态为“正常”和“存储空间满”时可以进行扩容。 云数据库 RDS for MySQL实例本地SSD盘的最大扩容容量与所选实例规格有关，其他存储类型的磁盘最大可扩容至4000GB（如果您想提高存储空间扩容上限到10TB，请联系客服申请），扩容次数没有限制。 磁盘扩容期间，实例状态为“扩容中”备份业务不受影响。 如果是主备实例，针对主实例扩容时，会同时对其备实例进行扩容。 磁盘扩容的过程中，不需要重启数据库实例。 扩容过程中，该实例不可重启和删除。 磁盘容量变更只允许扩容，不能缩容。 选择磁盘加密的实例，新扩容的磁盘空间依然会使用原加密密钥进行加密。

磁盘满设置只读 数据库磁盘空间不足的原因和解决方案，请参见数据超过了RDS实例的最大存储容量怎么办。 表1 磁盘满只读说明 磁盘空间 说明 不区分磁盘大小 磁盘剩余空间一旦小于5GB，设置实例只读。 说明： 该条规则优先于其他设置只读的规则。 小于1TB 磁盘使用率到达97%，设置实例只读。 磁盘使用率下降到87%，解除只读。 大于或等于1TB 磁盘剩余空间小于30GB，设置实例只读。 磁盘剩余空间大于或等于150GB，解除只读。 图1 查看磁盘使用率

指标异常说明（影响） 生产数据库一定要及时清理非活跃逻辑复制槽。配置非活跃逻辑复制槽监控指标（连续3个周期 上报值≥1 Counts），当存在时，需要及时关注并处理。 存在非活跃逻辑复制槽产生的影响： 数据库残留的非活跃逻辑复制槽，会一直保留逻辑复制所需要的资源。数据库wal日志无法被清理，从而导致wal日志积压，占用更多的磁盘空间，严重时会导致磁盘满。 可能意味着应用侧的业务未按预期运行，存在风险。

排查及解决方法 排查是否存在失效的逻辑复制槽。 在发布端执行如下SQL，排查是否存在失效的逻辑复制槽。 若有返回时，则说明数据库中存在失效的逻辑复制槽，其中返回的slot_name字段为失效逻辑复制槽的名称。 select slot_name,database,active from pg_replication_slots where active ='f' and slot_type='logical'; 业务确认是否需要继续使用该逻辑复制槽。 联系业务方排查是否要继续使用该逻辑复制槽，若不使用时执行3。 若需继续使用，建议业务按照以下方向排查： 订阅端创建订阅时未启用逻辑复制槽的复制，手动设置为disable状态。 在订阅端执行以下SQL查看subenabled列的字段返回。 select subname,subenabled from pg_subscription; 若subenabled列的字段返回为f，说明订阅未启用逻辑复制，执行以下SQL启用订阅的逻辑复制。 ALTER SUBSCRIPTION sub_name ENABLE; 若返回为t，则进行以下步骤排查。 使用其他工具执行任务时使用的逻辑复制槽未自动清理，由于任务中断或源数据库或目标数据库的某些操作，如备份、重建索引等意外情况产生。 在发布端执行如下SQL查询，观察返回的“slot_name”字段的值是否是以drs等开头，则说明是执行drs任务产生的该逻辑复制槽，此时可根据任务情况，判断是否执行3清理。 select slot_name,database,active from pg_replication_slots where active ='f' and slot_type='logical'; 如果确认不再使用逻辑复制槽，则删除失效的逻辑复制槽。 select pg_drop_replication_slot('slot_name');

支持的数据库版本 仅如下版本支持SQL审计功能。如果您的数据库引擎版本较低，请参考升级内核小版本升级到最新版本。 对于RDS for MySQL 5.6云盘实例，支持5.6.43及其以上版本。 对于RDS for MySQL 5.6本地盘实例，支持5.6.47.3及其以上版本。 对于RDS for MySQL 5.7云盘实例，支持5.7.23及其以上版本。 对于RDS for MySQL 5.7本地盘实例，支持5.7.29.3及其以上版本。 支持RDS for MySQL 8.0版本。

语法限制 读写分离请求路由原理：客户的前端请求会根据当前数据库节点权重的配置，随机路由到后端任一数据库节点。 因此，一些SQL语句多次执行的结果可能存在差异，部分语句列举如下： 使用读写分离地址连接proxy和直连后端数据库执行show processlist结果返回有差异，因为proxy的show processlist是逻辑的，仅仅将通过proxy节点下发的业务展示出来，所以和直连后端数据库有差异。 当某一个代理节点处于异常状态时，通过读写分离地址连接proxy执行show processlist或者kill时，有可能会出现命令执行时间稍微变长或卡顿的情况，此时无需关注，业务不会受到影响。 当数据库代理节点缩容后，通过代理执行show processlist命令时，可能会将被缩容的节点上的业务展示出来。 通过数据库代理进行kill时，可能会出现超时等报错信息，此时可以通过再次执行show processlist查看业务是否真正被kill成功。 通过数据库代理的请求只能通过代理进行kill操作。 使用读写分离的连接地址时，不支持使用show errors和show warnings命令。 使用读写分离的连接地址时，如果存储过程(procedure)和函数(function)中依赖了用户变量，即@variable，则运行结果可能不正确。

功能限制 开启读写分离功能后，删除RDS for MySQL主实例，会同步删除只读实例，并关闭读写分离功能。 读写分离不支持RDS for MySQL8.0的caching_sha2_password身份认证插件。 开启读写分离功能后，主实例和只读实例均不允许修改数据库端口和内网地址。 读写分离功能不支持压缩协议。 读写分离不支持事务隔离级别READ-UNCOMMITTED。 如果执行了Multi-Statements，默认当前连接的后续请求会全部路由到主节点，需断开当前连接并重新连接才能恢复读写分离，目前支持多种Multi-Statements处理模式，详情参考设置Multi-Statements处理模式。 如果执行了临时表的相关操作，默认当前连接的后续请求会全部路由到主节点，需断开当前连接并重新连接才能复读写分离。 如果执行了Handler语句，默认后续请求全部路由到主节点，需断开当前连接并重新连接才能恢复读写分离。 使用读写分离的连接地址时，事务请求都会路由到主实例（可以使用事务拆分功能对事务中写之前的读请求进行拆分），不保证非事务读的一致性，业务上有读一致性需求可以封装到事务中。 使用读写分离的连接地址时，LAST_INSERT_ID()函数仅支持在事务中使用。 使用用户自定义变量时，包含用户自定义变量的语句会路由到主节点。 数据库代理服务不支持读写表中单列超过16MB的数据。 当使用数据库代理时，多语句拼接的SQL大小不超过100MB，避免数据库代理解析SQL消耗过多的资源。 当使用.net客户端连接数据库代理时，需要客户端的MySQL.Data驱动版本不低于8.0.19，低版本MySQL.Data与数据库代理存在兼容性风险。 当使用事务拆分功能时，需要将代理升级至最新版。 数据库代理不支持SQL_MODE参数PAD_CHAR_TO_FULL_LENGTH。

响应参数 状态码： 202 表4 响应Body参数 参数 参数类型 描述 backup_policy object 备份策略对象，包括备份保留的天数和备份开始时间。详情请参考表5。 表5 ShowBackupPolicyResult 参数 参数类型 描述 keep_days Integer 备份文件可以保存的天数。 start_time String 备份时间段。自动备份将在该时间段内触发。 period String 备份周期配置。自动备份将在每星期指定的天进行。

URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/backups/policy 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 type 否 String 备份策略类型。该参数仅针对GeminiDB Cassandra。可取值： Instance，表示查询实例级备份。 DatabaseTable，表示查询库表级备份。 默认取值“Instance”。

响应示例 状态码： 202 Success 自动备份策略开启： { "backup_policy" : { "keep_days" : 7, "start_time" : "19:00-20:00", "period" : "1,2,4,5,6" } } 自动备份策略关闭： { "backup_policy" : { "keep_days" : 0 } }

请求示例 URI样例 PUT https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in02/backups/policy 请求体样例 开启或修改自动备份策略，备份周期为"1,2,3,4,5,6"，备份时间段为"01:00-02:00",备份保留天数为7天： { "backup_policy" : { "period" : "1,2,3,4,5,6", "start_time" : "01:00-02:00", "keep_days" : 7 } } 关闭自动备份策略： { "backup_policy" : { "keep_days" : 0 } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 backup_policy 是 object 备份策略对象，包括备份保留的天数和备份开始时间。详情请参考表4。 表4 BackupPolicy 参数 是否必选 参数类型 描述 keep_days 是 Integer 指定已生成的备份文件可以保存的天数。 取值范围：0～35。取0值，表示关闭自动备份策略。 start_time 否 String 备份时间段。自动备份将在该时间段内触发。开启自动备份策略时，该参数必选；关闭自动备份策略时，不传该参数。 取值范围：格式必须为hh:mm-HH:MM，且有效，当前时间指UTC时间。 HH取值必须比hh大1。 mm和MM取值必须相同，且取值必须为00、15、30、45。 取值示例：23:00-00:00。 period 否 String 备份周期配置。自动备份将在每星期指定的天进行。启用自动备份策略时，此参数必选。如果自动备份策略关闭，则不需要传递该参数。 取值范围：格式为半角逗号隔开的数字，数字代表星期。保留天数取值不同，备份周期约束如下： 指定已生成的备份文件可以保存的天数为0天，不传该参数。 指定已生成的备份文件可以保存的天数为1～6天，备份周期全选，取值为：1,2,3,4,5,6,7。 指定已生成的备份文件可以保存的天数为7～35天，备份周期至少选择一周中的一天。示例：1,2,3,4。

测试环境 区域：华北-北京四。 可用区：可用区1。 弹性云服务器（Elastic Cloud Server，简称ECS）：规格选择h3.4xlarge.2，16U32GB，操作系统镜像使用CentOS 7.5 64位版本。 压测数据模型：单行1KB大小。 压测平均CPU负载：50%。 被测试实例的规格：覆盖以下规格类型，详见表1 实例规格。 表1 实例规格 编号 规格 cluster1 4U16GB cluster2 8U32GB cluster3 16U64GB cluster4 32U128GB

测试模型 workload模型 表2 测试模型 测试模型编号 测试模型 workload-read-mostly 100% read workload-write-mostly 100% insert workload-read-write-combination 50% update, 50% read 数据模型 fieldlength=100, fieldcount=10 预置数据量 本次性能测试中，针对每种规格的实例，测试了如下预置数据量的性能。 预置数据具体如下表所示： 表3 预置数据量 编号 规格 预置数据量 cluster1 4U16GB 200GB cluster2 8U32GB 500GB cluster3 16U64GB 1000GB cluster4 32U128GB 2000GB

兼容的接口列表 表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，在其内部会进行请求的分发。我们希望DynamoDB接口的请求均匀的分布在所有的节点，实现这个目标DynamoDB提供了低成本并且小型的库，将它附加到DynamoDB SDK。其基本原理是客户端维护当前DB集群存活的节点列表，在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中的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只能v占位符,比如':placeholder'。

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

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

测试数据 不同测试模型下，不同规格且预置相当数据量，测试的OPS*数据（表格中黑色字体），详见表1 测试数据中加粗内容。 表1 测试数据 节点规格 4U16GB 8U32GB 16U64GB 32U128GB 预置数据量 200GB 500GB 1000GB 2000GB 测试模型编号 workload-read-mostly 10690 23872 59169 104149 workload-write-mostly 13987 35183 71469 130171 workload-read-write-combination 11694 30528 66517 119160 OPS：Operation Per Second，数据库每秒执行的操作数。 测试模型编号：测试模型编号对应的测试模型，请参见表2 测试模型。 父主题： 性能白皮书

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

更多操作 创建团队完成后，您还可以执行如下表2所示的操作。 表2 更多操作 操作 说明 关注团队 单击“我的团队”区域右上角“关注团队”。 在“关注团队”页面的“团队列表”中，单击需要添加的团队名称右侧的“关注”。 在“我的团队”列表中可查看到此新关注的团队卡片。 设置默认团队 选中“我的团队”区域内团队卡片左下角的“默认团队”，可将此团队设置为默认团队，此默认团队将置顶显示在开发中心团队空间中的团队首位。 移出团队 单击“我的团队”区域内团队卡片右下角的“移出”，可将此团队从我的团队列表移出，我的团队列表中将不显示此团队。移出后通过右上角“添加团队”可再次添加到我的团队。 说明： 团队创建人不可移出自己创建的团队。

操作步骤 在开发中心工作台首页下方的“我的团队”区域，单击右侧“创建团队”。 在“创建团队”页面，设置团队相关参数，参数配置请参见表1。 表1 创建团队参数说明 参数名称 参数说明 团队名称 必填项，团队的命名。 团队归属部门 必填项，选择系统中已提前创建的部门，部门的创建方法请参见部门管理。 关联服务 必填项，选择系统中已提前创建的服务，服务创建方法请参见服务管理。 团队 LOG O 必填项，单击系统默认图片上的“点击修改”，可选择本地图片自定义LOGO图片。 团队简介（可选） 非必填项，团队空间的功能描述或其他备注信息。 单击“创建”。 在“我的团队”区域可查看到创建的团队的卡片。

操作须知 该功能仅对组织管理员可见。 组织管理员可将任一用户添加为开发中心用户，已添加的用户不可重复添加。 添加至开发中心“用户管理”中的用户称为开发中心用户，未添加至开发中心“用户管理”中的用户称为非开发中心用户。 开发中心的“项目经理”、“开发人员”、“测试人员”、“浏览者”角色仅开发中心用户可申请。 仅开发中心用户才能被添加至团队空间成员。 组织管理将用户从开发中心用户中删除时，会同步删除该用户在开发中心中所有的角色权限。 非组织管理员且非开发中心用户访问开发中心时，不可查看团队列表，不可关注团队，需要在开发中心概览页根据页面提示进行申请，申请时可选择任一组织管理员审批（申请电子流将生成待办推送至业务控制台由审批人进行审批）。 开发中心用户总人数只能小于等于总配额，超过用户总配额可联系AppStage开通者在AppStage管理控制台购买开发人员增量包来扩展开发中心用户数。

更多操作 创建标签作用域信息完成后，您还可以执行如下表2的操作。 表2 更多操作 操作 步骤 查看标签作用域 可通过以下三种方式查看标签作用域基本信息和归属信息。 在标签作用域列表中直接查看标签信息。 单击标签作用域列表中的中文名称。 单击标签作用域列表“操作”列的“查看详情”。 编辑标签作用域 单击标签作用域列表“操作”列的（编辑）。 在“编辑”页面编辑标签作用域的模型类型、中/英文名、标签值。 删除标签作用域 单击标签作用域列表“操作”列的“删除”，删除作用域信息。

更多操作 表8 更多操作 操作 说明 编辑账号 在账号列表，单击待编辑账号所在行“操作”列的“编辑”。 删除账号 在账号列表，单击待删除账号所在行“操作”列的“删除”。 编辑项目 在账号列表单击已录入的账号所在行“操作”列的“查看”，默认显示“项目列表”页面，单击待编辑项目所在行“操作”列的“编辑”。 删除项目 在账号列表单击已录入的账号所在行“操作”列的“查看”，默认显示“项目列表”页面，单击待删除项目所在行“操作”列的“删除”。 查看企业项目列表 在账号列表单击已录入的账号所在行“操作”列的“查看”，选择“企业项目列表”，查看企业项目列表。 查询EPS 在EPS配置页面，选择公有云账号、租户、产品、服务，单击“查询”，查询服务的EPS信息。 修改EPS配置 在查询的EPS信息列表中，单击操作列的“修改”，修改EPS ID和EPS名称。 删除EPS 在查询的EPS信息列表中，单击操作列的“删除”，在弹出的提示框中单击“确定”，即可删除服务和EPS的绑定关系。

创建EPS 支持在AppStage中创建EPS。 在“公有云信息管理”页面，选择左侧导航栏的“EPS配置”。 单击“创建”。 创建EPS，具体参数如表7所示，创建完成后，单击“提交”。 表7 创建EPS参数 参数名称 参数说明 公有云账号 选择用户的华为云账号名。 租户 选择已录入的租户。 产品 选择已录入的产品。 EPS名称 创建企业项目的名称。仅允许输入英文字母、数字、中文、“_”和“-”，且在租户账号内唯一。