华为云用户手册

网站备案使用前必读 可以不做备案吗？ 不可以，根据《互联网信息服务管理办法》等相关规定，使用中国大陆节点服务器开办的网站，必须先办理网站备案，备案成功并获取通信管理局下发的ICP备案号后才能开通访问。 网站在国外，需要备案吗？ 不需要，根据中国的相关法规，只有在中国大陆运营的网站才需要进行备案。如果您的 域名 解析到的服务器IP地址在中国香港、中国台湾、中国澳门、或其它非中国的国家和地区，则不需要备案。 我只有域名，不买服务器，可以备案吗？ 不可以，域名无法单独备案。只有购买了华为云备案服务器，华为云才能成为您的接入商，免费为您提供备案服务。 我的服务器在华为云，域名是其他云厂商的，可以在华为云备案吗？ 可以，根据规定您需要在您选择的服务器提供商处进行网站备案，即如果您的服务器是在华为云购买，则需要在华为云进行备案。 我在“其他云”已经备案过，现在转到华为云，为什么网站不能访问？ 如果您已在其他接入商处完成备案并获取备案号，需要将域名解析至华为云购买的中国大陆服务器，网站才可以被访问。具体操作请登录华为云备案管理系统，办理“新增接入”备案。 我的业务是通过IP访问的，需要备案吗？ 需要，只要使用中国大陆节点的服务器就需要备案。如果您使用的是华为云服务器，请在华为云备案系统提交备案申请；如果使用的是其他服务器提供商的服务器，请在其他服务器提供商处提交备案申请。

修订记录 发布日期 修订记录 2023-05-12 第六次正式发布。 新增 网站备案使用前必读 2021-07-26 第五次正式发布。 修改 快速完成网站备案，修改“提交初审”的描述，新增表2。 2021-05-31 第四次正式发布。 优化快速完成网站备案，补充各操作的常见问题。 2020-08-21 第三次正式发布。 修改 快速完成网站备案，短信核验修改为必选操作。 更新工信部备案管理系统链接。 2020-07-07 第二次正式发布。 新增 部署网站的端到端流程与相关介绍。 2020-02-21 第一次正式发布。

将订阅模型部署为服务 针对我的订阅模型，支持将模型一键部署为服务。 在“我的订阅”列表中，单击模型名称左侧的小三角，展开模型的详情和模型版本。 在“版本列表”中，单击“部署”，选择对应的服务类型。 图4 部署 若您选择部署的是商用模型，则选择服务类型后会弹出“修改配额”窗口，根据需要选择配额后单击“确定”即可跳转至“部署”页面。 由于商用模型支持同时购买多种配额模式的资产，所以仅部署商用模型时需要进行配额选择。免费模型仅一种配额模式无需选择。 图5 修改配额 若您选择部署的非商业模型，系统自动跳转至“部署”页面。 在部署页面中，无需再选择模型及其版本，参考部署模型的操作指导完成其他参数填写，即可部署为您需要的服务。

读写分离 RDS for SQL Server2019企业版和2017企业版支持只读实例。 RDS for MySQL数据库的主实例和只读实例都具有独立的连接地址，每个云数据库RDS for MySQL单机实例、主备实例最多支持创建5个只读实例，创建方法请参见创建只读实例。 为了实现读取能力的弹性扩展，分担数据库压力，您可以在某个区域中创建一个或多个只读实例，利用只读实例满足大量的数据库读取需求，以此增加应用的吞吐量。 父主题： 典型应用

