#21

mabel-dev · Jan 8, 2024 · 5722886 · 5722886
1 parent edaad24
commit 5722886
Show file tree

Hide file tree

Showing 3 changed files with 13 additions and 1 deletion.
diff --git a/docs/get-started/external-standards/sql92.md b/docs/get-started/external-standards/sql92.md
@@ -58,7 +58,7 @@ E061-13  | Correlated subqueries                                     | unknown
 E061-14  | Search condition                                          | unknown
 **E071** | **Basic query expressions**                               | unknown
 E071-01  | `UNION DISTINCT` table operator                           | no
-E071-02  | `UNION ALL` table operator                                | no
+E071-02  | `UNION ALL` table operator                                | partial
 E071-03  | `EXCEPT DISTINCT` table operator                          | no
 E071-05  | Columns combined via table operators need not have exactly the same data type | partial
 E071-06  | Table operators in subqueries                             | unknown

diff --git a/docs/get-started/release-notes/change-log.md b/docs/get-started/release-notes/change-log.md
@@ -10,6 +10,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 - [[#1362](https://github.com/mabel-dev/opteryx/pull/1362)] Shortcut OR evaluations [@joocer](https://github.com/joocer)
 - [[#1365](https://github.com/mabel-dev/opteryx/pull/1365)] Shortcut nested AND evaluations [@joocer](https://github.com/joocer)
+- [[#1367](https://github.com/mabel-dev/opteryx/pull/1367)] Support UNION statements [@joocer](https://github.com/joocer)
 
 ## [0.12.0] - 2024-01-02    
 

diff --git a/docs/sql-reference/statements.md b/docs/sql-reference/statements.md
@@ -7,6 +7,7 @@ The following statement forms are supported.
 Retrieve rows from zero or more relations.
 
 ~~~sql
+[ statement UNION [ ALL ] ... ]
 SELECT [ DISTINCT [ ON (<columns>) ] ] <expression> [, ..]
   FROM <relation> [AS <alias>]
    FOR <period>
@@ -25,6 +26,16 @@ OFFSET <offset>
  LIMIT <limit>
 ~~~
 
+### UNION class
+
+~~~
+statement UNION [ ALL ] statement
+~~~
+
+The `UNION` class appends the results of two queries together one after the other. The names and types of the resulting columns are taken from the first statement, names in the second statement are ignored and types are coerced where possible.
+
+The default behaviour of the `UNION` class is to deduplicate rows, to return all rows, including duplicates the `ALL` modifier must be used.
+
 ### SELECT clause
 
 ~~~