spark-instrumented-optimizer/docs/sql-ref-syntax-ddl-drop-view.md
Huaxin Gao 0c8d3d2a15 [SPARK-28798][FOLLOW-UP] Add alter view link to drop view
### What changes were proposed in this pull request?
Add alter view link to drop view

### Why are the changes needed?
create view has links to drop view and alter view
alter view has  links to create view and drop view
drop view currently doesn't have a link to alter view. I think it's better to link to alter view as well.

### Does this PR introduce any user-facing change?
Yes

### How was this patch tested?
Tested using jykyll build --serve

Closes #26495 from huaxingao/spark-28798.

Authored-by: Huaxin Gao <huaxing@us.ibm.com>
Signed-off-by: Sean Owen <sean.owen@databricks.com>
2019-11-13 07:11:26 -06:00

2.4 KiB

layout title displayTitle license
global DROP VIEW DROP VIEW Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Description

DROP VIEW removes the metadata associated with a specified view from the catalog.

Syntax

{% highlight sql %} DROP VIEW [IF EXISTS] [database_name.]view_name {% endhighlight %}

Parameter

IF EXISTS
If specified, no exception is thrown when the view does not exists.
database_name
Specifies the database name where view is present.
view_name
Specifies the view name to be dropped.

Example

{% highlight sql %} -- Assumes a view named employeeView exists. DROP VIEW employeeView; +---------+--+ | Result | +---------+--+ +---------+--+

-- Assumes a view named employeeView exists in the userdb database DROP VIEW userdb.employeeView; +---------+--+ | Result | +---------+--+ +---------+--+

-- Assumes a view named employeeView does not exists. -- Throws exception DROP VIEW employeeView; Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeeView; (state=,code=0)

-- Assumes a view named employeeView does not exists,Try with IF EXISTS -- this time it will not throw exception DROP VIEW IF EXISTS employeeView; +---------+--+ | Result | +---------+--+ +---------+--+

{% endhighlight %}