SHOW SEMANTIC AI_VERIFIED_QUERIES

列出语义视图中预定义的 AI 验证查询（问题 → SQL 对）。验证查询用于为 AI Agent 提供参考示例，帮助将自然语言问题映射到正确的 SQL。

语法

SHOW SEMANTIC AI_VERIFIED_QUERIES IN <semantic_view_name>; SHOW SEMANTIC AI_VERIFIED_QUERIES FROM <semantic_view_name>;

其中

IN

和

FROM

FROM

可互换使用。

说明：当前仅支持指定语义视图名称的查询，不支持跨视图列举所有 AI 验证查询。

参数说明

参数	描述
`<semantic_view_name>` <semantic_view_name>	必填。语义视图名称。支持多段标识符（如 `db.schema.view` db.schema.view ）。

输出列

列名	类型	描述
`workspace_name` workspace_name	TEXT	工作空间名称
`schema_name` schema_name	TEXT	Schema 名称
`semantic_view_name` semantic_view_name	TEXT	语义视图名称
`name` name	TEXT	验证查询名称
`question` question	TEXT	自然语言问题
`sql` sql	TEXT	对应的 SQL 查询（存储为不透明字符串，引擎不解析不执行）
`verified_at` verified_at	BIGINT	验证时间（Unix 时间戳，秒）
`onboarding_question` onboarding_question	BOOLEAN	是否为新用户引导问题
`verified_by` verified_by	TEXT	验证人

结果按

name

name

字典序排列。

使用说明

无需运行中的虚拟集群 — 该命令不需要虚拟集群即可执行。
权限控制 — 仅返回当前用户有权限访问的语义视图中的验证查询。
SQL 不执行 — 输出的 SQL 作为元数据存储，引擎不解析、不验证、不执行。供外部 AI Agent 或开发人员参考。
问题匹配 — 外部客户端可通过
```
question
```
question
字段精确匹配，取出对应的
```
sql
```
sql
字段。

权限要求

权限	对象	说明
任意权限	语义视图	至少需要对语义视图拥有一个权限

示例

列出所有 AI 验证查询

SHOW SEMANTIC AI_VERIFIED_QUERIES IN tpch_rev_analysis;

输出示例：

tianqi_ws semantic_view tpch_rev_analysis TOTAL_DISCOUNTED_PRICE What is the average order value for each year? SELECT ... 1772645863 TRUE (STEWARD = data_stewards)

使用 FROM 关键字（IN 的等价写法）

SHOW SEMANTIC AI_VERIFIED_QUERIES FROM tpch_rev_analysis;

客户端匹配问题

客户端读取输出后按问题匹配：

# 伪代码示例 rows = execute("SHOW SEMANTIC AI_VERIFIED_QUERIES IN tpch_rev_analysis") for row in rows: if row.question == "What is the average order value for each year?": sql = row.sql # 取出绑定的 SQL

查看 AI 验证查询的定义来源

-- 通过 DESC 查看 DESC SEMANTIC VIEW tpch_rev_analysis; -- 通过 SHOW CREATE 查看 DDL SHOW CREATE SEMANTIC VIEW tpch_rev_analysis;