ClickHouse/docs/en/sql-reference/table-functions/null.md

42 lines
1.1 KiB
Markdown
Raw Normal View History

2020-10-30 01:09:42 +00:00
---
2022-08-28 14:53:34 +00:00
slug: /en/sql-reference/table-functions/null
sidebar_position: 140
sidebar_label: null function
2022-08-29 16:26:17 +00:00
title: 'null'
2020-10-30 01:09:42 +00:00
---
2022-07-14 13:00:54 +00:00
Creates a temporary table of the specified structure with the [Null](../../engines/table-engines/special/null.md) table engine. According to the `Null`-engine properties, the table data is ignored and the table itself is immediately dropped right after the query execution. The function is used for the convenience of test writing and demonstrations.
2020-10-30 01:09:42 +00:00
2021-07-29 15:20:55 +00:00
**Syntax**
2020-10-30 01:09:42 +00:00
``` sql
null('structure')
```
2021-07-29 15:20:55 +00:00
**Parameter**
2020-10-30 01:09:42 +00:00
- `structure` — A list of columns and column types. [String](../../sql-reference/data-types/string.md).
2020-10-30 01:09:42 +00:00
**Returned value**
A temporary `Null`-engine table with the specified structure.
2020-10-30 01:09:42 +00:00
**Example**
Query with the `null` function:
``` sql
INSERT INTO function null('x UInt64') SELECT * FROM numbers_mt(1000000000);
```
can replace three queries:
```sql
CREATE TABLE t (x UInt64) ENGINE = Null;
INSERT INTO t SELECT * FROM numbers_mt(1000000000);
DROP TABLE IF EXISTS t;
```
2021-07-29 15:20:55 +00:00
See also:
- [Null table engine](../../engines/table-engines/special/null.md)