Edit

SHOW DATABASES

Description

Views databases in your current StarRocks cluster or an external data source. Note that you can only view databases of an external data source in StarRocks 2.3 or later versions.

Syntax

SHOW DATABASES [FROM <catalog_name>]

Parameters

ParameterRequiredDescription
catalog_nameNoThe name of the internal catalog or an external catalog.
  • If you do not specified the parameter or set the value of the parameter to the name of the internal catalog, which is default_catalog, you can view databases in your current StarRocks cluster.
  • If you set the value of the parameter to the name of an external catalog, you can view databases in the corresponding external data source.

Examples

Example 1: View databases in your current StarRocks cluster.

SHOW DATABASES;

Or

SHOW DATABASES FROM default_catalog;

The output of the preceding statements is as follows.

+----------+
| Database |
+----------+
| db1      |
| db2      |
| db3      |
+----------+

Example 2: View databases in a Hive cluster by using the Hive1 external catalog.

SHOW DATABASES FROM hive1;

+-----------+
| Database  |
+-----------+
| hive_db1  |
| hive_db2  |
| hive_db3  |
+-----------+