Google Git
Sign in
apache / spark-website / asf-site / . / site / docs / 3.5.5 / sql-ref-syntax-aux-show-views.html
blob: b3f886d3fc797959d34c553a6840c39e19f196f1 [file] [log] [blame]
<!DOCTYPE html>
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
<!--[if IE 8]> <html class="no-js lt-ie9"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js"> <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>SHOW VIEWS - Spark 3.5.5 Documentation</title>
<link rel="stylesheet" href="css/bootstrap.min.css">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,wght@0,400;0,500;0,700;1,400;1,500;1,700&Courier+Prime:wght@400;700&display=swap" rel="stylesheet">
<link href="css/custom.css" rel="stylesheet">
<script src="js/vendor/modernizr-2.6.1-respond-1.1.0.min.js"></script>
<link rel="stylesheet" href="css/pygments-default.css">
<link rel="stylesheet" href="css/docsearch.min.css" />
<link rel="stylesheet" href="css/docsearch.css">
<!-- Matomo -->
<script>
var _paq = window._paq = window._paq || [];
/* tracker methods like "setCustomDimension" should be called before "trackPageView" */
_paq.push(["disableCookies"]);
_paq.push(['trackPageView']);
_paq.push(['enableLinkTracking']);
(function() {
var u="https://analytics.apache.org/";
_paq.push(['setTrackerUrl', u+'matomo.php']);
_paq.push(['setSiteId', '40']);
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
})();
</script>
<!-- End Matomo Code -->
</head>
<body class="global">
<!--[if lt IE 7]>
<p class="chromeframe">You are using an outdated browser. <a href="https://browsehappy.com/">Upgrade your browser today</a> or <a href="http://www.google.com/chromeframe/?redirect=true">install Google Chrome Frame</a> to better experience this site.</p>
<![endif]-->
<!-- This code is taken from http://twitter.github.com/bootstrap/examples/hero.html -->
<nav class="navbar navbar-expand-lg navbar-dark p-0 px-4 fixed-top" style="background: #1d6890;" id="topbar">
<div class="navbar-brand"><a href="index.html">
<img src="img/spark-logo-rev.svg" width="141" height="72"/></a><span class="version">3.5.5</span>
</div>
<button class="navbar-toggler" type="button" data-toggle="collapse"
data-target="#navbarCollapse" aria-controls="navbarCollapse"
aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarCollapse">
<ul class="navbar-nav me-auto">
<li class="nav-item"><a href="index.html" class="nav-link">Overview</a></li>
<li class="nav-item dropdown">
<a href="#" class="nav-link dropdown-toggle" id="navbarQuickStart" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Programming Guides</a>
<div class="dropdown-menu" aria-labelledby="navbarQuickStart">
<a class="dropdown-item" href="quick-start.html">Quick Start</a>
<a class="dropdown-item" href="rdd-programming-guide.html">RDDs, Accumulators, Broadcasts Vars</a>
<a class="dropdown-item" href="sql-programming-guide.html">SQL, DataFrames, and Datasets</a>
<a class="dropdown-item" href="structured-streaming-programming-guide.html">Structured Streaming</a>
<a class="dropdown-item" href="streaming-programming-guide.html">Spark Streaming (DStreams)</a>
<a class="dropdown-item" href="ml-guide.html">MLlib (Machine Learning)</a>
<a class="dropdown-item" href="graphx-programming-guide.html">GraphX (Graph Processing)</a>
<a class="dropdown-item" href="sparkr.html">SparkR (R on Spark)</a>
<a class="dropdown-item" href="api/python/getting_started/index.html">PySpark (Python on Spark)</a>
</div>
</li>
<li class="nav-item dropdown">
<a href="#" class="nav-link dropdown-toggle" id="navbarAPIDocs" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">API Docs</a>
<div class="dropdown-menu" aria-labelledby="navbarAPIDocs">
<a class="dropdown-item" href="api/scala/org/apache/spark/index.html">Scala</a>
<a class="dropdown-item" href="api/java/index.html">Java</a>
<a class="dropdown-item" href="api/python/index.html">Python</a>
<a class="dropdown-item" href="api/R/index.html">R</a>
<a class="dropdown-item" href="api/sql/index.html">SQL, Built-in Functions</a>
</div>
</li>
<li class="nav-item dropdown">
<a href="#" class="nav-link dropdown-toggle" id="navbarDeploying" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Deploying</a>
<div class="dropdown-menu" aria-labelledby="navbarDeploying">
<a class="dropdown-item" href="cluster-overview.html">Overview</a>
<a class="dropdown-item" href="submitting-applications.html">Submitting Applications</a>
<div class="dropdown-divider"></div>
<a class="dropdown-item" href="spark-standalone.html">Spark Standalone</a>
<a class="dropdown-item" href="running-on-mesos.html">Mesos</a>
<a class="dropdown-item" href="running-on-yarn.html">YARN</a>
<a class="dropdown-item" href="running-on-kubernetes.html">Kubernetes</a>
</div>
</li>
<li class="nav-item dropdown">
<a href="#" class="nav-link dropdown-toggle" id="navbarMore" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">More</a>
<div class="dropdown-menu" aria-labelledby="navbarMore">
<a class="dropdown-item" href="configuration.html">Configuration</a>
<a class="dropdown-item" href="monitoring.html">Monitoring</a>
<a class="dropdown-item" href="tuning.html">Tuning Guide</a>
<a class="dropdown-item" href="job-scheduling.html">Job Scheduling</a>
<a class="dropdown-item" href="security.html">Security</a>
<a class="dropdown-item" href="hardware-provisioning.html">Hardware Provisioning</a>
<a class="dropdown-item" href="migration-guide.html">Migration Guide</a>
<div class="dropdown-divider"></div>
<a class="dropdown-item" href="building-spark.html">Building Spark</a>
<a class="dropdown-item" href="https://spark.apache.org/contributing.html">Contributing to Spark</a>
<a class="dropdown-item" href="https://spark.apache.org/third-party-projects.html">Third Party Projects</a>
</div>
</li>
<li class="nav-item">
<input type="text" id="docsearch-input" placeholder="Search the docs…">
</li>
</ul>
<!--<span class="navbar-text navbar-right"><span class="version-text">v3.5.5</span></span>-->
</div>
</nav>
<div class="container">
<div class="left-menu-wrapper">
<div class="left-menu">
<h3><a href="sql-programming-guide.html">Spark SQL Guide</a></h3>
<ul>
<li>
<a href="sql-getting-started.html">
Getting Started
</a>
</li>
<li>
<a href="sql-data-sources.html">
Data Sources
</a>
</li>
<li>
<a href="sql-performance-tuning.html">
Performance Tuning
</a>
</li>
<li>
<a href="sql-distributed-sql-engine.html">
Distributed SQL Engine
</a>
</li>
<li>
<a href="sql-pyspark-pandas-with-arrow.html">
PySpark Usage Guide for Pandas with Apache Arrow
</a>
</li>
<li>
<a href="sql-migration-guide.html">
Migration Guide
</a>
</li>
<li>
<a href="sql-ref.html">
SQL Reference
</a>
</li>
<ul>
<li>
<a href="sql-ref-ansi-compliance.html">
ANSI Compliance
</a>
</li>
<li>
<a href="sql-ref-datatypes.html">
Data Types
</a>
</li>
<li>
<a href="sql-ref-datetime-pattern.html">
Datetime Pattern
</a>
</li>
<li>
<a href="sql-ref-number-pattern.html">
Number Pattern
</a>
</li>
<li>
<a href="sql-ref-functions.html">
Functions
</a>
</li>
<li>
<a href="sql-ref-identifier.html">
Identifiers
</a>
</li>
<li>
<a href="sql-ref-identifier-clause.html">
IDENTIFIER clause
</a>
</li>
<li>
<a href="sql-ref-literals.html">
Literals
</a>
</li>
<li>
<a href="sql-ref-null-semantics.html">
Null Semantics
</a>
</li>
<li>
<a href="sql-ref-syntax.html">
SQL Syntax
</a>
</li>
<ul>
<li>
<a href="sql-ref-syntax.html#ddl-statements">
Data Definition Statements
</a>
</li>
<li>
<a href="sql-ref-syntax.html#dml-statements">
Data Manipulation Statements
</a>
</li>
<li>
<a href="sql-ref-syntax.html#data-retrieval-statements">
Data Retrieval(Queries)
</a>
</li>
<li>
<a href="sql-ref-syntax.html#auxiliary-statements">
Auxiliary Statements
</a>
</li>
</ul>
</ul>
<li>
<a href="sql-error-conditions.html">
Error Conditions
</a>
</li>
</ul>
</div>
</div>
<input id="nav-trigger" class="nav-trigger" checked type="checkbox">
<label for="nav-trigger"></label>
<div class="content-with-sidebar mr-3" id="content">
<h1 class="title">SHOW VIEWS</h1>
<h3 id="description">Description</h3>
<p>The <code class="language-plaintext highlighter-rouge">SHOW VIEWS</code> statement returns all the views for an optionally specified database.
Additionally, the output of this statement may be filtered by an optional matching
pattern. If no database is specified then the views are returned from the
current database. If the specified database is global temporary view database, we will
list global temporary views. Note that the command also lists local temporary views
regardless of a given database.</p>
<h3 id="syntax">Syntax</h3>
<div class="language-sql highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">SHOW</span> <span class="n">VIEWS</span> <span class="p">[</span> <span class="err">{</span> <span class="k">FROM</span> <span class="o">|</span> <span class="k">IN</span> <span class="err">}</span> <span class="n">database_name</span> <span class="p">]</span> <span class="p">[</span> <span class="k">LIKE</span> <span class="n">regex_pattern</span> <span class="p">]</span>
</code></pre></div></div>
<h3 id="parameters">Parameters</h3>
<ul>
<li>
<p><strong>{ FROM <code class="language-plaintext highlighter-rouge">|</code> IN } database_name</strong></p>
<p>Specifies the database name from which views are listed.</p>
</li>
<li>
<p><strong>regex_pattern</strong></p>
<p>Specifies the regular expression pattern that is used to filter out unwanted views.</p>
<ul>
<li>Except for <code class="language-plaintext highlighter-rouge">*</code> and <code class="language-plaintext highlighter-rouge">|</code> character, the pattern works like a regular expression.</li>
<li><code class="language-plaintext highlighter-rouge">*</code> alone matches 0 or more characters and <code class="language-plaintext highlighter-rouge">|</code> is used to separate multiple different regular expressions,
any of which can match.</li>
<li>The leading and trailing blanks are trimmed in the input pattern before processing. The pattern match is case-insensitive.</li>
</ul>
</li>
</ul>
<h3 id="examples">Examples</h3>
<div class="language-sql highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">-- Create views in different databases, also create global/local temp views.</span>
<span class="k">CREATE</span> <span class="k">VIEW</span> <span class="n">sam</span> <span class="k">AS</span> <span class="k">SELECT</span> <span class="n">id</span><span class="p">,</span> <span class="n">salary</span> <span class="k">FROM</span> <span class="n">employee</span> <span class="k">WHERE</span> <span class="n">name</span> <span class="o">=</span> <span class="s1">'sam'</span><span class="p">;</span>
<span class="k">CREATE</span> <span class="k">VIEW</span> <span class="n">sam1</span> <span class="k">AS</span> <span class="k">SELECT</span> <span class="n">id</span><span class="p">,</span> <span class="n">salary</span> <span class="k">FROM</span> <span class="n">employee</span> <span class="k">WHERE</span> <span class="n">name</span> <span class="o">=</span> <span class="s1">'sam1'</span><span class="p">;</span>
<span class="k">CREATE</span> <span class="k">VIEW</span> <span class="n">suj</span> <span class="k">AS</span> <span class="k">SELECT</span> <span class="n">id</span><span class="p">,</span> <span class="n">salary</span> <span class="k">FROM</span> <span class="n">employee</span> <span class="k">WHERE</span> <span class="n">name</span> <span class="o">=</span> <span class="s1">'suj'</span><span class="p">;</span>
<span class="n">USE</span> <span class="n">userdb</span><span class="p">;</span>
<span class="k">CREATE</span> <span class="k">VIEW</span> <span class="n">user1</span> <span class="k">AS</span> <span class="k">SELECT</span> <span class="n">id</span><span class="p">,</span> <span class="n">salary</span> <span class="k">FROM</span> <span class="k">default</span><span class="p">.</span><span class="n">employee</span> <span class="k">WHERE</span> <span class="n">name</span> <span class="o">=</span> <span class="s1">'user1'</span><span class="p">;</span>
<span class="k">CREATE</span> <span class="k">VIEW</span> <span class="n">user2</span> <span class="k">AS</span> <span class="k">SELECT</span> <span class="n">id</span><span class="p">,</span> <span class="n">salary</span> <span class="k">FROM</span> <span class="k">default</span><span class="p">.</span><span class="n">employee</span> <span class="k">WHERE</span> <span class="n">name</span> <span class="o">=</span> <span class="s1">'user2'</span><span class="p">;</span>
<span class="n">USE</span> <span class="k">default</span><span class="p">;</span>
<span class="k">CREATE</span> <span class="k">GLOBAL</span> <span class="k">TEMP</span> <span class="k">VIEW</span> <span class="n">temp1</span> <span class="k">AS</span> <span class="k">SELECT</span> <span class="mi">1</span> <span class="k">AS</span> <span class="n">col1</span><span class="p">;</span>
<span class="k">CREATE</span> <span class="k">TEMP</span> <span class="k">VIEW</span> <span class="n">temp2</span> <span class="k">AS</span> <span class="k">SELECT</span> <span class="mi">1</span> <span class="k">AS</span> <span class="n">col1</span><span class="p">;</span>
<span class="c1">-- List all views in default database</span>
<span class="k">SHOW</span> <span class="n">VIEWS</span><span class="p">;</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="n">namespace</span> <span class="o">|</span> <span class="n">viewName</span> <span class="o">|</span> <span class="n">isTemporary</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="k">default</span> <span class="o">|</span> <span class="n">sam</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="k">default</span> <span class="o">|</span> <span class="n">sam1</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="k">default</span> <span class="o">|</span> <span class="n">suj</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="o">|</span> <span class="n">temp2</span> <span class="o">|</span> <span class="k">true</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="c1">-- List all views from userdb database </span>
<span class="k">SHOW</span> <span class="n">VIEWS</span> <span class="k">FROM</span> <span class="n">userdb</span><span class="p">;</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="n">namespace</span> <span class="o">|</span> <span class="n">viewName</span> <span class="o">|</span> <span class="n">isTemporary</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="n">userdb</span> <span class="o">|</span> <span class="n">user1</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="n">userdb</span> <span class="o">|</span> <span class="n">user2</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="o">|</span> <span class="n">temp2</span> <span class="o">|</span> <span class="k">true</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="c1">-- List all views in global temp view database </span>
<span class="k">SHOW</span> <span class="n">VIEWS</span> <span class="k">IN</span> <span class="n">global_temp</span><span class="p">;</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="n">namespace</span> <span class="o">|</span> <span class="n">viewName</span> <span class="o">|</span> <span class="n">isTemporary</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="n">global_temp</span> <span class="o">|</span> <span class="n">temp1</span> <span class="o">|</span> <span class="k">true</span> <span class="o">|</span>
<span class="o">|</span> <span class="o">|</span> <span class="n">temp2</span> <span class="o">|</span> <span class="k">true</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="c1">-- List all views from default database matching the pattern `sam*`</span>
<span class="k">SHOW</span> <span class="n">VIEWS</span> <span class="k">FROM</span> <span class="k">default</span> <span class="k">LIKE</span> <span class="s1">'sam*'</span><span class="p">;</span>
<span class="o">+</span><span class="c1">-----------+------------+--------------+</span>
<span class="o">|</span> <span class="n">namespace</span> <span class="o">|</span> <span class="n">viewName</span> <span class="o">|</span> <span class="n">isTemporary</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-----------+------------+--------------+</span>
<span class="o">|</span> <span class="k">default</span> <span class="o">|</span> <span class="n">sam</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="k">default</span> <span class="o">|</span> <span class="n">sam1</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-----------+------------+--------------+</span>
<span class="c1">-- List all views from the current database matching the pattern `sam|suj｜temp*`</span>
<span class="k">SHOW</span> <span class="n">VIEWS</span> <span class="k">LIKE</span> <span class="s1">'sam|suj|temp*'</span><span class="p">;</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="n">namespace</span> <span class="o">|</span> <span class="n">viewName</span> <span class="o">|</span> <span class="n">isTemporary</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
<span class="o">|</span> <span class="k">default</span> <span class="o">|</span> <span class="n">sam</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="k">default</span> <span class="o">|</span> <span class="n">suj</span> <span class="o">|</span> <span class="k">false</span> <span class="o">|</span>
<span class="o">|</span> <span class="o">|</span> <span class="n">temp2</span> <span class="o">|</span> <span class="k">true</span> <span class="o">|</span>
<span class="o">+</span><span class="c1">-------------+------------+--------------+</span>
</code></pre></div></div>
<h3 id="related-statements">Related statements</h3>
<ul>
<li><a href="sql-ref-syntax-ddl-create-view.html">CREATE VIEW</a></li>
<li><a href="sql-ref-syntax-ddl-drop-view.html">DROP VIEW</a></li>
<li><a href="sql-ref-syntax-ddl-create-database.html">CREATE DATABASE</a></li>
<li><a href="sql-ref-syntax-ddl-drop-database.html">DROP DATABASE</a></li>
</ul>
</div>
<!-- /container -->
</div>
<script src="js/vendor/jquery-3.5.1.min.js"></script>
<script src="js/vendor/bootstrap.bundle.min.js"></script>
<script src="js/vendor/anchor.min.js"></script>
<script src="js/main.js"></script>
<script type="text/javascript" src="js/vendor/docsearch.min.js"></script>
<script type="text/javascript">
// DocSearch is entirely free and automated. DocSearch is built in two parts:
// 1. a crawler which we run on our own infrastructure every 24 hours. It follows every link
// in your website and extract content from every page it traverses. It then pushes this
// content to an Algolia index.
// 2. a JavaScript snippet to be inserted in your website that will bind this Algolia index
// to your search input and display its results in a dropdown UI. If you want to find more
// details on how works DocSearch, check the docs of DocSearch.
docsearch({
apiKey: 'd62f962a82bc9abb53471cb7b89da35e',
appId: 'RAI69RXRSK',
indexName: 'apache_spark',
inputSelector: '#docsearch-input',
enhancedSearchInput: true,
algoliaOptions: {
'facetFilters': ["version:3.5.5"]
},
debug: false // Set debug to true if you want to inspect the dropdown
});
</script>
<!-- MathJax Section -->
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
TeX: { equationNumbers: { autoNumber: "AMS" } }
});
</script>
<script>
// Note that we load MathJax this way to work with local file (file://), HTTP and HTTPS.
// We could use "//cdn.mathjax...", but that won't support "file://".
(function(d, script) {
script = d.createElement('script');
script.type = 'text/javascript';
script.async = true;
script.onload = function(){
MathJax.Hub.Config({
tex2jax: {
inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ],
displayMath: [ ["$$","$$"], ["\\[", "\\]"] ],
processEscapes: true,
skipTags: ['script', 'noscript', 'style', 'textarea', 'pre']
}
});
};
script.src = ('https:' == document.location.protocol ? 'https://' : 'http://') +
'cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js' +
'?config=TeX-AMS-MML_HTMLorMML';
d.getElementsByTagName('head')[0].appendChild(script);
}(document));
</script>
</body>
</html>