华为云用户手册

DQL语句 语法定义 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99100101102103104105106107108109110111112113114115116117 query: values | { select | selectWithoutFrom | query UNION [ ALL ] query | query EXCEPT query | query INTERSECT query } [ ORDER BY orderItem [, orderItem ]* ] [ LIMIT { count | ALL } ] [ OFFSET start { ROW | ROWS } ] [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY]orderItem: expression [ ASC | DESC ]select: SELECT [ ALL | DISTINCT ] { * | projectItem [, projectItem ]* } FROM tableExpression [ WHERE booleanExpression ] [ GROUP BY { groupItem [, groupItem ]* } ] [ HAVING booleanExpression ] [ WINDOW windowName AS windowSpec [, windowName AS windowSpec ]* ]selectWithoutFrom: SELECT [ ALL | DISTINCT ] { * | projectItem [, projectItem ]* }projectItem: expression [ [ AS ] columnAlias ] | tableAlias . *tableExpression: tableReference [, tableReference ]* | tableExpression [ NATURAL ] [ LEFT | RIGHT | FULL ] JOIN tableExpression [ joinCondition ]joinCondition: ON booleanExpression | USING '(' column [, column ]* ')'tableReference: tablePrimary [ matchRecognize ] [ [ AS ] alias [ '(' columnAlias [, columnAlias ]* ')' ] ]tablePrimary: [ TABLE ] [ [ catalogName . ] schemaName . ] tableName | LATERAL TABLE '(' functionName '(' expression [, expression ]* ')' ')' | UNNEST '(' expression ')'values: VALUES expression [, expression ]*groupItem: expression | '(' ')' | '(' expression [, expression ]* ')' | CUBE '(' expression [, expression ]* ')' | ROLLUP '(' expression [, expression ]* ')' | GROUPING SETS '(' groupItem [, groupItem ]* ')'windowRef: windowName | windowSpecwindowSpec: [ windowName ] '(' [ ORDER BY orderItem [, orderItem ]* ] [ PARTITION BY expression [, expression ]* ] [ RANGE numericOrIntervalExpression {PRECEDING} | ROWS numericExpression {PRECEDING} ] ')'matchRecognize: MATCH_RECOGNIZE '(' [ PARTITION BY expression [, expression ]* ] [ ORDER BY orderItem [, orderItem ]* ] [ MEASURES measureColumn [, measureColumn ]* ] [ ONE ROW PER MATCH ] [ AFTER MATCH ( SKIP TO NEXT ROW | SKIP PAST LAST ROW | SKIP TO FIRST variable | SKIP TO LAST variable | SKIP TO variable ) ] PATTERN '(' pattern ')' [ WITHIN intervalLiteral ] DEFINE variable AS condition [, variable AS condition ]* ')'measureColumn: expression AS aliaspattern: patternTerm [ '|' patternTerm ]*patternTerm: patternFactor [ patternFactor ]*patternFactor: variable [ patternQuantifier ]patternQuantifier: '*' | '*?' | '+' | '+?' | '?' | '??' | '{' { [ minRepeat ], [ maxRepeat ] } '}' ['?'] | '{' repeat '}'

按列GROUP BY 功能描述 按列进行分组操作。 语法格式 1234 SELECT [ ALL | DISTINCT ] { * | projectItem [, projectItem ]* } FROM tableExpression [ WHERE booleanExpression ] [ GROUP BY { groupItem [, groupItem ]* } ] 语法说明 GROUP BY：按列可分为单列GROUP BY与多列GROUP BY。 单列GROUP BY：指GROUP BY子句中仅包含一列。 多列GROUP BY：指GROUP BY子句中不止一列，查询语句将按照GROUP BY的所有字段分组，所有字段都相同的记录将被放在同一组中。 注意事项 GroupBy在流处理表中会产生更新结果。 示例 根据score及name两个字段对表student进行分组，并返回分组结果。 12 SELECT name,score, max(score) FROM student GROUP BY name,score;

Grouping sets, Rollup, Cube 功能描述 GROUPING SETS 的 GROUP BY 子句可以生成一个等效于由多个简单 GROUP BY 子句的 UNION ALL 生成的结果集，并且其效率比 GROUP BY 要高。 ROLLUP与CUBE按一定的规则产生多种分组，然后按各种分组统计数据。 CUBE生成的结果集显示了所选列中值的所有组合的聚合。 Rollup生成的结果集显示了所选列中值的某一层次结构的聚合。 语法格式 1234 SELECT [ ALL | DISTINCT ] { * | projectItem [, projectItem ]* } FROM tableExpression [ WHERE booleanExpression ] [ GROUP BY groupingItem] 语法说明 groupingItem：是Grouping sets(columnName [, columnName]*)、Rollup(columnName [, columnName]*)、Cube(columnName [, columnName]*) 注意事项 无。 示例 分别产生基于user和product的结果。 123 SELECT SUM(amount)FROM OrdersGROUP BY GROUPING SETS ((user), (product));

