From a6be5308e8ad6ff942afa57be73e97eb0f8b8ac2 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Mon, 4 Apr 2022 21:08:12 +0800 Subject: [PATCH] chore(doc): add in conditional function and subquery operator --- .../01-conditional-functions/in.md | 46 +++++++++++++ .../03-sql/02-dml/_category_.json | 7 ++ .../03-reference/03-sql/02-dml/_category_.yml | 4 -- .../03-sql/03-query-syntax/_category_.json | 7 ++ .../dml-select.md | 0 .../03-sql/03-query/_category_.yml | 4 -- .../03-sql/04-query-operators/_category_.json | 7 ++ .../04-query-operators/operators-subquery.md | 64 +++++++++++++++++++ .../03-sql/04-show/_category_.json | 7 ++ .../03-sql/04-show/_category_.yml | 4 -- .../03-sql/05-kill/_category_.json | 7 ++ .../03-sql/05-kill/_category_.yml | 4 -- .../03-sql/06-list/_category_.json | 7 ++ .../03-sql/06-list/_category_.yml | 4 -- .../03-sql/07-system-tables/_category_.json | 7 ++ .../03-sql/07-system-tables/_category_.yml | 4 -- 16 files changed, 159 insertions(+), 24 deletions(-) create mode 100644 docs/doc/03-reference/02-functions/01-conditional-functions/in.md create mode 100644 docs/doc/03-reference/03-sql/02-dml/_category_.json delete mode 100644 docs/doc/03-reference/03-sql/02-dml/_category_.yml create mode 100644 docs/doc/03-reference/03-sql/03-query-syntax/_category_.json rename docs/doc/03-reference/03-sql/{03-query => 03-query-syntax}/dml-select.md (100%) delete mode 100644 docs/doc/03-reference/03-sql/03-query/_category_.yml create mode 100644 docs/doc/03-reference/03-sql/04-query-operators/_category_.json create mode 100644 docs/doc/03-reference/03-sql/04-query-operators/operators-subquery.md create mode 100644 docs/doc/03-reference/03-sql/04-show/_category_.json delete mode 100644 docs/doc/03-reference/03-sql/04-show/_category_.yml create mode 100644 docs/doc/03-reference/03-sql/05-kill/_category_.json delete mode 100644 docs/doc/03-reference/03-sql/05-kill/_category_.yml create mode 100644 docs/doc/03-reference/03-sql/06-list/_category_.json delete mode 100644 docs/doc/03-reference/03-sql/06-list/_category_.yml create mode 100644 docs/doc/03-reference/03-sql/07-system-tables/_category_.json delete mode 100644 docs/doc/03-reference/03-sql/07-system-tables/_category_.yml diff --git a/docs/doc/03-reference/02-functions/01-conditional-functions/in.md b/docs/doc/03-reference/02-functions/01-conditional-functions/in.md new file mode 100644 index 000000000000..70ca1a6b462a --- /dev/null +++ b/docs/doc/03-reference/02-functions/01-conditional-functions/in.md @@ -0,0 +1,46 @@ +--- +title: IN +description: Tests whether the argument is or is not one of the members of an explicit list +--- + +Tests whether the argument is or is not one of the members of an explicit list. + +## Syntax + +```sql + [ NOT ] IN ( , , ... ) +``` + +## Arguments + +| Arguments | Description | +| ----------- | ----------- | + +## Return Type + + +## Examples + +```sql +mysql> select * from numbers(10) where number in (0, 1, 2, 3); ++--------+ +| number | ++--------+ +| 0 | +| 1 | +| 2 | +| 3 | ++--------+ + +mysql> select * from numbers(10) where number not in (0, 1, 2, 3); ++--------+ +| number | ++--------+ +| 4 | +| 5 | +| 6 | +| 7 | +| 8 | +| 9 | ++--------+ +``` diff --git a/docs/doc/03-reference/03-sql/02-dml/_category_.json b/docs/doc/03-reference/03-sql/02-dml/_category_.json new file mode 100644 index 000000000000..dc41a6d06383 --- /dev/null +++ b/docs/doc/03-reference/03-sql/02-dml/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "DML Commands", + "link": { + "type": "generated-index", + "slug": "/reference/sql/dml" + } +} \ No newline at end of file diff --git a/docs/doc/03-reference/03-sql/02-dml/_category_.yml b/docs/doc/03-reference/03-sql/02-dml/_category_.yml deleted file mode 100644 index 5c22444c504a..000000000000 --- a/docs/doc/03-reference/03-sql/02-dml/_category_.yml +++ /dev/null @@ -1,4 +0,0 @@ -label: 'DML Commands' -link: - type: generated-index - title: 'DML Commands' diff --git a/docs/doc/03-reference/03-sql/03-query-syntax/_category_.json b/docs/doc/03-reference/03-sql/03-query-syntax/_category_.json new file mode 100644 index 000000000000..b674e816211a --- /dev/null +++ b/docs/doc/03-reference/03-sql/03-query-syntax/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "Query Syntax", + "link": { + "type": "generated-index", + "slug": "/reference/sql/query-syntax" + } +} \ No newline at end of file diff --git a/docs/doc/03-reference/03-sql/03-query/dml-select.md b/docs/doc/03-reference/03-sql/03-query-syntax/dml-select.md similarity index 100% rename from docs/doc/03-reference/03-sql/03-query/dml-select.md rename to docs/doc/03-reference/03-sql/03-query-syntax/dml-select.md diff --git a/docs/doc/03-reference/03-sql/03-query/_category_.yml b/docs/doc/03-reference/03-sql/03-query/_category_.yml deleted file mode 100644 index 98132d2901db..000000000000 --- a/docs/doc/03-reference/03-sql/03-query/_category_.yml +++ /dev/null @@ -1,4 +0,0 @@ -label: 'Query and Operators' -link: - type: generated-index - title: 'Query and Operators' diff --git a/docs/doc/03-reference/03-sql/04-query-operators/_category_.json b/docs/doc/03-reference/03-sql/04-query-operators/_category_.json new file mode 100644 index 000000000000..af63902ea53a --- /dev/null +++ b/docs/doc/03-reference/03-sql/04-query-operators/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "Query Operators", + "link": { + "type": "generated-index", + "slug": "/reference/sql/query-operators" + } +} \ No newline at end of file diff --git a/docs/doc/03-reference/03-sql/04-query-operators/operators-subquery.md b/docs/doc/03-reference/03-sql/04-query-operators/operators-subquery.md new file mode 100644 index 000000000000..77da497b70f0 --- /dev/null +++ b/docs/doc/03-reference/03-sql/04-query-operators/operators-subquery.md @@ -0,0 +1,64 @@ +--- +title: Subquery Operators +description: + A subquery is a query nested within another query. +--- + +This topic provides reference information about the subquery operators supported in Databend. + +A subquery is a query nested within another query. + +## [ NOT ] EXISTS + +An EXISTS subquery is a boolean expression that can appear in a WHERE clause: +* An EXISTS expression evaluates to TRUE if any rows are produced by the subquery. +* A NOT EXISTS expression evaluates to TRUE if no rows are produced by the subquery. + +### Syntax + +```sql +[ NOT ] EXISTS ( ) +``` + +:::note +* Correlated EXISTS subqueries are currently supported only in a WHERE clause. +::: + +### Example + +```sql +mysql> select number from numbers(10) where number>5 and exists(select number from numbers(5) where number>4); +Query OK, 0 rows affected +``` +`select number from numbers(5) where number>4` no rows are produced, `exists(select number from numbers(5) where number>4)` is FALSE. + +```sql +mysql> select number from numbers(10) where number>5 and exists(select number from numbers(5) where number>3); ++--------+ +| number | ++--------+ +| 6 | +| 7 | +| 8 | +| 9 | ++--------+ +``` + +`EXISTS(SELECT NUMBER FROM NUMBERS(5) WHERE NUMBER>3)` is TRUE. + +```sql +mysql> select number from numbers(10) where number>5 and not exists(select number from numbers(5) where number>4); ++--------+ +| number | ++--------+ +| 6 | +| 7 | +| 8 | +| 9 | ++--------+ +``` + +`not exists(select number from numbers(5) where number>4)` is TRUE. + + + diff --git a/docs/doc/03-reference/03-sql/04-show/_category_.json b/docs/doc/03-reference/03-sql/04-show/_category_.json new file mode 100644 index 000000000000..a505a797d8bf --- /dev/null +++ b/docs/doc/03-reference/03-sql/04-show/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "SHOW Commands", + "link": { + "type": "generated-index", + "slug": "/reference/sql/show" + } +} \ No newline at end of file diff --git a/docs/doc/03-reference/03-sql/04-show/_category_.yml b/docs/doc/03-reference/03-sql/04-show/_category_.yml deleted file mode 100644 index 650f566d4b1d..000000000000 --- a/docs/doc/03-reference/03-sql/04-show/_category_.yml +++ /dev/null @@ -1,4 +0,0 @@ -label: 'Show Commands' -link: - type: generated-index - title: 'Show Commands' diff --git a/docs/doc/03-reference/03-sql/05-kill/_category_.json b/docs/doc/03-reference/03-sql/05-kill/_category_.json new file mode 100644 index 000000000000..d12ab0785c8c --- /dev/null +++ b/docs/doc/03-reference/03-sql/05-kill/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "KILL Commands", + "link": { + "type": "generated-index", + "slug": "/reference/sql/kill" + } +} \ No newline at end of file diff --git a/docs/doc/03-reference/03-sql/05-kill/_category_.yml b/docs/doc/03-reference/03-sql/05-kill/_category_.yml deleted file mode 100644 index 50a82f74c7ce..000000000000 --- a/docs/doc/03-reference/03-sql/05-kill/_category_.yml +++ /dev/null @@ -1,4 +0,0 @@ -label: 'Kill Commands' -link: - type: generated-index - title: 'Kill Commands' diff --git a/docs/doc/03-reference/03-sql/06-list/_category_.json b/docs/doc/03-reference/03-sql/06-list/_category_.json new file mode 100644 index 000000000000..4163b6fed493 --- /dev/null +++ b/docs/doc/03-reference/03-sql/06-list/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "LIST Commands", + "link": { + "type": "generated-index", + "slug": "/reference/sql/list" + } +} \ No newline at end of file diff --git a/docs/doc/03-reference/03-sql/06-list/_category_.yml b/docs/doc/03-reference/03-sql/06-list/_category_.yml deleted file mode 100644 index 67bef4ba0ae9..000000000000 --- a/docs/doc/03-reference/03-sql/06-list/_category_.yml +++ /dev/null @@ -1,4 +0,0 @@ -label: 'List Commands' -link: - type: generated-index - title: 'List Commands' diff --git a/docs/doc/03-reference/03-sql/07-system-tables/_category_.json b/docs/doc/03-reference/03-sql/07-system-tables/_category_.json new file mode 100644 index 000000000000..292d08c3360a --- /dev/null +++ b/docs/doc/03-reference/03-sql/07-system-tables/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "System Tables", + "link": { + "type": "generated-index", + "slug": "/reference/sql/system-tables" + } +} \ No newline at end of file diff --git a/docs/doc/03-reference/03-sql/07-system-tables/_category_.yml b/docs/doc/03-reference/03-sql/07-system-tables/_category_.yml deleted file mode 100644 index 6a20d104967d..000000000000 --- a/docs/doc/03-reference/03-sql/07-system-tables/_category_.yml +++ /dev/null @@ -1,4 +0,0 @@ -label: 'System Tables' -link: - type: generated-index - title: 'System Tables'