日志 RDS for MySQL 支持查看数据库级别的错误日志，包括数据库主库和从库运行的错误信息，以及运行较慢的SQL查询语句，有助于分析系统中存在的问题。 错误日志的详细介绍，请参见查看或下载错误日志。 慢日志用来记录执行时间超过当前慢日志阈值“long_query_time”（默认是1秒）的语句，通过慢日志的日志明细、统计分析情况，查找出执行效率低的语句，进行优化。 慢日志的详细介绍，请参见查看或下载慢日志。 支持查看主备切换日志，通过RDS for MySQ L实例 的主备切换日志信息，评估对业务的影响。 主备切换日志的详细介绍，请参见查看主备切换日志。 支持开通SQL审计功能，系统会将所有的SQL操作记录下来存入日志文件，以提供针对数据增删改查等操作的审计行为。 SQL审计的详细介绍和开通配置方法，请参见开启SQL审计日志。 RDS for PostgreSQL 错误日志记录了数据库运行时的日志，通过错误日志有助于分析系统中存在的问题。 错误日志的详细介绍，请参见查看或下载错误日志。 慢日志用来记录执行时间超过当前慢日志阈值“log_min_duration_statement”的语句，通过慢日志的日志明细、统计分析情况，查找出执行效率低的语句，进行优化。 慢日志的详细介绍，请参见查看或下载慢日志。 RDS for SQL Server 运行日志记录了数据库运行时的日志，通过运行 日志分析 系统中存在的问题。 运行日志的详细介绍，请参见查看或下载运行日志。 慢日志用来记录执行时间超过当前慢日志阈值“long_query_time”（默认是1秒）的语句，通过慢日志的日志明细，查找出执行效率低的语句，进行优化。 慢日志的详细介绍，请参见查看或下载慢日志。 默认开启SQL审计功能，系统会将对服务级、数据库级、表级的主要变更操作记录进审计日志文件，以提供针对数据增删改查等操作的审计行为。 审计日志的详细介绍，请参见查看或下载审计日志。

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

服务韧性 RDS for MySQL使用EVS作为存放数据的云盘，本身具有三副本的冗余，提供9个9的数据持久性，还通过跨区域复制、AZ之间数据容灾、AZ内反亲和等技术方案，保障实例的可靠性和可用性。 RDS for PostgreSQL使用EVS作为存放数据的云盘，本身具有三副本的冗余，提供9个9的数据持久性，还通过跨区域复制、AZ内反亲和等技术方案，保障实例的可靠性和可用性。 RDS for SQL Server使用EVS作为存放数据的云盘，本身具有三副本的冗余，提供9个9的数据持久性，还通过跨区域复制、AZ内反亲和等技术方案，保障实例的可靠性和可用性。 图1 可靠性架构保证数据稳定，业务可靠 父主题： 安全

数据保护技术 云数据库RDS通过多种数据保护手段和特性，保障存储在RDS中的数据安全可靠。 表1 RDS的数据保护手段和特性 数据保护手段 简要说明 详细介绍 传输加密（SSL） RDS for MySQL实例支持非SSL和SSL传输协议，为保证数据传输的安全性，推荐您使用更加安全的SSL协议。 RDS for PostgreSQL实例和RDS for SQL Server实例支持SSL传输协议，保证数据传输的安全性。 RDS for MySQL：设置SSL 数据加密 RDS for PostgreSQL：通过psql命令行内网连接实例 RDS for SQL Server：通过内网连接RDS for SQL Server实例 跨可用区部署 为了达到更高的可靠性，RDS支持选择多可用区部署主实例和备实例，可用区之间内网互通，不同可用区之间物理隔离，RDS会自动将主实例和备实例分布到不同的可用区，以提供故障切换能力和高可用性。 RDS for MySQL：购买实例选择跨可用区部署 RDS for PostgreSQL：购买实例选择跨可用区部署 RDS for SQL Server：购买实例选择跨可用区部署 删除保护 云数据库RDS支持将退订后的包年包月实例和删除的按需实例，加入回收站管理。通过数据库回收站中重建实例功能，可以恢复1~7天内删除的实例。 RDS for MySQL：回收站 RDS for PostgreSQL：回收站 RDS for SQL Server：回收站 跨区域备份 云数据库RDS支持将备份文件存放到另一个区域存储，某一区域的实例故障后，可以在异地区域使用备份文件在异地恢复到新的RDS实例，用来恢复业务。 RDS for MySQL：设置跨区域备份策略 RDS for PostgreSQL：设置跨区域备份策略 RDS for SQL Server：设置跨区域备份策略 父主题： 安全