表达式GROUP BY 功能描述 按表达式对流进行分组操作。 语法格式 1234 SELECT [ ALL | DISTINCT ] { * | projectItem [, projectItem ]* } FROM tableExpression [ WHERE booleanExpression ] [ GROUP BY { groupItem [, groupItem ]* } ] 语法说明 groupItem：可以是单字段，多字段，也可以是字符串函数等调用，不能是聚合函数。 注意事项 无。 示例 先利用substring函数取字段name的子字符串，并按照该子字符串进行分组，返回每个子字符串及对应的记录数。 12 SELECT substring(name,6),count(name) FROM student GROUP BY substring(name,6);

安全标准遵从包 当前可选择的安全标准遵从包如表1所示，用户依据判定指引选择并订阅安全遵从包。 表1 安全标准遵从包一览 遵从包名称 描述 适用区域 分类 领域 判定指引 PCI DSS安全遵从包 该遵从包依据广受国际认可的数据安全标准-支付卡行业数据安全标准 (PCI DSS 3.2.1版，2018 年 5 月)，提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）自评数据安全管理情况，并结合PCI DSS给出了数据安全方面的改进建议，帮助企业提升数据安全水平。 全球 行业标准 数据安全 您是否作为参与支付卡处理的实体，包括商户、处理商、收单机构、发卡机构和服务提供商？ 您是否存储、处理或传输持卡人数据（主账户信息（PAN，一般为银行卡号）、持卡人姓名、银行卡有效期、业务码）或敏感验证数据（全磁道数据、信用卡安全码、PIN）？ 您是否期望对您在数据安全方面的风险进行识别，并获知如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。 ISO 27001安全遵从包 该遵从包依据国际上公认的ISO 27001信息安全管理体系要求（2013版），提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）自评信息安全管理情况，并给出了信息安全方面的改进建议，帮助企业提升信息安全水平。 全球 国际标准 信息安全 ISO 27001为组织建立、实施、运行、保持和持续改进信息安全管理体系规定了要求，是一项具有普适性的信息安全标准。 如您期望对您在信息安全方面的风险进行识别，并获知如何采取措施降低风险，建议您订阅该遵从包。 ISO 27701安全遵从包 该遵从包依据国际上公认的ISO 27701隐私信息管理要求和指南（2019版），提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）自评隐私信息管理情况，并给出了隐私保护方面的改进建议，帮助企业贯彻隐私保护的责任，提升隐私保护及信息安全水平。 全球 国际标准 隐私保护 您是否涉及处理（包括收集、使用、传输、存储、删除等）个人可识别信息（简称“PII”，如姓名、电话号码、电子邮箱、身份证件信息等，在本遵从包中也称作“个人数据”）？ 您是否作为PII控制者（决定PII处理目的和方法的隐私利益相关方，在本遵从包中也称作“数据控制者”）和/或PII处理者（代表PII控制者，并按照PII控制者的指示对PII进行处理的隐私利益相关方，在本遵从包中也称作“数据处理者”）的角色？ 您是否期望对您在隐私保护方面的风险进行识别，并获知如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。 等保2.0标准四级安全遵从包 该遵从包依据国家标准GB/T 22239-2019《信息安全技术网络安全等级保护基本要求》中四级的安全要求，提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）自评网络安全管理情况，并给出了网络安全等级保护的改进建议，帮助企业建设网络安全体系，提升网络安全水平。 中国 国家标准 网络安全 您是否涉及网络安全等级保护工作的作用对象，主要包括基础信息网络（为信息流通、信息系统运行等起基础支撑作用的信息网络，包括电信网、广播电视传输网、互联网、业务专网等网络设备设施）、信息系统（例如工业控制系统、 云计算平台 、物联网、使用移动互联技术的信息系统以及其他信息系统）和大数据等？ 您是否期望对网络实施分级保护措施，在网络安全保护方面的风险进行识别，并获知如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。 等保2.0标准三级安全遵从包 该遵从包依据国家标准GB/T 22239-2019《信息安全技术网络安全等级保护基本要求》中三级的安全要求，提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）自评网络安全管理情况，并给出了网络安全等级保护的改进建议，帮助企业建设网络安全体系，提升网络安全水平。 中国 国家标准 网络安全 您是否涉及网络安全等级保护工作的作用对象，主要包括基础信息网络（为信息流通、信息系统运行等起基础支撑作用的信息网络，包括电信网、广播电视传输网、互联网、业务专网等网络设备设施）、信息系统（例如工业控制系统、云计算平台、物联网、使用移动互联技术的信息系统以及其他信息系统）和大数据等？ 您是否期望对网络实施分级保护措施，在网络安全保护方面的风险进行识别，并获知如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。

