2020-04-24 07:02:44 +00:00
---
2022-04-03 23:05:35 +00:00
toc_priority: 40
toc_title: ANSI Compatibility
2020-04-24 07:02:44 +00:00
---
# ANSI SQL Compatibility of ClickHouse SQL Dialect {#ansi-sql-compatibility-of-clickhouse-sql-dialect}
2022-04-03 23:05:35 +00:00
!!! note "Note"
This article relies on Table 38, “Feature taxonomy and definition for mandatory features”, Annex ISO/IEC ](https://www.iso.org/obp/ui/#iso:std:iso-iec:9075:-2:ed-4:v1:en:sec:8 ).
2020-04-24 07:02:44 +00:00
## Differences in Behaviour {#differences-in-behaviour}
The following table lists cases when query feature works in ClickHouse, but behaves not as specified in ANSI SQL.
| Feature
|------------|-----------------------------|-----------------------------------------------------------------------------------------------------------|
2020-04-24 07:30:31 +00:00
| E011 | Numeric data types | Numeric literal with period is interpreted as approximate (`Float64`) instead of exact (`Decimal`) |
2020-04-24 07:02:44 +00:00
| E051-05 | Select items can be renamed | Item renames have a wider visibility scope than just the SELECT result |
| E141-01 | NOT NULL constraints | `NOT NULL` is implied for table columns by default |
| E011-04 | Arithmetic operators | ClickHouse overflows instead of checked arithmetic and changes the result data type based on custom rules |
## Feature Status {#feature-status}
| Feature
|------------|--------------------------------------------------------------------------------------------------------------------------|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **E011** | **Numeric data types** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| E011-01 | INTEGER and SMALLINT data types | Yes {.text-success} | |
2021-01-20 00:17:20 +00:00
| E011-02 | REAL, DOUBLE PRECISION and FLOAT data types data types | Yes {.text-success} | |
| E011-03 | DECIMAL and NUMERIC data types | Yes {.text-success} | |
2020-12-12 01:20:43 +00:00
| E011-04 | Arithmetic operators | Yes {.text-success} | |
| E011-05 | Numeric comparison | Yes {.text-success} | |
| E011-06 | Implicit casting among the numeric data types | No {.text-danger} | ANSI SQL allows arbitrary implicit cast between numeric types, while ClickHouse relies on functions having multiple overloads instead of implicit cast |
2020-04-24 07:02:44 +00:00
| **E021** | **Character string types** | **Partial** {.text-warning} | |
2021-01-20 00:17:20 +00:00
| E021-01 | CHARACTER data type | Yes {.text-success} | |
| E021-02 | CHARACTER VARYING data type | Yes {.text-success} | |
| E021-03 | Character literals | Yes {.text-success} | |
2020-12-12 01:20:43 +00:00
| E021-04 | CHARACTER_LENGTH function | Partial {.text-warning} | No `USING` clause |
| E021-05 | OCTET_LENGTH function | No {.text-danger} | `LENGTH` behaves similarly |
| E021-06 | SUBSTRING | Partial {.text-warning} | No support for `SIMILAR` and `ESCAPE` clauses, no `SUBSTRING_REGEX` variant |
| E021-07 | Character concatenation | Partial {.text-warning} | No `COLLATE` clause |
| E021-08 | UPPER and LOWER functions | Yes {.text-success} | |
| E021-09 | TRIM function | Yes {.text-success} | |
2021-01-20 00:17:20 +00:00
| E021-10 | Implicit casting among the fixed-length and variable-length character string types | Partial | ANSI SQL allows arbitrary implicit cast between string types, while ClickHouse relies on functions having multiple overloads instead of implicit cast |
2020-12-12 01:20:43 +00:00
| E021-11 | POSITION function | Partial {.text-warning} | No support for `IN` and `USING` clauses, no `POSITION_REGEX` variant |
| E021-12 | Character comparison | Yes {.text-success} | |
2020-04-24 07:02:44 +00:00
| **E031** | **Identifiers** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| E031-01 | Delimited identifiers | Partial {.text-warning} | Unicode literal support is limited |
| E031-02 | Lower case identifiers | Yes {.text-success} | |
| E031-03 | Trailing underscore | Yes {.text-success} | |
2020-04-24 07:02:44 +00:00
| **E051** | **Basic query specification** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| E051-01 | SELECT DISTINCT | Yes {.text-success} | |
| E051-02 | GROUP BY clause | Yes {.text-success} | |
| E051-04 | GROUP BY can contain columns not in `<select list>` | Yes {.text-success} | |
| E051-05 | Select items can be renamed | Yes {.text-success} | |
| E051-06 | HAVING clause | Yes {.text-success} | |
| E051-07 | Qualified \* in select list | Yes {.text-success} | |
| E051-08 | Correlation name in the FROM clause | Yes {.text-success} | |
| E051-09 | Rename columns in the FROM clause | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **E061** | **Basic predicates and search conditions** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| E061-01 | Comparison predicate | Yes {.text-success} | |
| E061-02 | BETWEEN predicate | Partial {.text-warning} | No `SYMMETRIC` and `ASYMMETRIC` clause |
| E061-03 | IN predicate with list of values | Yes {.text-success} | |
| E061-04 | LIKE predicate | Yes {.text-success} | |
| E061-05 | LIKE predicate: ESCAPE clause | No {.text-danger} | |
| E061-06 | NULL predicate | Yes {.text-success} | |
| E061-07 | Quantified comparison predicate | No {.text-danger} | |
| E061-08 | EXISTS predicate | No {.text-danger} | |
| E061-09 | Subqueries in comparison predicate | Yes {.text-success} | |
| E061-11 | Subqueries in IN predicate | Yes {.text-success} | |
| E061-12 | Subqueries in quantified comparison predicate | No {.text-danger} | |
| E061-13 | Correlated subqueries | No {.text-danger} | |
| E061-14 | Search condition | Yes {.text-success} | |
2020-04-24 07:02:44 +00:00
| **E071** | **Basic query expressions** | **Partial** {.text-warning} | |
2021-01-20 00:17:20 +00:00
| E071-01 | UNION DISTINCT table operator | Yes {.text-success} | |
2020-12-12 01:20:43 +00:00
| E071-02 | UNION ALL table operator | Yes {.text-success} | |
| E071-03 | EXCEPT DISTINCT table operator | No {.text-danger} | |
| E071-05 | Columns combined via table operators need not have exactly the same data type | Yes {.text-success} | |
| E071-06 | Table operators in subqueries | Yes {.text-success} | |
2021-01-20 00:17:20 +00:00
| **E081** | **Basic privileges** | **Yes** {.text-success} | |
| E081-01 | SELECT privilege at the table level | Yes {.text-success} | |
2020-09-14 19:32:51 +00:00
| E081-02 | DELETE privilege | | |
2021-01-20 00:17:20 +00:00
| E081-03 | INSERT privilege at the table level | Yes {.text-success} | |
| E081-04 | UPDATE privilege at the table level | Yes {.text-success} | |
2020-09-14 19:32:51 +00:00
| E081-05 | UPDATE privilege at the column level | | |
| E081-06 | REFERENCES privilege at the table level | | |
| E081-07 | REFERENCES privilege at the column level | | |
2021-01-20 00:17:20 +00:00
| E081-08 | WITH GRANT OPTION | Yes {.text-success} | |
2020-09-14 19:32:51 +00:00
| E081-09 | USAGE privilege | | |
| E081-10 | EXECUTE privilege | | |
2020-04-24 07:02:44 +00:00
| **E091** | **Set functions** | **Yes** {.text-success} | |
2020-12-12 01:20:43 +00:00
| E091-01 | AVG | Yes {.text-success} | |
| E091-02 | COUNT | Yes {.text-success} | |
| E091-03 | MAX | Yes {.text-success} | |
| E091-04 | MIN | Yes {.text-success} | |
| E091-05 | SUM | Yes {.text-success} | |
2021-01-20 00:17:20 +00:00
| E091-06 | ALL quantifier | Yes {.text-success} | |
| E091-07 | DISTINCT quantifier | Yes {.text-success} | Not all aggregate functions supported |
2020-04-24 07:02:44 +00:00
| **E101** | **Basic data manipulation** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| E101-01 | INSERT statement | Yes {.text-success} | Note: primary key in ClickHouse does not imply the `UNIQUE` constraint |
2021-01-20 00:17:20 +00:00
| E101-03 | Searched UPDATE statement | Partial | There’ `ALTER UPDATE` statement for batch data modification |
| E101-04 | Searched DELETE statement | Partial | There’ `ALTER DELETE` statement for batch data removal |
2020-04-24 07:02:44 +00:00
| **E111** | **Single row SELECT statement** | **No** {.text-danger} | |
| **E121** | **Basic cursor support** | **No** {.text-danger} | |
2020-12-12 01:20:43 +00:00
| E121-01 | DECLARE CURSOR | No {.text-danger} | |
2021-01-20 00:17:20 +00:00
| E121-02 | ORDER BY columns need not be in select list | Yes {.text-success} | |
| E121-03 | Value expressions in ORDER BY clause | Yes {.text-success} | |
2020-12-12 01:20:43 +00:00
| E121-04 | OPEN statement | No {.text-danger} | |
| E121-06 | Positioned UPDATE statement | No {.text-danger} | |
| E121-07 | Positioned DELETE statement | No {.text-danger} | |
| E121-08 | CLOSE statement | No {.text-danger} | |
| E121-10 | FETCH statement: implicit NEXT | No {.text-danger} | |
| E121-17 | WITH HOLD cursors | No {.text-danger} | |
2021-01-20 00:17:20 +00:00
| **E131** | **Null value support (nulls in lieu of values)** | **Yes** {.text-success} | Some restrictions apply |
2020-04-24 07:02:44 +00:00
| **E141** | **Basic integrity constraints** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| E141-01 | NOT NULL constraints | Yes {.text-success} | Note: `NOT NULL` is implied for table columns by default |
| E141-02 | UNIQUE constraint of NOT NULL columns | No {.text-danger} | |
2021-01-20 00:17:20 +00:00
| E141-03 | PRIMARY KEY constraints | Partial | |
2020-12-12 01:20:43 +00:00
| E141-04 | Basic FOREIGN KEY constraint with the NO ACTION default for both referential delete action and referential update action | No {.text-danger} | |
| E141-06 | CHECK constraint | Yes {.text-success} | |
| E141-07 | Column defaults | Yes {.text-success} | |
| E141-08 | NOT NULL inferred on PRIMARY KEY | Yes {.text-success} | |
| E141-10 | Names in a foreign key can be specified in any order | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **E151** | **Transaction support** | **No** {.text-danger} | |
2020-12-12 01:20:43 +00:00
| E151-01 | COMMIT statement | No {.text-danger} | |
| E151-02 | ROLLBACK statement | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **E152** | **Basic SET TRANSACTION statement** | **No** {.text-danger} | |
2020-12-12 01:20:43 +00:00
| E152-01 | SET TRANSACTION statement: ISOLATION LEVEL SERIALIZABLE clause | No {.text-danger} | |
| E152-02 | SET TRANSACTION statement: READ ONLY and READ WRITE clauses | No {.text-danger} | |
2021-01-20 00:17:20 +00:00
| **E153** | **Updatable queries with subqueries** | **Yes** {.text-success} | |
2020-04-24 07:02:44 +00:00
| **E161** | **SQL comments using leading double minus** | **Yes** {.text-success} | |
| **E171** | **SQLSTATE support** | **No** {.text-danger} | |
| **E182** | **Host language binding** | **No** {.text-danger} | |
| **F031** | **Basic schema manipulation** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| F031-01 | CREATE TABLE statement to create persistent base tables | Partial {.text-warning} | No `SYSTEM VERSIONING` , `ON COMMIT` , `GLOBAL` , `LOCAL` , `PRESERVE` , `DELETE` , `REF IS` , `WITH OPTIONS` , `UNDER` , `LIKE` , `PERIOD FOR` clauses and no support for user resolved data types |
| F031-02 | CREATE VIEW statement | Partial {.text-warning} | No `RECURSIVE` , `CHECK` , `UNDER` , `WITH OPTIONS` clauses and no support for user resolved data types |
| F031-03 | GRANT statement | Yes {.text-success} | |
2021-01-20 00:17:20 +00:00
| F031-04 | ALTER TABLE statement: ADD COLUMN clause | Yes {.text-success} | No support for `GENERATED` clause and system time period |
2020-12-12 01:20:43 +00:00
| F031-13 | DROP TABLE statement: RESTRICT clause | No {.text-danger} | |
| F031-16 | DROP VIEW statement: RESTRICT clause | No {.text-danger} | |
| F031-19 | REVOKE statement: RESTRICT clause | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **F041** | **Basic joined table** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| F041-01 | Inner join (but not necessarily the INNER keyword) | Yes {.text-success} | |
| F041-02 | INNER keyword | Yes {.text-success} | |
| F041-03 | LEFT OUTER JOIN | Yes {.text-success} | |
| F041-04 | RIGHT OUTER JOIN | Yes {.text-success} | |
| F041-05 | Outer joins can be nested | Yes {.text-success} | |
| F041-07 | The inner table in a left or right outer join can also be used in an inner join | Yes {.text-success} | |
| F041-08 | All comparison operators are supported (rather than just =) | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **F051** | **Basic date and time** | **Partial** {.text-warning} | |
2021-01-20 00:17:20 +00:00
| F051-01 | DATE data type (including support of DATE literal) | Yes {.text-success} | |
2020-12-12 01:20:43 +00:00
| F051-02 | TIME data type (including support of TIME literal) with fractional seconds precision of at least 0 | No {.text-danger} | |
2021-01-20 00:18:40 +00:00
| F051-03 | TIMESTAMP data type (including support of TIMESTAMP literal) with fractional seconds precision of at least 0 and 6 | Yes {.text-success} | |
| F051-04 | Comparison predicate on DATE, TIME, and TIMESTAMP data types | Yes {.text-success} | |
| F051-05 | Explicit CAST between datetime types and character string types | Yes {.text-success} | |
2020-12-12 01:20:43 +00:00
| F051-06 | CURRENT_DATE | No {.text-danger} | `today()` is similar |
| F051-07 | LOCALTIME | No {.text-danger} | `now()` is similar |
| F051-08 | LOCALTIMESTAMP | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **F081** | **UNION and EXCEPT in views** | **Partial** {.text-warning} | |
| **F131** | **Grouped operations** | **Partial** {.text-warning} | |
2020-12-12 01:20:43 +00:00
| F131-01 | WHERE, GROUP BY, and HAVING clauses supported in queries with grouped views | Yes {.text-success} | |
| F131-02 | Multiple tables supported in queries with grouped views | Yes {.text-success} | |
| F131-03 | Set functions supported in queries with grouped views | Yes {.text-success} | |
| F131-04 | Subqueries with GROUP BY and HAVING clauses and grouped views | Yes {.text-success} | |
| F131-05 | Single row SELECT with GROUP BY and HAVING clauses and grouped views | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **F181** | **Multiple module support** | **No** {.text-danger} | |
| **F201** | **CAST function** | **Yes** {.text-success} | |
| **F221** | **Explicit defaults** | **No** {.text-danger} | |
| **F261** | **CASE expression** | **Yes** {.text-success} | |
2020-12-12 01:20:43 +00:00
| F261-01 | Simple CASE | Yes {.text-success} | |
| F261-02 | Searched CASE | Yes {.text-success} | |
| F261-03 | NULLIF | Yes {.text-success} | |
| F261-04 | COALESCE | Yes {.text-success} | |
2020-04-24 07:02:44 +00:00
| **F311** | **Schema definition statement** | **Partial** {.text-warning} | |
2021-01-20 00:17:20 +00:00
| F311-01 | CREATE SCHEMA | Partial {.text-danger} | See CREATE DATABASE |
2020-12-12 01:20:43 +00:00
| F311-02 | CREATE TABLE for persistent base tables | Yes {.text-success} | |
| F311-03 | CREATE VIEW | Yes {.text-success} | |
| F311-04 | CREATE VIEW: WITH CHECK OPTION | No {.text-danger} | |
| F311-05 | GRANT statement | Yes {.text-success} | |
2020-04-24 07:02:44 +00:00
| **F471** | **Scalar subquery values** | **Yes** {.text-success} | |
| **F481** | **Expanded NULL predicate** | **Yes** {.text-success} | |
| **F812** | **Basic flagging** | **No** {.text-danger} | |
2020-09-14 19:42:54 +00:00
| **S011** | **Distinct data types** | | |
2020-04-24 07:02:44 +00:00
| **T321** | **Basic SQL-invoked routines** | **No** {.text-danger} | |
2020-12-12 01:20:43 +00:00
| T321-01 | User-defined functions with no overloading | No {.text-danger} | |
| T321-02 | User-defined stored procedures with no overloading | No {.text-danger} | |
| T321-03 | Function invocation | No {.text-danger} | |
| T321-04 | CALL statement | No {.text-danger} | |
| T321-05 | RETURN statement | No {.text-danger} | |
2020-04-24 07:02:44 +00:00
| **T631** | **IN predicate with one list element** | **Yes** {.text-success} | |
