接口说明 1.24.100以前版本的多维视图&多维分支相关接口将于2025年01月起逐步下线。如果您的系统正在调用1.24.100以前版本接口，请尽快更新至1.24.100版本接口，避免因相关接口下线而导致系统不可用。 1.24.100以前版本的多维视图&多维分支相关接口包括：getAllVersions、logicalDeleteLatestVersion、deleteLatestVersion、getVersionByMaster、batchUpdateVersion、compareBusinessVersion、deleteBranch、logicalDeleteBranch、batchDeleteBranch、batchLogicalDeleteBranch、batchDelete、batchLogicalDelete、logicalDelete、delete和createView。

示例代码对比 本章节以createView/createViewV2接口为例。 表1 示例代码对比 1.24.100以前版本 1.24.100版本 public void test() { // 创建VersionViewCreateDTO公共父类的dto对象 VersionViewCreateDTO dto = new VersionViewCreateDTO(); dto.setVersionId(1L); cbmvFuntionTest01Delegator.createView(dto); } public void test() { // 创建CBMVFuntionTest01VersionViewCreateDTO子类的dto对象 CBMVFuntionTest01VersionViewCreateDTO dto = new CBMVFuntionTest01VersionViewCreateDTO(); dto.setVersionId(1L); cbmvFuntionTest01Delegator.createViewV2(dto); }

操作步骤 登录华为云管理控制台，鼠标指向页面右上角的用户名，在下拉列表中单击“我的凭证”。 图1 我的凭证入口 在“我的凭证”页面中选择“访问密钥”页签。单击“新增访问密钥”，按操作指引获取认证账账号的AK/SK，请妥善保管AK/SK信息。 图2 访问密钥 每个用户仅允许新增两个访问密钥。 为保证访问密钥的安全，访问密钥仅在初次生成时自动下载，后续不可再次通过管理控制台页面获取。请在生成后妥善保管。

请求示例 获取实例健康诊断报告内容。 GET https://das.cn-north-7.myhuaweicloud.com/v3/052041494800d57c2f02c00275b4c247/instances/bcfa975193f1402fa11a6d4fd6baf5fbin01/get-instance-health-report?task_id=bb252ed0-3d06-489a-a662-6609e054e91c

响应示例 状态码： 200 Success. { "success" : true, "summary_info" : { "analysis_results" : [ { "risk_code" : "SLOW_ LOG _ISSUE", "risk_level" : "WARNING", "risk_content" : "慢SQL问题", "reasons" : [ { "reason_code" : "SLOW_LOG_EXIST", "reason_content" : "存在慢SQL", "suggestions" : [ { "suggestion_code" : "ANALYZE_SLOW_LOG", "suggestion_content" : "分析慢SQL查找问题根源" } ] } ] } ] }, "instance_info" : { "tenant_id" : "05204146e600d48f0f02c002850ec340", "project_id" : "052041494800d57c2f02c00275b4c247", "instance_id" : "bcfa975193f1402fa11a6d4fd6baf5fbin01", "instance_name" : "rds-sql-勿删1", "cpu" : 2, "mem" : 8, "disk_size" : 60, "disk_type" : "CLOUDSSD", "engine" : "mysql", "engine_version" : "5.7" }, "performance_stat" : { "analyze_success" : true, "peak_stats" : [ { "metric" : "qps", "value" : 64.88, "max_value" : 11178, "normalized" : 0.005804258364644837, "stage" : "LIGHT", "timestamp" : 1728756000 } ], "ratio_stats" : [ { "criticalThreshold" : 11178, "mediumThreshold" : 7824.599999999999, "lightThreshold" : 3353.4, "metric" : "qps", "max_value" : 11178, "critical_ratio" : 0, "medium_ratio" : 0, "light_ratio" : 1 } ] }, "disk_stat" : { "analyze_success" : true, "peak_stats" : [ { "metric" : "iops", "value" : 91.9, "max_value" : 4500, "normalized" : 0.020422222222222224, "stage" : "LIGHT", "timestamp" : 1728750600 } ], "ratio_stats" : [ { "criticalThreshold" : 4500, "mediumThreshold" : 3150, "lightThreshold" : 1350, "metric" : "iops", "max_value" : 4500, "critical_ratio" : 0, "medium_ratio" : 0, "light_ratio" : 1 } ] }, "table_space_stat" : { "analyze_success" : true }, "slow_log_stat" : { "analyze_success" : true, "collect_slow_log" : true, "top_execute_slow_logs" : [ { "template_id" : "5B20B6BF446F926F", "template" : "INSERT INTO test123 VALUES (?);", "databases" : [ "test_db" ], "times" : 83, "avg_query_time" : 0.9021538595657752, "max_query_time" : 45.08398997783661, "avg_rows_examined" : 0, "sum_rows_examined" : 0, "avg_rows_sent" : 0 } ], "rows_examined_exceeding" : [ ] }, "full_sql_Stat" : { "analyze_success" : true, "collect_full_sql" : true, "execute_top_templates" : [ { "template_id" : "B38F825636B24B7", "template" : "CREATE TABLE IF NOT EXISTS table_001 (id int)", "databases" : [ "test_db" ], "times" : 1, "avg_query_time" : 5, "avg_rows_examined" : 0, "sum_rows_examined" : 0 } ] }, "inspection_Stat" : { "analyze_success" : true, "inspection_score" : [ { "score" : 100, "critical" : 0, "medium" : 0, "light" : 0, "cpu_usage" : 3.93, "mem_usage" : 22.91, "space_usage" : 8.66, "connection_rate" : 0.54, "iops_usage" : 0.28, "thread_running" : 4, "slow_sql_total" : 0, "lost_points_detail_list" : [ { "metric" : "memUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "cpuUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "spaceUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "iopsUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "connectionRate", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "threadRunning", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "slowSqlTotal", "lost_points" : 0, "risk_level" : "NORMAL" } ] } ] } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 success Boolean 日报诊断是否成功。 start_at Long 日报诊断区间的起始时间（Unix timestamp），单位：毫秒。 end_at Long 日报诊断区间的结束时间（Unix timestamp），单位：毫秒。 task_id String 报告ID。 summary_info 表5 object 日报内容摘要信息 instance_info 表9 object 实例信息列表。 performance_stat 表10 object 性能统计分析列表。 disk_stat 表11 object 磁盘统计分析列表。 table_space_stat 表14 object 表空间统计分析列表。 slow_log_stat 表17 object 慢SQL统计分析列表。 full_sql_stat 表18 object 全量SQL统计分析列表。 inspection_stat 表20 object 巡检评分统计分析列表。 error_message String 错误信息。 表5 HealthReportSummaryInfo 参数 参数类型 描述 analysis_results Array of 表6 objects 分析结果列表。 表6 HealthReportAnalysisResult 参数 参数类型 描述 risk_code String 风险点编码。 risk_level String 风险点级别。 risk_content String 风险点内容。 reasons Array of 表7 objects 可能原因列表。 表7 HealthReportRiskReason 参数 参数类型 描述 reason_code String 可能原因编码。 reason_content String 可能原因内容。 suggestions Array of 表8 objects 建议优化措施列表。 表8 HealthReportRiskSuggestion 参数 参数类型 描述 suggestion_code String 建议优化措施编码。 suggestion_content String 建议优化措施。 表9 HealthReportInstanceInfo 参数 参数类型 描述 tenant_id String 账号ID。 project_id String 项目ID。 instance_id String 实例ID。 master_node_id String 主节点ID。 instance_name String 实例名称。 cpu Integer 实例cpu核数。 mem Integer 实例内存大小。 disk_size Integer 磁盘大小。 disk_type String 磁盘类型。 engine String 实例引擎类型。 engine_version String 引擎内核版本。 表10 HealthReportPerformanceStat 参数 参数类型 描述 peak_stats Array of 表12 objects 峰值统计信息列表。 ratio_stats Array of 表13 objects 比率值数据列表。 表11 HealthReportDiskStat 参数 参数类型 描述 peak_stats Array of 表12 objects 峰值统计信息列表。 ratio_stats Array of 表13 objects 比率值数据列表。 表12 HealthReportSingleValueStat 参数 参数类型 描述 metric String 指标名。 value Double 数值。 max_value Double 最大值。 normalized Double 归一化值。 stage String 当前状态。 timestamp Long 指标采集时间。 表13 HealthReportRatioStat 参数 参数类型 描述 metric String 指标名。 max_value Double 最大值。 critical_ratio Double 高水位占比。 medium_ratio Double 中水位占比。 light_ratio Double 低水位占比。 表14 HealthReportTableSpaceStat 参数 参数类型 描述 size_top Array of 表15 objects 表大小Top列表。 rows_top Array of 表15 objects 表行数量Top列表。 size_incr_top Array of 表16 objects 表大小增长Top列表。 rows_incr_top Array of 表16 objects 表行数量增长Top列表。 analyze_success Boolean 统计分析是否成功。 error_message String 错误信息。 表15 HealthReportTableSpaceInfo 参数 参数类型 描述 database String 数据库名。 table String 表名。 db_engine String 数据库引擎。 table_size Long 表大小。 data_size Long 数据大小。 index_size Long 索引大小。 rows Long 行数量。 表16 HealthReportTableSpaceIncrInfo 参数 参数类型 描述 database String 数据库名。 table String 表名。 increment Long 增长量。 analyze_success Boolean 统计分析是否成功。 error_message String 错误信息。 表17 HealthReportSlowLogStat 参数 参数类型 描述 collect_slow_log Boolean 是否收集慢SQL。 top_execute_slow_logs Array of 表19 objects 慢SQL Top执行次数列表。 top_avg_query_time_slow_logs Array of 表19 objects 慢SQL Top平均执行时间列表。 top_max_query_time_slow_logs Array of 表19 objects 慢SQL Top最大执行时间列表。 rows_examined_exceeding Array of 表19 objects 慢SQL Top扫描返回比列表。 analyze_success Boolean 统计分析是否成功。 error_message String 错误信息。 表18 HealthReportFullSqlStat 参数 参数类型 描述 collect_full_sql Boolean 是否收集全量SQL。 execute_top_templates Array of 表19 objects 全量SQL Top总执行次数列表。 sum_rows_examined_top_templates Array of 表19 objects 全量SQL Top总扫描行数列表。 avg_cost_top_templates Array of 表19 objects 全量SQL Top平均执行耗时列表。 analyze_success Boolean 统计分析是否成功。 error_message String 错误信息。 表19 HealthReportSqlTemplate 参数 参数类型 描述 template_id String 模板ID。 template String 模板内容。 databases Array of strings 数据库列表。 times Long 执行次数。 avg_query_time Double 平均执行时间。 max_query_time Double 最大执行时间。 avg_rows_examined Double 平均扫描行数。 max_rows_examined Double 最大扫描行数。 sum_rows_examined Double 总扫描行数。 avg_rows_sent Double 平均返回行数。 max_rows_sent Double 最大返回行数。 表20 HealthReportInspectionStat 参数 参数类型 描述 inspection_score Array of 表21 objects 巡检评分。 analyze_success Boolean 统计分析是否成功。 error_message String 错误信息。 表21 HealthReportInspectionScore 参数 参数类型 描述 score Double 得分。 critical Integer 严重事件。 medium Integer 警告事件。 light Integer 优化事件。 cpu_usage Double CPU使用率。 mem_usage Double 内存使用率。 space_usage Double 空间使用率。 connection_rate Double 连接使用率。 iops_usage Double IOPS使用率。 thread_running Double 活跃会话。 slow_sql_total Long 慢SQL数量。 lost_points_detail_list Array of 表22 objects 扣分详情。 表22 HealthReportLostPointsDetail 参数 参数类型 描述 metric String 扣分项。 lost_points Double 所扣分数。 risk_level String 事件等级。 状态码： 400 表23 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表24 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI GET /v3/{project_id}/instances/{instance_id}/get-instance-health-report 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 是 String 任务ID。

请求示例 获取数据库列表。 GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/fa7d0b6e40704cd48facf9889d6e745bin01/space-analysis?datastore_type=MySQL&object_type=database&show_instance_info=true&offset=0&limit=100 获取表列表。 GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/fa7d0b6e40704cd48facf9889d6e745bin01/space-analysis?datastore_type=MySQL&object_type=table&database_id=24937&show_instance_info=false&offset=0&limit=100

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Long 记录总数 db_objects Array of DbObjectSpaceInfo objects 数据库对象列表 instance_info InstanceSpaceInfo object 实例空间信息。数据来源于文件系统。已用空间包含数据空间、日志空间和其他空间，其他空间包括引擎产生的临时文件等。 表5 DbObjectSpaceInfo 参数 参数类型 描述 object_type String 对象类型，如果是table，同时需要传database_id 枚举值： database table object_name String 对象名称 object_id String 对象ID used_size Long 已使用空间，以字节为单位 data_size Long 数据空间，以字节为单位 index_size Long 索引空间，以字节为单位 estimated_rows Long 估算值行数，以字节为单位 表6 InstanceSpaceInfo 参数 参数类型 描述 total_size Long 实例总空间，以字节为单位。TaurusDB不会返回总空间。 used_size Long 已使用空间，以字节为单位 data_size Long 数据空间，以字节为单位 log_size Long 日志空间，以字节为单位 avg_daily_growth Long 近七日的数据平均日增长量，以字节为单位 last_result_time Long 最后一次分析的结果时间，毫秒单位时间戳 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

响应示例 状态码： 200 Success. { "db_objects" : [ { "object_type" : "database", "object_name" : "db_01", "object_id" : "24937", "used_size" : 171687936, "data_size" : 129646592, "index_size" : 38895616 }, { "object_type" : "database", "object_name" : "test_db", "object_id" : "24936", "used_size" : 84574208, "data_size" : 41484288, "index_size" : 38895616 } ], "total" : 2, "instance_info" : { "total_size" : 42949672960, "used_size" : 2635862016, "data_size" : 256262144, "log_size" : 2100001252, "avg_daily_growth" : 86016, "last_result_time" : 1615323657065 } }

URI GET /v3/{project_id}/instances/{instance_id}/space-analysis 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 object_type 是 String 对象类型 缺省值：database 枚举值： database table database_id 否 String 数据库ID offset 否 String 偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。offset必须是limit的整数倍。 缺省值：0 limit 否 String 查询记录数。默认为100，不能为负数，最小值为1，最大值为100。 缺省值：100 show_instance_info 否 String 是否返回实例级别数据，取值：true或者false 缺省值：true datastore_type 是 String 引擎类型 枚举值： MySQL TaurusDB SQLServer

上传数据方式 在开始执行分析作业前，请先上传待分析的原始数据。不同的上传方法对数据大小要求不同，您可以参考表 上传数据方式选择相应的数据上传方式。 表1 上传数据方式 上传数据方式 说明 “数据”页面上传 通过“数据”页面上传数据，支持上传最大为1GB的单个文件。 数据上传方法请参见“数据”页面上传。 使用命令行工具上传 命令行工具（eihealth-toolkit）配套 EIHealth 平台，提供数据、应用、流程和作业资源的管理和使用，支持上传最大为48.8TB的单个文件。 数据上传方法请参见命令行工具概述。

使用须知 仅支持MySQL InnoDB引擎。 仅支持select/insert/update/delete语句诊断，其中insert必须带select子句。 暂不支持查询information_schema、test、mysql。 暂不支持使用视图的语句。 SQL诊断功能会获取相关表结构和数据分布信息（非原始数据），该信息仅用于诊断逻辑，不会存储到DAS服务器。 获取表结构和数据分布信息的过程中，可能会对实例带来额外负载，但对性能影响甚微。 SQL诊断历史是唯一存储在DAS服务器上的数据，如果执行删除操作后，也将彻底从服务器上删除。 格式化用于提高SQL语句易读性，只是转换SQL语句的显示形式，不会修改SQL的执行逻辑和语义。 格式化是对整个SQL窗口内所有SQL语句进行格式化，暂不支持选中多条语句中的某一条进行格式化。

前提条件 TaurusDB5.6的内核版本要大于等于5.6.43.3，5.7的内核版本要大于等于5.7.25.3。 不支持E CS 自建库，不支持创建中、冻结、异常实例。 请务必在紧急情况下使用该功能，您的Kill操作将会以日志的形式被记录下来。 当您的实例能够通过DAS正常登录时，请勿使用该功能，您可以登录实例，通过实时会话功能执行相关操作。 rdsadmin、rdsbackup、rdsmetric、rdsRepl等敏感用户的会话禁止Kill。 当CPU或者连接数打满的情况下，kill会话请求有一定概率会下发超时，此时请重新下发kill会话请求。

使用须知 仅支持MySQL InnoDB引擎。 仅支持select/insert/update/delete语句诊断，其中insert必须带select子句。 暂不支持查询information_schema、test、mysql。 暂不支持使用视图的语句。 SQL诊断功能会获取相关表结构和数据分布信息（非原始数据），该信息仅用于诊断逻辑，不会存储到DAS服务器。 获取表结构和数据分布信息的过程中，可能会对实例带来额外负载，但对性能影响甚微。 SQL诊断历史是唯一存储在DAS服务器上的数据，如果执行删除操作后，也将彻底从服务器上删除。 格式化用于提高SQL语句易读性，只是转换SQL语句的显示形式，不会修改SQL的执行逻辑和语义。 格式化是对整个SQL窗口内所有SQL语句进行格式化，暂不支持选中多条语句中的某一条进行格式化。