ClickHouse/docs/en/sql-reference/operators/exists.md

45 lines
940 B
Markdown
Raw Normal View History

2021-11-12 20:02:26 +00:00
# EXISTS {#exists-operator}
The `EXISTS` operator checks how many records are in the result of a subquery. If it is empty, then the operator returns `0`. Otherwise, it returns `1`.
2021-11-12 20:02:26 +00:00
2021-11-13 20:00:00 +00:00
`EXISTS` can be used in a [WHERE](../../sql-reference/statements/select/where.md) clause.
2022-04-03 23:05:35 +00:00
!!! warning "Warning"
References to main query tables and columns are not supported in a subquery.
2021-11-12 20:02:26 +00:00
**Syntax**
```sql
WHERE EXISTS(subquery)
```
**Example**
2021-11-18 19:44:38 +00:00
Query with a subquery returning several rows:
2021-11-12 20:02:26 +00:00
``` sql
2021-11-18 19:44:38 +00:00
SELECT count() FROM numbers(10) WHERE EXISTS(SELECT number FROM numbers(10) WHERE number > 8);
2021-11-12 20:02:26 +00:00
```
2021-11-18 19:44:38 +00:00
Result:
2021-11-12 20:02:26 +00:00
``` text
2021-11-18 19:44:38 +00:00
┌─count()─┐
│ 10 │
└─────────┘
```
Query with a subquery that returns an empty result:
``` sql
SELECT count() FROM numbers(10) WHERE EXISTS(SELECT number FROM numbers(10) WHERE number > 11);
```
Result:
``` text
┌─count()─┐
│ 0 │
└─────────┘
2021-11-12 20:02:26 +00:00
```