RDS for PostgreSQL实例规格 RDS for PostgreSQL实例支持的数据库版本请参见数据库引擎和版本。 RDS for PostgreSQL实例规格的CPU架构分为X86架构和ARM架构，详见表1。支持的规格列表请参见表4、表5和表6。 X86架构：通用型（推荐）、独享型（推荐）、通用增强型（存量经营）、通用增强II型（存量经营） ARM架构：鲲鹏通用增强型 表1 实例规格类型 规格 说明 适用场景 约束限制 通用型（推荐） 与同一物理机上的其他通用型规格实例共享CPU资源，通过资源复用换取CPU使用率最大化，性价比较高，适用于对性能稳定性要求较低的应用场景。 侧重对成本、性价比要求较高的场景。 后续主推规格，支持的区域如表2所示。 独享型（推荐） 完全独享的CPU和内存，性能长期稳定，不会因为物理机上其它实例的行为而受到影响，适用于对性能稳定性要求较高的应用场景。 电商、游戏、金融、政企等核心数据库场景。 后续主推规格，支持的区域如表2所示。 通用增强型、通用增强II型 CPU性能强劲，并搭载全新网络加速引擎，以及DPDK(Data Plane Development Kit)快速报文处理机制，提供更高的网络性能以及算力，满足不同场景需求。 对数据库算力与网络有更高性能要求的网站和Web应用场景。 该规格为存量经营。 鲲鹏通用增强型 搭载鲲鹏920处理器及25GE智能高速网卡，提供强劲鲲鹏算力和高性能网络 政府、互联网等企业场景。 支持的区域如表3所示。 表2 通用型、独享型支持的区域 规格类型 区域 通用型、独享型 华北-北京四、华北-乌兰察布一 华东-上海一 华南-广州、华南-广州-友好用户环境 西南-贵阳一 亚太-曼谷、亚太-新加坡 中国-香港 拉美-圣保罗一、拉美-圣地亚哥、拉美-墨西哥城一、拉美-墨西哥城二 非洲-约翰内斯堡 表3 鲲鹏通用增强型支持的区域 规格类型 区域 可用区 PostgreSQL版本 鲲鹏通用增强型 华北-北京四 可用区一、可用区二、可用区七 11 华东-上海一 可用区一、可用区三 11 华南-广州 可用区二、可用区五 11 华南-深圳 可用区一 11 西南-贵阳一 可用区一 11 华北-乌兰察布一 可用区一 11 表4 X86架构实例规格（通用型、独享型） 规格 主备实例规格码 只读实例规格码 单机实例规格码 vCPU(个) 内存(GB) 通用型 rds.pg.n1.medium.2.ha rds.pg.n1.medium.2.rr rds.pg.n1.medium.2 1 2 rds.pg.n1.large.2.ha rds.pg.n1.large.2.rr rds.pg.n1.large.2 2 4 rds.pg.n1.large.4.ha rds.pg.n1.large.4.rr rds.pg.n1.large.4 2 8 rds.pg.n1.xlarge.2.ha rds.pg.n1.xlarge.2.rr rds.pg.n1.xlarge.2 4 8 rds.pg.n1.xlarge.4.ha rds.pg.n1.xlarge.4.rr rds.pg.n1.xlarge.4 4 16 rds.pg.n1.2xlarge.2.ha rds.pg.n1.2xlarge.2.rr rds.pg.n1.2xlarge.2 8 16 rds.pg.n1.2xlarge.4.ha rds.pg.n1.2xlarge.4.rr rds.pg.n1.2xlarge.4 8 32 独享型 说明： SSD云盘和极速型SSD支持的独享型规格存在差异，请以实际环境为准。 rds.pg.x1.large.2.ha rds.pg.x1.large.2.rr - 2 4 rds.pg.x1.large.4.ha rds.pg.x1.large.4.rr - 2 8 rds.pg.x1.large.8.ha rds.pg.x1.large.8.rr - 2 16 rds.pg.x1.xlarge.2.ha rds.pg.x1.xlarge.2.rr - 4 8 rds.pg.x1.xlarge.4.ha rds.pg.x1.xlarge.4.rr - 4 16 rds.pg.x1.xlarge.8.ha rds.pg.x1.xlarge.8.rr - 4 32 rds.pg.x1.2xlarge.2.ha rds.pg.x1.2xlarge.2.rr - 8 16 rds.pg.x1.2xlarge.4.ha rds.pg.x1.2xlarge.4.rr - 8 32 rds.pg.x1.2xlarge.8.ha rds.pg.x1.2xlarge.8.rr - 8 64 rds.pg.x1.4xlarge.2.ha rds.pg.x1.4xlarge.2.rr - 16 32 rds.pg.x1.4xlarge.4.ha rds.pg.x1.4xlarge.4.rr - 16 64 rds.pg.x1.4xlarge.8.ha rds.pg.x1.4xlarge.8.rr - 16 128 rds.pg.x1.8xlarge.2.ha rds.pg.x1.8xlarge.2.rr - 32 64 rds.pg.x1.8xlarge.4.ha rds.pg.x1.8xlarge.4.rr - 32 128 rds.pg.x1.16xlarge.2.ha rds.pg.x1.16xlarge.2.rr - 64 128 rds.pg.x1.16xlarge.4.ha rds.pg.x1.16xlarge.4.rr - 64 256 rds.pg.x1.16xlarge.8.ha rds.pg.x1.16xlarge.8.rr - 64 512 表5 X86架构实例规格（通用增强型、通用增强II型） 规格 vCPU(个) 内存(GB) 通用增强型 1 2 1 4 2 4 2 8 2 16 4 8 4 16 4 32 8 32 8 64 16 64 32 128 60 128 60 256 通用增强II型 2 4 2 8 2 16 4 8 4 16 4 32 8 16 8 32 8 64 16 32 16 64 16 128 32 64 32 128 64 128 64 256 64 512 表6 ARM架构实例规格 规格 主备实例规格码 只读实例规格码 单机实例规格码 vCPU(个) 内存(GB) 鲲鹏通用增强型 rds.pg.large.arm2.ha rds.pg.large.arm2.rr rds.pg.large.arm2.single 2 4 rds.pg.large.arm4.ha rds.pg.large.arm4.rr rds.pg.large.arm4.single 2 8 rds.pg.xlarge.arm2.ha rds.pg.xlarge.arm2.rr rds.pg.xlarge.arm2.single 4 8 rds.pg.xlarge.arm4.ha rds.pg.xlarge.arm4.rr rds.pg.xlarge.arm4.single 4 16 rds.pg.2xlarge.arm2.ha rds.pg.2xlarge.arm2.rr rds.pg.2xlarge.arm2.single 8 16 rds.pg.2xlarge.arm4.ha rds.pg.2xlarge.arm4.rr rds.pg.2xlarge.arm4.single 8 32 rds.pg.4xlarge.arm2.ha rds.pg.4xlarge.arm2.rr rds.pg.4xlarge.arm2.single 16 32 rds.pg.4xlarge.arm4.ha rds.pg.4xlarge.arm4.rr rds.pg.4xlarge.arm4.single 16 64 rds.pg.8xlarge.arm2.ha rds.pg.8xlarge.arm2.rr rds.pg.8xlarge.arm2.single 32 64 rds.pg.8xlarge.arm4.ha rds.pg.8xlarge.arm4.rr rds.pg.8xlarge.arm4.single 32 128 rds.pg.15xlarge.arm2.ha rds.pg.15xlarge.arm2.rr rds.pg.15xlarge.arm2.single 60 120 数据库实例规格请以实际环境为准。 父主题： 实例规格