隐私保护遵从包 当前可选择的隐私保护遵从包如表2所示，用户依据判定指引选择并订阅安全遵从包。 表2 隐私保护遵从包 遵从包名称 描述 适用区域 分类 领域 判定指引 中国-澳门隐私保护遵从包 该遵从包依据《澳门个人资料保护法》2005年（Personal Data Protection Act，2005，简称“PDPA”），提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）进行自评估，并为您的企业处理个人数据的有关活动提供指引。 中国-澳门 法律法规 隐私保护 您或者您的企业是否涉及如下场景之一： 以全部或部分自动化方式进行个人资料（在本遵从包中也称作“个人数据”）处理活动； 以非自动化方式进行的，构成或拟构成人工存档系统的一部分的个人资料的处理活动； 使用监控录像或其它设备来捕捉、处理和传播可用以识别某一特定个人的声音和图像。 说明： 澳门个人资料保护法没有对适用的“地域范围”进行规定。是否适用澳门PDPA或者是否受澳门法律的管辖，在上述3个场景涉及的情况，建议考虑以下两点： 资料处理活动是否在澳门特区领土范围有关联，例如在澳门特区内进行的个人资料搜集、储存的行为； 资料处理活动是否与澳门居民（包括法人、自然人）有关联。 您是否期望对您在澳门的个人资料处理方面的风险进行识别，并获知如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。 中国-大陆隐私保护遵从包 该遵从包依据《中国个人信息安全规范》2020年的法规要求，提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）进行自评估，为企业提供开展收集、存储、使用、共享、转让、公开披露、删除等个人信息处理活动应遵循的安全要求，并给出了隐私保护方面的改进建议，帮助您的企业提升个人信息保护水平。 中国大陆 法律法规 隐私保护 您是否涉及在中国大陆境内进行个人数据的收集、使用或披露等个人信息处理活动？ 您是否期望对您在中国个人信息安全规范下的个人信息安全风险进行识别，并获取如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。 中国-香港隐私保护遵从包 该遵从包依据《香港个人资料（私隐）条例》1995年（Personal Data （Privacy ）Ordinance，1995，简称PDPO）的法规要求，提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）进行自评估，指导您的企业如何收集、存储、传输、处理和使用收集到的个人数据，并给出了隐私保护方面的改进建议，帮助您的企业提升隐私保护及信息安全水平。 中国香港 法律法规 隐私保护 您是否涉及对一名在世人士有关及可确定个人身份的资料，以可供查阅及处理的方式记录下来？ 说明： 中国香港PDPO没有对适用的“地域范围”进行规定，是否适用中国香港PDPO，建议结合以下条件考虑：您是否涉及作为中国香港境内的资料使用者（在本遵从包中也称作“数据控制者”）收集、使用、或处理个人资料（在本遵从包中也称作“个人数据”）？ 您是否期望对您在中国香港PDPO下的个人资料处理相关风险进行识别，并获取如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。 新加坡隐私保护遵从包 该遵从包依据《新加坡个人数据保护法》2012年（Personal Data Protection Act，2012，简称PDPA）的法规要求，提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）进行自评估，并给出了隐私保护方面的改进建议，帮助您的企业规范个人数据的收集、使用或披露，以及提升个人保护其个人信息数据各项权利的意识。 新加坡 法律法规 隐私保护 您是否涉及在新加坡境内进行个人数据的收集、使用或披露等个人信息处理活动？ 您是否期望对您在新加坡个人数据保护法下的个人数据保护相关风险进行识别，并获取如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。 泰国隐私保护遵从包 该遵从包依据《泰国个人数据保护法 B.E.2562》 2019年（Personal Data Protection Act B.E.2562 2019, 简称PDPA）的法规要求，提供检查项和评测指引供云计算客户（在本遵从包中也称作“您”或者“您的企业”）进行自评估，并给出了隐私保护方面的改进建议，帮助企业全面管理数据保护以及个人数据的收集、保护、使用、存储、披露、传输。 泰国 法律法规 隐私保护 您是否涉及在泰国境内收集、保护、使用、披露、传输和其他处理个人数据的情形？ 您是否涉及对位于泰国境内的个人数据主体从事以下活动： 您向泰国境内的数据主体提供服务，无论是否由该数据主体支付费用 监控数据主体的行为，且该监控发生在泰国境内 您是否期望对您在泰国个人数据保护法下的个人数据保护风险进行识别，并获取如何采取措施降低风险？ 如果以上任一回答为是，建议您订阅该遵从包。

