Heatwave User Guide Abstract
Total Page:16
File Type:pdf, Size:1020Kb
HeatWave User Guide Abstract This is the HeatWave User Guide. This document provides information and procedures about loading data into HeatWave and running queries. For information about creating and managing a HeatWave cluster, refer to the MySQL Database Service User Guide. For information about the latest HeatWave features and updates, refer to the HeatWave Release Notes. For legal information, see the Legal Notices. For help with using MySQL, please visit the MySQL Forums, where you can discuss your issues with other MySQL users. Document generated on: 2021-09-27 (revision: 70897) Table of Contents Preface and Legal Notices .................................................................................................................. v 1 Introduction ..................................................................................................................................... 1 1.1 Architecture .......................................................................................................................... 2 1.2 MySQL Autopilot .................................................................................................................. 3 2 Before You Begin ............................................................................................................................ 5 3 Preparing Data ................................................................................................................................ 7 3.1 Identifying Tables to Load ..................................................................................................... 7 3.2 Excluding Table Columns ..................................................................................................... 7 3.3 Encoding String Columns ..................................................................................................... 8 3.4 Defining Data Placement Keys .............................................................................................. 9 3.5 Defining the Secondary Engine ........................................................................................... 11 4 Loading Data ................................................................................................................................ 13 4.1 Auto Parallel Load .............................................................................................................. 14 4.2 Change Propagation ........................................................................................................... 20 5 Unloading Tables .......................................................................................................................... 23 6 Running Queries ........................................................................................................................... 25 7 Table Load and Query Example .................................................................................................... 33 8 Workload Optimization using Advisor ............................................................................................. 37 8.1 Auto Encoding .................................................................................................................... 38 8.2 Auto Data Placement .......................................................................................................... 42 8.3 Query Insights .................................................................................................................... 45 8.4 Advisor Examples ............................................................................................................... 48 8.5 Advisor Report Table .......................................................................................................... 50 9 Best Practices ............................................................................................................................... 53 10 Troubleshooting ........................................................................................................................... 63 11 Reference ................................................................................................................................... 67 11.1 Supported Data Types ...................................................................................................... 67 11.2 Supported Functions and Operators .................................................................................. 68 11.2.1 Aggregate Functions .............................................................................................. 68 11.2.2 Arithmetic Operators .............................................................................................. 69 11.2.3 Cast Functions and Operators ................................................................................ 69 11.2.4 Comparison Functions and Operators ..................................................................... 70 11.2.5 Control Flow Functions and Operators .................................................................... 70 11.2.6 Date and Time Functions ....................................................................................... 71 11.2.7 Logical Operators ................................................................................................... 72 11.2.8 Mathematical Functions .......................................................................................... 72 11.2.9 String Functions and Operators .............................................................................. 73 11.2.10 Window Functions ................................................................................................ 75 11.3 Supported SQL Modes ..................................................................................................... 75 11.4 String Column Encoding Reference ................................................................................... 76 11.4.1 Variable-length Encoding ........................................................................................ 76 11.4.2 Dictionary Encoding ............................................................................................... 77 11.5 Metadata Queries ............................................................................................................. 78 11.6 Limitations ........................................................................................................................ 82 11.7 System Variables .............................................................................................................. 87 11.8 Secondary Engine Variables ............................................................................................. 90 11.9 Status Variables ............................................................................................................... 91 11.10 Performance Schema Tables .......................................................................................... 92 11.10.1 The rpd_exec_stats Table .................................................................................... 92 11.10.2 The rpd_nodes Table ........................................................................................... 93 11.10.3 The rpd_table_id Table ......................................................................................... 94 iii HeatWave User Guide 11.10.4 The rpd_tables Table ........................................................................................... 94 11.10.5 The rpd_column_id Table ..................................................................................... 95 11.10.6 The rpd_columns Table ........................................................................................ 96 11.10.7 The rpd_query_stats Table ................................................................................... 96 11.11 Generating tpch Sample Data ......................................................................................... 97 iv Preface and Legal Notices This is the HeatWave User Guide. This document provides information and procedures about loading data into HeatWave and running queries. For information about creating and managing a HeatWave cluster, refer to the MySQL Database Service User Guide. For information about the latest HeatWave features and updates, refer to the HeatWave Release Notes. Legal Notices Copyright © 1997, 2021, Oracle and/or its affiliates. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any programs embedded, installed or activated on delivered hardware, and modifications of such programs) and Oracle computer