如何在HeidiSQL中为Firebird设置语句超时时间？

使用HeidiSQL连接Firebird 4.0时，执行包含两次左外连接的查询后，返回错误：

SQL Error (335544794): [FireDAC][Phys][FB]operation was cancelled Statement level timeout expired

尝试通过SET STATEMENT TIMEOUT 1000 SECOND;修改语句超时时间，但该命令未生效，超时提示仍出现。完整查询语句如下：

SET STATEMENT TIMEOUT 1000 SECOND;

SELECT FIRST 100 * FROM STAGE_TABLE
LEFT OUTER JOIN DIM_TABLE ON STAGE_TABLE.ID = DIM_TABLE.ID
LEFT OUTER JOIN FACT_TABLE ON STAGE_TABLE.ID = FACT_TABLE.ID;

单独执行第一个左连接查询耗时约0.5秒，添加第二个连接后立即触发超时，怀疑HeidiSQL或Firebird未执行第一条SET命令。

• 将超时参数直接嵌入查询语句
  Firebird支持在SELECT语句中通过WITH STATEMENT TIMEOUT子句指定超时，无需单独执行SET命令，确保参数作用于当前查询：

  SELECT FIRST 100 * FROM STAGE_TABLE
  LEFT OUTER JOIN DIM_TABLE ON STAGE_TABLE.ID = DIM_TABLE.ID
  LEFT OUTER JOIN FACT_TABLE ON STAGE_TABLE.ID = FACT_TABLE.ID
  WITH STATEMENT TIMEOUT 1000; -- 单位为秒
  

• 检查HeidiSQL的语句执行方式
  确认在HeidiSQL中执行的是全部语句而非单条语句。如果只选中SELECT部分执行，前面的SET命令不会被运行，自然不会生效。可以点击HeidiSQL工具栏的“执行所有语句”按钮（或按F9），确保两条命令在同一会话中连续执行。

• 排查查询性能瓶颈
  新增第二个连接后触发超时，大概率是查询性能问题而非单纯超时设置：

  • 检查DIM_TABLE.ID和FACT_TABLE.ID是否创建了索引，无索引会导致全表扫描，大幅增加查询耗时。创建索引命令示例：

    CREATE INDEX IDX_DIM_ID ON DIM_TABLE(ID);
    CREATE INDEX IDX_FACT_ID ON FACT_TABLE(ID);
    

  • 可以通过EXPLAIN PLAN FOR前缀查看查询执行计划，确认是否存在全表扫描等低效操作：

    EXPLAIN PLAN FOR
    SELECT FIRST 100 * FROM STAGE_TABLE
    LEFT OUTER JOIN DIM_TABLE ON STAGE_TABLE.ID = DIM_TABLE.ID
    LEFT OUTER JOIN FACT_TABLE ON STAGE_TABLE.ID = FACT_TABLE.ID;
    

• 调整Firebird全局超时设置（可选）
  如果会话级设置始终不生效，可修改Firebird配置文件firebird.conf，调整全局语句超时参数：

  1. 找到StatementTimeout配置项，将其值改为1000000（单位为毫秒，对应1000秒）
  2. 重启Firebird服务使配置生效
     注意：此设置会影响所有数据库会话，仅在需要全局调整时使用。

内容的提问来源于stack exchange，提问作者Sebastian Kollmar