到期与欠费 服务到期 “按需计费”实例，没有到期的概念。 “包年/包月”实例到期后无法在RDS管理控制台进行该实例的操作，相关接口也无法调用，自动化监控或告警等运维也会停止。如果在保留期结束时您没有续费，实例将终止服务，系统中的数据也将被永久删除。 若您购买的实例已到期，请参见费用中心用户指南中资源停止服务或逾期释放说明章节进行处理。 欠费 “包年/包月”实例，没有欠费的概念。 “按需计费”实例是按实际使用扣费，当余额不足，无法扣费，就会导致实例欠费。您续费后解冻实例，可继续正常使用，请注意在保留期进行的续费，是以原到期时间作为生效时间，您应当支付从进入保留期开始到续费时的服务费用。 若您购买的实例已欠费，请参见费用中心用户指南中欠费还款章节进行处理。

计费项 华为云RDS对您选择的数据库实例、数据库存储和备份存储（可选）收费。 表1 RDS计费项说明 计费项 计费说明 数据库实例 提供包年包月和按需计费两种方式。同一个实例下的实例规格计费方式和存储计费方式保持一致。 数据库存储 备份存储（可选） RDS提供了部分免费存储空间，用于存放您的备份数据，其总容量约为您购买容量的100%。备份存储用量超过数据库存储空间的100%，开始按照阶梯计费。 公网流量 RDS实例支持公网访问，公网访问会产生带宽流量费；RDS数据库实例在云内部网络产生的流量不计费。 华为云RDS管理费用详情，请参见产品价格详情。您可以通过RDS提供的价格计算器，选择您需要的实例规格，来快速计算出购买RDS实例的参考价格。

