blob: 76eca4d1eb6f6a2e8bf6ee6c06b9b349dae6c10e [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 DATABASES - Spark 3.0.0-preview 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/bootstrap-responsive.min.css">
<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">
<!-- 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 -->
<div class="navbar navbar-fixed-top" id="topbar">
<div class="navbar-inner">
<div class="container">
<div class="brand"><a href="index.html">
<img src="img/spark-logo-hd.png" style="height:50px;"/></a><span class="version">3.0.0-preview</span>
</div>
<ul class="nav">
<!--TODO(andyk): Add class="active" attribute to li some how.-->
<li><a href="index.html">Overview</a></li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Programming Guides<b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="quick-start.html">Quick Start</a></li>
<li><a href="rdd-programming-guide.html">RDDs, Accumulators, Broadcasts Vars</a></li>
<li><a href="sql-programming-guide.html">SQL, DataFrames, and Datasets</a></li>
<li><a href="structured-streaming-programming-guide.html">Structured Streaming</a></li>
<li><a href="streaming-programming-guide.html">Spark Streaming (DStreams)</a></li>
<li><a href="ml-guide.html">MLlib (Machine Learning)</a></li>
<li><a href="graphx-programming-guide.html">GraphX (Graph Processing)</a></li>
<li><a href="sparkr.html">SparkR (R on Spark)</a></li>
</ul>
</li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">API Docs<b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="api/scala/index.html#org.apache.spark.package">Scala</a></li>
<li><a href="api/java/index.html">Java</a></li>
<li><a href="api/python/index.html">Python</a></li>
<li><a href="api/R/index.html">R</a></li>
<li><a href="api/sql/index.html">SQL, Built-in Functions</a></li>
</ul>
</li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Deploying<b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="cluster-overview.html">Overview</a></li>
<li><a href="submitting-applications.html">Submitting Applications</a></li>
<li class="divider"></li>
<li><a href="spark-standalone.html">Spark Standalone</a></li>
<li><a href="running-on-mesos.html">Mesos</a></li>
<li><a href="running-on-yarn.html">YARN</a></li>
<li><a href="running-on-kubernetes.html">Kubernetes</a></li>
</ul>
</li>
<li class="dropdown">
<a href="api.html" class="dropdown-toggle" data-toggle="dropdown">More<b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="configuration.html">Configuration</a></li>
<li><a href="monitoring.html">Monitoring</a></li>
<li><a href="tuning.html">Tuning Guide</a></li>
<li><a href="job-scheduling.html">Job Scheduling</a></li>
<li><a href="security.html">Security</a></li>
<li><a href="hardware-provisioning.html">Hardware Provisioning</a></li>
<li><a href="migration-guide.html">Migration Guide</a></li>
<li class="divider"></li>
<li><a href="building-spark.html">Building Spark</a></li>
<li><a href="https://spark.apache.org/contributing.html">Contributing to Spark</a></li>
<li><a href="https://spark.apache.org/third-party-projects.html">Third Party Projects</a></li>
</ul>
</li>
</ul>
<!--<p class="navbar-text pull-right"><span class="version-text">v3.0.0-preview</span></p>-->
</div>
</div>
</div>
<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-datatypes.html">
Data Types
</a>
</li>
<li>
<a href="sql-ref-null-semantics.html">
Null Semantics
</a>
</li>
<li>
<a href="sql-ref-nan-semantics.html">
NaN Semantics
</a>
</li>
<li>
<a href="sql-ref-syntax.html">
SQL Syntax
</a>
</li>
<ul>
<li>
<a href="sql-ref-syntax-ddl.html">
Data Definition Statements
</a>
</li>
<li>
<a href="sql-ref-syntax-dml.html">
Data Manipulation Statements
</a>
</li>
<li>
<a href="sql-ref-syntax-qry.html">
Data Retrieval(Queries)
</a>
</li>
<li>
<a href="sql-ref-syntax-aux.html">
Auxilarry Statements
</a>
</li>
<ul>
<li>
<a href="sql-ref-syntax-aux-analyze.html">
Analyze statement
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-cache.html">
Caching statements
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-describe.html">
Describe Commands
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show.html">
Show commands
</a>
</li>
<ul>
<li>
<a href="sql-ref-syntax-aux-show-columns.html">
SHOW COLUMNS
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show-databases.html">
<b>SHOW DATABASES</b>
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show-functions.html">
SHOW FUNCTIONS
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show-table.html">
SHOW TABLE
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show-tables.html">
SHOW TABLES
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show-tblproperties.html">
SHOW TBLPROPERTIES
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show-partitions.html">
SHOW PARTITIONS
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-show-create-table.html">
SHOW CREATE TABLE
</a>
</li>
</ul>
<li>
<a href="sql-ref-syntax-aux-conf-mgmt.html">
Configuration Management Commands
</a>
</li>
<li>
<a href="sql-ref-syntax-aux-resource-mgmt.html">
Resource Management Commands
</a>
</li>
</ul>
</ul>
<li>
<a href="sql-ref-functions.html">
Functions
</a>
</li>
<li>
<a href="sql-ref-arithmetic-ops.html">
Arthmetic operations
</a>
</li>
</ul>
</ul>
</div>
</div>
<input id="nav-trigger" class="nav-trigger" checked type="checkbox">
<label for="nav-trigger"></label>
<div class="content-with-sidebar" id="content">
<h1 class="title">SHOW DATABASES</h1>
<h3 id="description">Description</h3>
<p>Lists the databases that match an optionally supplied string pattern. If no
pattern is supplied then the command lists all the databases in the system.
Please note that the usage of <code>SCHEMAS</code> and <code>DATABASES</code> are interchangable
and mean the same thing.</p>
<h3 id="syntax">Syntax</h3>
<figure class="highlight"><pre><code class="language-sql" data-lang="sql"><span></span><span class="k">SHOW</span> <span class="err">{</span><span class="n">DATABASES</span><span class="o">|</span><span class="n">SCHEMAS</span><span class="err">}</span> <span class="p">[</span><span class="k">LIKE</span> <span class="n">string_pattern</span><span class="p">]</span></code></pre></figure>
<h3 id="parameters">Parameters</h3>
<dl>
<dt><code><em>LIKE string_pattern</em></code></dt>
<dd>
Specifies a string pattern that is used to match the databases in the system. In
the specified string pattern <code>'*'</code> matches any number of characters.
</dd>
</dl>
<h3 id="examples">Examples</h3>
<figure class="highlight"><pre><code class="language-sql" data-lang="sql"><span></span><span class="c1">-- Create database. Assumes a database named `default` already exists in</span>
<span class="c1">-- the system. </span>
<span class="k">CREATE</span> <span class="k">DATABASE</span> <span class="n">payroll_db</span><span class="p">;</span>
<span class="k">CREATE</span> <span class="k">DATABASE</span> <span class="n">payments_db</span><span class="p">;</span>
<span class="c1">-- Lists all the databases. </span>
<span class="k">SHOW</span> <span class="n">DATABASES</span><span class="p">;</span>
<span class="o">+</span><span class="c1">------------+</span>
<span class="o">|</span><span class="n">databaseName</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="o">|</span> <span class="n">payments_db</span><span class="o">|</span>
<span class="o">|</span> <span class="n">payroll_db</span><span class="o">|</span>
<span class="o">+</span><span class="c1">------------+</span>
<span class="c1">-- Lists databases with name starting with string pattern `pay`</span>
<span class="k">SHOW</span> <span class="n">DATABASES</span> <span class="k">LIKE</span> <span class="s1">&#39;pay*&#39;</span><span class="p">;</span>
<span class="o">+</span><span class="c1">------------+</span>
<span class="o">|</span><span class="n">databaseName</span><span class="o">|</span>
<span class="o">+</span><span class="c1">------------+</span>
<span class="o">|</span> <span class="n">payments_db</span><span class="o">|</span>
<span class="o">|</span> <span class="n">payroll_db</span><span class="o">|</span>
<span class="o">+</span><span class="c1">------------+</span>
<span class="c1">-- Lists all databases. Keywords SCHEMAS and DATABASES are interchangeable. </span>
<span class="k">SHOW</span> <span class="n">SCHEMAS</span><span class="p">;</span>
<span class="o">+</span><span class="c1">------------+</span>
<span class="o">|</span><span class="n">databaseName</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="o">|</span> <span class="n">payments_db</span><span class="o">|</span>
<span class="o">|</span> <span class="n">payroll_db</span><span class="o">|</span>
<span class="o">+</span><span class="c1">------------+</span></code></pre></figure>
<h3 id="related-statements">Related Statements</h3>
<ul>
<li><a href="sql-ref-syntax-aux-describe-databases.html">DESCRIBE DATABASE</a></li>
<li><a href="sql-ref-syntax-ddl-create-database.html">CREATE DATABASE</a></li>
<li><a href="sql-ref-syntax-ddl-alter-database.html">ALTER DATABASE</a></li>
</ul>
</div>
<!-- /container -->
</div>
<script src="js/vendor/jquery-3.4.1.min.js"></script>
<script src="js/vendor/bootstrap.min.js"></script>
<script src="js/vendor/anchor.min.js"></script>
<script src="js/main.js"></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>