Skip to main content

CONNECTIONS

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 13.3 LTS and above check marked yes Unity Catalog only

INFORMATION_SCHEMA.CONNECTIONS describes foreign connections.

Information is displayed only for connections the user has permission to interact with.

This is an extension to the SQL Standard Information Schema.

Definition

The CONNECTIONS relation contains the following columns:

NameData typeNullableDescription
CONNECTION_NAMESTRINGNoName of the connection.
CONNECTION_TYPESTRINGNoThe type of the connection, e.g. REDSHIFT, SNOWFLAKE, MYSQL, POSTGRESQL
CONNECTION_OWNERSTRINGNoOwner of the connection.
COMMENTSTRINGYesAn optional comment that describes the connection.
CREATEDTIMESTAMPNoTimestamp when the catalog was created.
CREATED_BYSTRINGNoPrincipal who created the connection.
CREDENTIAL_TYPESTRINGNoType of the credential like ‘USERNAME_PASSWORD’, ‘OAUTH’
LAST_ALTEREDTIMESTAMPNoTimestamp when the connection was last altered in any way.
LAST_ALTERED_BYSTRINGNoPrincipal who last altered the connection.
CONNECTION_OPTIONSSTRINGYesA subset of the options used to establish the connection.
URLSTRINGNoThe URL of the connection.

Constraints

The following constraints apply to the CONNECTION relation:

ClassNameColumn ListDescription
Primary keyCONNECTIONS_PKCONNECTION_NAMEUnique identifier for the connection.

Examples

SQL
> SELECT connection_owner
FROM information_schema.connections