RDS与其他服务的关系 关系型数据库与其他服务之间的关系，具体如下图所示。 图1 关系型数据库与其他服务的关系示意图 表1 与其他服务的关系 相关服务 交互功能 弹性云服务器（E CS ） 云数据库RDS服务配合弹性云服务器（Elastic Cloud Server，简称ECS）一起使用，通过内网连接云数据库RDS可以有效地降低应用响应时间、节省公网流量费用。 虚拟私有云（VPC） 对您的云数据库RDS实例进行网络隔离和访问控制。 对象存储服务 （OBS） 存储云数据库RDS实例的自动和手动备份数据。 云监控服务 （Cloud Eye） 云监控 服务是一个开放性的监控平台，帮助用户实时监测云数据库RDS资源的动态。云监控服务提供多种告警方式以保证及时预警，为您的服务正常运行保驾护航。 云审计服务（CTS） 云审计服务（Cloud Trace Service，简称CTS），为用户提供云服务资源的操作记录，供您查询、审计和回溯使用。 数据库安全服务（DBSS） 数据库前端使用数据库安全服务(Database Security Service，简称DBSS)，多种策略防止数据库被攻击，持久保护云上数据库安全。 分布式缓存服务（DCS） 分布式缓存服务（Distributed Cache Service，简称DCS）通过将热点数据放入缓存，加快用户端的访问速度，提升用户体验。 分布式数据库 中间件服务（DDM） 对于云数据库 RDS for MySQL，使用分布式数据库中间件服务（Distributed Database Middleware，简称DDM），后端对接多个数据库实例，实现分布式数据库的透明访问。 数据复制服务 （DRS） 使用数据复制服务，实现数据库平滑迁移上云。 数据管理服务（DAS） 使用数据管理服务，通过专业优质的可视化操作界面，提高数据管理工作的效率和安全。

