Google Git
Sign in
apache / spark-website / 20f2720126be7a5ecea244fa7ff977a995ed2a8c / . / site / docs / 3.2.0 / sql-ref-syntax-aux-show-tables.html
blob: 61d233089a2043a96e6f90a6c36b4737f2a34747 [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">
<title>SHOW TABLES - Spark 3.2.0 Documentation</title>
<link rel="stylesheet" href="css/bootstrap.min.css">
<style>
body {
padding-top: 60px;
padding-bottom: 40px;
}
</style>
<meta name="viewport" content="width=device-width">
<link rel="stylesheet" href="css/main.css">
<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="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
<link rel="stylesheet" href="css/docsearch.css">
<!-- Google analytics script -->
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-32518208-2']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<!--[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 fixed-top navbar-expand-md navbar-light bg-light" id="topbar">
<div class="container">
<div class="navbar-header">
<div class="navbar-brand"><a href="index.html">
<img src="img/spark-logo-hd.png" style="height:50px;"/></a><span class="version">3.2.0</span>
</div>
</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">
<!--TODO(andyk): Add class="active" attribute to li some how.-->
<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.2.0</span></span>-->
</div>
</div>
</nav>
<div class="container-wrapper">
<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-old.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-functions.html">
Functions
</a>
</li>
<li>
<a href="sql-ref-identifier.html">
Identifiers
</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>
</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 TABLES</h1>
<h3 id="description">Description</h3>
<p>The <code class="language-plaintext highlighter-rouge">SHOW TABLES</code> statement returns all the tables 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 tables are returned from the
current 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">TABLES</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 tables are listed.</p>
</li>
<li>
<p><strong>regex_pattern</strong></p>
<p>Specifies the regular expression pattern that is used to filter out unwanted tables.</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">-- List all tables in default database</span>
<span class="k">SHOW</span> <span class="n">TABLES</span><span class="p">;</span>
<span class="o">+</span><span class="c1">--------+---------+-----------+</span>
<span class="o">|</span><span class="k">database</span><span class="o">|</span><span class="n">tableName</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="c1">--------+---------+-----------+</span>
<span class="c1">-- List all tables from userdb database </span>
<span class="k">SHOW</span> <span class="n">TABLES</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="k">database</span><span class="o">|</span><span class="n">tableName</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="c1">--------+---------+-----------+</span>
<span class="c1">-- List all tables in userdb database</span>
<span class="k">SHOW</span> <span class="n">TABLES</span> <span class="k">IN</span> <span class="n">userdb</span><span class="p">;</span>
<span class="o">+</span><span class="c1">--------+---------+-----------+</span>
<span class="o">|</span><span class="k">database</span><span class="o">|</span><span class="n">tableName</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="c1">--------+---------+-----------+</span>
<span class="c1">-- List all tables from default database matching the pattern `sam*`</span>
<span class="k">SHOW</span> <span class="n">TABLES</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="k">database</span><span class="o">|</span><span class="n">tableName</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 tables matching the pattern `sam*|suj`</span>
<span class="k">SHOW</span> <span class="n">TABLES</span> <span class="k">LIKE</span> <span class="s1">'sam*|suj'</span><span class="p">;</span>
<span class="o">+</span><span class="c1">--------+---------+-----------+</span>
<span class="o">|</span><span class="k">database</span><span class="o">|</span><span class="n">tableName</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="c1">--------+---------+-----------+</span>
</code></pre></div></div>
<h3 id="related-statements">Related Statements</h3>
<ul>
<li><a href="sql-ref-syntax-ddl-create-table.html">CREATE TABLE</a></li>
<li><a href="sql-ref-syntax-ddl-drop-table.html">DROP TABLE</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="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/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: 'b18ca3732c502995563043aa17bc6ecb',
indexName: 'apache_spark',
inputSelector: '#docsearch-input',
enhancedSearchInput: true,
algoliaOptions: {
'facetFilters': ["version:3.2.0"]
},
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>