Back to Materialize

DROP VIEW

doc/user/content/sql/drop-view.md

1231.3 KB
Original Source

DROP VIEW removes a view from Materialize.

Conceptual framework

Materialize maintains views after you create them. If you no longer need the view, you can remove it.

Because views rely on receiving data from sources, you must drop all views that rely on a source before you can drop the source itself. You can achieve this easily using DROP SOURCE...CASCADE.

Syntax

mzsql
DROP VIEW [IF EXISTS] <view_name> [RESTRICT|CASCADE];
Syntax elementDescription
IF EXISTSOptional. If specified, do not return an error if the named view does not exist.
<view_name>The view you want to drop. You can find available view names through SHOW VIEWS.
RESTRICTOptional. Do not drop this view if any other views depend on it. (Default)
CASCADEOptional. Drop all views that depend on this view.

Examples

mzsql
SHOW VIEWS;
nofmt
  name
---------
 my_view
mzsql
DROP VIEW my_view;
nofmt
DROP VIEW

Privileges

The privileges required to execute this statement are:

{{% include-headless "/headless/sql-command-privileges/drop-view" %}}