版本功能差异（WEB版、标准版、企业版） Microsoft SQL Server官方版本的主要功能差异如表1所示。 表1 主要功能差异 功能 WEB版 标准版 企业版 高可用 不支持 Mirror HA Microsoft SQL Server 2008（Mirror）支持 Microsoft SQL Server 2012（Mirror）支持 Microsoft SQL Server 2014（Mirror）支持 Microsoft SQL Server 2016（Mirror）支持 Microsoft SQL Server 2017（Always On）支持 数据压缩 支持 支持 支持 SQL Profiler 支持 支持 支持 列式索引 不支持 支持 支持 表/索引分区 支持 支持 支持 变更数据捕获（Change Data Capture，简称CDC） 不支持 支持 支持 并行检索操作 不支持 不支持 支持 分区表并行度调整 支持 支持 支持 透明数据加密（Transparent Data Encryption，简称TDE） 不支持 不支持 支持 高级R语言集成 不支持 不支持 支持 父主题： RDS for SQL Server各版本功能概览

URI URI格式 DELETE /v3/{project_id}/instances/{instance_id}/database/{db_name} URI样例 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/a8abe84a41364097be7c233c39275087in04/database/rds-test 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。 db_name 是 需要删除的数据库名。

请求消息 参数说明 表2 参数说明 名称 是否必选 参数类型 说明 comment 否 String 数据库用户名备注。 取值范围：长度1~512个字符。 URI样例 PUT https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/db-users/root/comment 请求样例 { "comment": "this is a comment"}

URI URI格式 POST /v3/{project_id}/instances/{instance_id}/proxy URI样例 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/proxy 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。

URI URI格式 PUT /v3/{project_id}/instances/{instance_id}/proxy/delay-threshold URI样例 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/proxy/delay-threshold 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。

URI URI格式 POST /v3/{project_id}/instances/{instance_id}/proxy/scale URI样例 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/proxy/scale 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。

请求消息 参数说明 表2 参数说明 名称 是否必选 参数类型 说明 is_force_delete 否 Boolean 是否强制删除数据库，默认是false。 URI样例 DELETE https://{endpoint}/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/a8abe84a41364097be7c233c39275087in04/database/rds-test 请求样例 { "is_force_delete" : false }

数据修改 建议慎用delete、update的mutation操作 标准SQL的更新、删除操作是同步的，即客户端要等服务端反回执行结果（通常是int值）；而ClickHouse的update、delete是通过异步方式实现的，当执行update语句时，服务端立即返回执行成功还是失败结果，但是实际上此时数据还没有修改完成，而是在后台排队等着进行真正的修改，可能会出现操作覆盖的情况，也无法保证操作的原子性。 业务场景要求有update、delete等操作，建议使用ReplacingMergeTree、CollapsingMergeTree、VersionedCollapsingMergeTree引擎，使用方式参见：https://clickhouse.tech/docs/zh/engines/table-engines/mergetree-family/collapsingmergetree/。 建议少或不增删数据列 业务提前规划列个数，如果将来有更多列要使用，可以规划预留多列，避免在生产系统跑业务过程中进行大量的alter table modify列操作，导致不可以预知的性能、数据一致性问题。 对于批量数据清理，建议根据分区来操作： ALTER TABLE table_name DROP PARTITION partition_name; 禁止修改索引列 对索引列的修改会导致现有索引失效，触发重建索引，期间查询数据不准确。 如果业务场景必须修改索引列，推荐用ReplacingMergeTree引擎建表，使用数据写入+去重引擎代替数据更新场景：https://clickhouse.tech/docs/zh/engines/table-engines/mergetree-family/collapsingmergetree/。 父主题： 数据查询

普通物化视图与projection对比 表1 普通物化视图与projection对比表 物化视图类型 原表数据与物化视图一致性 灵活性 物化视图开发及维护复杂度 普通物化视图 数据从原表同步到物化视图需要时间窗 灵活性较高，有新的业务可开发新的物化视图； 可开发复杂逻辑SQL语句的物化视图。 复杂度较高，需要开发很多物化视图，每个物化视图都需要单独去管理和维护 projection 数据实时同步，数据写入即可查询到物化视图最新数据 创建表时指定的物化视图语法，新的SQL业务需要修改表结构 不需要开发很多物化视图，任意查询SQL会自动重写命中物化视图 Projection仅在 MRS 3.2.0及以上的版本中支持。 父主题： 物化视图设计

