From 80c932fc0b7676d415aa53959217d3463fff5918 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Kohn?= <andre.kohn@salesforce.com>
Date: Mon, 19 Aug 2024 13:58:38 +0200
Subject: [PATCH] Hyper API August 2024 Release (#115)

* Add release note about ICU update (#108)

* Adjust documentation for `EXPLAIN` (#111)

* docs: Add Release Notes for new array type (#114)

* Prepare the August 2024 release

---------

Co-authored-by: Axel Uhlig <41142210+axeluhlig@users.noreply.github.com>
Co-authored-by: Axel Uhlig <auhlig@salesforce.com>
Co-authored-by: Adrian Vogelsgesang <avogelsgesang@salesforce.com>
Co-authored-by: Lucas Wolf <iamlucaswolf@gmail.com>
---
 website/docs/releases.md            |  9 +++++++++
 website/docs/sql/command/explain.md | 28 +++++++++++++++-------------
 website/src/config.ts               |  2 +-
 3 files changed, 25 insertions(+), 14 deletions(-)

diff --git a/website/docs/releases.md b/website/docs/releases.md
index 126ff42..fb4065f 100644
--- a/website/docs/releases.md
+++ b/website/docs/releases.md
@@ -24,6 +24,15 @@ In case you are wondering why all our releases start with `0.0`, read [this FAQ
 
 :::
 
+### 0.0.20027 [Aug 19 2024]
+
+* Introduced new [`array` SQL datatypes](./sql/datatype/array.md).
+* The options available for [EXPLAIN](sql/command/explain) changed:
+  * `EXPLAIN VERBOSE` was removed in favor of `EXPLAIN (FORMAT JSON)`
+  * There are two new output formats `EXPLAIN (FORMAT TERSE_JSON)` and `EXPLAIN (FORMAT SCHEMA)`
+* Update Unicode support from Unicode 14.0 to 15.1
+* Update Hyper's collation tables from CLDR 71 to CLDR 74. Besides corrections this also adds new collations to Hyper.
+
 ### 0.0.19691 [July 4, 2024]
 
 * Hyper API is now available under the Apache 2.0 license.
diff --git a/website/docs/sql/command/explain.md b/website/docs/sql/command/explain.md
index 2d8bc8b..d57f9ab 100644
--- a/website/docs/sql/command/explain.md
+++ b/website/docs/sql/command/explain.md
@@ -6,12 +6,12 @@
 
 ```sql_template
 EXPLAIN (<option>, ...) <query>;
-EXPLAIN [VERBOSE] [ANALYZE] <query>;
 ```
 
 where the available `<option>`s are
 
 ```sql_template
+FORMAT <format>
 VERBOSE
 ANALYZE
 OPTIMIZERSTEPS
@@ -26,23 +26,25 @@ Don't expect query plans (neither their formatting nor their semantics) to be st
 :::
 
 
-This command retrieves the query plan which Hyper uses to execute the given query.
+The `EXPLAIN` command retrieves information about the query plan which Hyper uses to execute the given query.
 The query plan describes which tables are accessed in which order, how they are joined together, which expressions are evaluated and all other details of query execution.
 
-One or more `<option>`s can be provided to change which information is displayed and how it is displayed.
-In general, options are provided within parentheses after the `EXPLAIN` keyword.
-In addition, `VERBOSE` and `ANALYZE` can also be provided without parentheses.
-
-There are three types of plans which can be queried:
+`EXPLAIN` can provide the following types of information:
 
 * The *optimized plan*. By default, if no other behavior is requested through an `<option>`, `EXPLAIN` will display the optimized plan.
 * The *optimizer steps*. If the `OPTIMIZERSTEPS` option is present, Hyper will output the plan at multiple intermediate steps during query optimization, e.g., before and after join reordering.
 * The *analyzed plan*. When invoked with the `ANALYZE` option, Hyper will actually execute the query, including all side effects (inserted/deleted tuples, etc.). Instead of the normal query results, you will however receive the query plan of the query, annotated with runtime statistics such as the number of tuples processed by each operator.
+* The *result schema*. With the `FORMAT SCHEMA`, only the list of result columns and their types are returned. The actual query plan is not printed.
+
+The `FORMAT` option determines the formatting of the returned data. The availble options are:
+* `TEXT_TREE`: a tree-like representation of the query plan as ASCII art. To be viewed using a monospaced font.
+* `JSON`: output the plan as pretty-printed JSON.
+* `TERSE_JSON`: output the plan as JSON without pretty-printing.
+* `SCHEMA`: only print a list of the returned columns. Don't actually print information about the joins, table scans, etc.
 
-By default, plans are formatted as ASCII art.
-The ASCII art is useful for quickly grasping the overall query structure, but is lacking details, such as the exact join conditions.
-Those details are present in the JSON output format, which can be requested using the `VERBOSE` option. 
-The `VERBOSE` option can be combined with any other choice.
+By default, plans are formatted as ASCII art trees.
+The ASCII art representation is useful for quickly grasping the overall query structure, but is lacking details, such as the exact join conditions.
+Those details are present in the JSON output format, which can be requested using the `FORMAT JSON` option.
 To visualize a JSON query plan and interactively explore it, copy-paste the plan into [Hyper's Plan Viewer](https://tableau.github.io/query-graphs/).
 
 ## Examples
@@ -71,10 +73,10 @@ WHERE l_shipdate >= date '1994-01-01'
     AND l_quantity < 24
 ```
 
-If we want to view the plan in a graphical plan viewer, or want to see additional details in the plan, we can use the `VERBOSE` option and then copy-paste the resulting JSON into [Hyper's Plan Viewer](https://tableau.github.io/query-graphs/).
+If we want to view the plan in a graphical plan viewer, or want to see additional details in the plan, we can use the `FORMAT JSON` option and then copy-paste the resulting JSON into [Hyper's Plan Viewer](https://tableau.github.io/query-graphs/).
 
 ```
-EXPLAIN (VERBOSE, OPTIMIZERSTEPS)
+EXPLAIN (FORMAT JSON, OPTIMIZERSTEPS)
 SELECT sum(l_extendedprice * l_discount) as revenue
 FROM lineitem
 WHERE l_shipdate >= date '1994-01-01'
diff --git a/website/src/config.ts b/website/src/config.ts
index 279a6c7..bef927d 100644
--- a/website/src/config.ts
+++ b/website/src/config.ts
@@ -1,4 +1,4 @@
-const version_long = '0.0.19691.r2d7e5bc8';
+const version_long = '0.0.20027.rcc745c2c';
 const version_short = version_long.substr(0, version_long.lastIndexOf('.'));
 
 const downloadBaseUrl = 'https://downloads.tableau.com/tssoftware/';