Superset SQL Lab 长查询默认 6 小时被终止怎么解决配置 SQLLAB_ASYNC_TIME_LIMIT_SEC【免费下载链接】supersetApache Superset is a Data Visualization and Data Exploration Platform项目地址: https://gitcode.com/gh_mirrors/supers/superset在 Apache Superset 的 SQL Lab 中运行一条耗时很长的 SQL 时查询执行到一定时间后会被强制终止界面上报错The query was killed after N seconds. It might be too complex, or the database might be under heavy load.这是 Celery 对 SQL Lab 异步查询任务的时限保护默认最长允许运行 6 小时超过后查询被 kill。本文解决的问题是确认你的超时属于这一类并通过SQLLAB_ASYNC_TIME_LIMIT_SEC在配置文件中把时限调大到你的查询能跑完为止。先确认是 Celery 查询时限触发的终止Superset 里与“超时”相关的配置不止一个先区分清楚避免改错项配置默认值作用出处SQLLAB_ASYNC_TIME_LIMIT_SEC6 小时int(timedelta(hours6).total_seconds())SQL Lab 查询被 Celery kill 前的最大运行时长superset/config.py#L1033-L1034SQLLAB_TIMEOUT30 秒SQL Lab 同步查询的超时时长superset/config.py#L1024-L1025官方 FAQ 对这一现象的说明是SQL Lab 长查询默认最多运行 6 小时之后会被 Celery kill如果想让查询运行更久需要在配置中指定超时时间FAQWhy are my queries timing out?。机制上superset/sql_lab.py 把这个配置直接用作 Celery 任务的时限# superset/sql_lab.py SQLLAB_TIMEOUT config[SQLLAB_ASYNC_TIME_LIMIT_SEC] SQLLAB_HARD_TIMEOUT SQLLAB_TIMEOUT 60 celery_app.task( namesql_lab.get_sql_results, time_limitSQLLAB_HARD_TIMEOUT, # 硬时限soft 时限 60 秒 soft_time_limitSQLLAB_TIMEOUT, # 软时限到点抛出 SoftTimeLimitExceeded ) def get_sql_results(...): ...即达到SQLLAB_ASYNC_TIME_LIMIT_SEC时任务抛出SoftTimeLimitExceeded查询状态被置为TIMED_OUT并向前端返回上文那段 “killed after N seconds” 的错误再加上 60 秒后是 Celery 的硬 kill 兜底superset/sql_lab.py#L74-L75、superset/sql_lab.py#L162-L166、superset/sql_lab.py#L302-L317。所以判断标准很简单如果你的报错正是 “The query was killed after N seconds”且 N 接近你环境里配置的时限默认 21600 秒那就是本场景要解决的问题。不要和 504 Gateway Time-out 混淆。FAQ 指出加载 dashboard 或 explore 时出现 504通常是请求经过了 Nginx 等网关/代理Superset 未在客户端超时默认 60 秒SUPERSET_WEBSERVER_TIMEOUT内返回响应由网关直接向客户端回了 504。这是代理层问题改SQLLAB_ASYNC_TIME_LIMIT_SEC解决不了它docs/docs/faq.mdx。在 superset_config.py 中配置 SQLLAB_ASYNC_TIME_LIMIT_SEC按 Superset 的自定义配置方式Configuring Superset不要改动核心的superset/config.py而是创建自己的配置模块superset_config.py只覆盖需要改的参数。在superset_config.py中写入单位为秒SQLLAB_ASYNC_TIME_LIMIT_SEC 60 * 60 * 6上面的写法来自官方 FAQ 的示例注意60 * 60 * 6恰好等于默认值 6 小时你的目标是把时限“调大”所以这里的数值要按你的查询实际耗时取一个更大的值例如希望 12 小时就写60 * 60 * 12。配置文件的生效方式取决于你的部署形态直接部署在 Linux 上把superset_config.py加入PYTHONPATH或设置环境变量指向完整路径export SUPERSET_CONFIG_PATH/app/superset_config.py基于官方镜像的自定义 DockerfileCOPY --chownsuperset superset_config.py /app/ ENV SUPERSET_CONFIG_PATH /app/superset_config.pyDocker Compose 开发部署在docker/pythonpath_dev/superset_config_docker.py中提供配置该文件被 git 忽略避免误提交本地配置机制见docker/pythonpath_dev/superset_config.py中的from superset_config_docker import *docs/docs/installation/docker-compose.mdx。验证配置是否生效配置在进程启动时加载修改后重启 Superset以及处理 SQL Lab 查询的 worker 进程使新配置生效然后重新执行之前被 kill 的那条长查询成功条件查询在原来的时限点附近没有被终止不再出现 “The query was killed after N seconds” 报错正常返回结果。若仍然在旧时限点被 kill说明改的配置没有加载到新启动的进程中——先确认实际运行的进程加载的确实是你的superset_config.py例如检查SUPERSET_CONFIG_PATH是否已导出、Docker 容器内文件是否已复制进去。两点限制需要留意调大SQLLAB_ASYNC_TIME_LIMIT_SEC只是放宽 Superset 侧的 kill 时限查询本身能否跑完仍取决于底层数据库的执行能力。FAQ 也提醒如果查询慢应当去调优你的数据仓库而不是无限拉长超时。如果你的现象其实是网关 504dashboard/explore 加载时应改SUPERSET_WEBSERVER_TIMEOUT示例SUPERSET_WEBSERVER_TIMEOUT 60并核对代理层的超时设置而不是动 Celery 时限。【免费下载链接】supersetApache Superset is a Data Visualization and Data Exploration Platform项目地址: https://gitcode.com/gh_mirrors/supers/superset创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
