SQL Extensions

On top of standard PostgreSQL syntax, SereneDB offers several SQL extensions and syntactic sugar that make queries more concise and readable.

Tip

Several of these features were first introduced by SereneDB, while some are inspired by other systems. Many of the features originally introduced by SereneDB (e.g., GROUP BY ALL) have been since adapted by other systems.

Clauses

• Creating tables and inserting data:
  • CREATE OR REPLACE TABLE: avoid DROP TABLE IF EXISTS statements in scripts.
  • CREATE TABLE ... AS SELECT (CTAS): create a new table from the output of a table without manually defining a schema.
  • INSERT INTO ... BY NAME: this variant of the INSERT statement allows using column names instead of positions.
  • INSERT OR IGNORE INTO ...: insert the rows that do not result in a conflict due to UNIQUE or PRIMARY KEY constraints.
  • INSERT OR REPLACE INTO ...: insert the rows that do not result in a conflict due to UNIQUE or PRIMARY KEY constraints. For those that result in a conflict, replace the columns of the existing row to the new values of the to-be-inserted row.
• Describing tables and computing statistics:
  • DESCRIBE: provides a succinct summary of the schema of a table or query.
  • SUMMARIZE: returns summary statistics for a table or query.
• Making SQL clauses more compact and readable:
  • FROM-first syntax with an optional SELECT clause: SereneDB allows queries in the form of FROM tbl which selects all columns (performing a SELECT * statement).
  • GROUP BY ALL: omit the group-by columns by inferring them from the list of attributes in the SELECT clause.
  • ORDER BY ALL: shorthand to order on all columns (e.g., to ensure deterministic results).
  • SELECT * EXCLUDE: the EXCLUDE option allows excluding specific columns from the * expression.
  • SELECT * REPLACE: the REPLACE option allows replacing specific columns with different expressions in a * expression.
  • UNION BY NAME: perform the UNION operation along the names of columns (instead of relying on positions).
  • Prefix aliases in the SELECT and FROM clauses: write x: 42 instead of 42 AS x for improved readability.
  • Specifying a percentage of the table size for the LIMIT clause: write LIMIT 10% to return 10% of the query results.
• Transforming tables:
  • PIVOT to turn long tables to wide tables.
  • UNPIVOT to turn wide tables to long tables.
• Defining SQL-level variables:
  • SET VARIABLE
  • RESET VARIABLE

Query Features

• Column aliases in WHERE, GROUP BY, and HAVING. (Note that column aliases cannot be used in the ON clause of JOIN clauses.)
• COLUMNS() expression can be used to execute the same expression on multiple columns:
  • with regular expressions
  • with EXCLUDE and REPLACE
  • with lambda functions
• Reusable column aliases (also known as “lateral column aliases”), e.g.: SELECT i + 1 AS j, j + 2 AS k FROM range(0, 3) t(i)
• Advanced aggregation features for analytical (OLAP) queries:
  • FILTER clause
  • GROUPING SETS, GROUP BY CUBE, GROUP BY ROLLUP clauses
• count() shorthand for count(*)
• IN operator for lists and maps
• Specifying column names for common table expressions (WITH)
• Specifying column names in the JOIN clause
• Using VALUES in the JOIN clause
• Using VALUES in the anchor part of common table expressions
• SWITCH statements as syntactic sugar for the CASE expression

Literals and Identifiers

• Case-insensitivity while maintaining case of entities in the catalog
• Underscores as digit separators in numeric literals

Data Types

• MAP data type
• UNION data type

Data Import

• Auto-detecting the headers and schema of CSV files
• Directly querying CSV files and Parquet files
• Filename expansion (globbing), e.g.: FROM 'my-data/part-*.parquet'

Functions and Expressions

• Dot operator for function chaining: SELECT ('hello').upper()
• String formatters: the format() function with the fmt syntax and the printf() function
• List comprehensions
• List slicing and indexing from the back ([-1])
• String slicing
• STRUCT.* notation
• Creating LIST using square brackets
• Simple LIST and STRUCT creation
• Updating the schema of STRUCTs

Join Types

• ASOF joins
• LATERAL joins
• POSITIONAL joins

Trailing Commas

SereneDB allows trailing commas, both when listing entities (e.g., column and table names) and when constructing LIST items. For example, the following query works:

Query

SELECT    42 AS x,    ['a', 'b', 'c',] AS y,    'hello world' AS z,;

Result

 x  | y       | z----+---------+------------- 42 | {a,b,c} | hello world

"Top-N in Group" Queries

Computing the "top-N rows in a group" ordered by some criteria is a common task in SQL that unfortunately often requires a complex query involving window functions and/or subqueries.

To aid in this, SereneDB provides the aggregate functions max(arg, n), min(arg, n), arg_max(arg, val, n), arg_min(arg, val, n), max_by(arg, val, n) and min_by(arg, val, n) to efficiently return the "top" n rows in a group based on a specific column in either ascending or descending order.

For example, let's use the following table:

Query

SELECT * FROM t1;

Result

 grp | val-----+----- a   |   2 a   |   1 b   |   5 b   |   4 a   |   3 b   |   6

We want to get a list of the top-3 val values in each group grp. The conventional way to do this is to use a window function in a subquery:

Query

SELECT array_agg(rs.val), rs.grpFROM    (SELECT val, grp, row_number() OVER (PARTITION BY grp ORDER BY val DESC) AS rid    FROM t1 ORDER BY val DESC) AS rsWHERE rid < 4GROUP BY rs.grp;

Result

 array_agg | grp-----------+----- {3,2,1}   | a {6,5,4}   | b

But in SereneDB, we can do this much more concisely (and efficiently!):

Query

SELECT max(val, 3) FROM t1 GROUP BY grp;

Result

 max--------- {3,2,1} {6,5,4}