sql-to-docSQL转文档

功能

1. 1. 连接 MaxCompute/DataWorks 执行 SQL 查询
2. 按照 Jinja2 模板格式整理数据
3. 在飞书知识库或云空间中创建文档
4. 返回文档链接

使用场景

• - 定期数据周报自动生成
• 业务数据汇总统计
• 一次性数据查询并生成报告
• 将 SQL 结果导出为可读文档

配置参数

参数	说明	示例
sqlquery	要执行的 SQL 语句	SELECT * FROM tablename WHERE ...
template

数据整理模板（Jinja2格式） | 详见下方模板语法 |

模板语法

jinja

{{ title }}

数据汇总

| 指标 | 数值 | 环比 |
|------|------|------|
{% for row in data %}
| {{ row.indicator }} | {{ row.value }} | {{ row.change }} |
{% endfor %}

详细数据

{{ data_table }}

使用方式

1. 简单查询

帮我执行 SQL：SELECT * FROM wosaihzbi.adssqbcomprehensivebusinessdatastatisticsw
并把结果写入文档

2. 带模板的数据整理

查询 wosaihzbi.adssqbcomprehensivebusinessdatastatisticsw 近五周数据，
按照收钱吧周报格式整理，写入知识库

3. 完整参数指定

执行 SQL: SELECT statweek, totaltrans_cnt FROM table
模板：按周汇总表格
文档标题：交易周报
目标：知识库 space_id=7396876397862764545, node=Dv3YwcsXEimpeokAORkc7K8fnhh

执行流程

1. 1. SQL 执行：使用 maxcompute 连接查询数据
2. 数据处理：将 SQL 结果转换为 Python 对象（列表/字典）
3. 模板渲染：使用 Jinja2 渲染模板 + 数据
4. 文档创建：调用 feishucreatedoc 创建云文档
5. 通知用户（可选）：发送文档链接给指定用户

输出

• - 飞书云文档链接
• 文档创建状态

相关工具

• - maxcompute SQL 执行（通过 exec 调用 DataWorks OpenAPI）
• feishucreatedoc - 创建云文档
• feishuimuser_message - 发送通知