Related Documentation Download this Manual
PDF (US Ltr) - 0.6Mb
PDF (A4) - 0.6Mb


HeatWave User Guide  /  Workload Optimization using Advisor

Chapter 8 Workload Optimization using Advisor

This section describes the Advisor utility, which provides the following optimization capabilities:

  • Auto Encoding

    Recommends string column encodings for improving query performance and reducing the amount of memory required on HeatWave nodes. See Section 8.1, “Auto Encoding”.

  • Auto Data Placement

    Recommends data placement keys for optimizing JOIN and GROUP BY query performance. See Section 8.2, “Auto Data Placement”.

  • Query Insights

    Provides runtimes for successfully executed queries and runtime estimates for EXPLAIN queries, queries cancelled using Ctrl+C, and queries that fail due to out of memory errors. Runtime data is useful for query optimization, troubleshooting, and estimating the cost of running a particular query or workload. See Section 8.3, “Query Insights”.

Advisor is workload-aware and provides recommendations based on machine learning models, data analysis, and HeatWave query history. Advisor analyzes the last 200 successfully executed HeatWave queries.

Advisor is implemented as a stored procedure named heatwave_advisor, which resides in the MySQL sys schema. Running Advisor involves issuing a CALL statement for the stored procedure with optional arguments.

CALL sys.heatwave_advisor (options);

Issue the following statement to view Advisor command-line help:

CALL sys.heatwave_advisor(JSON_OBJECT("output","help"));

Advisor can be run from any MySQL client or connector.

Advisor Requirements

  • To run Advisor, the HeatWave cluster must be active.

  • The user must have the following MySQL privileges: