SuperAPI AI 工具集

wren-query

数据与分析

查看项目

更新于 10-15 20:10

技能介绍

用途:通过 Wren 语义 CLI 运行、试运行或校验 SQL 查询,适用于需要以 wren 语义模型访问数据源的场景。

前置检查:先确认 ~/.wren/mdl.json 与 ~/.wren/connection_info.json 是否存在;缺失时需按资料给出的格式创建。两个文件均从 ~/.wren/ 自动发现。

主要能力(按意图选命令):执行并返回结果用 uv run wren --sql '...';仅翻译为原生 SQL(不连数据库)用 uv run wren dry-plan --sql '...';不取行仅试运行用 uv run wren dry-run --sql '...';校验 SQL 是否有效用 uv run wren validate --sql '...'。若 wren 为全局安装(非 uv),直接用 wren 而非 uv run wren。

配置:mdl.json 为语义模型,可定义 catalog、schema、models(含 name、tableReference、columns、primaryKey);connection_info.json 需包含 datasource 字段及连接信息。支持的 datasource:mysql、postgres、bigquery、snowflake、clickhouse、trino、mssql、databricks、redshift、oracle、duckdb。

可覆盖参数:--mdl 指定其他模型文件、--connection-file 指定其他连接文件、--output 选择 table(默认)|csv|json、--limit 限制行数。

常见错误:缺 mdl.json 需创建 ~/.wren/mdl.json;缺 connection_info.json 需创建并含 datasource;缺 datasource 键需补齐;unknown datasource 需检查拼写;Connection refused 需确认数据库运行且 host/port 正确。

限制:资料未提供更详细的安装步骤、性能或收费信息。