消息&短信MSG SMS 服务权限 默认情况下，新建的 IAM 用户没有任何权限，您需要将其加入用户组，并给用户组授予角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 消息&短信部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如华北-北京四）对应的项目（cn-north-4）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问消息&短信时，需要先切换至授权区域。 权限根据角色进行授权。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 如表1 消息&短信服务系统角色所示，包括了消息&短信的所有系统策略。 表1 消息&短信服务系统角色 策略名称 描述 策略类别 依赖关系 RTC Administrator 语音通话、消息&短信、 隐私保护通话 的所有执行权限。 角色 无 MSGSMS FullAccess 消息&短信服务普通用户权限，拥有该权限的用户可以拥有消息&短信支持的全部权限，包括创建、删除、查询、变更规格等操作。 系统策略 无 MSGSMS ReadOnlyAccess 消息&短信服务只读权限，拥有该权限的用户仅能查看消息&短信服务数据。 系统策略 无 如表2所示，列出了短信服务操作与系统权限的授权关系，供您选择选择合适的系统权限。 表2 消息&短信MSGSMS操作与系统策略关系 操作 MSGSMS FullAccess MSGSMS ReadOnlyAccess 查询短信应用数量 √ √ 查询短信应用 √ √ 查询权限 √ √ 查询短信应用密钥 √ √ 查询租户受限原因 √ √ 查询签名信息 √ √ 查询短信类型 √ √ 查询签名名称 √ √ 查询短信模板 √ √ 查询催审配置 √ √ 查询校验租户订单状态 √ √ 查询开发者信息 √ √ 查询短信模板名称 √ √ 查询短信模板变量 √ √ 查看群发助手任务名称 √ √ 查询群发助手短信发送任务 √ √ 查看群发助手任务结果详情 √ √ 查询短信限额策略 √ √ 查询短信业务统计数据 √ √ 查询联系人 √ √ 查询历史请求信息 √ √ 查询短信总览统计数据 √ √ 查询消息提醒 √ √ 查询单条短信价格 √ √ 查询企业项目 √ √ 查询公共配置 √ √ 查询租户企业名称 √ √ 查询短信发送国家 √ √ 查看短信详情 √ √ 查询企业营业执照文件 √ √ 删除签名 √ x 删除短信模板 √ x 删除联系人 √ x 导出群发助手任务发送号码 √ x 导出短信业务统计数据 √ x 创建短信应用 √ x 发送验证码 √ x 添加签名 √ x 修改签名 √ x 签名申请催审 √ x 创建短信模板 √ x 导入群发助手短信发送任务 √ x 创建群发助手短信发送任务 √ x 添加联系人 √ x 新增解除黑名单请求 √ x 更新短信应用密钥 √ x 修改短信应用 √ x 申请激活签名 √ x 修改短信模板 √ x 更新群发助手定时任务 √ x 设置短信限额策略 √ x 修改联系人 √ x 批量导入短信模板 √ x 上传企业营业执照文件 √ x

产品规格 分类 功能特性 国内短信 短信功能 短信回复 支持 彩信 不支持 短信细则 一条短信最多能发多少个字 文本短信模板字数上限：500个字 短信内容长度计算规则 用户接收短信看到的号码 106开头的随机号码 可接收短信的号码 手机号（不包含物联网卡） 有短信功能的固话 短信支持的语言 首选简体中文 平台机制 统计短信发送数据 支持 短信发送管控机制 支持 短信发送频率 同一个号码：验证码：2次/分钟，50次/24小时；通知短信：10次/分钟，50次/24小时；推广短信：4次/1小时，10次/24小时 同一个号码同一条短信（验证码/通知/推广短信）：2次/59秒，5次/59分钟 短信发送频率限制 签名类型和模板类型是否需匹配 支持 短信发送失败后自动重发 不支持 API支持哪些协议接入 HTTPS 短信到达率 99% 父主题： 产品概述

产品功能 华为 云消息 &短信服务的功能如下： 服务种类 特点 支持上行短信 国内短信支持接收用户回复短信。 支持单发和群发短信 支持单发短信，也支持使用群发助手发送短信。可参考使用群发助手。 支持防盗刷和发送频率限制功能 支持短信使用情况监控，有效预防验证码短信被盗刷和用户退订风险。可参考发送频率限制和防盗刷限制。 支持短信格式自定义功能 可按模板或自定义格式发送。可参考使用须知。 支持可视化业务查询功能 随时查询使用情况和业务发送详情反馈。可参考业务统计。 如有任何疑问，请联系华为云智能客服，将有专人为您解答。 父主题： 产品概述

