CodeGeeX支持五种自然语言转SQL路径：一、问答模式快速生成；二、代码注释触发低侵入式生成；三、上传DDL实现上下文感知生成；四、Excel数据源虚拟查询；五、CLI工具批量生成带注释的SQL脚本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将自然语言描述的查询需求快速转化为可执行的SQL语句，CodeGeeX可通过多种交互方式直接生成结构正确、安全合规的SQL代码。以下是实现该目标的具体路径：
一、在问答模式中输入自然语言指令生成SQL
此方法适用于快速验证单条查询逻辑，无需编写完整脚本，CodeGeeX会基于上下文理解业务意图并输出标准SQL语句。
1、打开VS Code或JetBrains IDE，确保已安装并登录CodeGeeX插件。
2、按下快捷键Ctrl+Shift+I（Windows/Linux）或Cmd+Shift+I（Mac）唤出「Ask CodeGeeX」侧边栏。
3、在输入框中键入中文指令，例如：“查询用户表中年龄大于25且注册时间在2024年之后的所有姓名和邮箱”。
4、点击发送或按Enter，等待模型返回SQL语句，确认其包含WHERE条件、日期函数及字段别名等要素。
二、在代码编辑区通过注释触发SQL生成
该方式将自然语言嵌入开发流程，在已有项目中实现低侵入式SQL构建，生成结果可直接复制粘贴至执行环境。
1、在Python或JavaScript文件中新建一行，输入以#开头的注释，例如：# 找出订单金额最高的前10个客户ID和总消费额。
2、将光标置于该行末尾，按下Alt+Enter（Windows/Linux）或Option+Enter（Mac）调用代码建议。
3、从弹出列表中选择CodeGeeX生成的SQL片段，检查是否使用GROUP BY与ORDER BY组合，并避免SELECT *。
4、若需适配特定数据库方言（如MySQL的LIMIT或SQL Server的TOP），可在注释中明确说明：“生成适用于PostgreSQL的SQL”。
三、上传数据库结构后生成上下文感知SQL
当模型获知表名、字段类型与约束关系时，生成的SQL更精准，能自动规避列不存在、类型不匹配等常见错误。
1、进入CodeGeeX网页端或企业版后台，点击「数据库上下文」模块。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
2、上传DDL脚本文件（如CREATE TABLE语句集合）或粘贴建表语句文本。
3、在对话框中输入查询需求，例如：“统计每个部门的平均薪资，排除空值，并按降序排列”。
4、确认返回SQL中是否正确引用了department字段、使用AVG()聚合函数及IS NOT NULL过滤条件。
四、针对Excel数据源生成查询语句
该路径专为非技术用户设计，支持将本地Excel表格作为虚拟数据库进行自然语言查询，无需导入数据库系统。
1、访问支持自然语言查Excel的CodeGeeX集成平台（如v4-enterprise.codegeex.cn）。
2、点击「上传Excel」按钮，选择含表头的.xlsx文件，系统自动解析为临时表结构。
3、在查询框中输入：“显示销售额大于50000的产品名称和对应区域”。
4、执行后查看生成的SQL，注意其是否将Excel工作表名映射为FROM子句中的表别名，并使用双引号包裹中文列名。
五、使用CLI命令行工具批量生成SQL脚本
适用于需将多个自然语言描述批量转为SQL文件的场景，支持输出为.sql格式并保留原始注释。
1、在终端中执行安装命令：pip install codegeex-cli。
2、准备一个文本文件queries.txt，每行一条中文查询，例如：“列出近30天内下单次数超过5次的用户手机号”。
3、运行转换命令：codegeex-sql --input queries.txt --output output.sql --dialect mysql。
4、检查output.sql内容，确认每段SQL上方均附有原始中文注释，且参数占位符（如%s或?）已按目标方言插入。
