# 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交互终端。