变量示例 变量格式 填写示例 说明 按序号标识 ${1}、${2}、...、${20} 长度限制：1-20个字符。 中间数字应代表变量在模板内容中的位置顺序。即${1}表示模板内容中的第一个变量，${2}表示模板内容中的第二个变量，以此类推。 说明： 特殊内容（如网址、手机号等）不允许设置局部变量，如www.${1}.cn、186${2}1234等。 按类型标识 ${PHONE}、${CHARDIGIT}、${DATETIME}、${MONEY}、${TEXT} 中间字符表示变量类型，各变量有默认长度限制，不支持自定义设置。 如有任何疑问，请联系华为云智能客服，将有专人为您解答。

防盗刷限制 功能定义 功能指引 短信盗刷是指通过恶意程序或工具，在短时间内，给单个或多个手机号码发送大量无效短信，造成短信轰炸和用户骚扰。 您可使用消息&短信服务提供的流量阈值管理功能，当短信发送总量超过设定限额数值，平台会自动帮您暂停发送短信，降低因客户自身业务被盗刷短信等引起的损失。 系统设置了默认预警值与限额值，初次使用请根据业务需要，参考通用设置修改预警值与限额值。 验证码短信盗刷是指利用短信资源中验证码获取功能，通过恶意程序或工具批量对单个或者多个号码进行验证码重复请求提交。 您也可加上图形验证码，当用户进行短信发送操作前，要求用户输入图形验证码，可防范短信盗刷攻击问题。

发送频率限制 为防止用户通过登录APP、网站或通过短信等方式找回密码时，在短时间内向同一号码，发起大量短信发送请求，影响用户体验。华为云针对国内短信进行如下流量控制，具体限制数量以运营商的实现为准。 限制项 短信类型 限制频率 说明 号码频次 验证码 2次/分钟 任意1分钟内，对同一个手机号码发送短信最多2次，超出次数会被限制。 50次/24小时 任意24小时内，对同一个手机号码发送短信最多50次，超出次数会被限制。 通知 10次/分钟 任意1分钟内，对同一个手机号码发送短信最多10次，超出次数会被限制。 50次/24小时 任意24小时内，对同一个手机号码发送短信最多50次，超出次数会被限制。 推广 4次/1小时 任意1小时内，对同一个手机号码发送短信最多4次，超出次数会被限制。 推广短信发送时间为每日8:00 - 22:00，夜间无法发送。 10次/24小时 任意24小时内，对同一个手机号码发送短信最多10次，超出次数会被限制。 推广短信发送时间为每日8:00 - 22:00，夜间无法发送。 同号同内容管控 验证码/通知/推广 2次/59秒 任意59秒内，对同一个手机号码发送同一短信（内容完全相同）最多2次，超出次数会被限制。 5次/59分钟 任意59分钟内，对同一个手机号码发送同一短信（内容完全相同）最多5次，超出次数会被限制。

短信封禁规则 消息&短信服务会针对用户发送的短信内容进行审核，防范在短信中出现违反国家法律法规内容。 序号 违规行为定义 违规性质 处理方式 1 下发短信中不含有签名，或与报备签名不符合 一般 以正式邮件的方式进行提醒并要求整改，连续三次提醒未按要求整改，直接关停账号业务 2 营销短信业务未提前报备通过，在每天22:00至次日8:00时间段内发送 一般 以正式邮件的方式进行提醒并要求整改，连续三次提醒未按要求整改，直接关停账号业务。 3 营销短信业务未提供明确退订方式 一般 以正式邮件的方式进行提醒并要求整改，连续三次提醒未按要求整改，直接关停账号业务。 4 向最终用户提供短信服务前未经最终用户同意 严重 暂停账号业务，以正式邮件的方式进行警告要求整改，确认整改好再恢复账号业务，再次出现直接关停。 5 下发短信内容和报备内容不符 严重 暂停账号业务，以正式邮件的方式进行警告要求整改，确认整改好再恢复账号业务，再次出现直接关停。 6 用行业通道发送营销短信内容（含前面是行业短信或验证码，后面附带营销推广内容的，算营销短信） 严重 暂停账号业务，以正式邮件的方式进行警告要求整改，确认整改好再恢复账号业务，再次出现直接关停。 7 发送内容产生投诉且为有效投诉，月投诉率达到百万分之0.25 严重 暂停账号业务，以正式邮件的方式进行警告要求整改，确认整改好再恢复账号业务，再次出现直接关停。 8 经查证发送内容为官网明确禁止发送类短信 重大 关停账号业务。 9 发送内容产生投诉且为有效投诉，月投诉率达到百万分之0.4 重大 关停账号业务。

