1 概述

1.1 SQL引擎V2.0 是什么？

• SQL引擎V2.0是 数据模型引擎V2.0 下面的执行引擎。
• 它是SQL引擎V1.0的升级。

1.2 SQL引擎V2.0适合的查数场景

• ”简单“查询，比如只查询维度+度量(原子度量)。
• 指标二次计算： 指标之间的加、减、乘、除、case when、IIF等的简单加工支持走SQL引擎V2.0。
• 快速计算：在报表层使用快速计算可以走SQL引擎，比如同期值、前期值、累计值等。

1.3 SQL引擎V2.0不适合的查数场景

• 查询含有计算度量(包含mdx表达式)、计算成员、计算命名集，不支持走SQL引擎。

• 当过滤条件是度量并且显示了合计的情况，如下图，不支持走SQL引擎：
  

  
  

• 年周层次，涉及到时间的计算不支持走SQL引擎，如下图：

  

• 交叉表组件如果显示分类汇总，并且在度量、快速度量上增加了排序不支持走SQL引擎，如下图：
  

1.4 如何开启SQL引擎V2.0？

• 需要先在运维设置/系统限项/高级设置 开启SQL引擎V2.0: USE_NEW_ENGINE_NEW_SQL=true, 这个一旦开启，是全局性的，所有基于数据模型的报表查询满足条件都会走SQL引擎V2.0。
• 如果只是想要在某个数据模型中开启，可以在高级选项开启：DATAMODEL_OPEN_SMARTCUBE_ENGINE_BUTTON=true，效果如下图所示：
  

2 SQL引擎V2.0 VS V1.0的功能对比

2.1 SQL引擎V2.0 比SQL引擎V1.0增强了那些功能

2.2  SQL引擎V2.0 与 V1.0的差异

3 如何判断是否走了SQL引擎V2.0

方法1：查看系统监控 “SQL/MDX监控”记录的数据源是否显示“SQL引擎V2.0”，如果是，则走了SQL引擎V2.0。

方法2：耗时分析，与方法1一样查看执行数据源：

4 SQL引擎V2.0的原理简说

SQL引擎V2.0是使用 DuckDB 作为 数据模型 SQL 查询的执行引擎。

作为一款嵌入式数据库，DuckDB 专为高效处理大规模数据分析任务而设计，其内存引擎在其中扮演了至关重要的角色。

以下是关于 DuckDB 内存引擎的一些关键点：

内存中的数据结构

DuckDB 使用一种称为 "flat columnar" 的存储格式来组织数据。这种格式将表的每一列分别存储在一个连续的内存块中，而不是按行存储。这不仅提高了缓存命中率，还使得对单个列的操作更加高效，非常适合用于分析查询中常见的聚合操作。

矢量化执行

DuckDB 的内存引擎采用了矢量化执行模型。这意味着在处理数据时，它不是一次处理一行，而是批量处理一整批（通常是1024或更多）的数据记录。矢量化可以显著减少解释开销，并允许现代CPU更好地利用SIMD（单指令多数据流）指令集进行并行计算，从而大幅提升查询性能。

内存管理

DuckDB 的内存管理机制能够智能地决定何时将数据保留在内存中以及何时将其写回到磁盘。对于临时结果和中间状态，DuckDB 可以根据可用内存自动调整策略，确保即使是在资源受限的环境中也能保持良好的性能。此外，DuckDB 支持显式的内存预算设置，用户可以根据具体需求控制最大内存使用量。

并发与事务支持

尽管主要针对读密集型工作负载进行了优化，但 DuckDB 的内存引擎也提供了基本的并发控制和事务支持。它可以安全地处理多个并发查询，并保证ACID属性（原子性、一致性、隔离性和持久性），即使所有操作都在内存中完成。

内存中的索引

为了加速查询，DuckDB 在内存中构建了多种类型的索引结构，如哈希索引、B树索引等。这些索引可以帮助快速定位特定值的位置，减少不必要的全表扫描，提高查询效率。特别是在涉及大量连接或查找操作的情况下，适当的索引可以极大地改善性能。

5 性能对比

5.1 单事实表模型

5.2 多事实模型