mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-05 22:12:21 +00:00
154 lines
4.6 KiB
Markdown
154 lines
4.6 KiB
Markdown
---
|
|
slug: /en/sql-reference/statements/select/except
|
|
sidebar_label: EXCEPT
|
|
---
|
|
|
|
# EXCEPT Clause
|
|
|
|
The `EXCEPT` clause returns only those rows that result from the first query without the second. The queries must match the number of columns, order, and type. The result of `EXCEPT` can contain duplicate rows.
|
|
|
|
Multiple `EXCEPT` statements are executed left to right if parenthesis are not specified. The `EXCEPT` operator has the same priority as the `UNION` clause and lower priority than the `INTERSECT` clause.
|
|
|
|
``` sql
|
|
SELECT column1 [, column2 ]
|
|
FROM table1
|
|
[WHERE condition]
|
|
|
|
EXCEPT
|
|
|
|
SELECT column1 [, column2 ]
|
|
FROM table2
|
|
[WHERE condition]
|
|
|
|
```
|
|
The condition could be any expression based on your requirements.
|
|
|
|
## Examples
|
|
|
|
Here is a simple example that returns the numbers 1 to 10 that are _not_ a part of the numbers 3 to 8:
|
|
|
|
Query:
|
|
|
|
``` sql
|
|
SELECT number FROM numbers(1,10) EXCEPT SELECT number FROM numbers(3,6);
|
|
```
|
|
|
|
Result:
|
|
|
|
```response
|
|
┌─number─┐
|
|
│ 1 │
|
|
│ 2 │
|
|
│ 9 │
|
|
│ 10 │
|
|
└────────┘
|
|
```
|
|
|
|
`EXCEPT` and `INTERSECT` can often be used interchangeably with different Boolean logic, and they are both useful if you have two tables that share a common column (or columns). For example, suppose we have a few million rows of historical cryptocurrency data that contains trade prices and volume:
|
|
|
|
```sql
|
|
CREATE TABLE crypto_prices
|
|
(
|
|
trade_date Date,
|
|
crypto_name String,
|
|
volume Float32,
|
|
price Float32,
|
|
market_cap Float32,
|
|
change_1_day Float32
|
|
)
|
|
ENGINE = MergeTree
|
|
PRIMARY KEY (crypto_name, trade_date);
|
|
|
|
INSERT INTO crypto_prices
|
|
SELECT *
|
|
FROM s3(
|
|
'https://learn-clickhouse.s3.us-east-2.amazonaws.com/crypto_prices.csv',
|
|
'CSVWithNames'
|
|
);
|
|
|
|
SELECT * FROM crypto_prices
|
|
WHERE crypto_name = 'Bitcoin'
|
|
ORDER BY trade_date DESC
|
|
LIMIT 10;
|
|
```
|
|
|
|
```response
|
|
┌─trade_date─┬─crypto_name─┬──────volume─┬────price─┬───market_cap─┬──change_1_day─┐
|
|
│ 2020-11-02 │ Bitcoin │ 30771456000 │ 13550.49 │ 251119860000 │ -0.013585099 │
|
|
│ 2020-11-01 │ Bitcoin │ 24453857000 │ 13737.11 │ 254569760000 │ -0.0031840964 │
|
|
│ 2020-10-31 │ Bitcoin │ 30306464000 │ 13780.99 │ 255372070000 │ 0.017308505 │
|
|
│ 2020-10-30 │ Bitcoin │ 30581486000 │ 13546.52 │ 251018150000 │ 0.008084608 │
|
|
│ 2020-10-29 │ Bitcoin │ 56499500000 │ 13437.88 │ 248995320000 │ 0.012552661 │
|
|
│ 2020-10-28 │ Bitcoin │ 35867320000 │ 13271.29 │ 245899820000 │ -0.02804481 │
|
|
│ 2020-10-27 │ Bitcoin │ 33749879000 │ 13654.22 │ 252985950000 │ 0.04427984 │
|
|
│ 2020-10-26 │ Bitcoin │ 29461459000 │ 13075.25 │ 242251000000 │ 0.0033826586 │
|
|
│ 2020-10-25 │ Bitcoin │ 24406921000 │ 13031.17 │ 241425220000 │ -0.0058658565 │
|
|
│ 2020-10-24 │ Bitcoin │ 24542319000 │ 13108.06 │ 242839880000 │ 0.013650347 │
|
|
└────────────┴─────────────┴─────────────┴──────────┴──────────────┴───────────────┘
|
|
```
|
|
|
|
Now suppose we have a table named `holdings` that contains a list of cryptocurrencies that we own, along with the number of coins:
|
|
|
|
```sql
|
|
CREATE TABLE holdings
|
|
(
|
|
crypto_name String,
|
|
quantity UInt64
|
|
)
|
|
ENGINE = MergeTree
|
|
PRIMARY KEY (crypto_name);
|
|
|
|
INSERT INTO holdings VALUES
|
|
('Bitcoin', 1000),
|
|
('Bitcoin', 200),
|
|
('Ethereum', 250),
|
|
('Ethereum', 5000),
|
|
('DOGEFI', 10);
|
|
('Bitcoin Diamond', 5000);
|
|
```
|
|
|
|
We can use `EXCEPT` to answer a question like **"Which coins do we own have never traded below $10?"**:
|
|
|
|
```sql
|
|
SELECT crypto_name FROM holdings
|
|
EXCEPT
|
|
SELECT crypto_name FROM crypto_prices
|
|
WHERE price < 10;
|
|
```
|
|
|
|
Result:
|
|
|
|
```response
|
|
┌─crypto_name─┐
|
|
│ Bitcoin │
|
|
│ Bitcoin │
|
|
└─────────────┘
|
|
```
|
|
|
|
This means of the four cryptocurrencies we own, only Bitcoin has never dropped below $10 (based on the limited data we have here in this example).
|
|
|
|
## EXCEPT DISTINCT
|
|
|
|
Notice in the previous query we had multiple Bitcoin holdings in the result. You can add `DISTINCT` to `EXCEPT` to eliminate duplicate rows from the result:
|
|
|
|
```sql
|
|
SELECT crypto_name FROM holdings
|
|
EXCEPT DISTINCT
|
|
SELECT crypto_name FROM crypto_prices
|
|
WHERE price < 10;
|
|
```
|
|
|
|
Result:
|
|
|
|
```response
|
|
┌─crypto_name─┐
|
|
│ Bitcoin │
|
|
└─────────────┘
|
|
```
|
|
|
|
|
|
**See Also**
|
|
|
|
- [UNION](union.md#union-clause)
|
|
- [INTERSECT](intersect.md#intersect-clause)
|