图表类型与说明 每种图表都有其适用场景和数据要素（即构成图表的字段）。下面为您介绍各种类型图表的使用场景、数据要素和样例展示。 表1 图表适用场景 类型 类型 说明 数据要素 图片 图片 图片组件主要用于添加图片到报表页面进行组合展示，常用于添加页面补充说明配图或者添加 LOG O图片等进行页面美观度整体提升。 类别轴/维度 轴值/度量 颜色图例 视频 视频 视频是媒体组件的一种，支持自定义视频的URL地址、视频播放属性、播放器的外观属性等，支持mp4格式的视频，能够在可视化应用中添加视频播放器来播放您的视频。 链接 FLV视频流 功能同视频组件，支持播放FLV视频格式。 链接

发布大屏步骤 登录智能数据洞察控制台。 单击管理控制台左上角的，选择区域。 单击左下角的企业项目选择企业项目。 在控制台的右侧“我的项目列”选择或搜索对应的项目，单击进入项目。 在项目页面，单击数据分析下“大屏”进入大屏管理页面。 单击未发布的大屏，进入编辑页面。 单击页面右上角的“保存并发布”按钮，页面提示“大屏发布成功”。 如果编辑大屏内容，单击大屏页面右上角“重新发布”按钮，页面提示“大屏发布成功”。

智能分析助手使用流程 如何快速搭建一个智能分析助手，可参见创建智能分析助手，它将为您详细介绍智能分析助手的基础使用方法。如果需要使用智能分析助手的进阶特性，可参见配置智能分析助手和与智能分析助手对话两个部分的指导，帮助您更有效地进行智能问答。 图5 智能分析助手使用流程 表1 智能分析助手使用流程说明 序号 步骤 说明 1 创建智能分析助手 介绍智能分析助手的基础使用方法，帮助您快速上手智能分析助手。 2 配置智能分析助手 介绍智能分析助手的配置方法，帮助您提高问答的质量和效率。 3 与智能分析助手对话 介绍智能分析助手的高阶问答功能，帮助您提高数据分析的效率。

可视化配置（可选） DataArts Insight提供的数据集的可视化配置功能，帮助您更加便捷地配置数据集字段，提供了多种参数设置，包括字段名称、字段类型、默认聚合方式、数值展示格式、字段描述、是否允许搜索以及分析优先级等。 单击“可视化配置”，进入可视化配置页面。 选择需要修改的字段，并按需编辑字段，参数说明如表2所示。 单击可批量配置字段，当前支持批量转换为维度或度量，支持批量设置隐藏、取消隐藏，支持批量删除字段。 图3 可视化配置 表2 可视化配置参数说明 参数名称 说明 字段名称|物理字段 字段名称，在该页面支持自定义，字段名称会显示在仪表板和大屏制作的图表中。 物理字段不支持修改。 字段类型 字段支持的类型，包括日期、文本、数字。其中日期支持多种格式设置。 默认聚合 维度字段不支持设置，仅度量字段支持设置聚合方式。 支持以下设置：无聚合、求和、平均值、计数、去重计数、最大值、最小值、总体标准差、样本标准差、总体标方差、样本方差、区间起始值、区间结束值。 说明： 区间起始值、区间结束值只支持单项设置，不支持同时设置。 数值展示格式 无格式、数值、货币、对象量词、长度、重量、能量、容量、时间、百分比。 字段描述 对字段的相关信息的描述。 允许搜索 是否允许搜索枚举值，用于标记字段的枚举值在训练时是否允许被搜索，当前仅能提取最多1000个枚举值。 说明： 仅支持文本类型。 分析优先级 用于确定智能分析助手中的自动见解功能从数据集选用字段分析时的优先级，最多支持配置10个高分析优先级字段。 操作 支持对字段的删除和隐藏，此处可对已隐藏的字段进行取消隐藏。 说明： 删除数据集中的字段时要检查该字段是否在大屏、报表和权限配置中有使用。

操作流程 图1 使用智能分析助手数据分析流程 表1 使用智能分析助手数据分析流程说明 序号 步骤 说明 1 新建项目空间 新建项目空间，后续所有的数据分析在该空间中展开，用便于数据管理。 2 接入数据源 数据源是数据分析的基础，成功接入数据源后才能进行数据分析。 3 新建数据集 数据集作为数据源和可视化展示的中间环节，承接数据源的输入，并为可视化展示提供输入。 4 创建智能分析助手 创建智能分析助手可以简化数据获取、图表制作等流程。 5 智能问答 在智能分析助手问答界面进行提问，智能分析助手将自动返回结果。 6 搭建仪表板 仪表板是 数据可视化 的关键工具，可以直观展示图表，使得数据洞察变得直观易懂。

