跳到主要内容
版本：Stable-3.1

中间结果落盘

本文介绍如何将大算子的中间计算结果落盘 (Spill to disk)。

概述​

对于依靠内存计算处理查询的数据库系统，例如 StarRocks，它们在大数据集上处理聚合、排序以及连接等运算时，会消耗大量内存资源。当达到内存限制时，这些查询将被强制终止。

但在某些场景下，您可能希望使用有限的内存资源稳定地完成某些任务，甚至愿意为此牺牲部分性能，例如，构建物化视图或使用 INSERT INTO SELECT 执行轻量级 ETL。这类任务会大量消耗内存资源，进而阻塞集群中运行的其他查询。通常，您需要通过手动调整参数解决这个问题，并且依靠集群资源隔离策略来控制查询并发。这种方式不仅较为不便，并且在极端情况下，可能依然会失败。

从 v3.0.1 开始，StarRocks 支持将一些大算子的中间结果落盘。 使用此功能，您可以在牺牲一部分性能的前提下，大幅降低大规模数据查询上的内存消耗，进而提高整个系统的可用性。

目前，StarRocks 支持将以下算子的中间结果落盘：

  • 聚合算子
  • 排序算子
  • Hash join（LEFT JOIN、RIGHT JOIN、FULL JOIN、OUTER JOIN、SEMI JOIN 以及 INNER JOIN）算子

开启中间结果落盘​

根据以下步骤开启中间结果落盘：

  1. 在 BE 配置文件 be.conf 中指定落盘路径 spill_local_storage_dir，并重启集群使修改生效。

    spill_local_storage_dir=/<dir_1>[;/<dir_2>]

    说明

    • 您可以指定多个落盘路径 spill_local_storage_dir，中间使用分号（;）分隔。
    • 在生产环境中，我们强烈建议您为数据存储和中间结果落盘使用不同的磁盘。当中间结果落盘时，写入负载和磁盘使用量可能会显著增加。如果使用相同的磁盘，这种激增会影响集群中运行的其他查询或任务。

  2. 执行以下语句开启中间结果落盘：

    SET enable_spill = true;

  3. 通过 Session 变量 spill_mode 设定中间结果落盘模式：

    SET spill_mode = { "auto" | "force" };

    说明

    每个涉及中间结果落盘的查询在完成后，StarRocks 会自动清除其产生的落盘数据。如果 BE 在清除数据之前崩溃导致数据残留，StarRocks 会在 BE 重新启动时清除落盘数据。

    变量默认值描述
    enable_spillfalse是否启用中间结果落盘。如果将其设置为 true，StarRocks 会将中间结果落盘，以减少在查询中处理聚合、排序或连接算子时的内存使用量。
    spill_modeauto中间结果落盘的执行方式。有效值：auto：达到内存使用阈值时，会自动触发落盘。force：无论内存使用情况如何，StarRocks 都会强制落盘所有相关算子的中间结果。此变量仅在变量 enable_spill 设置为 true 时生效。

使用限制​

  • 中间结果落盘无法解决所有内存不足问题。例如，StarRocks 无法释放用于表达式计算的内存。
  • 通常，涉及中间结果落盘的查询可能表明其查询时间有数量级的增长。建议您通过设置 Session 变量 query_timeout 适当延长这些查询的超时时间。