SHOW CONNECTIONS
Applies to: Databricks SQL Databricks Runtime 13.3 LTS and above
Lists the connections that match an optionally supplied regular expression pattern. If no pattern is supplied then the command lists all the connections in the system.
Syntax
SHOW CONNECTIONS [ [ LIKE ] regex_pattern ]
You can also use SERVERS
instead of CONNECTIONS
.
Parameters
regex_pattern
A regular expression pattern that is used to filter the results of the statement.
- Except for
*
and|
character, the pattern works like a regular expression. *
alone matches 0 or more characters and|
is used to separate multiple different regular expressions, any of which can match.- The leading and trailing blanks are trimmed in the input pattern before processing. The pattern match is case-insensitive.
- Except for
Returns
A result set of cvonnections with the following columns:
name STRING NOT NULL
: names of connections in the metastore.connection_type STRING NOT NULL
: The type of the connection. For example:postgresql
.created_at STRING NOT NULL
: The timestamp when the connection was created, inISO 8601
format.created_by STRING NOT NULL
: The principal who created the connection.comment STRING
: An optional user specified comment on a connection.
Examples
> SHOW CONNECTIONS;
name connection_type created_at created_by comment
------------------- --------------- ---------------------------- ------------- ---------------------
mysql_connection mysql 2022-01-01T00:00:00.000+0000 alf@melmak.et mysql connection
postgres_connection postgresql 2022-06-12T13:30:00.000+0000 alf@melmak.et postgresql connection
> SHOW CONNECTIONS LIKE 'mysql*';
name connection_type created_at created_by comment
---------------- --------------- ---------------------------- ------------- ---------------------
mysql_connection mysql 2022-01-01T00:00:00.000+0000 alf@melmak.et mysql connection