数据说明 为保护用户的隐私和数据安全，所有数据均已进行了采样和脱敏。本例共计三个数据表：order_info_demo_01（订单表）、product_info_demo_02（商品信息表）user_info_demo_03（用户数据表），详细信息请参见表2。 表2 商品销售数据示例 表名称 字段名称 字段类型 字段说明 order_info_demo_01 id int ID编号 sale_price int 销售价格 profit int 利润 pay_time int 支付时间 create_time int 订单创建时间 product_info_demo_02 product_id int ID编号 product_name string 商品名称 product_type string 商品类型 product_color string 商品颜色 product_price string 商品价格 user_info_demo_03 id int ID编号 user_name int 用户名 age int 年龄 gender int 性别

URI DELETE /v1/{project_id}/instances/{instance_id}/workspaces/{workspace_id} 表1 路径参数 参数 是否必选 参数类型 描述 instance_id 是 String 实例ID。 workspace_id 是 String 工作空间ID。获取方法请参见获取工作空间ID。 project_id 是 String 项目ID。获取方法请参见获取项目ID。

响应参数 表4 响应Body参数 参数 参数类型 描述 instances Array of objects 实例信息。具体请参考表5。 count Integer 数据数量。 page_data Array of objects 当前页的数据。 表5 instances 参数 参数类型 描述 project_id String 项目ID。 region_id String RegionId。 order_id String 订单ID。 instance_id String 产品实例ID。 instance_name String 产品实例名称。 resource_spec_code String 产品规格。 order_type String 订单类型： ON_DEMAND：按需。 PERIOD：包周期。 status Integer 实例状态，有以下几种状态。 1：未生效； 2：生效中； 3：已删除=退订； 4：保留期=冻结； 5：宽限期。 domain_id String 账号ID。 eps_id String 所属企业项目ID。

响应示例 获取已开通实例列表成功 。 { "count": 1, "page_data": [ { "project_id": "9c3043ab4xxxx055888643b331a0xxxx", "region_id": "xxx", "order_id": "4xxxxd9517314ebbbe17258a9640xxxx", "instance_id": "4e7xxxx517314exxxx17258a9640c05f", "instance_name": "xxxx-4e7a0d9517314exxxx17258a9640c05f", "instance_spec_code": "DataArtsInsight.unit.enterprise.user", "order_type": "ON_DEMAND", "status": 2, "create_user": "***", "create_date": 169xxxx2604761, "domain_id": "d22f8acfxxxx428fb22606b64dc7xxxx", "eps_id": "0" } ]}

URI GET /v1/{project_id}/instances 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Integer 偏移值。分页的偏移值，0代表不偏移，也就是第一页，1代表偏移1，指的第二页。 limit 是 Integer 返回列表数量。 sort_key 否 String 排序字段isOpen，是否开启行列权限。 sort_dir 否 String 排序类别：desc、asc。desc代表减序，asc代表升序。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 user_id 是 String userId value 否 Array of strings value value_type 否 String 默认标签值类型，默认为NULL。 DEFAULT：默认值，采用默认标签值； NULL：为空； ALL：所有值； ENUM：枚举值，default_value必须有枚举值配置。

响应示例 状态码： 200 数据源列表详情。 { "count" : 100, "page_data" : [ { "id" : "xxxxxxx796649a185b012a96xxxxxxx", "name" : "test_name", "host" : "xxx.xx.x.xx", "port" : 80, "server_list" : "xxx.xx.x.xx:xxxx", "database_name" : "db_name", "user_name" : "test_name", "test_url" : "jdbc:gaussdb://xxx.xx.x.xx:xxxx/gaussdb?socketTimeout=120&loginTimeout=5&ssl=true", "project_id" : "xxxxxxxb4dac4055888643b331axxxxxxx", "domain_id" : "xxxxxxxcf3c90428fb22606b64dxxxxxxx", "work_space_id" : "xxxxxxxa5ea0764ffa850664804b9xxxxxxx", "extra" : "[{\"ip\": \"xxx.xx.x.xx\", \"port\": xxxx, \"channelType\": \"eip\"}]", "config" : { "ssl" : true }, "type" : "DWS", "source" : "dws", "mode" : "multi-node", "default_schema" : "public", "creation_user" : "xxxxxxx63a94b0ba2887b8xxxxxxx", "creation_date" : 1700114987113, "creation_user_name" : "ei_dlv_l00456193_01", "update_user" : "xxxxxxxa863a94b0ba2887b80dxxxxxxx", "update_user_name" : "name1", "update_date" : 1701071948929 } ]}

