SQL WebSocket消息与会话¶
GET /query/ws,共享工作区解析允许workspace_id查询或X-Workspace-ID头,二者须一致且不能重复/首尾空白。共享产品凭据子协议可传moi-api-key/moi-bearer,身份验证后只回显协议名,凭据不放URL。此handler没有调用看板的额外Origin校验函数;实际代理和来源策略待环境验证,不直接判定生产漏洞。
建立连接后RunInteractive开启专用actor数据库会话,SQL执行复用该连接;取消在独立actor会话根据拥有的query_id和连接ID执行,再CAS更新killed。不能把看板WS的每业务消息独立授权上下文规则套在这里;
请求message_type |
data |
响应 |
|---|---|---|
ping |
无 |
pong,回显消息id |
query_execute |
与run-query相同参数 |
先query_id,后query_result |
query_kill |
query_id,非statement_id |
query_kill ACK,回显取消请求id |
preclose |
无 |
结束连接 |
顶层id用于消息关联,query_id响应的data.id也是消息id,而data.query_id是保存执行记录ID;query_result携带真实操作/语句ID和状态。成功/失败都可能在query_result中返回,前端需检查status/err_msg。
开始前校验或取消失败等error消息只有data.err字符串,没有看板WS的status/code/msg结构。外层只有id、message_type、可选data,无HTTP code/data封套。服务端对非法JSON或未知类型可静默忽略,未应用看板的128字节id或单在途409规则。多个执行消息可交给同一数据库连接,不能据此承诺SQL真正并行、乱序安全或按id去重。
断线结束数据库会话与请求上下文,但不代表所有已执行写入撤销。取消ACK后仍查同一query_id的状态,不将前端kill Promise完成等同数据库已经取消。前端当前对error消息没有显式case,execute等待query_result(30秒),kill超时10秒也resolve;
Go SDK连接/收发支持上下文deadline,Python receive可设并恢复timeout;二者提供query_execute/query_kill/ping/receive。CLI connect-query-web-socket只握手、输出协议并关闭,无查询帧;query-web-socket-url仅构造URL。不得据名称写成完整CLI交互终端。