需提供数据库元信息、结构化指令、建表语句、分步验证及API schema参数，才能实现自然语言驱动的可执行SQL、图表与结论生成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望用自然语言与通义千问交互完成数据分析全流程，但实际操作中无法生成可执行SQL、图表或分析结论，则可能是由于提问方式不规范、缺失数据库上下文或未明确输出格式要求。以下是实现对话式数据分析的具体操作路径：
一、提供完整数据库元信息
通义千问无法自动感知用户本地或远程数据库的表结构，必须由用户显式声明基础元数据，才能生成合规SQL并支撑后续图表生成。缺失该信息将导致字段引用错误、JOIN条件失效或聚合逻辑偏差。
1、在首次提问时明确写出目标数据库的全部表名与各字段名称及类型，例如：“用户表user包含字段id（主键）、name（VARCHAR）、reg_date（DATE）、level（TINYINT）；订单表order包含字段id（主键）、user_id（外键）、amount（DECIMAL）、status（VARCHAR）、create_time（DATETIME）”。
2、标注关键约束关系，例如：“user.id与order.user_id构成一对多关系，status取值为‘paid’‘cancelled’‘pending’”。
3、说明业务语义规则，例如：“VIP用户指level大于等于3的用户，最近一周指create_time >= DATE_SUB(NOW(), INTERVAL 7 DAY)”。
二、使用结构化指令格式提问
自然语言混杂多重条件易引发歧义，应采用分项陈述方式限定查询意图，使模型能逐条解析执行逻辑，并据此生成对应SQL、数据表格与图表描述。
1、以“查询目标”开头，说明最终需要返回的字段或聚合结果，例如：“查询目标：返回VIP用户的姓名、总下单金额、订单笔数、最近一笔订单时间”。
2、用“筛选条件”单独列出WHERE或HAVING约束，例如：“筛选条件：订单状态为‘paid’，下单时间在2026年之后，且用户注册时间早于2025年”。
3、用“分组排序”说明GROUP BY和ORDER BY需求，例如：“分组排序：按用户名分组，按总金额降序排列，仅取前10名”。
4、用“图表要求”声明可视化形式，例如：“图表要求：生成柱状图展示前10名VIP用户的总金额对比，X轴为姓名，Y轴为金额，标题为‘2026年VIP用户消费TOP10’”。
三、嵌入建表语句增强上下文理解
在连续对话中，可先发送真实DDL语句作为上下文输入，再提出查询需求，使模型基于确切的表结构推导合法字段引用路径，显著降低列名误写、函数误用或语法不兼容风险。
1、复制粘贴MySQL或PostgreSQL建表语句至对话首条消息，例如：“CREATE TABLE user (id VARCHAR(20) PRIMARY KEY, name VARCHAR(50), reg_date DATE, level TINYINT); CREATE TABLE order (id BIGINT PRIMARY KEY, user_id VARCHAR(20), amount DECIMAL(10,2), status VARCHAR(20), create_time DATETIME); ALTER TABLE order ADD FOREIGN KEY (user_id) REFERENCES user(id);”。
2、紧接第二条消息提出自然语言查询，例如：“请统计每个VIP用户的订单总金额和平均订单金额，并生成饼图显示各用户金额占比”。
3、确认模型返回的SQL中所有字段均存在于前述DDL定义内，且函数调用符合目标数据库版本规范，例如MySQL 8.0支持窗口函数，而旧版本需改写为子查询。
四、验证并拆解生成内容分步执行
通义千问输出内容通常包含SQL语句、模拟数据表格与图表描述文本三部分，需人工校验其一致性与可执行性，避免因AI幻觉导致逻辑断裂或格式错位。
1、提取生成的SQL，在Navicat或DBeaver中执行验证，检查是否返回预期字段与行数，特别注意日期函数、字符串截取函数与目标数据库引擎是否兼容。
2、将SQL执行结果整理为标准CSV格式，确保列名与模型生成的表格头完全一致，列顺序必须严格匹配，否则图表工具无法正确映射数据源。
3、依据模型输出的图表描述文本，在ECharts、Excel或QuickSight中手动配置可视化组件，重点核对坐标轴字段、聚合方式（SUM/COUNT/AVG）、分类维度是否与原始SQL GROUP BY逻辑一致。
五、启用API调用并传入schema参数
当集成至Spring Boot等后端系统时，需通过API请求体显式注入数据库schema信息，而非依赖对话历史，确保每次请求具备独立可复现的元数据上下文。
1、构造JSON请求体，包含prompt字段与schema字段，其中schema为JSON数组，每项含table_name、columns（含name/type/is_primary_key/is_foreign_key）、relationships。
2、调用通义千问Text2SQL专用API端点，例如POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2sql，必须设置Content-Type为application/json并携带有效的API-KEY认证头。
3、解析返回JSON中的sql、data（二维数组）、chart_type、chart_config字段，分别注入到JDBC执行器、前端表格组件与ECharts初始化配置中。
