SQL Server通过存储过程实现飞书消息卡片推送

原创于 2025-07-09 16:44:22 发布 · 222 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#飞书

一、背景与需求场景

企业内部系统与飞书协作平台深度集成已成为数字化转型的关键环节。SQL Server作为核心业务数据库，常需主动触发业务事件通知，例如：

库存预警阈值突破时实时通知采购团队
订单状态变更时同步至跨部门协作群
系统定时任务执行结果反馈

飞书消息卡片相比普通文本消息具备显著优势：

交互能力：支持按钮响应、表单提交等操作
富文本展示：可嵌入表格、进度条、时间戳等元素
结构化数据：通过JSON模板实现动态数据绑定

二、技术架构与核心组件

系统架构图

graph LR
A[SQL Server] -->|触发事件| B(存储过程)
B -->|HTTP请求| C[飞书Webhook]
C -->|推送| D[飞书客户端]

核心组件说明

组件	作用
SQL存储过程	业务逻辑入口与消息触发引擎
sp_OACreate组件	发起HTTP请求的COM接口
飞书机器人Webhook	消息接收端点（需企业管理员配置）
JSON消息模板	卡片动态渲染的骨架结构

三、实现步骤详解

3.1 存储过程内调用HTTP请求

完整实现代码：

CREATE PROCEDURE dbo.SendFeishuCard
    @Title NVARCHAR(100),
    @Content NVARCHAR(500)
AS
BEGIN
    DECLARE @url NVARCHAR(500) = 'https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_TOKEN';
    DECLARE @json NVARCHAR(MAX);
    
    -- 构建基础卡片JSON
    SET @json = N'{
        "msg_type": "interactive",
        "card": {
            "header": {
                "title": {
                    "tag": "plain_text",
                    "content": "' + @Title + '"
                }
            },
            "elements": [
                {
                    "tag": "div",
                    "text": {
                        "tag": "lark_md",
                        "content": "' + @Content + '"
                    }
                },
                {
                    "tag": "action",
                    "actions": [
                        {
                            "tag": "button",
                            "text": "查看详情",
                            "type": "primary",
                            "url": "https://your-system.com"
                        }
                    ]
                }
            ]
        }
    }';
    
    -- 发起HTTP请求
    DECLARE @obj INT, @status INT;
    EXEC sp_OACreate 'MSXML2.ServerXMLHTTP', @obj OUT;
    EXEC sp_OAMethod @obj, 'Open', NULL, 'POST', @url, false;
    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Type', 'application/json';
    EXEC sp_OAMethod @obj, 'send', NULL, @json;
    EXEC sp_OAGetProperty @obj, 'status', @status OUT;
    
    -- 记录日志
    INSERT INTO MessageLog (Status, ResponseTime) 
    VALUES (@status, GETDATE());
    
    EXEC sp_OADestroy @obj;
END

3.2 动态生成消息卡片JSON

数据绑定示例（使用FOR JSON PATH）

DECLARE @json NVARCHAR(MAX) = (
    SELECT 
        '库存预警通知' AS 'card.header.title.content',
        (
            SELECT 
                CONCAT('**产品**: ', ProductName, '\n', 
                       '**当前库存**: ', StockQty) AS 'content'
            FROM Inventory 
            WHERE StockQty < AlertThreshold
            FOR JSON PATH
        ) AS 'card.elements[0].text.content'
    FOR JSON PATH, WITHOUT_ARRAY_WRAPPER
);

卡片关键字段说明

{
  "header": { /* 标题区 */ },
  "elements": [  // 内容区块
    { "tag": "div" },      // 文本容器
    { "tag": "hr" },       // 分隔线
    { "tag": "note" }      // 备注信息
  ],
  "actions": [   // 交互按钮
    { 
      "tag": "button", 
      "url": "https://callback.link" 
    }
  ]
}

3.3 错误处理与日志记录

增强型错误处理代码：

BEGIN TRY
    EXEC sp_OAMethod @obj, 'send', NULL, @json;
    EXEC sp_OAGetProperty @obj, 'status', @status OUT;
    
    IF @status <> 200
        RAISERROR('HTTP请求失败: %d', 16, 1, @status);
END TRY
BEGIN CATCH
    INSERT INTO ErrorLog (ErrorMsg, ErrorTime)
    VALUES (ERROR_MESSAGE(), GETDATE());
    
    -- 重试机制
    EXEC dbo.RetrySendFeishu @json, 3; 
END CATCH

四、安全与权限配置

安全实施要点

密钥管理

-- 从加密表获取Token
DECLARE @token NVARCHAR(100) = dbo.GetDecryptedKey('FeishuBot');
SET @url = CONCAT('https://open.feishu.cn/hook/', @token);

网络层防护
- 在飞书控制台配置SQL Server公网IP白名单
- 启用HTTPS证书双向验证（需导入CA证书到SQL Server）

权限最小化原则

GRANT EXEC ON dbo.SendFeishuCard TO [AlertRole];
DENY ALTER ANY DATABASE TO PUBLIC;

五、扩展场景与优化

5.1 定时任务集成
通过SQL Agent定期触发：

EXEC msdb.dbo.sp_add_jobstep
    @job_name = 'DailyInventoryAlert',
    @step_name = 'SendFeishuNotification',
    @subsystem = 'TSQL',
    @command = 'EXEC dbo.SendFeishuCard 
        @Title=''每日库存报告'', 
        @Content=(SELECT * FROM InventoryReport FOR JSON AUTO)';

5.2 批量推送性能优化
异步处理架构：

sequenceDiagram
    SQL Server->>消息队列: 写入待发送消息
    消息队列->>Worker服务: 拉取消息
    Worker服务->>飞书API: 并行发送

5.3 用户响应回调处理
飞书事件订阅配置：

# Python回调服务示例（需独立部署）
@app.route('/feishu-callback', methods=['POST'])
def handle_action():
    action = request.json['action']['value']
    if action == 'approve':
        UpdateOrderStatus(request.json['order_id'])