以下先决条件适用于将查询卸载到 HeatWave：

如果不满足任何先决条件，则查询不会卸载并默认回退到 MySQL 数据库系统进行处理。

在运行查询之前，您可以使用 EXPLAIN确定查询是否将卸载到 HeatWave 进行处理。如果是，则 输出Extra列 EXPLAIN显示： “ Using secondary engine RAPID”。

mysql> EXPLAIN SELECT O_ORDERPRIORITY, COUNT(*) AS ORDER_COUNT FROM orders 
       WHERE O_ORDERDATE >= DATE '1994-03-01' GROUP BY O_ORDERPRIORITY 
       ORDER BY O_ORDERPRIORITY\G
*************************** 1. row ***************************
           id: 1
  select_type: SIMPLE
        table: orders
   partitions: NULL
         type: ALL
possible_keys: NULL
          key: NULL
      key_len: NULL
          ref: NULL
         rows: 14862970
     filtered: 33.33
        Extra: Using where; Using temporary; Using filesort; Using secondary 
        engine RAPID

如果Using secondary engine RAPID未出现在Extra列中，则查询不会卸载到 HeatWave。要确定查询不会卸载的原因，请参阅第 2.13 节“故障排除”，或尝试使用调试查询中描述的过程 调试查询。

使用EXPLAIN验证查询可以卸载后，运行查询并记下执行时间。

mysql> SELECT O_ORDERPRIORITY, COUNT(*) AS ORDER_COUNT FROM orders 
       WHERE O_ORDERDATE >= DATE '1994-03-01' GROUP BY O_ORDERPRIORITY 
       ORDER BY O_ORDERPRIORITY;
+-----------------+-------------+
| O_ORDERPRIORITY | ORDER_COUNT |
+-----------------+-------------+
| 1-URGENT        |     2017573 |
| 2-HIGH          |     2015859 |
| 3-MEDIUM        |     2013174 |
| 4-NOT SPECIFIED |     2014476 |
| 5-LOW           |     2013674 |
+-----------------+-------------+
5 rows in set (0.04 sec)

要将 HeatWave 查询执行时间与 MySQL 数据库系统执行时间进行比较，请禁用 use_secondary_engine变量并再次运行查询以查看在 MySQL 数据库系统上运行需要多长时间。

mysql> SET SESSION use_secondary_engine=OFF;

mysql> SELECT O_ORDERPRIORITY, COUNT(*) AS ORDER_COUNT FROM orders 
       WHERE O_ORDERDATE >= DATE '1994-03-01' GROUP BY O_ORDERPRIORITY 
       ORDER BY O_ORDERPRIORITY;
+-----------------+-------------+
| O_ORDERPRIORITY | ORDER_COUNT |
+-----------------+-------------+
| 1-URGENT        |     2017573 |
| 2-HIGH          |     2015859 |
| 3-MEDIUM        |     2013174 |
| 4-NOT SPECIFIED |     2014476 |
| 5-LOW           |     2013674 |
+-----------------+-------------+
5 rows in set (8.91 sec)

HeatWave 使用工作负载感知、基于优先级的自动调度机制来调度并发发出的查询以供执行。调度机制优先考虑短期运行的查询，但考虑队列中的等待时间，以便最终安排执行成本更高的查询。这种调度方法总体上减少了查询执行等待时间。

当 HeatWave 空闲时，到达的查询会立即安排执行。它没有排队。仅当前面的查询在 HeatWave 上运行时，查询才会排队。

在查询编译时为每个查询执行轻量级成本估算。

通过取消的查询Ctrl-C将从调度队列中删除。

有关您可以运行以查看 HeatWave 查询历史记录（包括查询开始时间、结束时间和调度队列中的等待时间）的查询，请参阅第 5.2 节，“HeatWave 监控”。

当在 HeatWave 中执行查询时，自动查询计划改进功能会收集查询计划统计信息并将其存储在统计缓存中。当新查询与先前执行的查询共享查询执行计划节点时，将使用从先前执行的查询中收集的统计信息而不是估计的统计信息，从而改进查询执行计划、成本估计、执行时间和内存效率。

缓存中的每个条目对应一个查询执行计划节点。查询执行计划可能有用于表扫描、 JOINs、GROUP BY 操作等的节点。

统计缓存是一个LRU结构。当达到缓存容量时，随着新条目的添加，最近最少使用的条目将从缓存中逐出。统计缓存中允许的条目数为 65536，足以存储 4000 到 5000 个中等复杂度的唯一查询的统计信息。统计缓存条目的最大数量由 MySQL 管理的 rapid_stats_cache_max_entries 设置定义。

本节介绍如何调试无法卸载到 HeatWave 以执行的查询。查询调试是通过启用 MySQL 优化器跟踪并查询 INFORMATION_SCHEMA.OPTIMIZER_TRACE 失败原因的表来执行的。

报告查询卸载失败的原因取决于遇到的问题或限制。对于不支持的子句或功能等常见问题，会报告具体原因。对于优化器执行的未定义问题或不支持的查询转换，报告了以下一般原因：

[{"Reason": "Currently unsupported RAPID query compilation scenario"}]

对于不满足HeatWave的query cost threshold的query，报如下原因：

[{"Reason": "The estimated query cost does not exceed secondary_engine_cost_threshold."}]

