用途:通过查询数据仓库回答业务问题,适合计数、指标、趋势等需要仓库数据的分析请求。内核在首次执行调用时自动启动。
主要能力:提供 run_sql、run_sql_pandas、run_sql_many 等内核函数,分别返回 Polars DataFrame、Pandas DataFrame 或并发执行的多个结果;pl 与 pd 已预导入。run_sql_many 并发执行以提升效率,但为 fail-fast。还提供概念缓存(概念到表映射)、模式缓存(查询策略)、表结构缓存及缓存管理。
使用方式:所有命令相对于该技能目录执行。先查找缓存策略与概念映射,缓存未命中时可用 Grep 检索 SQL 或查询 INFORMATION_SCHEMA 发现表,再执行查询并在展示结果前缓存所学内容。常用命令如 uv run scripts/cli.py pattern lookup "<问题>"、uv run scripts/cli.py exec "df = run_sql('SELECT ...')"、uv run scripts/cli.py concept learn 等。
限制:exec 默认等待 120 秒后中断并返回客户端停止等待消息,查询可能仍在服务端完成,可用 -t 调整;空闲内核在 2 小时无活动后自行终止(此前保留状态),可用 ASTRO_KERNEL_IDLE_TIMEOUT 覆盖(秒,0 表示禁用)。其余细节暂未提供。