本技能是阿里云 AnalyticDB for MySQL(ADB MySQL)的运维诊断助手,通过内置脚本 scripts/call_adb_api.py 与 ADB MySQL OpenAPI 交互,获取实时数据并给出诊断建议。
主要能力:集群管理(集群列表、详情、存储空间、账号、网络);性能监控(CPU、QPS、RT、内存、连接数等指标);慢查询诊断(BadSQL 检测、SQL Pattern 分析、定位慢查询根因);运行中 SQL 分析(查看当前执行 SQL、定位长耗时查询);空间诊断(分区合理性、过大非分区表、数据倾斜、复制表合理性、主键合理性、空闲索引与冷热表优化建议);SQL 执行(需配置数据库连接信息)。
使用方式:命令格式为 uv run ./scripts/call_adb_api.py <子命令> [参数]。常用子命令包括 describe_db_clusters、describe_db_cluster_attribute、describe_db_cluster_performance、describe_db_cluster_space_summary、describe_diagnosis_records、describe_bad_sql_detection、describe_sql_patterns、describe_table_statistics、describe_available_advices、describe_excessive_primary_keys、describe_oversize_non_partition_table_infos、describe_table_partition_diagnose、describe_inclined_tables、execute_sql、get_current_utc_time。通用参数有 --region(默认 cn-hangzhou)、--cluster-id(如 amv-xxx)、--start-time、--end-time(ISO 8601 UTC)、--query-condition、--lang、--order、--page-number、--page-size(默认 30)。性能指标 Key 含 AnalyticDB_CPU、QPS、QueryRT、QueryWaitTime、Connections、DiskUsedRatio 等。
环境变量:ALIBABA_CLOUD_ACCESS_KEY_ID / SECRET 为 OpenAPI 必填,可选 STS Token;execute_sql 需 ADB_MYSQL_HOST、PORT、USER、PASSWORD、DATABASE 等。结果以格式化 JSON 输出到 stdout。
限制与提醒:ADB MySQL 是云原生 OLAP 分析型数据库,列存、MPP 存算分离,与 MySQL 有本质区别,回答问题时不应以 MySQL 知识替代,需参考官方文档。时间参数需自行计算 UTC 范围,未指定时默认最近 1 小时。需具备阿里云访问凭证及相应权限;执行 SQL 需配置数据库连接。官方未提供价格与收费信息。