Snowflake Cortex Analyst

基于 Snowflake 语义视图把业务问题转成 SQL 查询

基于 Snowflake 语义视图把业务问题转成 SQL 查询

产品定位

Cortex Analyst 适合需要把自然语言数据问答嵌入自有产品或企业分析流程的团队。它不是一个能自动理解任意数据库的独立聊天应用:开发团队需要准备 Snowflake 中的数据对象及语义层,配置授权角色,再通过 API 发送问题并处理文本、SQL 或澄清建议。Snowflake 支持语义视图,也继续支持旧式语义模型 YAML;官方建议新项目采用语义视图,并在文档中建议转向 Cortex Agents。Cortex Analyst 与 Cortex Agents 是不同的产品入口和计费路径,不应视为同一个应用。

提供方: Snowflake

适合用户

  • 希望让业务用户用自然语言查询 Snowflake 结构化数据的分析团队
  • 负责维护语义视图、指标定义和数据权限的数据工程师或分析工程师
  • 希望把 text-to-SQL 能力集成到自有分析产品中的开发者
  • 需要用已验证问题持续评估 SQL 生成效果的数据治理与质量团队

不适合

  • 没有 Snowflake 数据环境、只需要分析个人文件的用户
  • 希望无需配置语义模型、权限和校验就直接对任意数据库提问的团队

功能亮点

  • 把自然语言问题转成 SQL

    围绕已配置的语义模型或语义视图生成 SQL;API 返回可供应用处理的说明和查询内容,含糊问题可能需要澄清,生成结果应按业务风险验证。

  • 用业务语义定义指标与字段

    语义层为表、列和业务指标补充名称及含义,帮助系统按组织的业务语言理解提问;Snowflake 建议新实现使用语义视图,旧式 YAML 语义模型仍可用于兼容场景。

  • 通过 REST API 接入分析产品

    应用可调用 Cortex Analyst REST API,提交问题及语义视图或模型引用,并展示其文本、SQL 或建议响应;调用方需要处理身份验证、角色权限和多轮会话状态。

  • 支持多轮与流式交互

    API 支持基于前序问题的多轮对话,也可以流式返回处理中状态和内容片段,便于集成方更早呈现结果;客户端需按事件类型处理响应。

  • 用已验证查询评估语义定义

    团队可将自然语言问题及预期 SQL 作为验证集,评估生成查询并观察准确性回归与延迟,再据此改进语义视图。评测结果不等于对所有真实问题的正确性保证。

使用步骤

搭建自然语言业务指标查询入口

  1. 在 Snowflake 中确认要开放的数据表、业务指标和可访问角色
  2. 为新实现建立语义视图并描述关键维度、度量和业务术语
  3. 通过有权限的角色调用 Cortex Analyst API,提交用户问题与语义视图引用
  4. 在应用中处理解释、SQL 或澄清建议,并按权限执行或呈现查询结果
  5. 抽查生成 SQL 是否符合业务口径,再将常见问法纳入后续验证集

评估并迭代语义视图

  1. 收集具有代表性的业务问题及其正确 SQL,建立已验证查询集
  2. 针对目标语义视图运行 Cortex Analyst 评估
  3. 检查生成 SQL 的正确性、失败样例和延迟指标
  4. 修订语义定义或验证用例,并重新运行评估确认没有回归
  5. 按团队发布流程更新分析应用中的语义定义

适用场景

让业务团队查询经营指标

需要查看收入、订单或客户等指标的业务分析团队

将经过定义的指标和维度暴露在语义视图中,让业务人员以日常语言询问趋势或分组结果;重要决策仍应查看 SQL、口径定义和数据时效。

在内部分析产品中嵌入数据问答

构建数据产品、分析门户或运营工作台的开发团队

通过 REST API 将自然语言问题接入自有界面,由应用控制用户身份、Snowflake 角色、结果展示和安全策略,而不是直接暴露数据库访问凭证。

验证业务语义层对常见问题的覆盖

维护语义视图和指标治理的数据团队

把常见业务问题与正确 SQL 组合成测试集,检查语义视图更新后是否仍能生成符合预期的查询,并持续发现定义缺漏。

访问与价格

可用状态: 当前可用

价格信息: 按量计费

支持平台: API

价格说明: Snowflake 当前文档将 Cortex Analyst API 列为旧式 Platform Credit 计费;通过 Cortex Agents 调用则按 AI Credits 计费。具体消耗、模型费率和相关 Snowflake 计算资源费用随使用量而变,请以当前服务消费表和账户用量为准。

官方入口

常见问题

Cortex Analyst 能直接理解任意 Snowflake 表吗?

不应这样假设。请求需要提供语义模型、语义视图或其引用;语义层和角色权限决定系统如何解释业务术语及可访问的数据。新实现优先考虑语义视图。

Cortex Analyst 和 Cortex Agents 是同一个产品吗?

不是同一个产品入口。Cortex Analyst 提供自然语言到数据查询的能力;Snowflake 文档目前建议新实现考虑 Cortex Agents,并说明其支持 Cortex Analyst 的能力。本文仍单独介绍 Cortex Analyst,避免把不同的构建和计费方式混为一谈。

Cortex Analyst 如何计费?

Snowflake 当前计费文档将 Cortex Analyst API 列为旧式 Platform Credit 计费;通过 Cortex Agents 调用时按 AI Credits 计费。最终费用取决于调用路径、实际使用量和账户配置,应查看当前服务消费表。

来源核验

资料核验于 2026-10-06