查询成本阈值可防止将低成本查询卸载到 HeatWave。有关查询成本阈值的信息，请参阅 第 2.13 节，“故障排除”。

对于试图访问定义为 的列的查询， NOT SECONDARY报告了以下原因：

[{"Reason": "Column risk_assessment is marked as NOT SECONDARY."}]

NOT SECONDARY当表加载到 HeatWave 中时， 定义为的列将被排除。请参阅 排除表列。

您可以使用 HeatWave Advisor Query Insights 功能或通过查询 performance_schema.rpd_query_stats表 来查看 HeatWave 查询运行时间和运行时间估计。运行时数据对于查询优化、故障排除以及估算运行特定查询或工作负载的成本很有用。

HeatWave 查询运行时数据包括：

运行时数据可用于 HeatWave 查询历史记录中的查询，它是有关最近 1000 个执行查询的信息的非持久存储。

使用查询洞察

有关使用Query Insights的其他信息，请参阅 第 2.7.3.3 节，“Query Insights”。

使用 rpd_query_stats 表

查看 HeatWave 查询历史中所有查询的运行时数据：

SELECT query_id,
  JSON_EXTRACT(JSON_UNQUOTE(qkrn_text->'$**.sessionId'),'$[0]') AS session_id, 
  JSON_EXTRACT(JSON_UNQUOTE(qkrn_text->'$**.accumulatedRapidCost'),'$[0]') AS time_in_ns, 
  JSON_EXTRACT(JSON_UNQUOTE(qexec_text->'$**.error'),'$[0]') AS error_message
  FROM performance_schema.rpd_query_stats;

要查看特定 HeatWave 查询的运行时数据，按查询 ID 过滤：

SELECT query_id,
  JSON_EXTRACT(JSON_UNQUOTE(qkrn_text->'$**.sessionId'),'$[0]') AS session_id, 
  JSON_EXTRACT(JSON_UNQUOTE(qkrn_text->'$**.accumulatedRapidCost'),'$[0]') AS time_in_ns, 
  JSON_EXTRACT(JSON_UNQUOTE(qexec_text->'$**.error'),'$[0]') AS error_message
  FROM performance_schema.rpd_query_stats WHERE query_id = 1;

EXPLAIN输出包括查询 ID。您还可以在 performance_schema.rpd_query_stats表中查询查询 ID：

SELECT query_id, LEFT(query_text,160) FROM performance_schema.rpd_query_stats;

语句的SELECT查询 CREATE TABLE ... SELECT被卸载到 HeatWave 执行，表在 MySQL 数据库系统上创建。在查询长时间运行且复杂的情况下，将 查询卸载SELECT 到 HeatWave 可以减少 执行时间。由于在 MySQL 数据库系统实例上执行的大量 DML 操作，产生大型结果集的查询无法从该功能中受益。 CREATE TABLE ... SELECTSELECTSELECT

该SELECT表必须加载到 HeatWave 中。例如，以下语句从 ordersHeatWave 上的表中选择数据并将结果集插入到orders2MySQL 数据库系统上创建的表中：

mysql> CREATE TABLE orders2 SELECT * FROM orders;

语句的这一SELECT部分 受与常规查询 CREATE TABLE ... SELECT相同的 HeatWave 要求和限制的约束 。SELECT

语句的SELECT查询 INSERT ... SELECT被卸载到 HeatWave 执行，结果集被插入到 MySQL 数据库系统上的指定表中。在查询长时间运行且复杂的情况下，将 查询卸载 SELECT到 HeatWave 可以减少 执行时间。由于在 MySQL 数据库系统实例上执行的大量 DML 操作，产生大型结果集的查询无法从该功能中受益。 INSERT ... SELECTSELECTSELECT

该SELECT表必须加载到 HeatWave 中，并且该INSERT表必须存在于 MySQL 数据库系统中。例如，以下语句从orderstHeatWave 上的表中选择数据并将结果集插入到orders2 MySQL 数据库系统上的表中：

mysql> INSERT INTO orders2 SELECT * FROM orders;

使用说明：

HeatWave 支持查询视图。创建视图的表必须加载到 HeatWave 中。对视图执行的查询受与对表执行的查询相同的卸载先决条件和限制的约束。

在以下示例中，在 orders表上创建了一个视图，如 第 2.6 节“表加载和查询示例”中所述。该示例假定订单表已加载到 HeatWave 中。

mysql> CREATE VIEW v1 AS SELECT O_ORDERPRIORITY, O_ORDERDATE FROM orders;

要确定在视图上执行的查询是否可以卸载到 HeatWave 执行，请使用 EXPLAIN. 如果支持卸载，则输出Extra列 EXPLAIN显示 “ Using secondary engine RAPID ”，如下例所示：

mysql> EXPLAIN SELECT O_ORDERPRIORITY, COUNT(*) AS ORDER_COUNT 
       FROM v1 WHERE O_ORDERDATE >= DATE '1994-03-01' GROUP BY O_ORDERPRIORITY 
       ORDER BY O_ORDERPRIORITY\G
*************************** 1. row ***************************
           id: 1
  select_type: SIMPLE
        table: ORDERS
   partitions: NULL
         type: ALL
possible_keys: NULL
          key: NULL
      key_len: NULL
          ref: NULL
         rows: 1488248
     filtered: 33.32999801635742
        Extra: Using where; Using temporary; Using filesort; Using secondary engine RAPID