创建集群时配置LakeFormation数据连接 该操作指导用户在创建MRS集群时配置LakeFormation数据连接。 登录MRS管理控制台。 单击“购买集群”，进入“购买集群”页面。 在购买集群页面，选择“自定义购买”。 参考购买自定义拓扑集群进行配置并创建集群，且集群需满足表1中要求。 表1 LakeFormation数据连接参数说明 参数 参数说明 版本类型 LTS版 集群版本 MRS 3.1.2-LTS.6.Beta 当前仅MRS 3.1.2-LTS.6.Beta版本支持在创建集群时配置LakeFormation数据连接。 组件选择 必须包含Ranger、Hive、Guardian、Spark2x（可选）等组件。 元数据 选择“外置数据连接”，并配置以下参数： LakeFormation元数据：单击按钮开启。 LakeFormation连接实例：选择创建LakeFormation数据连接已创建的LakeFormation数据连接名称。 数据连接类型：保持默认。 虚拟私有云 与LakeFormation数据连接所在的虚拟私有云保持一致。 子网 选择子网名称。 拓扑调整 选择“开启”，并确认Ranger组件至少添加1个PolicySync（PSC）实例、Guardian组件至少添加2个TokenSever（TS）实例。 Kerberos认证 开启 委托 选择创建对接ECS/BMS云服务委托创建的委托（例如：lakeformation_test）。 参考配置MRS集群章节，配置Guardian组件、Hive/Spark2x存算分离、下载客户端等操作。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 12 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如 IAM 服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的帐号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个帐号下所有资源或帐号的某个project下的资源，详细定义请参见获取用户Token。 1 2 3 4 5 6 7 8 91011121314151617181920212223242526 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } }} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

状态码 表1 正常返回值 返回值 说明 200 任务提交成功 201 创建成功 表2 异常返回值 返回值 说明 400 Bad Request 请求参数错误。 401 Unauthorized 鉴权失败。 403 Forbidden 没有权限对资源访问。 404 Not Found 请求的资源不存在。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。 父主题： 通用请求返回值

响应示例 状态码： 200 OK { "request_id" : "6a63a18b8bab40ffb71ebd9cb80d0085", "topic_count" : 1, "topics" : [ { "topic_urn" : "urn:smn:regionId:8bad8a40e0f7462f8c1676e3f93a8183:test_topic_v2", "display_name" : "testtest", "name" : "test_topic_v1", "push_policy" : 0, "enterprise_project_id" : "0", "topic_id" : "84698185946d44d08431aa441d8e2cf2" } ]}

URI GET /v2/{project_id}/notifications/topics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取项目ID请参考 获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量。 偏移量为一个大于0小于资源总个数的整数，表示查询该偏移量后面的所有的资源，默认值为0。 缺省值：0 limit 否 Integer 查询的数量限制。 取值范围：1~100，取值一般为10，20，50。功能说明：每页返回的资源个数。默认值为100。 缺省值：100 enterprise_project_id 否 String 企业项目id，默认企业项目id为0。 缺省值：0 name 否 String 检索的主题名称，完全匹配。 fuzzy_name 否 String 检索的主题名称，模糊匹配，按照startwith模式进行匹配。 topic_id 否 String 检索的主题ID，完全匹配。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 topic_count Integer 返回的Topic个数。该参数不受offset和limit影响，即返回的是您账户下所有的Topic个数。 topics Array of ListTopicsItem objects Topic结构体数组。 表5 ListTopicsItem 参数 参数类型 描述 topic_urn String Topic的唯一的资源标识。 name String 创建topic的名字。 display_name String Topic的显示名，推送邮件消息时，作为邮件发件人显示。 push_policy Integer 消息推送的策略，该属性目前不支持修改，后续将支持修改。0表示发送失败，保留到失败队列，1表示直接丢弃发送失败的消息。 enterprise_project_id String 企业项目ID。 topic_id String 主题ID。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 403 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 404 表8 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 500 表9 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。