ClickHouse/docs/en/sql-reference/statements/drop.md

117 lines
2.3 KiB
Markdown
Raw Normal View History

2020-07-11 11:05:49 +00:00
---
toc_priority: 44
2020-07-23 13:06:50 +00:00
toc_title: DROP
2020-07-11 11:05:49 +00:00
---
# DROP Statements {#drop}
2021-05-27 19:44:11 +00:00
Deletes existing entity. If the `IF EXISTS` clause is specified, these queries do not return an error if the entity does not exist.
2020-07-11 11:05:49 +00:00
## DROP DATABASE {#drop-database}
Deletes all tables inside the `db` database, then deletes the `db` database itself.
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster]
```
## DROP TABLE {#drop-table}
Deletes the table.
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP [TEMPORARY] TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster]
```
## DROP DICTIONARY {#drop-dictionary}
Deletes the dictionary.
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP DICTIONARY [IF EXISTS] [db.]name
```
## DROP USER {#drop-user-statement}
Deletes a user.
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP USER [IF EXISTS] name [,...] [ON CLUSTER cluster_name]
```
## DROP ROLE {#drop-role-statement}
Deletes a role. The deleted role is revoked from all the entities where it was assigned.
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP ROLE [IF EXISTS] name [,...] [ON CLUSTER cluster_name]
```
## DROP ROW POLICY {#drop-row-policy-statement}
2020-07-11 11:05:49 +00:00
Deletes a row policy. Deleted row policy is revoked from all the entities where it was assigned.
2020-07-11 11:05:49 +00:00
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP [ROW] POLICY [IF EXISTS] name [,...] ON [database.]table [,...] [ON CLUSTER cluster_name]
```
## DROP QUOTA {#drop-quota-statement}
2020-07-11 11:05:49 +00:00
Deletes a quota. The deleted quota is revoked from all the entities where it was assigned.
2020-07-11 11:05:49 +00:00
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP QUOTA [IF EXISTS] name [,...] [ON CLUSTER cluster_name]
```
## DROP SETTINGS PROFILE {#drop-settings-profile-statement}
2020-07-11 11:05:49 +00:00
Deletes a settings profile. The deleted settings profile is revoked from all the entities where it was assigned.
2020-07-11 11:05:49 +00:00
Syntax:
2020-07-11 11:05:49 +00:00
``` sql
DROP [SETTINGS] PROFILE [IF EXISTS] name [,...] [ON CLUSTER cluster_name]
```
## DROP VIEW {#drop-view}
2020-07-11 11:05:49 +00:00
Deletes a view. Views can be deleted by a `DROP TABLE` command as well but `DROP VIEW` checks that `[db.]name` is a view.
Syntax:
``` sql
DROP VIEW [IF EXISTS] [db.]name [ON CLUSTER cluster]
```
2021-08-21 12:38:19 +00:00
## DROP FUNCTION {#drop-function}
Deletes a user defined function created by [CREATE FUNCTION](./create/function.md).
System functions can not be dropped.
**Syntax**
``` sql
DROP FUNCTION [IF EXISTS] function_name
```
**Example**
``` sql
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
DROP FUNCTION linear_equation;
2021-08-21 12:38:19 +00:00
```