响应示例 状态码： 200 数据源详情。 { "id" : "xxxxxxx3796649a185b012a96xxxxxxx", "name" : "xxx_gaussdbtest", "host" : "xxx.xx.x.xx", "port" : 8000, "server_list" : "xxx.xx.x.xx:xxxx", "database_name" : "gaussdb", "user_name" : "modernbi", "test_url" : "jdbc:gaussdb://xxx.xx.xx.xx:xxxx/gaussdb?socketTimeout=120&loginTimeout=5&ssl=true", "project_id" : "xxxxxxxb4dac4055888643b33xxxxxxx", "domain_id" : "xxxxxxxf3c90428fb22606b64xxxxxxx", "work_space_id" : "xxxxxxxea0764ffa850664804xxxxxxx", "extra" : "[{\"ip\": \"xxx.xx.x.xx\", \"port\": xxxx, \"channelType\": \"eip\"}]", "config" : { "ssl" : true }, "type" : "DWS", "source" : "dws", "mode" : "multi-node", "default_schema" : "public", "creation_user" : "xxxxxa863a94b0ba2887b80dxxxxx", "creation_date" : 1700114987113, "creation_user_name" : "test_name", "update_user" : "xxxxxxxa863a94b0ba2887b80dcxxxxxxx", "update_user_name" : "test_name", "update_date" : 1701071948929}

响应示例 状态码：200 获取数据集详情成功。 { "create_date" : 1705458279173, "create_user" : "cfcxxxx4501811aedcxxxxbbfe8", "create_user_name" : "xxxxxxx", "update_date" : 1705458279173, "update_user" : "cfcc77xxxx364501811aedcxxxxbbfe8", "update_user_name" : "xxxxxxx", "project_id" : "34ba64e53axxxb68cd7xxxxa8cc17bd", "workspace_id" : "d39157xxxx5f43c2bdxxxx74792b2d5e", "id" : "b745d57b-xxxx-4f2a-xxxx-3c0ff5fcf92f", "caption" : "api测试数据集10", "version" : "2.0", "ds_id" : "2eaa208dxxxxxxx9496914134fae2d4", "ds_type" : "DWS", "domain_id" : "10ae45e7xxxxxxbe954a211426d003", "physical_schema" : { "tables" : [ { "id" : "a25173cb-xxxx-42ec-xxxxx-67483f6cdaab", "database_name" : "modernbi_demo", "schema_name" : "autotest", "table_name" : "order_info", "table_type" : "table", "sql_text" : "", "is_fact_table" : false }, { "id" : "b745d57b-xxxx-4f2a-xxxx-3c0ff5fcf92f", "database_name" : "modernbi_demo", "schema_name" : "autotest", "table_name" : "sql_order_info", "table_type" : "sql", "sql_text" : "select * from autotest.order_info", "is_fact_table" : true } ] }, "logical_schema" : { "field_schema" : { "measures" : [ { "id" : "2d83ad17-32bb-xxxx-9c55-xxxxxxx", "caption" : "cs_bill_customer_sk", "is_expansion" : 0, "expansion_type" : 0, "column_formula" : "cs_xxxxx_customer_sk", "origin_column_name" : "cs_xxxx_customer_sk", "origin_column_type" : "int8", "data_type" : "NUMBER", "origin_data_type" : "NUMBER", "cube_id" : "2d83ad17-xxxxxxxxx-9c55-2a47415bdaf6" } ], "dimensions" : [ { "id" : "a25173cb-e229-xxxxxxx-67483f6cdaab.id", "caption" : "id1", "dimension_type" : "StandardDimension", "hierarchies" : [ { "caption" : "id1", "levels" : [ { "id" : "a25173cb-xxxxxxxxc-a4b4-67483f6cdaab.id", "caption" : "id1", "data_type" : "STRING", "origin_data_type" : "STRING", "origin_column_name" : "id", "origin_column_type" : "varchar(255)", "column_formula" : "id", "level_type" : null, "is_expansion" : 0, "expansion_type" : 0 } ] } ], "cube_id" : "a25173cb-xxxxxxxc-a4b4-67483f6cdaab" } ] }, "variables" : null, "relations" : [ { "source" : "b745d57b-axxxxx8ee4-3c0ff5fcf92f", "target" : "a25173cb-xxxxxx-a4b4-67483f6cdaab", "join_type" : "left join", "relation" : "many-to-one", "joins" : [ { "source_key" : "product_id", "source_type" : "dimension", "target_key" : "product_id", "target_type" : "dimension", "condition" : "equal-to" } ] } ] } }

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 例如，对于IAM获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，例如cn-north-1，可以从地区和终端节点中获取。 scope参数定义了Token的作用域，下面示例中IAM获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见IAM获取用户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。对于IAM获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求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-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也是相同，所以简洁起见将这两部分省略。

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